@r2wa-org/eden 0.0.72 → 0.0.76

package/dist/src/ledger/service.d.ts

@@ -1,462 +0,0 @@
-import Decimal from "decimal.js";
-import type { TransactionTx } from "../db/transaction";
-import type { LedgerEntrySelectSchemaType } from "./db.schemas";
-export interface CreateLedgerEntryParams {
-    assetId: string;
-    fromAccountId?: string | undefined;
-    toAccountId?: string | undefined;
-    bizType: LedgerEntrySelectSchemaType["bizType"];
-    amount: string | Decimal;
-    referenceId: string;
-    referenceType: LedgerEntrySelectSchemaType["referenceType"];
-    idempotencyKey: string;
-    memo?: string | undefined;
-    operatorId?: string | undefined;
-}
-export interface BalanceChangeResult {
-    success: boolean;
-    ledgerEntryId: string;
-    fromAvailableBefore?: string | null;
-    fromAvailableAfter?: string | null;
-    fromLockedBefore?: string | null;
-    fromLockedAfter?: string | null;
-    toAvailableBefore?: string | null;
-    toAvailableAfter?: string | null;
-    toLockedBefore?: string | null;
-    toLockedAfter?: string | null;
-    isIdempotent?: boolean;
-}
-export interface LedgerEntryQueryOptions {
-    assetId?: string;
-    accountId?: string;
-    limit?: number | undefined;
-    offset?: number | undefined;
-}
-declare abstract class BaseLedgerService {
-    protected static listLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
-        items: {
-            id: string;
-            createdAt: Date;
-            assetId: string;
-            fromAccountId: string | null;
-            toAccountId: string | null;
-            bizType: "deposit_credit" | "withdraw_freeze" | "withdraw_release" | "withdraw_debit" | "transfer_out" | "transfer_in" | "internal_transfer_out" | "internal_transfer_in" | "manual_increase" | "manual_decrease";
-            amount: string;
-            fromAvailableBefore: string | null;
-            fromAvailableAfter: string | null;
-            fromLockedBefore: string | null;
-            fromLockedAfter: string | null;
-            toAvailableBefore: string | null;
-            toAvailableAfter: string | null;
-            toLockedBefore: string | null;
-            toLockedAfter: string | null;
-            referenceId: string;
-            referenceType: "deposit_order" | "withdraw_order" | "transfer_order" | "internal_transfer_order" | "manual_adjustment";
-            idempotencyKey: string;
-            operatorId: string | null;
-            memo: string | null;
-            asset: {
-                symbol: string;
-                id: string;
-                name: string;
-                createdAt: Date;
-                updatedAt: Date;
-                precision: number;
-                isActive: boolean;
-                code: string;
-                category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                typeId: string;
-            };
-            fromAccount: {
-                id: string;
-                createdAt: Date;
-                updatedAt: Date;
-                userId: string;
-                status: "active" | "frozen" | "disabled";
-                assetId: string;
-                ledgerAccountTypeId: string;
-                available: string;
-                locked: string;
-                version: number;
-                asset: {
-                    symbol: string;
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    precision: number;
-                    isActive: boolean;
-                    code: string;
-                    category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                    typeId: string;
-                };
-                ledgerAccountType: {
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    description: string | null;
-                    key: string;
-                    allowDeposit: boolean;
-                    allowWithdraw: boolean;
-                    minWithdrawAmount: string;
-                    maxWithdrawAmount: string;
-                    allowTransfer: boolean;
-                    minTransferAmount: string;
-                    maxTransferAmount: string;
-                    allowInternalTransfer: boolean;
-                    allowInternalReceiveTransfer: boolean;
-                    minInternalTransferAmount: string;
-                    maxInternalTransferAmount: string;
-                    internalTransferRatio: string;
-                    allowTransaction: boolean;
-                    hasExpiry: boolean;
-                    expiryDays: number | null;
-                    isActive: boolean;
-                    sortOrder: number;
-                };
-            } | null;
-            toAccount: {
-                id: string;
-                createdAt: Date;
-                updatedAt: Date;
-                userId: string;
-                status: "active" | "frozen" | "disabled";
-                assetId: string;
-                ledgerAccountTypeId: string;
-                available: string;
-                locked: string;
-                version: number;
-                asset: {
-                    symbol: string;
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    precision: number;
-                    isActive: boolean;
-                    code: string;
-                    category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                    typeId: string;
-                };
-                ledgerAccountType: {
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    description: string | null;
-                    key: string;
-                    allowDeposit: boolean;
-                    allowWithdraw: boolean;
-                    minWithdrawAmount: string;
-                    maxWithdrawAmount: string;
-                    allowTransfer: boolean;
-                    minTransferAmount: string;
-                    maxTransferAmount: string;
-                    allowInternalTransfer: boolean;
-                    allowInternalReceiveTransfer: boolean;
-                    minInternalTransferAmount: string;
-                    maxInternalTransferAmount: string;
-                    internalTransferRatio: string;
-                    allowTransaction: boolean;
-                    hasExpiry: boolean;
-                    expiryDays: number | null;
-                    isActive: boolean;
-                    sortOrder: number;
-                };
-            } | null;
-        }[];
-        total: number;
-    }>;
-}
-/**
- * 用户侧账本服务
- * 提供用户查询自己账本记录的功能
- */
-export declare abstract class UserLedgerService extends BaseLedgerService {
-    static getLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
-        items: {
-            id: string;
-            createdAt: Date;
-            assetId: string;
-            fromAccountId: string | null;
-            toAccountId: string | null;
-            bizType: "deposit_credit" | "withdraw_freeze" | "withdraw_release" | "withdraw_debit" | "transfer_out" | "transfer_in" | "internal_transfer_out" | "internal_transfer_in" | "manual_increase" | "manual_decrease";
-            amount: string;
-            fromAvailableBefore: string | null;
-            fromAvailableAfter: string | null;
-            fromLockedBefore: string | null;
-            fromLockedAfter: string | null;
-            toAvailableBefore: string | null;
-            toAvailableAfter: string | null;
-            toLockedBefore: string | null;
-            toLockedAfter: string | null;
-            referenceId: string;
-            referenceType: "deposit_order" | "withdraw_order" | "transfer_order" | "internal_transfer_order" | "manual_adjustment";
-            idempotencyKey: string;
-            operatorId: string | null;
-            memo: string | null;
-            asset: {
-                symbol: string;
-                id: string;
-                name: string;
-                createdAt: Date;
-                updatedAt: Date;
-                precision: number;
-                isActive: boolean;
-                code: string;
-                category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                typeId: string;
-            };
-            fromAccount: {
-                id: string;
-                createdAt: Date;
-                updatedAt: Date;
-                userId: string;
-                status: "active" | "frozen" | "disabled";
-                assetId: string;
-                ledgerAccountTypeId: string;
-                available: string;
-                locked: string;
-                version: number;
-                asset: {
-                    symbol: string;
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    precision: number;
-                    isActive: boolean;
-                    code: string;
-                    category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                    typeId: string;
-                };
-                ledgerAccountType: {
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    description: string | null;
-                    key: string;
-                    allowDeposit: boolean;
-                    allowWithdraw: boolean;
-                    minWithdrawAmount: string;
-                    maxWithdrawAmount: string;
-                    allowTransfer: boolean;
-                    minTransferAmount: string;
-                    maxTransferAmount: string;
-                    allowInternalTransfer: boolean;
-                    allowInternalReceiveTransfer: boolean;
-                    minInternalTransferAmount: string;
-                    maxInternalTransferAmount: string;
-                    internalTransferRatio: string;
-                    allowTransaction: boolean;
-                    hasExpiry: boolean;
-                    expiryDays: number | null;
-                    isActive: boolean;
-                    sortOrder: number;
-                };
-            } | null;
-            toAccount: {
-                id: string;
-                createdAt: Date;
-                updatedAt: Date;
-                userId: string;
-                status: "active" | "frozen" | "disabled";
-                assetId: string;
-                ledgerAccountTypeId: string;
-                available: string;
-                locked: string;
-                version: number;
-                asset: {
-                    symbol: string;
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    precision: number;
-                    isActive: boolean;
-                    code: string;
-                    category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                    typeId: string;
-                };
-                ledgerAccountType: {
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    description: string | null;
-                    key: string;
-                    allowDeposit: boolean;
-                    allowWithdraw: boolean;
-                    minWithdrawAmount: string;
-                    maxWithdrawAmount: string;
-                    allowTransfer: boolean;
-                    minTransferAmount: string;
-                    maxTransferAmount: string;
-                    allowInternalTransfer: boolean;
-                    allowInternalReceiveTransfer: boolean;
-                    minInternalTransferAmount: string;
-                    maxInternalTransferAmount: string;
-                    internalTransferRatio: string;
-                    allowTransaction: boolean;
-                    hasExpiry: boolean;
-                    expiryDays: number | null;
-                    isActive: boolean;
-                    sortOrder: number;
-                };
-            } | null;
-        }[];
-        total: number;
-    }>;
-}
-/**
- * 管理侧账本服务
- * 提供管理员查询任意用户账本记录的功能
- */
-export declare abstract class AdminLedgerService extends BaseLedgerService {
-    static getLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
-        items: {
-            id: string;
-            createdAt: Date;
-            assetId: string;
-            fromAccountId: string | null;
-            toAccountId: string | null;
-            bizType: "deposit_credit" | "withdraw_freeze" | "withdraw_release" | "withdraw_debit" | "transfer_out" | "transfer_in" | "internal_transfer_out" | "internal_transfer_in" | "manual_increase" | "manual_decrease";
-            amount: string;
-            fromAvailableBefore: string | null;
-            fromAvailableAfter: string | null;
-            fromLockedBefore: string | null;
-            fromLockedAfter: string | null;
-            toAvailableBefore: string | null;
-            toAvailableAfter: string | null;
-            toLockedBefore: string | null;
-            toLockedAfter: string | null;
-            referenceId: string;
-            referenceType: "deposit_order" | "withdraw_order" | "transfer_order" | "internal_transfer_order" | "manual_adjustment";
-            idempotencyKey: string;
-            operatorId: string | null;
-            memo: string | null;
-            asset: {
-                symbol: string;
-                id: string;
-                name: string;
-                createdAt: Date;
-                updatedAt: Date;
-                precision: number;
-                isActive: boolean;
-                code: string;
-                category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                typeId: string;
-            };
-            fromAccount: {
-                id: string;
-                createdAt: Date;
-                updatedAt: Date;
-                userId: string;
-                status: "active" | "frozen" | "disabled";
-                assetId: string;
-                ledgerAccountTypeId: string;
-                available: string;
-                locked: string;
-                version: number;
-                asset: {
-                    symbol: string;
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    precision: number;
-                    isActive: boolean;
-                    code: string;
-                    category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                    typeId: string;
-                };
-                ledgerAccountType: {
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    description: string | null;
-                    key: string;
-                    allowDeposit: boolean;
-                    allowWithdraw: boolean;
-                    minWithdrawAmount: string;
-                    maxWithdrawAmount: string;
-                    allowTransfer: boolean;
-                    minTransferAmount: string;
-                    maxTransferAmount: string;
-                    allowInternalTransfer: boolean;
-                    allowInternalReceiveTransfer: boolean;
-                    minInternalTransferAmount: string;
-                    maxInternalTransferAmount: string;
-                    internalTransferRatio: string;
-                    allowTransaction: boolean;
-                    hasExpiry: boolean;
-                    expiryDays: number | null;
-                    isActive: boolean;
-                    sortOrder: number;
-                };
-            } | null;
-            toAccount: {
-                id: string;
-                createdAt: Date;
-                updatedAt: Date;
-                userId: string;
-                status: "active" | "frozen" | "disabled";
-                assetId: string;
-                ledgerAccountTypeId: string;
-                available: string;
-                locked: string;
-                version: number;
-                asset: {
-                    symbol: string;
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    precision: number;
-                    isActive: boolean;
-                    code: string;
-                    category: "FIAT" | "CRYPTO" | "POINT" | "RWA";
-                    typeId: string;
-                };
-                ledgerAccountType: {
-                    id: string;
-                    name: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    description: string | null;
-                    key: string;
-                    allowDeposit: boolean;
-                    allowWithdraw: boolean;
-                    minWithdrawAmount: string;
-                    maxWithdrawAmount: string;
-                    allowTransfer: boolean;
-                    minTransferAmount: string;
-                    maxTransferAmount: string;
-                    allowInternalTransfer: boolean;
-                    allowInternalReceiveTransfer: boolean;
-                    minInternalTransferAmount: string;
-                    maxInternalTransferAmount: string;
-                    internalTransferRatio: string;
-                    allowTransaction: boolean;
-                    hasExpiry: boolean;
-                    expiryDays: number | null;
-                    isActive: boolean;
-                    sortOrder: number;
-                };
-            } | null;
-        }[];
-        total: number;
-    }>;
-}
-export declare abstract class InternalLedgerService {
-    static increaseAvailableBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    static decreaseAvailableBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    static freezeBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    static unfreezeBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    static deductLockedBalance(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    static transferBetweenAccounts(tx: TransactionTx, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-}
-export {};