@r2wa-org/eden 0.0.48 → 0.0.50

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

@@ -1,28 +1,34 @@
 import Decimal from "decimal.js";
-import type { PgTransaction } from "drizzle-orm/pg-core";
+import type { TransactionTx } from "../db/transaction";
 import type { LedgerEntrySelectSchemaType } from "./db.schemas";
 export interface CreateLedgerEntryParams {
-    userId: string;
-    walletTypeId: string;
-    entryType: LedgerEntrySelectSchemaType["entryType"];
+    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;
-    availableBefore: string;
-    availableAfter: string;
-    frozenBefore: string;
-    frozenAfter: 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 {
-    walletTypeId?: LedgerEntrySelectSchemaType["walletTypeId"];
-    entryType?: LedgerEntrySelectSchemaType["entryType"];
+    assetId?: string;
+    accountId?: string;
     limit?: number | undefined;
     offset?: number | undefined;
 }
@@ -31,43 +37,134 @@ declare abstract class BaseLedgerService {
         items: {
             id: string;
             createdAt: Date;
-            userId: string;
-            walletTypeId: string;
-            entryType: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            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;
-            availableBefore: string;
-            availableAfter: string;
-            frozenBefore: string;
-            frozenAfter: 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_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
-            memo: string | null;
+            referenceType: "deposit_order" | "withdraw_order" | "transfer_order" | "internal_transfer_order" | "manual_adjustment";
+            idempotencyKey: string;
             operatorId: string | null;
-            walletType: {
+            memo: string | null;
+            asset: {
+                symbol: string;
                 id: string;
                 name: string;
                 createdAt: Date;
                 updatedAt: Date;
-                description: string | null;
-                code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-                allowDeposit: boolean;
-                allowWithdraw: boolean;
-                minWithdrawAmount: string;
-                maxWithdrawAmount: string;
-                allowTransfer: boolean;
-                minTransferAmount: string;
-                maxTransferAmount: string;
-                allowExchange: boolean;
-                allowReceiveExchange: boolean;
-                minExchangeAmount: string;
-                maxExchangeAmount: string;
-                exchangeRate: string;
-                allowTransaction: boolean;
-                hasExpiry: boolean;
-                expiryDays: number | null;
+                precision: number;
                 isActive: boolean;
-                sortOrder: number;
+                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;
     }>;
@@ -77,50 +174,138 @@ declare abstract class BaseLedgerService {
  * 提供用户查询自己账本记录的功能
  */
 export declare abstract class UserLedgerService extends BaseLedgerService {
-    /**
-     * 获取用户自己的账本记录
-     */
     static getLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
         items: {
             id: string;
             createdAt: Date;
-            userId: string;
-            walletTypeId: string;
-            entryType: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            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;
-            availableBefore: string;
-            availableAfter: string;
-            frozenBefore: string;
-            frozenAfter: 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_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
-            memo: string | null;
+            referenceType: "deposit_order" | "withdraw_order" | "transfer_order" | "internal_transfer_order" | "manual_adjustment";
+            idempotencyKey: string;
             operatorId: string | null;
-            walletType: {
+            memo: string | null;
+            asset: {
+                symbol: string;
                 id: string;
                 name: string;
                 createdAt: Date;
                 updatedAt: Date;
-                description: string | null;
-                code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-                allowDeposit: boolean;
-                allowWithdraw: boolean;
-                minWithdrawAmount: string;
-                maxWithdrawAmount: string;
-                allowTransfer: boolean;
-                minTransferAmount: string;
-                maxTransferAmount: string;
-                allowExchange: boolean;
-                allowReceiveExchange: boolean;
-                minExchangeAmount: string;
-                maxExchangeAmount: string;
-                exchangeRate: string;
-                allowTransaction: boolean;
-                hasExpiry: boolean;
-                expiryDays: number | null;
+                precision: number;
                 isActive: boolean;
-                sortOrder: number;
+                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;
     }>;
@@ -130,79 +315,148 @@ export declare abstract class UserLedgerService extends BaseLedgerService {
  * 提供管理员查询任意用户账本记录的功能
  */
 export declare abstract class AdminLedgerService extends BaseLedgerService {
-    /**
-     * 获取指定用户的账本记录
-     */
     static getLedgerEntries(userId: string, options?: LedgerEntryQueryOptions): Promise<{
         items: {
             id: string;
             createdAt: Date;
-            userId: string;
-            walletTypeId: string;
-            entryType: "deposit_confirmed" | "deposit_commission" | "withdraw_frozen" | "withdraw_confirmed" | "withdraw_fee" | "withdraw_rejected" | "transfer_in" | "transfer_out" | "wallet_transfer_in" | "wallet_transfer_out" | "freeze" | "unfreeze" | "manual_increase" | "manual_decrease" | "subscription_purchase" | "subscription_unlock";
+            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;
-            availableBefore: string;
-            availableAfter: string;
-            frozenBefore: string;
-            frozenAfter: 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_commission" | "deposit_order" | "withdraw_order" | "transfer_order" | "account_transfer" | "manual_adjustment" | "subscription_order";
-            memo: string | null;
+            referenceType: "deposit_order" | "withdraw_order" | "transfer_order" | "internal_transfer_order" | "manual_adjustment";
+            idempotencyKey: string;
             operatorId: string | null;
-            walletType: {
+            memo: string | null;
+            asset: {
+                symbol: string;
                 id: string;
                 name: string;
                 createdAt: Date;
                 updatedAt: Date;
-                description: string | null;
-                code: "balance" | "profit" | "team" | "check_in" | "meeting_reward" | "reform_pioneer_allowance" | "reform_monthly_enjoy" | "basic_livelihood" | "basic_pension" | "basic_medical";
-                allowDeposit: boolean;
-                allowWithdraw: boolean;
-                minWithdrawAmount: string;
-                maxWithdrawAmount: string;
-                allowTransfer: boolean;
-                minTransferAmount: string;
-                maxTransferAmount: string;
-                allowExchange: boolean;
-                allowReceiveExchange: boolean;
-                minExchangeAmount: string;
-                maxExchangeAmount: string;
-                exchangeRate: string;
-                allowTransaction: boolean;
-                hasExpiry: boolean;
-                expiryDays: number | null;
+                precision: number;
                 isActive: boolean;
-                sortOrder: number;
+                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;
     }>;
 }
-/**
- * 内部账本服务
- * 供其他模块调用，执行实际的余额变更和账本记录
- * 由各业务模块（deposit/withdraw 等）驱动
- */
-export declare abstract class InternalLedgerService extends BaseLedgerService {
-    /**
-     * 增加可用余额（用于充值、转入等）
-     */
-    static increaseAvailableBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    /**
-     * 减少可用余额（用于提现、转出等）
-     */
-    static decreaseAvailableBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    /**
-     * 冻结余额（从可用转到冻结）
-     */
-    static freezeBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    /**
-     * 解冻余额（从冻结转回可用）
-     */
-    static unfreezeBalance(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
-    /**
-     * 从冻结中扣除（用于提现完成、订单成交等）
-     */
-    static deductFromFrozen(tx: PgTransaction<any, any, any>, params: CreateLedgerEntryParams): Promise<BalanceChangeResult>;
+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 {};