@t2000/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,394 @@
+import { EventEmitter } from 'eventemitter3';
+import { SuiClient } from '@mysten/sui/client';
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import { Transaction } from '@mysten/sui/transactions';
+
+interface T2000Options {
+    keyPath?: string;
+    passphrase?: string;
+    network?: 'mainnet' | 'testnet';
+    rpcUrl?: string;
+    sponsored?: boolean;
+    name?: string;
+}
+interface GasReserve {
+    sui: number;
+    usdEquiv: number;
+}
+interface BalanceResponse {
+    available: number;
+    savings: number;
+    gasReserve: GasReserve;
+    total: number;
+    assets: Record<string, number>;
+}
+type GasMethod = 'self-funded' | 'sponsored' | 'auto-topup';
+interface SendResult {
+    success: boolean;
+    tx: string;
+    amount: number;
+    to: string;
+    gasCost: number;
+    gasCostUnit: string;
+    gasMethod: GasMethod;
+    balance: BalanceResponse;
+}
+interface SaveResult {
+    success: boolean;
+    tx: string;
+    amount: number;
+    apy: number;
+    fee: number;
+    gasCost: number;
+    gasMethod: GasMethod;
+}
+interface WithdrawResult {
+    success: boolean;
+    tx: string;
+    amount: number;
+    gasCost: number;
+    gasMethod: GasMethod;
+}
+interface BorrowResult {
+    success: boolean;
+    tx: string;
+    amount: number;
+    fee: number;
+    healthFactor: number;
+    gasCost: number;
+    gasMethod: GasMethod;
+}
+interface RepayResult {
+    success: boolean;
+    tx: string;
+    amount: number;
+    remainingDebt: number;
+    gasCost: number;
+    gasMethod: GasMethod;
+}
+interface SwapResult {
+    success: boolean;
+    tx: string;
+    fromAmount: number;
+    fromAsset: string;
+    toAmount: number;
+    toAsset: string;
+    priceImpact: number;
+    fee: number;
+    gasCost: number;
+    gasMethod: GasMethod;
+}
+interface HealthFactorResult {
+    healthFactor: number;
+    supplied: number;
+    borrowed: number;
+    maxBorrow: number;
+    liquidationThreshold: number;
+}
+interface MaxWithdrawResult {
+    maxAmount: number;
+    healthFactorAfter: number;
+    currentHF: number;
+}
+interface MaxBorrowResult {
+    maxAmount: number;
+    healthFactorAfter: number;
+    currentHF: number;
+}
+interface RatesResult {
+    USDC: {
+        saveApy: number;
+        borrowApy: number;
+    };
+}
+interface PositionEntry {
+    protocol: string;
+    asset: string;
+    type: 'save' | 'borrow';
+    amount: number;
+    apy: number;
+}
+interface PositionsResult {
+    positions: PositionEntry[];
+}
+interface EarningsResult {
+    totalYieldEarned: number;
+    currentApy: number;
+    dailyEarning: number;
+    supplied: number;
+}
+interface FundStatusResult {
+    supplied: number;
+    apy: number;
+    earnedToday: number;
+    earnedAllTime: number;
+    projectedMonthly: number;
+}
+interface DepositInfo {
+    address: string;
+    network: string;
+    supportedAssets: string[];
+    instructions: string;
+}
+interface TransactionRecord {
+    digest: string;
+    action: string;
+    amount?: number;
+    asset?: string;
+    timestamp: number;
+    gasMethod?: GasMethod;
+}
+
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'SPONSOR_FAILED' | 'SPONSOR_RATE_LIMITED' | 'GAS_STATION_UNAVAILABLE' | 'GAS_FEE_EXCEEDED' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'SLIPPAGE_EXCEEDED' | 'HEALTH_FACTOR_TOO_LOW' | 'WITHDRAW_WOULD_LIQUIDATE' | 'NO_COLLATERAL' | 'PROTOCOL_PAUSED' | 'PROTOCOL_UNAVAILABLE' | 'RPC_ERROR' | 'RPC_UNREACHABLE' | 'SPONSOR_UNAVAILABLE' | 'AUTO_TOPUP_FAILED' | 'PRICE_EXCEEDS_LIMIT' | 'UNSUPPORTED_NETWORK' | 'PAYMENT_EXPIRED' | 'DUPLICATE_PAYMENT' | 'FACILITATOR_REJECTION' | 'FACILITATOR_TIMEOUT' | 'UNKNOWN';
+interface T2000ErrorData {
+    reason?: string;
+    [key: string]: unknown;
+}
+declare class T2000Error extends Error {
+    readonly code: T2000ErrorCode;
+    readonly data?: T2000ErrorData;
+    readonly retryable: boolean;
+    constructor(code: T2000ErrorCode, message: string, data?: T2000ErrorData, retryable?: boolean);
+    toJSON(): {
+        retryable: boolean;
+        data?: T2000ErrorData | undefined;
+        error: T2000ErrorCode;
+        message: string;
+    };
+}
+declare function mapWalletError(error: unknown): T2000Error;
+declare function mapMoveAbortCode(code: number): string;
+
+interface T2000Events {
+    balanceChange: (event: {
+        asset: string;
+        previous: number;
+        current: number;
+        cause: string;
+        tx?: string;
+    }) => void;
+    healthWarning: (event: {
+        healthFactor: number;
+        threshold: number;
+        severity: 'warning';
+    }) => void;
+    healthCritical: (event: {
+        healthFactor: number;
+        threshold: number;
+        severity: 'critical';
+    }) => void;
+    yield: (event: {
+        earned: number;
+        total: number;
+        apy: number;
+        timestamp: number;
+    }) => void;
+    gasAutoTopUp: (result: {
+        usdcSpent: number;
+        suiReceived: number;
+    }) => void;
+    gasStationFallback: (event: {
+        reason: string;
+        method: string;
+        suiUsed: number;
+    }) => void;
+    error: (error: T2000Error) => void;
+}
+declare class T2000 extends EventEmitter<T2000Events> {
+    private readonly keypair;
+    private readonly client;
+    private readonly _address;
+    private _lastGasMethod;
+    private constructor();
+    static create(options?: T2000Options): Promise<T2000>;
+    static fromPrivateKey(privateKey: string, options?: {
+        network?: 'mainnet' | 'testnet';
+        rpcUrl?: string;
+    }): T2000;
+    static init(options: {
+        passphrase: string;
+        keyPath?: string;
+        name?: string;
+        sponsored?: boolean;
+    }): Promise<{
+        agent: T2000;
+        address: string;
+        sponsored: boolean;
+    }>;
+    /**
+     * Ensure the agent has enough SUI for gas.
+     * If SUI is low and USDC is available, auto-swaps $1 USDC → SUI.
+     */
+    private ensureGas;
+    /** SuiClient used by this agent — exposed for x402 and other integrations. */
+    get suiClient(): SuiClient;
+    /** Ed25519Keypair used by this agent — exposed for x402 and other integrations. */
+    get signer(): Ed25519Keypair;
+    address(): string;
+    send(params: {
+        to: string;
+        amount: number;
+        asset?: string;
+    }): Promise<SendResult>;
+    balance(): Promise<BalanceResponse>;
+    history(params?: {
+        limit?: number;
+    }): Promise<TransactionRecord[]>;
+    deposit(): Promise<DepositInfo>;
+    exportKey(): string;
+    save(params: {
+        amount: number | 'all';
+        asset?: string;
+    }): Promise<SaveResult>;
+    withdraw(params: {
+        amount: number | 'all';
+        asset?: string;
+    }): Promise<WithdrawResult>;
+    maxWithdraw(): Promise<MaxWithdrawResult>;
+    borrow(params: {
+        amount: number;
+        asset?: string;
+    }): Promise<BorrowResult>;
+    repay(params: {
+        amount: number | 'all';
+        asset?: string;
+    }): Promise<RepayResult>;
+    maxBorrow(): Promise<MaxBorrowResult>;
+    healthFactor(): Promise<HealthFactorResult>;
+    swap(params: {
+        from: string;
+        to: string;
+        amount: number;
+        maxSlippage?: number;
+    }): Promise<SwapResult>;
+    swapQuote(params: {
+        from: string;
+        to: string;
+        amount: number;
+    }): Promise<{
+        expectedOutput: number;
+        priceImpact: number;
+        poolPrice: number;
+        fee: {
+            amount: number;
+            rate: number;
+        };
+    }>;
+    positions(): Promise<PositionsResult>;
+    rates(): Promise<RatesResult>;
+    earnings(): Promise<EarningsResult>;
+    fundStatus(): Promise<FundStatusResult>;
+    private emitBalanceChange;
+}
+
+declare const MIST_PER_SUI = 1000000000n;
+declare const SUI_DECIMALS = 9;
+declare const USDC_DECIMALS = 6;
+declare const BPS_DENOMINATOR = 10000n;
+declare const CLOCK_ID = "0x6";
+declare const SUPPORTED_ASSETS: {
+    readonly USDC: {
+        readonly type: "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+        readonly decimals: 6;
+        readonly symbol: "USDC";
+    };
+    readonly SUI: {
+        readonly type: "0x2::sui::SUI";
+        readonly decimals: 9;
+        readonly symbol: "SUI";
+    };
+};
+type SupportedAsset = keyof typeof SUPPORTED_ASSETS;
+declare const DEFAULT_NETWORK: "mainnet";
+
+declare function validateAddress(address: string): string;
+declare function truncateAddress(address: string): string;
+
+declare function mistToSui(mist: bigint): number;
+declare function suiToMist(sui: number): bigint;
+declare function usdcToRaw(amount: number): bigint;
+declare function rawToUsdc(raw: bigint): number;
+declare function formatUsd(amount: number): string;
+declare function formatSui(amount: number): string;
+
+declare function generateKeypair(): Ed25519Keypair;
+declare function keypairFromPrivateKey(privateKey: string): Ed25519Keypair;
+declare function saveKey(keypair: Ed25519Keypair, passphrase: string, keyPath?: string): Promise<string>;
+declare function loadKey(passphrase: string, keyPath?: string): Promise<Ed25519Keypair>;
+declare function walletExists(keyPath?: string): Promise<boolean>;
+declare function exportPrivateKey(keypair: Ed25519Keypair): string;
+declare function getAddress(keypair: Ed25519Keypair): string;
+
+declare function solveHashcash(challenge: string): string;
+
+type FeeOperation = 'save' | 'swap' | 'borrow';
+interface ProtocolFeeInfo {
+    amount: number;
+    asset: string;
+    rate: number;
+    rawAmount: bigint;
+}
+declare function calculateFee(operation: FeeOperation, amount: number): ProtocolFeeInfo;
+
+interface SimulationResult {
+    success: boolean;
+    gasEstimateSui: number;
+    error?: {
+        moveAbortCode?: number;
+        moveModule?: string;
+        reason: string;
+        rawError: string;
+    };
+}
+declare function simulateTransaction(client: SuiClient, tx: Transaction, sender: string): Promise<SimulationResult>;
+declare function throwIfSimulationFailed(sim: SimulationResult): void;
+
+declare function getPoolPrice(client: SuiClient): Promise<number>;
+declare function getSwapQuote(client: SuiClient, fromAsset: 'USDC' | 'SUI', toAsset: 'USDC' | 'SUI', amount: number): Promise<{
+    expectedOutput: number;
+    priceImpact: number;
+    poolPrice: number;
+}>;
+
+declare function getRates(client: SuiClient): Promise<RatesResult>;
+
+interface GasExecutionResult {
+    digest: string;
+    effects: unknown;
+    gasMethod: GasMethod;
+    gasCostSui: number;
+}
+/**
+ * Gas resolution chain:
+ * 1. Self-funded (agent has enough SUI)
+ * 2. Auto-topup (swap USDC→SUI, then self-fund)
+ * 3. Gas Station sponsored (fallback)
+ * 4. Fail with INSUFFICIENT_GAS
+ */
+declare function executeWithGas(client: SuiClient, keypair: Ed25519Keypair, buildTx: () => Transaction | Promise<Transaction>): Promise<GasExecutionResult>;
+
+interface AutoTopUpResult {
+    success: boolean;
+    tx: string;
+    usdcSpent: number;
+    suiReceived: number;
+}
+declare function shouldAutoTopUp(client: SuiClient, address: string): Promise<boolean>;
+declare function executeAutoTopUp(client: SuiClient, keypair: Ed25519Keypair): Promise<AutoTopUpResult>;
+
+type GasRequestType = 'bootstrap' | 'auto-topup' | 'fallback';
+interface GasSponsorResponse {
+    txBytes: string;
+    sponsorSignature: string;
+    gasEstimateUsd: number;
+    type: GasRequestType;
+}
+interface GasStatusResponse {
+    circuitBreaker: boolean;
+    suiPrice: number;
+    bootstrapUsed?: number;
+    bootstrapRemaining?: number;
+}
+declare function getGasStatus(address?: string): Promise<GasStatusResponse>;
+
+export { type AutoTopUpResult, BPS_DENOMINATOR, type BalanceResponse, type BorrowResult, CLOCK_ID, DEFAULT_NETWORK, type DepositInfo, type EarningsResult, type FeeOperation, type FundStatusResult, type GasExecutionResult, type GasMethod, type GasRequestType, type GasReserve, type GasSponsorResponse, type GasStatusResponse, type HealthFactorResult, MIST_PER_SUI, type MaxBorrowResult, type MaxWithdrawResult, type PositionEntry, type PositionsResult, type ProtocolFeeInfo, type RatesResult, type RepayResult, SUI_DECIMALS, SUPPORTED_ASSETS, type SaveResult, type SendResult, type SimulationResult, type SupportedAsset, type SwapResult, T2000, T2000Error, type T2000ErrorCode, type T2000ErrorData, type T2000Options, type TransactionRecord, USDC_DECIMALS, type WithdrawResult, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, formatSui, formatUsd, generateKeypair, getAddress, getGasStatus, getPoolPrice, getRates, getSwapQuote, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, rawToUsdc, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };