@t2000/sdk 0.2.7 → 0.4.0

package/dist/index-DYQv9Wxo.d.ts

@@ -0,0 +1,393 @@
+import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { SuiClient } from '@mysten/sui/client';
+
+type AdapterCapability = 'save' | 'withdraw' | 'borrow' | 'repay' | 'swap';
+interface AdapterTxResult {
+    tx: Transaction;
+    feeCoin?: TransactionObjectArgument;
+    meta?: Record<string, unknown>;
+}
+interface LendingRates {
+    asset: string;
+    saveApy: number;
+    borrowApy: number;
+}
+interface AdapterPositions {
+    supplies: Array<{
+        asset: string;
+        amount: number;
+        apy: number;
+    }>;
+    borrows: Array<{
+        asset: string;
+        amount: number;
+        apy: number;
+    }>;
+}
+interface HealthInfo {
+    healthFactor: number;
+    supplied: number;
+    borrowed: number;
+    maxBorrow: number;
+    liquidationThreshold: number;
+}
+interface SwapQuote {
+    expectedOutput: number;
+    priceImpact: number;
+    poolPrice: number;
+}
+interface LendingAdapter {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly capabilities: readonly AdapterCapability[];
+    readonly supportedAssets: readonly string[];
+    readonly supportsSameAssetBorrow: boolean;
+    init(client: SuiClient): Promise<void>;
+    getRates(asset: string): Promise<LendingRates>;
+    getPositions(address: string): Promise<AdapterPositions>;
+    getHealth(address: string): Promise<HealthInfo>;
+    buildSaveTx(address: string, amount: number, asset: string, options?: {
+        collectFee?: boolean;
+    }): Promise<AdapterTxResult>;
+    buildWithdrawTx(address: string, amount: number, asset: string): Promise<AdapterTxResult & {
+        effectiveAmount: number;
+    }>;
+    buildBorrowTx(address: string, amount: number, asset: string, options?: {
+        collectFee?: boolean;
+    }): Promise<AdapterTxResult>;
+    buildRepayTx(address: string, amount: number, asset: string): Promise<AdapterTxResult>;
+    maxWithdraw(address: string, asset: string): Promise<{
+        maxAmount: number;
+        healthFactorAfter: number;
+        currentHF: number;
+    }>;
+    maxBorrow(address: string, asset: string): Promise<{
+        maxAmount: number;
+        healthFactorAfter: number;
+        currentHF: number;
+    }>;
+}
+interface SwapAdapter {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly capabilities: readonly AdapterCapability[];
+    init(client: SuiClient): Promise<void>;
+    getQuote(from: string, to: string, amount: number): Promise<SwapQuote>;
+    buildSwapTx(address: string, from: string, to: string, amount: number, maxSlippageBps?: number): Promise<AdapterTxResult & {
+        estimatedOut: number;
+        toDecimals: number;
+    }>;
+    getSupportedPairs(): Array<{
+        from: string;
+        to: string;
+    }>;
+    getPoolPrice(): Promise<number>;
+}
+
+interface T2000Options {
+    keyPath?: string;
+    /** PIN to decrypt the key file. Accepts any string (4+ chars). */
+    pin?: string;
+    /** @deprecated Use `pin` instead. */
+    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;
+    savingsBalance: number;
+}
+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;
+}
+interface SentinelAgent {
+    id: string;
+    objectId: string;
+    name: string;
+    model: string;
+    systemPrompt: string;
+    attackFee: bigint;
+    prizePool: bigint;
+    totalAttacks: number;
+    successfulBreaches: number;
+    state: string;
+}
+interface SentinelVerdict {
+    success: boolean;
+    score: number;
+    agentResponse: string;
+    juryResponse: string;
+    funResponse: string;
+    signature: string;
+    timestampMs: number;
+}
+interface SentinelAttackResult {
+    attackObjectId: string;
+    sentinelId: string;
+    prompt: string;
+    verdict: SentinelVerdict;
+    requestTx: string;
+    settleTx: string;
+    won: boolean;
+    feePaid: number;
+}
+
+declare class ProtocolRegistry {
+    private lending;
+    private swap;
+    registerLending(adapter: LendingAdapter): void;
+    registerSwap(adapter: SwapAdapter): void;
+    bestSaveRate(asset: string): Promise<{
+        adapter: LendingAdapter;
+        rate: LendingRates;
+    }>;
+    bestBorrowRate(asset: string, opts?: {
+        requireSameAssetBorrow?: boolean;
+    }): Promise<{
+        adapter: LendingAdapter;
+        rate: LendingRates;
+    }>;
+    bestSwapQuote(from: string, to: string, amount: number): Promise<{
+        adapter: SwapAdapter;
+        quote: SwapQuote;
+    }>;
+    allRates(asset: string): Promise<Array<{
+        protocol: string;
+        protocolId: string;
+        rates: LendingRates;
+    }>>;
+    allPositions(address: string): Promise<Array<{
+        protocol: string;
+        protocolId: string;
+        positions: AdapterPositions;
+    }>>;
+    getLending(id: string): LendingAdapter | undefined;
+    getSwap(id: string): SwapAdapter | undefined;
+    listLending(): LendingAdapter[];
+    listSwap(): SwapAdapter[];
+}
+
+declare class NaviAdapter implements LendingAdapter {
+    readonly id = "navi";
+    readonly name = "NAVI Protocol";
+    readonly version = "1.0.0";
+    readonly capabilities: readonly AdapterCapability[];
+    readonly supportedAssets: readonly string[];
+    readonly supportsSameAssetBorrow = true;
+    private client;
+    init(client: SuiClient): Promise<void>;
+    initSync(client: SuiClient): void;
+    getRates(asset: string): Promise<LendingRates>;
+    getPositions(address: string): Promise<AdapterPositions>;
+    getHealth(address: string): Promise<HealthInfo>;
+    buildSaveTx(address: string, amount: number, _asset: string, options?: {
+        collectFee?: boolean;
+    }): Promise<AdapterTxResult>;
+    buildWithdrawTx(address: string, amount: number, _asset: string): Promise<AdapterTxResult & {
+        effectiveAmount: number;
+    }>;
+    buildBorrowTx(address: string, amount: number, _asset: string, options?: {
+        collectFee?: boolean;
+    }): Promise<AdapterTxResult>;
+    buildRepayTx(address: string, amount: number, _asset: string): Promise<AdapterTxResult>;
+    maxWithdraw(address: string, _asset: string): Promise<MaxWithdrawResult>;
+    maxBorrow(address: string, _asset: string): Promise<MaxBorrowResult>;
+}
+
+declare class CetusAdapter implements SwapAdapter {
+    readonly id = "cetus";
+    readonly name = "Cetus";
+    readonly version = "1.0.0";
+    readonly capabilities: readonly AdapterCapability[];
+    private client;
+    init(client: SuiClient): Promise<void>;
+    initSync(client: SuiClient): void;
+    getQuote(from: string, to: string, amount: number): Promise<SwapQuote>;
+    buildSwapTx(address: string, from: string, to: string, amount: number, maxSlippageBps?: number): Promise<AdapterTxResult & {
+        estimatedOut: number;
+        toDecimals: number;
+    }>;
+    getSupportedPairs(): Array<{
+        from: string;
+        to: string;
+    }>;
+    getPoolPrice(): Promise<number>;
+}
+
+/**
+ * Suilend adapter — save + withdraw for USDC.
+ * Borrow/repay deferred to Phase 10 (requires multi-stable support).
+ *
+ * Uses the @suilend/sdk package (optional peer dependency). Users must
+ * install it separately: `npm install @suilend/sdk@^1`
+ *
+ * @see https://docs.suilend.fi/ecosystem/suilend-sdk-guide
+ */
+declare class SuilendAdapter implements LendingAdapter {
+    readonly id = "suilend";
+    readonly name = "Suilend";
+    readonly version = "1.0.0";
+    readonly capabilities: readonly AdapterCapability[];
+    readonly supportedAssets: readonly string[];
+    readonly supportsSameAssetBorrow = false;
+    private client;
+    private suilend;
+    private lendingMarketType;
+    private initialized;
+    init(client: SuiClient): Promise<void>;
+    private ensureInit;
+    private findReserve;
+    private getObligationCaps;
+    private resolveSymbol;
+    getRates(asset: string): Promise<LendingRates>;
+    getPositions(address: string): Promise<AdapterPositions>;
+    getHealth(address: string): Promise<HealthInfo>;
+    buildSaveTx(address: string, amount: number, _asset: string, options?: {
+        collectFee?: boolean;
+    }): Promise<AdapterTxResult>;
+    buildWithdrawTx(address: string, amount: number, _asset: string): Promise<AdapterTxResult & {
+        effectiveAmount: number;
+    }>;
+    buildBorrowTx(_address: string, _amount: number, _asset: string, _options?: {
+        collectFee?: boolean;
+    }): Promise<AdapterTxResult>;
+    buildRepayTx(_address: string, _amount: number, _asset: string): Promise<AdapterTxResult>;
+    maxWithdraw(address: string, _asset: string): Promise<{
+        maxAmount: number;
+        healthFactorAfter: number;
+        currentHF: number;
+    }>;
+    maxBorrow(_address: string, _asset: string): Promise<{
+        maxAmount: number;
+        healthFactorAfter: number;
+        currentHF: number;
+    }>;
+    private fetchAllCoins;
+}
+
+export { type AdapterCapability as A, type BalanceResponse as B, CetusAdapter as C, type DepositInfo as D, type EarningsResult as E, type FundStatusResult as F, type GasMethod as G, type HealthFactorResult as H, type LendingAdapter as L, type MaxWithdrawResult as M, NaviAdapter as N, type PositionsResult as P, type RepayResult as R, type SendResult as S, type T2000Options as T, type WithdrawResult as W, type TransactionRecord as a, type SwapAdapter as b, type SaveResult as c, type BorrowResult as d, type MaxBorrowResult as e, type SwapResult as f, type RatesResult as g, type LendingRates as h, type SentinelAgent as i, type SentinelAttackResult as j, type SentinelVerdict as k, type AdapterPositions as l, type AdapterTxResult as m, type GasReserve as n, type HealthInfo as o, type PositionEntry as p, ProtocolRegistry as q, SuilendAdapter as r, type SwapQuote as s };