@t2000/sdk 3.2.0 → 4.0.0

package/dist/index.d.cts

@@ -1,15 +1,16 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-Bh_0d-te.cjs';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, aA as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, aB as SaveableAsset, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aC as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aD as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aE as isAllowedAsset, aF as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aG as normalizeAsset, aH as normalizeCoinType, am as parseSuiRpcTx, aI as queryHistory, aJ as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aK as simulateTransaction, as as stableToRaw, at as suiToMist, aL as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-Bh_0d-te.cjs';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, ax as SendableAsset } from './types-CqpN8a8R.cjs';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ay as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, az as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, aA as GASLESS_MIN_STABLE_AMOUNT, aB as GASLESS_STABLE_TYPES, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, aD as Operation, P as ProtocolFeeInfo, aE as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, aF as SENDABLE_ASSETS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, aG as SaveableAsset, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aH as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, aI as createSuiClient, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aJ as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, aK as getSuiClient, aL as getSuiGrpcClient, af as getTier, aM as isAllowedAsset, aN as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aO as normalizeAsset, aP as normalizeCoinType, am as parseSuiRpcTx, aQ as queryHistory, aR as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aS as simulateTransaction, as as stableToRaw, at as suiToMist, aT as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-CqpN8a8R.cjs';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-DqIb4AnV.cjs';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-DqIb4AnV.cjs';
-import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-Bk7NncQ_.cjs';
-export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-Bk7NncQ_.cjs';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as SwapResult, p as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, q as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, r as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, s as FinancialSummary } from './types-HJGbXJ37.cjs';
+export { A as AssetRates, G as GasReserve, t as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, u as SerializedCetusRoute, v as SerializedCetusRoutePath, w as SerializedRouterDataV3, T as TransactionLeg, x as addSwapToTx, l as buildSwapTx, y as deserializeCetusRoute, m as findSwapRoute, z as isCetusRouteFresh, I as serializeCetusRoute, J as verifyCetusRouteCoinMatch } from './types-HJGbXJ37.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.cjs';
+import '@mysten/sui/grpc';
 import '@cetusprotocol/aggregator-sdk';
 
 declare class SafeguardEnforcer {
@@ -95,8 +96,8 @@ declare class T2000 extends EventEmitter<T2000Events> {
         network?: 'mainnet' | 'testnet';
         rpcUrl?: string;
     }): T2000;
-    static init(options: {
-        pin: string;
+    static init(options?: {
+        pin?: string;
         passphrase?: string;
         keyPath?: string;
         name?: string;
@@ -111,12 +112,6 @@ declare class T2000 extends EventEmitter<T2000Events> {
     /** Transaction signer (works for both keypair and zkLogin). */
     get signer(): TransactionSigner;
     pay(options: PayOptions): Promise<PayResult>;
-    stakeVSui(params: {
-        amount: number;
-    }): Promise<StakeVSuiResult>;
-    unstakeVSui(params: {
-        amount: number | 'all';
-    }): Promise<UnstakeVSuiResult>;
     swap(params: {
         from: string;
         to: string;
@@ -140,10 +135,31 @@ declare class T2000 extends EventEmitter<T2000Events> {
         providers?: string[];
     }): Promise<SwapQuoteResult>;
     address(): string;
+    /**
+     * Send `amount` of `asset` to `to` (hex address, SuiNS name, or
+     * `@audric` handle / saved contact).
+     *
+     * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+     *
+     * **Breaking changes from v3.x:**
+     * - `asset` is now REQUIRED (no implicit `?? 'USDC'` default). Callers
+     *   must specify `'USDC' | 'USDsui' | 'SUI'`. Sending `'USDT'` /
+     *   `'USDe'` / `'WAL'` / `'ETH'` / `'NAVX'` / `'GOLD'` now errors
+     *   with `INVALID_ASSET` — swap to a stable first.
+     * - USDC + USDsui builds go through `SuiGrpcClient` so the gRPC build
+     *   resolver auto-detects `0x2::balance::send_funds` eligibility and
+     *   zeros gas at simulate time. Result: **gasless USDC / USDsui sends
+     *   from a zero-SUI wallet.** SUI sends stay on the standard gas-paid
+     *   path.
+     *
+     * Submission stays on the JSON-RPC client (the rest of the SDK
+     * expects JSON-RPC for read paths, and Sui's docs explicitly support
+     * the "build via gRPC, execute via JSON-RPC" hybrid).
+     */
     send(params: {
         to: string;
         amount: number;
-        asset?: string;
+        asset: SupportedAsset;
     }): Promise<SendResult>;
     /**
      * [S.279 / CLI-CONTACTS-CLEANUP — 2026-05-23] Resolve a recipient
@@ -183,11 +199,12 @@ declare class T2000 extends EventEmitter<T2000Events> {
     transactionDetail(digest: string): Promise<TransactionRecord | null>;
     deposit(): Promise<DepositInfo>;
     /**
-     * [SPEC_AGENTIC_STACK P1 / SDK F2 (CLI rename support) — 2026-05-25]
-     * Preferred alias of `deposit()`. The CLI surface is `t2000 fund` post-Phase 1
-     * (more intuitive than "deposit" which sounds like a NAVI lending action).
-     * `deposit()` stays as the canonical method name for back-compat; it is NOT
-     * deprecated. This wrapper exists so SDK consumers can mirror CLI naming.
+     * [SPEC_AGENTIC_STACK P1 / SDK F2 — 2026-05-25; refreshed S.342 / 2026-05-26]
+     * Preferred alias of `deposit()`. Was introduced to mirror the v3 `t2000 fund`
+     * CLI command; the v4 CLI surface is `t2 receive` (deleted `fund` in the
+     * S.332 bulk cut). `deposit()` stays as the canonical method name for
+     * back-compat; `fund()` stays as a programmatic alias for audric + other
+     * SDK consumers that prefer the verb.
      */
     fund(): Promise<DepositInfo>;
     receive(params?: {
@@ -383,18 +400,70 @@ declare function normalizeAddressInput(value: string, ctx?: {
 
 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>;
+/**
+ * Save a keypair as a v2 plain Bech32 JSON file with `0o600` perms.
+ *
+ * `_passphrase` is accepted but IGNORED — kept in the signature for
+ * back-compat with v3.x callers. Will be removed when all callers
+ * are off PIN (Phase A Day 5+).
+ */
+declare function saveKey(keypair: Ed25519Keypair, _passphrase: string | undefined, keyPath?: string): Promise<string>;
+/**
+ * Save a Bech32 secret directly as a v2 plain wallet file. Used by any
+ * path where the secret is supplied externally rather than freshly
+ * generated. Kept exported because external tooling may still want it
+ * even though the CLI no longer ships an `--import` flag.
+ */
+declare function saveBech32(secret: string, keyPath?: string): Promise<string>;
+/**
+ * Load a keypair from disk.
+ *
+ * `_passphrase` is accepted but IGNORED — kept for back-compat. The
+ * actual file format determines the load path:
+ *
+ * - **v2 plain JSON** (`{ version: 2, secret: "suiprivkey1..." }`) →
+ *   decode + return keypair.
+ * - **Anything else** → throw `WALLET_CORRUPT`. The user moves or
+ *   deletes the file and runs `t2 init` to create a fresh wallet.
+ */
+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;
 
+/**
+ * Build a PTB that sends `amount` of `asset` from `address` to `to`.
+ *
+ * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+ *
+ * Asset constraint: `'USDC' | 'USDsui' | 'SUI'` only. Other assets throw
+ * `INVALID_ASSET` via `assertAllowedAsset('send', asset)`. The constrained
+ * set matches Sui mainnet's gasless allowlist (USDC + USDsui) plus SUI
+ * for users who want a gas-native transfer.
+ *
+ * Build paths:
+ * - **USDC / USDsui** — `0x2::balance::send_funds` Move call with a
+ *   `tx.balance({ type, balance })` input. When built via `SuiGrpcClient`,
+ *   the gRPC resolver auto-detects gasless eligibility and zeros gas.
+ *   When built via `SuiJsonRpcClient`, the same PTB still executes but
+ *   the caller pays normal gas. Minimum 0.01 (protocol allowlist floor).
+ * - **SUI** — `tx.splitCoins(tx.gas, [amount]) → tx.transferObjects()`.
+ *   Standard gas-native transfer. No minimum.
+ *
+ * Pre-flight balance check stays on JSON-RPC (`client.getBalance`) — it
+ * sums coin objects + address balance so the legacy `getCoins` page miss
+ * doesn't break for users whose stables landed via gasless deposits.
+ *
+ * `asset` is REQUIRED (no implicit USDC default — pre-v4 hid LLM intent
+ * errors). Callers passing the wrong asset get an explicit error rather
+ * than a silent currency substitution.
+ */
 declare function buildSendTx({ client, address, to, amount, asset, }: {
     client: SuiJsonRpcClient;
     address: string;
     to: string;
     amount: number;
-    asset?: SupportedAsset;
+    asset: SendableAsset;
 }): Promise<Transaction>;
 /**
  * Fragment-appender for the chain-mode send leg of SPEC 7 multi-write
@@ -414,6 +483,13 @@ declare function buildSendTx({ client, address, to, amount, asset, }: {
  * `buildSendTx` directly — it builds a complete tx including the
  * wallet-coin selection / merge / split prelude.
  *
+ * [v4.0 Phase A Day 2] Stays on the legacy `transferObjects` path
+ * because chain-mode bundles are NEVER gasless — by definition they
+ * combine multiple Move calls (`withdraw → send`, `swap → send`) which
+ * fail the protocol allowlist check (only `balance::send_funds` and
+ * a few related helpers are eligible). The bundled flow still works,
+ * the user just pays gas (or has it sponsored by audric via Enoki).
+ *
  * @returns void — the coin is consumed by `tx.transferObjects`. Callers
  *   that need the post-transfer "effective amount" should rely on the
  *   upstream appender's `effectiveAmount` (e.g. `addWithdrawToTx`'s
@@ -583,13 +659,18 @@ declare function selectSuiCoin(tx: Transaction, client: SuiJsonRpcClient, owner:
  */
 
 /**
- * Canonical write tools. The 10 tools that can be composed into a PTB
- * (Track B 2026-05-08 added `harvest_rewards`).
+ * Canonical write tools. The 8 tools that can be composed into a PTB.
+ *
+ * History:
+ * - 2026-05-08 (Track B): added `harvest_rewards` (compound macro).
+ * - 2026-05-25 (S.323): removed `volo_stake` / `volo_unstake` — full Volo
+ *   cut across SDK/CLI/MCP after the engine cut Volo in S.277. vSUI
+ *   remains as a passive token (NAVI reward, Cetus swap target).
  *
  * Excluded by design:
  * - `save_contact` — no on-chain leg (Prisma-only).
  */
-type WriteToolName = 'save_deposit' | 'withdraw' | 'borrow' | 'repay_debt' | 'send_transfer' | 'swap_execute' | 'claim_rewards' | 'harvest_rewards' | 'volo_stake' | 'volo_unstake';
+type WriteToolName = 'save_deposit' | 'withdraw' | 'borrow' | 'repay_debt' | 'send_transfer' | 'swap_execute' | 'claim_rewards' | 'harvest_rewards';
 interface SaveDepositInput {
     amount: number;
     asset?: 'USDC' | 'USDsui';
@@ -606,10 +687,29 @@ interface RepayDebtInput {
     amount: number;
     asset?: 'USDC' | 'USDsui';
 }
+/**
+ * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+ * `asset` is now REQUIRED (no more silent USDC default). The parameter
+ * type is the wider `SupportedAsset` rather than the narrower
+ * `SendableAsset` so callers that thread a wide-typed asset through
+ * (primarily the engine LLM tool surface) compile without modification.
+ * Runtime narrowing happens via `assertAllowedAsset('send', asset)`,
+ * which throws `INVALID_ASSET` for anything outside the
+ * `['USDC', 'USDsui', 'SUI']` whitelist. USDC + USDsui route through
+ * the gasless `0x2::balance::send_funds` Move call; SUI uses the
+ * standard `transferObjects` path.
+ *
+ * Audric hosts: the audric chat client (`audric-chat-client.tsx`)
+ * already defaults asset to `'USDC'` at the marker layer before
+ * calling `sponsoredTx({ type: 'send' })`, so this signature change
+ * doesn't break the LLM flow. LLM intents like "send 5 WAL" now
+ * surface a clear error instead of silently building a non-gasless
+ * tx.
+ */
 interface SendTransferInput {
     to: string;
     amount: number;
-    asset?: SupportedAsset;
+    asset: SupportedAsset;
 }
 interface SwapExecuteInput {
     from: string;
@@ -644,12 +744,6 @@ interface HarvestRewardsInput {
     /** USD floor for "is this worth swapping?" — dust below transfers to wallet. Default $0.01. */
     minRewardUsd?: number;
 }
-interface VoloStakeInput {
-    amountSui: number;
-}
-interface VoloUnstakeInput {
-    amountVSui: number | 'all';
-}
 /**
  * Discriminated union mapping `toolName` → `input`. Used to type
  * `WriteStep` so consumers get autocomplete + compile-time validation
@@ -695,14 +789,6 @@ type WriteStep = {
 } | {
     toolName: 'harvest_rewards';
     input: HarvestRewardsInput;
-} | {
-    toolName: 'volo_stake';
-    input: VoloStakeInput;
-    inputCoinFromStep?: number;
-} | {
-    toolName: 'volo_unstake';
-    input: VoloUnstakeInput;
-    inputCoinFromStep?: number;
 };
 interface ComposeTxOptions {
     sender: string;
@@ -805,7 +891,7 @@ type StepPreview = {
     toolName: 'send_transfer';
     effectiveAmount: number;
     recipient: string;
-    asset: SupportedAsset;
+    asset: SendableAsset;
 } | {
     toolName: 'swap_execute';
     effectiveAmountIn: number;
@@ -831,12 +917,6 @@ type StepPreview = {
         reason: 'untradeable' | 'dust' | 'no-route';
     }>;
     expectedUsdcDeposited: number;
-} | {
-    toolName: 'volo_stake';
-    effectiveAmountMist: bigint;
-} | {
-    toolName: 'volo_unstake';
-    effectiveAmountMist: bigint | 'all';
 };
 interface ComposeTxResult {
     tx: Transaction;
@@ -898,8 +978,9 @@ interface AppenderContext {
  * downstream consumer's `chainedCoin`. Terminal consumers
  * (`save_deposit`, `repay_debt`, `send_transfer`) omit it.
  *
- * `swap_execute`, `volo_stake`, and `volo_unstake` are dual-mode —
- * they accept `chainedCoin` AND populate `outputCoin`.
+ * `swap_execute` is the only dual-mode tool — it accepts `chainedCoin`
+ * AND populates `outputCoin`. (`volo_stake` / `volo_unstake` were also
+ * dual-mode prior to S.323 / 2026-05-25; cut with the full Volo removal.)
  */
 interface AppenderResult<TPreview extends StepPreview> {
     preview: TPreview;
@@ -932,7 +1013,7 @@ declare function getSponsoredSwapProviders(): Promise<string[]>;
 /**
  * The typed registry. Each entry is a wallet-mode dispatcher that takes
  * (tx, input, ctx) and returns a per-step preview. Compile-time check
- * that all 10 `WriteToolName` values have an entry — TypeScript will
+ * that all 8 `WriteToolName` values have an entry — TypeScript will
  * fail the build if a tool is missing.
  */
 declare const WRITE_APPENDER_REGISTRY: {
@@ -960,12 +1041,6 @@ declare const WRITE_APPENDER_REGISTRY: {
     harvest_rewards: AppenderFn<HarvestRewardsInput, Extract<StepPreview, {
         toolName: 'harvest_rewards';
     }>>;
-    volo_stake: AppenderFn<VoloStakeInput, Extract<StepPreview, {
-        toolName: 'volo_stake';
-    }>>;
-    volo_unstake: AppenderFn<VoloUnstakeInput, Extract<StepPreview, {
-        toolName: 'volo_unstake';
-    }>>;
 };
 /**
  * Walks the assembled PTB's command list and extracts every recipient
@@ -1274,98 +1349,6 @@ declare function getSwapQuote(params: {
     providers?: string[];
 }): Promise<SwapQuoteResult>;
 
-/**
- * VOLO vSUI liquid staking — thin transaction builders.
- * No SDK dependency. Two Move calls, immutable contract addresses.
- */
-
-declare const VOLO_PKG = "0x68d22cf8bdbcd11ecba1e094922873e4080d4d11133e2443fddda0bfd11dae20";
-declare const VOLO_POOL = "0x2d914e23d82fedef1b5f56a32d5c64bdcc3087ccfea2b4d6ea51a71f587840e5";
-declare const VOLO_METADATA = "0x680cd26af32b2bde8d3361e804c53ec1d1cfe24c7f039eb7f549e8dfde389a60";
-declare const VSUI_TYPE = "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT";
-interface VoloStats {
-    apy: number;
-    exchangeRate: number;
-    tvl: number;
-}
-/**
- * Fetch VOLO vSUI staking stats (APY, exchange rate, TVL).
- */
-declare function getVoloStats(): Promise<VoloStats>;
-/**
- * Build a PTB to stake SUI for vSUI.
- */
-declare function buildStakeVSuiTx(_client: SuiJsonRpcClient, address: string, amountMist: bigint): Promise<Transaction>;
-/**
- * Build a PTB to unstake vSUI back to SUI.
- */
-declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, amountMist: bigint | 'all'): Promise<Transaction>;
-/**
- * SPEC 7 § "Layer 1" Volo stake appender. Two modes.
- *
- * Wallet mode (`inputCoin` omitted): pre-flights via `getBalance` and
- * sources SUI through `coinWithBalance({ type: SUI, useGasCoin: false })`,
- * which resolves coin objects + address balance at build time. Mirrors
- * the audric host's `transactions/prepare/route.ts:524-545` volo-stake
- * branch — sponsored-flow safe (does NOT consume `tx.gas`, which
- * belongs to the Enoki sponsor in sponsored flows).
- *
- * For non-sponsored flows where the caller owns `tx.gas`, prefer
- * `buildStakeVSuiTx` directly (it splits from gas, which avoids one
- * `getBalance` RTT).
- *
- * Chain mode (`inputCoin` provided): consumes the passed-in SUI coin
- * ref entirely. Used for chained flows like "swap USDC → SUI → stake".
- * The caller is responsible for splitting upstream if they only want
- * part of the input coin staked.
- *
- * @returns
- *   - `coin`: vSUI output coin ref, ready for downstream consumption or
- *     wallet transfer (`tx.transferObjects`).
- *   - `effectiveAmountMist`: SUI mist consumed (echoes `input.amountMist`
- *     in both modes; chain-mode trusts the caller-supplied value since
- *     the actual coin balance is opaque).
- */
-declare function addStakeVSuiToTx(tx: Transaction, client: SuiJsonRpcClient, address: string, input: {
-    amountMist: bigint;
-    inputCoin?: TransactionObjectArgument;
-}): Promise<{
-    coin: TransactionObjectArgument;
-    effectiveAmountMist: bigint;
-}>;
-/**
- * SPEC 7 § "Layer 1" Volo unstake appender. Two modes.
- *
- * Wallet mode (`inputCoin` omitted): pre-flights via `getBalance` and
- * sources vSUI through `coinWithBalance({ type: VSUI, balance })`,
- * which resolves coin objects + address balance at build time. With
- * `'all'`, the entire balance is consumed.
- *
- * Chain mode (`inputCoin` provided): consumes the passed-in vSUI coin
- * ref. With `amountMist = 'all'`, the entire input coin is unstaked.
- * With a bigint `amountMist`, the input coin is split internally and
- * only that portion unstaked (the leftover stays accessible via the
- * original ref). Used for chained flows where vSUI was just produced
- * by a prior step.
- *
- * @returns
- *   - `coin`: SUI output coin ref, ready for downstream consumption
- *     (e.g. `addSendToTx`, `addStakeVSuiToTx` re-stake) or wallet
- *     transfer (`tx.transferObjects`).
- *   - `effectiveAmountMist`: input vSUI mist consumed; echoes
- *     `input.amountMist` (`'all'` is preserved as-is — the actual SUI
- *     received differs from input vSUI by the pool exchange rate, so
- *     callers needing the SUI amount must query `getVoloStats` or
- *     parse balance changes from the executed tx).
- */
-declare function addUnstakeVSuiToTx(tx: Transaction, client: SuiJsonRpcClient, address: string, input: {
-    amountMist: bigint | 'all';
-    inputCoin?: TransactionObjectArgument;
-}): Promise<{
-    coin: TransactionObjectArgument;
-    effectiveAmountMist: bigint | 'all';
-}>;
-
 /**
  * SuiNS leaf-subname builders for the `audric.sui` parent NFT.
  *
@@ -1505,4 +1488,4 @@ declare function fullHandle(label: string): string;
  */
 declare function displayHandle(label: string): string;
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, StakeVSuiResult, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStakeInput, type VoloStats, type VoloUnstakeInput, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, addStakeVSuiToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildUnstakeVSuiTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };