games_app/backend/dist/services/walletService.d.ts

62 lines
2.5 KiB
TypeScript

/**
* User wallet and deposit address service.
* Derives TRON (TRC20) and BSC (BEP20) deposit addresses for USDT.
* Spendable ledger is always USDT_TRC20 (6 decimals). Inventory is deposit-sourced
* ops telemetry per network; withdrawals are capped by ledger + hot float, not inventory.
*/
import * as transactionRepository from '../repositories/transactionRepository';
import { Transaction } from '../models';
import { type WalletTypeCapabilities } from './walletCapabilities';
/**
* Gets or creates a USDT deposit address for a user (TRC20 or BEP20 custody rail).
*/
export declare function getOrCreateDepositAddress(userId: string, walletTypeCode: string): Promise<{
address: string;
walletType: WalletTypeCapabilities;
}>;
export declare function getWalletTypes(): Promise<WalletTypeCapabilities[]>;
export type NetworkBalanceInfo = {
code: string;
network: string;
depositEnabled: boolean;
withdrawEnabled: boolean;
/** Cumulative deposits credited on this network (ops / reporting; not a withdrawal cap). */
inventory: string;
/** Max withdrawable on this rail when enabled = full spendable available (ledger units). */
withdrawable: string;
};
export type UserBalancesResponse = {
/** Unified spendable USDT ledger (USDT_TRC20, 6 decimals). */
spendable: {
walletType: WalletTypeCapabilities;
available: string;
locked: string;
bonusAvailable: string;
testAvailable: string;
};
inventory: {
TRON: string;
BSC: string;
};
networks: NetworkBalanceInfo[];
/**
* @deprecated Prefer `spendable` + `networks`. Kept for older clients:
* single spendable row only (no separate BEP20 ledger balance).
*/
balances: Array<{
walletType: WalletTypeCapabilities;
available: string;
locked: string;
bonusAvailable: string;
testAvailable: string;
}>;
};
export declare function getUserBalances(userId: string): Promise<UserBalancesResponse>;
export declare function listUserTransactions(userId: string, limit: number, offset: number, category?: transactionRepository.TransactionActivityCategory): Promise<Transaction[]>;
export declare function listUserTransactionsPaginated(userId: string, limit: number, offset: number, category?: transactionRepository.TransactionActivityCategory): Promise<{
items: Transaction[];
total: number;
limit: number;
offset: number;
}>;
//# sourceMappingURL=walletService.d.ts.map