@t2000/sdk 0.21.14 → 0.21.16

package/dist/token-registry-CVba8FI2.d.ts

@@ -0,0 +1,341 @@
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
+import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { G as GasMethod } from './types-XWEUAS-X.js';
+
+/**
+ * Abstract signing interface that decouples the SDK from any specific
+ * key management strategy (Ed25519 keypair, zkLogin, multisig, …).
+ */
+interface TransactionSigner {
+    getAddress(): string;
+    signTransaction(txBytes: Uint8Array): Promise<{
+        signature: string;
+    }>;
+}
+
+declare class KeypairSigner implements TransactionSigner {
+    private readonly keypair;
+    constructor(keypair: Ed25519Keypair);
+    getAddress(): string;
+    signTransaction(txBytes: Uint8Array): Promise<{
+        signature: string;
+    }>;
+    /** Access the underlying keypair for APIs that still require it directly. */
+    getKeypair(): Ed25519Keypair;
+}
+
+interface ZkLoginProof {
+    proofPoints: {
+        a: string[];
+        b: string[][];
+        c: string[];
+    };
+    issBase64Details: {
+        indexMod4: number;
+        value: string;
+    };
+    headerBase64: string;
+    addressSeed: string;
+}
+declare class ZkLoginSigner implements TransactionSigner {
+    private readonly ephemeralKeypair;
+    private readonly zkProof;
+    private readonly userAddress;
+    private readonly maxEpoch;
+    constructor(ephemeralKeypair: Ed25519Keypair, zkProof: ZkLoginProof, userAddress: string, maxEpoch: number);
+    getAddress(): string;
+    signTransaction(txBytes: Uint8Array): Promise<{
+        signature: string;
+    }>;
+    isExpired(currentEpoch: number): boolean;
+}
+
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'SPONSOR_FAILED' | 'SPONSOR_RATE_LIMITED' | 'USDC_SPONSOR_FAILED' | 'USDC_SPONSOR_RATE_LIMITED' | 'GAS_STATION_UNAVAILABLE' | 'GAS_FEE_EXCEEDED' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'HEALTH_FACTOR_TOO_LOW' | 'WITHDRAW_WOULD_LIQUIDATE' | 'WITHDRAW_FAILED' | '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' | 'CONTACT_NOT_FOUND' | 'INVALID_CONTACT_NAME' | 'FACILITATOR_TIMEOUT' | 'SAFEGUARD_BLOCKED' | 'SWAP_NO_ROUTE' | 'SWAP_FAILED' | '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 SafeguardConfig {
+    locked: boolean;
+    maxPerTx: number;
+    maxDailySend: number;
+    dailyUsed: number;
+    dailyResetDate: string;
+    maxLeverage?: number;
+    maxPositionSize?: number;
+}
+interface TxMetadata {
+    operation: 'send' | 'save' | 'withdraw' | 'borrow' | 'repay' | 'pay';
+    amount?: number;
+}
+declare const OUTBOUND_OPS: Set<"save" | "borrow" | "send" | "withdraw" | "repay" | "pay">;
+declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
+
+declare class SafeguardEnforcer {
+    private config;
+    private readonly configPath;
+    constructor(configDir?: string);
+    load(): void;
+    assertNotLocked(): void;
+    check(metadata: TxMetadata): void;
+    recordUsage(amount: number): void;
+    lock(): void;
+    unlock(): void;
+    set(key: string, value: unknown): void;
+    getConfig(): SafeguardConfig;
+    isConfigured(): boolean;
+    private resetDailyIfNewDay;
+    private save;
+}
+
+interface GasExecutionResult {
+    digest: string;
+    effects: unknown;
+    balanceChanges?: unknown[];
+    gasMethod: GasMethod;
+    gasCostSui: number;
+    /** Pre-TX SUI balance in MIST — used internally for proactive gas maintenance. */
+    preTxSuiMist?: bigint;
+}
+/**
+ * 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
+ *
+ * After every successful transaction, proactively tops up SUI if it
+ * dropped below threshold — so the user never hits a "no gas" wall.
+ */
+declare function executeWithGas(client: SuiJsonRpcClient, signer: TransactionSigner, buildTx: () => Transaction | Promise<Transaction>, options?: {
+    metadata?: TxMetadata;
+    enforcer?: SafeguardEnforcer;
+}): Promise<GasExecutionResult>;
+
+interface AutoTopUpResult {
+    success: boolean;
+    tx: string;
+    usdcSpent: number;
+    suiReceived: number;
+}
+declare function shouldAutoTopUp(client: SuiJsonRpcClient, address: string): Promise<boolean>;
+declare function executeAutoTopUp(_client: SuiJsonRpcClient, _signer: TransactionSigner): 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>;
+
+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 displayName: "USDC";
+    };
+    readonly USDT: {
+        readonly type: "0x375f70cf2ae4c00bf37117d0c85a2c71545e6ee05c4a5c7d282cd66a4504b068::usdt::USDT";
+        readonly decimals: 6;
+        readonly symbol: "USDT";
+        readonly displayName: "suiUSDT";
+    };
+    readonly USDe: {
+        readonly type: "0x41d587e5336f1c86cad50d38a7136db99333bb9bda91cea4ba69115defeb1402::sui_usde::SUI_USDE";
+        readonly decimals: 6;
+        readonly symbol: "USDe";
+        readonly displayName: "suiUSDe";
+    };
+    readonly USDsui: {
+        readonly type: "0x44f838219cf67b058f3b37907b655f226153c18e33dfcd0da559a844fea9b1c1::usdsui::USDSUI";
+        readonly decimals: 6;
+        readonly symbol: "USDsui";
+        readonly displayName: "USDsui";
+    };
+    readonly SUI: {
+        readonly type: "0x2::sui::SUI";
+        readonly decimals: 9;
+        readonly symbol: "SUI";
+        readonly displayName: "SUI";
+    };
+    readonly WAL: {
+        readonly type: "0x356a26eb9e012a68958082340d4c4116e7f55615cf27affcff209cf0ae544f59::wal::WAL";
+        readonly decimals: 9;
+        readonly symbol: "WAL";
+        readonly displayName: "WAL";
+    };
+    readonly ETH: {
+        readonly type: "0xd0e89b2af5e4910726fbcd8b8dd37bb79b29e5f83f7491bca830e94f7f226d29::eth::ETH";
+        readonly decimals: 8;
+        readonly symbol: "ETH";
+        readonly displayName: "suiETH";
+    };
+    readonly NAVX: {
+        readonly type: "0xa99b8952d4f7d947ea77fe0ecdcc9e5fc0bcab2841d6e2a5aa00c3044e5544b5::navx::NAVX";
+        readonly decimals: 9;
+        readonly symbol: "NAVX";
+        readonly displayName: "NAVX";
+    };
+    readonly GOLD: {
+        readonly type: "0x9d297676e7a4b771ab023291377b2adfaa4938fb9080b8d12430e4b108b836a9::xaum::XAUM";
+        readonly decimals: 6;
+        readonly symbol: "GOLD";
+        readonly displayName: "XAUM";
+    };
+};
+type SupportedAsset = keyof typeof SUPPORTED_ASSETS;
+type StableAsset = 'USDC' | 'USDT' | 'USDe' | 'USDsui';
+declare const STABLE_ASSETS: readonly StableAsset[];
+declare const ALL_NAVI_ASSETS: readonly SupportedAsset[];
+declare const DEFAULT_NETWORK: "mainnet";
+declare const CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
+declare const GAS_RESERVE_MIN = 0.05;
+
+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 stableToRaw(amount: number, decimals: number): bigint;
+declare function rawToStable(raw: bigint, decimals: number): number;
+declare function getDecimals(asset: SupportedAsset): number;
+declare function formatUsd(amount: number): string;
+declare function formatSui(amount: number): string;
+declare function formatAssetAmount(amount: number, asset: string): string;
+
+interface SimulationResult {
+    success: boolean;
+    gasEstimateSui: number;
+    error?: {
+        moveAbortCode?: number;
+        moveModule?: string;
+        reason: string;
+        rawError: string;
+    };
+}
+declare function simulateTransaction(client: SuiJsonRpcClient, tx: Transaction, sender: string): Promise<SimulationResult>;
+declare function throwIfSimulationFailed(sim: SimulationResult): void;
+
+type FeeOperation = 'save' | 'borrow';
+interface ProtocolFeeInfo {
+    amount: number;
+    asset: string;
+    rate: number;
+    rawAmount: bigint;
+}
+declare function calculateFee(operation: FeeOperation, amount: number): ProtocolFeeInfo;
+/**
+ * Add on-chain fee collection to an existing PTB via t2000::treasury::collect_fee().
+ * The Move function splits the fee from the payment coin and stores it in the
+ * Treasury's internal Balance<T>. Atomic — reverts with the operation if it fails.
+ */
+declare function addCollectFeeToTx(tx: Transaction, paymentCoin: TransactionObjectArgument, operation: FeeOperation): void;
+
+type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
+interface SafeguardErrorDetails {
+    attempted?: number;
+    limit?: number;
+    current?: number;
+}
+declare class SafeguardError extends T2000Error {
+    readonly rule: SafeguardRule;
+    readonly details: SafeguardErrorDetails;
+    constructor(rule: SafeguardRule, details: SafeguardErrorDetails, message?: string);
+    toJSON(): {
+        error: "SAFEGUARD_BLOCKED";
+        message: string;
+        retryable: boolean;
+        data: {
+            attempted?: number;
+            limit?: number;
+            current?: number;
+            rule: SafeguardRule;
+        };
+    };
+}
+
+/**
+ * Unified token registry — single source of truth for coin types, decimals, and symbols.
+ *
+ * ZERO heavy dependencies. Safe to import from any context (server, browser, Edge).
+ * All other token maps (KNOWN_COINS, DEC_MAP, TOKEN_DECIMALS, etc.) should be replaced
+ * with imports from this file.
+ *
+ * To add a new token: add ONE entry to COIN_REGISTRY below. Everything else derives from it.
+ */
+interface CoinMeta {
+    type: string;
+    decimals: number;
+    symbol: string;
+}
+/**
+ * Canonical coin registry. Merges NAVI lending assets + swap-supported tokens.
+ * Key = user-friendly name (used in swap_execute, CLI, prompts).
+ */
+declare const COIN_REGISTRY: Record<string, CoinMeta>;
+/**
+ * Get decimals for any coin type. Checks full type match, then suffix match, then defaults to 9.
+ * Handles address normalization differences (leading zeros, casing).
+ */
+declare function getDecimalsForCoinType(coinType: string): number;
+/**
+ * Resolve a full coin type to a user-friendly symbol.
+ * Returns the last `::` segment if not in the registry.
+ */
+declare function resolveSymbol(coinType: string): string;
+/**
+ * Name → type map for swap resolution. Derived from COIN_REGISTRY.
+ * Contains BOTH original-case and UPPERCASE keys for case-insensitive lookup.
+ * Backward-compatible with the original TOKEN_MAP in cetus-swap.ts.
+ */
+declare const TOKEN_MAP: Record<string, string>;
+/**
+ * Resolve a user-friendly token name to its full coin type.
+ * Returns the input unchanged if already a full coin type (contains "::").
+ * Case-insensitive: 'usde', 'USDe', 'USDE' all resolve correctly.
+ */
+declare function resolveTokenType(nameOrType: string): string | null;
+/** Common type constants for direct import (avoid hardcoding strings). */
+declare const SUI_TYPE: string;
+declare const USDC_TYPE: string;
+declare const USDT_TYPE: string;
+declare const USDSUI_TYPE: string;
+declare const USDE_TYPE: string;
+declare const ETH_TYPE: string;
+declare const WBTC_TYPE: string;
+declare const WAL_TYPE: string;
+declare const NAVX_TYPE: string;
+
+export { getDecimals as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, USDT_TYPE as H, WBTC_TYPE as I, ZkLoginSigner as J, KeypairSigner as K, addCollectFeeToTx as L, MIST_PER_SUI as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, calculateFee as Q, executeAutoTopUp as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, executeWithGas as V, WAL_TYPE as W, formatAssetAmount as X, formatSui as Y, type ZkLoginProof as Z, formatUsd as _, type AutoTopUpResult as a, getDecimalsForCoinType as a0, getGasStatus as a1, mapMoveAbortCode as a2, mapWalletError as a3, mistToSui as a4, rawToStable as a5, rawToUsdc as a6, resolveSymbol as a7, resolveTokenType as a8, shouldAutoTopUp as a9, stableToRaw as aa, suiToMist as ab, truncateAddress as ac, usdcToRaw as ad, validateAddress as ae, SafeguardEnforcer as af, CETUS_USDC_SUI_POOL as ag, simulateTransaction as ah, throwIfSimulationFailed as ai, COIN_REGISTRY as b, type CoinMeta as c, DEFAULT_SAFEGUARD_CONFIG as d, type GasExecutionResult as e, type GasRequestType as f, type GasSponsorResponse as g, type GasStatusResponse as h, SUI_DECIMALS as i, SUI_TYPE as j, SUPPORTED_ASSETS as k, type SafeguardConfig as l, SafeguardError as m, type SafeguardErrorDetails as n, type SafeguardRule as o, type SimulationResult as p, type StableAsset as q, type SupportedAsset as r, type T2000ErrorCode as s, type T2000ErrorData as t, TOKEN_MAP as u, type TransactionSigner as v, type TxMetadata as w, USDC_TYPE as x, USDE_TYPE as y, USDSUI_TYPE as z };

package/dist/token-registry-DIl3H4Jh.d.cts

@@ -0,0 +1,341 @@
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
+import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { G as GasMethod } from './types-XWEUAS-X.cjs';
+
+/**
+ * Abstract signing interface that decouples the SDK from any specific
+ * key management strategy (Ed25519 keypair, zkLogin, multisig, …).
+ */
+interface TransactionSigner {
+    getAddress(): string;
+    signTransaction(txBytes: Uint8Array): Promise<{
+        signature: string;
+    }>;
+}
+
+declare class KeypairSigner implements TransactionSigner {
+    private readonly keypair;
+    constructor(keypair: Ed25519Keypair);
+    getAddress(): string;
+    signTransaction(txBytes: Uint8Array): Promise<{
+        signature: string;
+    }>;
+    /** Access the underlying keypair for APIs that still require it directly. */
+    getKeypair(): Ed25519Keypair;
+}
+
+interface ZkLoginProof {
+    proofPoints: {
+        a: string[];
+        b: string[][];
+        c: string[];
+    };
+    issBase64Details: {
+        indexMod4: number;
+        value: string;
+    };
+    headerBase64: string;
+    addressSeed: string;
+}
+declare class ZkLoginSigner implements TransactionSigner {
+    private readonly ephemeralKeypair;
+    private readonly zkProof;
+    private readonly userAddress;
+    private readonly maxEpoch;
+    constructor(ephemeralKeypair: Ed25519Keypair, zkProof: ZkLoginProof, userAddress: string, maxEpoch: number);
+    getAddress(): string;
+    signTransaction(txBytes: Uint8Array): Promise<{
+        signature: string;
+    }>;
+    isExpired(currentEpoch: number): boolean;
+}
+
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'SPONSOR_FAILED' | 'SPONSOR_RATE_LIMITED' | 'USDC_SPONSOR_FAILED' | 'USDC_SPONSOR_RATE_LIMITED' | 'GAS_STATION_UNAVAILABLE' | 'GAS_FEE_EXCEEDED' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'HEALTH_FACTOR_TOO_LOW' | 'WITHDRAW_WOULD_LIQUIDATE' | 'WITHDRAW_FAILED' | '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' | 'CONTACT_NOT_FOUND' | 'INVALID_CONTACT_NAME' | 'FACILITATOR_TIMEOUT' | 'SAFEGUARD_BLOCKED' | 'SWAP_NO_ROUTE' | 'SWAP_FAILED' | '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 SafeguardConfig {
+    locked: boolean;
+    maxPerTx: number;
+    maxDailySend: number;
+    dailyUsed: number;
+    dailyResetDate: string;
+    maxLeverage?: number;
+    maxPositionSize?: number;
+}
+interface TxMetadata {
+    operation: 'send' | 'save' | 'withdraw' | 'borrow' | 'repay' | 'pay';
+    amount?: number;
+}
+declare const OUTBOUND_OPS: Set<"save" | "borrow" | "send" | "withdraw" | "repay" | "pay">;
+declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
+
+declare class SafeguardEnforcer {
+    private config;
+    private readonly configPath;
+    constructor(configDir?: string);
+    load(): void;
+    assertNotLocked(): void;
+    check(metadata: TxMetadata): void;
+    recordUsage(amount: number): void;
+    lock(): void;
+    unlock(): void;
+    set(key: string, value: unknown): void;
+    getConfig(): SafeguardConfig;
+    isConfigured(): boolean;
+    private resetDailyIfNewDay;
+    private save;
+}
+
+interface GasExecutionResult {
+    digest: string;
+    effects: unknown;
+    balanceChanges?: unknown[];
+    gasMethod: GasMethod;
+    gasCostSui: number;
+    /** Pre-TX SUI balance in MIST — used internally for proactive gas maintenance. */
+    preTxSuiMist?: bigint;
+}
+/**
+ * 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
+ *
+ * After every successful transaction, proactively tops up SUI if it
+ * dropped below threshold — so the user never hits a "no gas" wall.
+ */
+declare function executeWithGas(client: SuiJsonRpcClient, signer: TransactionSigner, buildTx: () => Transaction | Promise<Transaction>, options?: {
+    metadata?: TxMetadata;
+    enforcer?: SafeguardEnforcer;
+}): Promise<GasExecutionResult>;
+
+interface AutoTopUpResult {
+    success: boolean;
+    tx: string;
+    usdcSpent: number;
+    suiReceived: number;
+}
+declare function shouldAutoTopUp(client: SuiJsonRpcClient, address: string): Promise<boolean>;
+declare function executeAutoTopUp(_client: SuiJsonRpcClient, _signer: TransactionSigner): 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>;
+
+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 displayName: "USDC";
+    };
+    readonly USDT: {
+        readonly type: "0x375f70cf2ae4c00bf37117d0c85a2c71545e6ee05c4a5c7d282cd66a4504b068::usdt::USDT";
+        readonly decimals: 6;
+        readonly symbol: "USDT";
+        readonly displayName: "suiUSDT";
+    };
+    readonly USDe: {
+        readonly type: "0x41d587e5336f1c86cad50d38a7136db99333bb9bda91cea4ba69115defeb1402::sui_usde::SUI_USDE";
+        readonly decimals: 6;
+        readonly symbol: "USDe";
+        readonly displayName: "suiUSDe";
+    };
+    readonly USDsui: {
+        readonly type: "0x44f838219cf67b058f3b37907b655f226153c18e33dfcd0da559a844fea9b1c1::usdsui::USDSUI";
+        readonly decimals: 6;
+        readonly symbol: "USDsui";
+        readonly displayName: "USDsui";
+    };
+    readonly SUI: {
+        readonly type: "0x2::sui::SUI";
+        readonly decimals: 9;
+        readonly symbol: "SUI";
+        readonly displayName: "SUI";
+    };
+    readonly WAL: {
+        readonly type: "0x356a26eb9e012a68958082340d4c4116e7f55615cf27affcff209cf0ae544f59::wal::WAL";
+        readonly decimals: 9;
+        readonly symbol: "WAL";
+        readonly displayName: "WAL";
+    };
+    readonly ETH: {
+        readonly type: "0xd0e89b2af5e4910726fbcd8b8dd37bb79b29e5f83f7491bca830e94f7f226d29::eth::ETH";
+        readonly decimals: 8;
+        readonly symbol: "ETH";
+        readonly displayName: "suiETH";
+    };
+    readonly NAVX: {
+        readonly type: "0xa99b8952d4f7d947ea77fe0ecdcc9e5fc0bcab2841d6e2a5aa00c3044e5544b5::navx::NAVX";
+        readonly decimals: 9;
+        readonly symbol: "NAVX";
+        readonly displayName: "NAVX";
+    };
+    readonly GOLD: {
+        readonly type: "0x9d297676e7a4b771ab023291377b2adfaa4938fb9080b8d12430e4b108b836a9::xaum::XAUM";
+        readonly decimals: 6;
+        readonly symbol: "GOLD";
+        readonly displayName: "XAUM";
+    };
+};
+type SupportedAsset = keyof typeof SUPPORTED_ASSETS;
+type StableAsset = 'USDC' | 'USDT' | 'USDe' | 'USDsui';
+declare const STABLE_ASSETS: readonly StableAsset[];
+declare const ALL_NAVI_ASSETS: readonly SupportedAsset[];
+declare const DEFAULT_NETWORK: "mainnet";
+declare const CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
+declare const GAS_RESERVE_MIN = 0.05;
+
+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 stableToRaw(amount: number, decimals: number): bigint;
+declare function rawToStable(raw: bigint, decimals: number): number;
+declare function getDecimals(asset: SupportedAsset): number;
+declare function formatUsd(amount: number): string;
+declare function formatSui(amount: number): string;
+declare function formatAssetAmount(amount: number, asset: string): string;
+
+interface SimulationResult {
+    success: boolean;
+    gasEstimateSui: number;
+    error?: {
+        moveAbortCode?: number;
+        moveModule?: string;
+        reason: string;
+        rawError: string;
+    };
+}
+declare function simulateTransaction(client: SuiJsonRpcClient, tx: Transaction, sender: string): Promise<SimulationResult>;
+declare function throwIfSimulationFailed(sim: SimulationResult): void;
+
+type FeeOperation = 'save' | 'borrow';
+interface ProtocolFeeInfo {
+    amount: number;
+    asset: string;
+    rate: number;
+    rawAmount: bigint;
+}
+declare function calculateFee(operation: FeeOperation, amount: number): ProtocolFeeInfo;
+/**
+ * Add on-chain fee collection to an existing PTB via t2000::treasury::collect_fee().
+ * The Move function splits the fee from the payment coin and stores it in the
+ * Treasury's internal Balance<T>. Atomic — reverts with the operation if it fails.
+ */
+declare function addCollectFeeToTx(tx: Transaction, paymentCoin: TransactionObjectArgument, operation: FeeOperation): void;
+
+type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
+interface SafeguardErrorDetails {
+    attempted?: number;
+    limit?: number;
+    current?: number;
+}
+declare class SafeguardError extends T2000Error {
+    readonly rule: SafeguardRule;
+    readonly details: SafeguardErrorDetails;
+    constructor(rule: SafeguardRule, details: SafeguardErrorDetails, message?: string);
+    toJSON(): {
+        error: "SAFEGUARD_BLOCKED";
+        message: string;
+        retryable: boolean;
+        data: {
+            attempted?: number;
+            limit?: number;
+            current?: number;
+            rule: SafeguardRule;
+        };
+    };
+}
+
+/**
+ * Unified token registry — single source of truth for coin types, decimals, and symbols.
+ *
+ * ZERO heavy dependencies. Safe to import from any context (server, browser, Edge).
+ * All other token maps (KNOWN_COINS, DEC_MAP, TOKEN_DECIMALS, etc.) should be replaced
+ * with imports from this file.
+ *
+ * To add a new token: add ONE entry to COIN_REGISTRY below. Everything else derives from it.
+ */
+interface CoinMeta {
+    type: string;
+    decimals: number;
+    symbol: string;
+}
+/**
+ * Canonical coin registry. Merges NAVI lending assets + swap-supported tokens.
+ * Key = user-friendly name (used in swap_execute, CLI, prompts).
+ */
+declare const COIN_REGISTRY: Record<string, CoinMeta>;
+/**
+ * Get decimals for any coin type. Checks full type match, then suffix match, then defaults to 9.
+ * Handles address normalization differences (leading zeros, casing).
+ */
+declare function getDecimalsForCoinType(coinType: string): number;
+/**
+ * Resolve a full coin type to a user-friendly symbol.
+ * Returns the last `::` segment if not in the registry.
+ */
+declare function resolveSymbol(coinType: string): string;
+/**
+ * Name → type map for swap resolution. Derived from COIN_REGISTRY.
+ * Contains BOTH original-case and UPPERCASE keys for case-insensitive lookup.
+ * Backward-compatible with the original TOKEN_MAP in cetus-swap.ts.
+ */
+declare const TOKEN_MAP: Record<string, string>;
+/**
+ * Resolve a user-friendly token name to its full coin type.
+ * Returns the input unchanged if already a full coin type (contains "::").
+ * Case-insensitive: 'usde', 'USDe', 'USDE' all resolve correctly.
+ */
+declare function resolveTokenType(nameOrType: string): string | null;
+/** Common type constants for direct import (avoid hardcoding strings). */
+declare const SUI_TYPE: string;
+declare const USDC_TYPE: string;
+declare const USDT_TYPE: string;
+declare const USDSUI_TYPE: string;
+declare const USDE_TYPE: string;
+declare const ETH_TYPE: string;
+declare const WBTC_TYPE: string;
+declare const WAL_TYPE: string;
+declare const NAVX_TYPE: string;
+
+export { getDecimals as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, USDT_TYPE as H, WBTC_TYPE as I, ZkLoginSigner as J, KeypairSigner as K, addCollectFeeToTx as L, MIST_PER_SUI as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, calculateFee as Q, executeAutoTopUp as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, executeWithGas as V, WAL_TYPE as W, formatAssetAmount as X, formatSui as Y, type ZkLoginProof as Z, formatUsd as _, type AutoTopUpResult as a, getDecimalsForCoinType as a0, getGasStatus as a1, mapMoveAbortCode as a2, mapWalletError as a3, mistToSui as a4, rawToStable as a5, rawToUsdc as a6, resolveSymbol as a7, resolveTokenType as a8, shouldAutoTopUp as a9, stableToRaw as aa, suiToMist as ab, truncateAddress as ac, usdcToRaw as ad, validateAddress as ae, SafeguardEnforcer as af, CETUS_USDC_SUI_POOL as ag, simulateTransaction as ah, throwIfSimulationFailed as ai, COIN_REGISTRY as b, type CoinMeta as c, DEFAULT_SAFEGUARD_CONFIG as d, type GasExecutionResult as e, type GasRequestType as f, type GasSponsorResponse as g, type GasStatusResponse as h, SUI_DECIMALS as i, SUI_TYPE as j, SUPPORTED_ASSETS as k, type SafeguardConfig as l, SafeguardError as m, type SafeguardErrorDetails as n, type SafeguardRule as o, type SimulationResult as p, type StableAsset as q, type SupportedAsset as r, type T2000ErrorCode as s, type T2000ErrorData as t, TOKEN_MAP as u, type TransactionSigner as v, type TxMetadata as w, USDC_TYPE as x, USDE_TYPE as y, USDSUI_TYPE as z };