games_app/backend/dist/services/transferService.d.ts
2026-11-04 18:15:04 +02:00

21 lines
1.1 KiB
TypeScript

/**
* Internal peer-to-peer transfer service.
* Moves ledger balance between users by email; requires 2FA when enabled.
*/
/**
* Transfers balance from one user to another identified by email.
* Peer transfers always debit/credit the unified main ledger (USDT_TRC20).
* Deposit/withdraw rails such as USDT_BEP20 are not valid transfer assets.
* @param userId Sender user UUID
* @param toEmail Recipient email (normalized and hashed for lookup)
* @param walletTypeCode Asset code for the transfer (must be USDT_TRC20)
* @param amountRaw Amount in smallest ledger unit
* @param totpCode TOTP code when sender has 2FA enabled
* @returns Sender transaction ID and status (always completed on success)
* @throws {Error} On invalid amount, failed 2FA, recipient not found, self-transfer, insufficient balance, or min remaining
*/
export declare function requestTransfer(userId: string, toEmail: string, walletTypeCode: string, amountRaw: bigint, totpCode?: string): Promise<{
transactionId: string;
status: string;
}>;
//# sourceMappingURL=transferService.d.ts.map