@t2000/sdk 4.4.0 → 5.0.0

package/dist/index.d.ts

@@ -1,17 +1,13 @@
 import { EventEmitter } from 'eventemitter3';
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, az as SendableAsset } from './types-DqRLGfOC.js';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aA as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, aB as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, aC as GASLESS_MIN_STABLE_AMOUNT, aD 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, aE as OPERATION_ASSETS, O as OUTBOUND_OPS, aF as Operation, P as ProtocolFeeInfo, aG as SAVEABLE_ASSETS, S as SAVE_FEE_BPS, aH 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, aI 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, aJ as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, aK as createSuiClient, a5 as executeTx, a6 as extractAllUserLegs, a7 as extractTransferDetails, a8 as extractTxCommands, a9 as extractTxSender, aa as fallbackLabel, ab as formatAssetAmount, ac as formatSui, ad as formatUsd, aL as getCoinMeta, ae as getDecimals, af as getDecimalsForCoinType, aM as getSuiClient, aN as getSuiGrpcClient, ag as getTier, aO as isAllowedAsset, aP as isInRegistry, ah as isSupported, ai as isTier1, aj as isTier2, ak as mapMoveAbortCode, al as mapWalletError, am as mistToSui, aQ as normalizeAsset, aR as normalizeCoinType, an as parseSuiRpcTx, ao as payWithMpp, aS as queryHistory, aT as queryTransaction, ap as rawToStable, aq as rawToUsdc, ar as refineLendingLabel, as as resolveSymbol, at as resolveTokenType, aU as simulateTransaction, au as stableToRaw, av as suiToMist, aV as throwIfSimulationFailed, aw as truncateAddress, ax as usdcToRaw, ay as validateAddress } from './types-DqRLGfOC.js';
-import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-DqIb4AnV.js';
-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.js';
-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, s as SponsoredCoinMergeCache, j as SwapRouteResult, t as FinancialSummary } from './types-Ch0zVUpC.js';
-export { A as AssetRates, u as CoinPage, G as GasReserve, v as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, w as SelectAndSplitResult, x as SerializedCetusRoute, y as SerializedCetusRoutePath, z as SerializedRouterDataV3, T as TransactionLeg, I as addSwapToTx, l as buildSwapTx, J as deserializeCetusRoute, K as fetchAllCoins, m as findSwapRoute, L as isCetusRouteFresh, N as selectAndSplitCoin, Q as selectSuiCoin, U as serializeCetusRoute, V as verifyCetusRouteCoinMatch } from './types-Ch0zVUpC.js';
+import { W as TxMetadata, p as SafeguardConfig, T as T2000Error, az as T2000Options, U as TransactionSigner, P as PayOptions, l as PayResult, aA as SwapResult, aB as SwapQuoteResult, y as SupportedAsset, t as SendResult, B as BalanceResponse, R as TransactionRecord, f as DepositInfo, aC as PaymentRequest, a2 as ZkLoginProof, aD as SuiCoreClient, aE as SendableAsset, k as OverlayFeeConfig, aF as SponsoredCoinMergeCache, z as SwapRouteResult } from './types-CgZWnHhs.js';
+export { aG as CETUS_USDC_SUI_POOL, C as CLOCK_ID, a as COIN_REGISTRY, b as ClassifyBalanceChange, c as ClassifyResult, d as CoinMeta, aH as CoinPage, aI as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, e as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, aJ as GASLESS_MIN_STABLE_AMOUNT, aK 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, aL as OPERATION_ASSETS, O as OVERLAY_FEE_RATE, aM as Operation, aN as SENDABLE_ASSETS, S as STABLE_ASSETS, m as SUI_DECIMALS, n as SUI_TYPE, o as SUPPORTED_ASSETS, q as SafeguardError, r as SafeguardErrorDetails, s as SafeguardRule, aO as SelectAndSplitResult, aP as SerializedCetusRoute, aQ as SerializedCetusRoutePath, aR as SerializedRouterDataV3, u as SimulationResult, v as StableAsset, w as SuiHolding, x as SuiRpcTxBlock, A as T2000ErrorCode, F as T2000ErrorData, H as T2000_OVERLAY_FEE_WALLET, J as TOKEN_MAP, Q as TransactionLeg, V as TxDirection, X as USDC_DECIMALS, Y as USDC_TYPE, Z as USDE_TYPE, _ as USDSUI_TYPE, $ as USDT_TYPE, a0 as WAL_TYPE, a1 as WBTC_TYPE, a3 as ZkLoginSigner, aS as addSwapToTx, aT as assertAllowedAsset, a4 as buildSwapTx, a5 as classifyAction, a6 as classifyLabel, a7 as classifyTransaction, aU as deserializeCetusRoute, a8 as executeTx, a9 as extractAllUserLegs, aa as extractTransferDetails, ab as extractTxCommands, ac as extractTxSender, ad as fallbackLabel, aV as fetchAllCoins, ae as findSwapRoute, af as formatAssetAmount, ag as formatSui, ah as formatUsd, aW as getCoinMeta, ai as getDecimals, aj as getDecimalsForCoinType, aX as getSuiClient, aY as getSuiGrpcClient, aZ as isAllowedAsset, a_ as isCetusRouteFresh, a$ as isInRegistry, ak as mapMoveAbortCode, al as mapWalletError, am as mistToSui, b0 as normalizeAsset, b1 as normalizeCoinType, an as parseSuiRpcTx, ao as payWithMpp, b2 as queryHistory, b3 as queryTransaction, ap as rawToStable, aq as rawToUsdc, ar as refineLendingLabel, as as resolveSymbol, at as resolveTokenType, b4 as selectAndSplitCoin, b5 as selectSuiCoin, b6 as serializeCetusRoute, b7 as simulateTransaction, au as stableToRaw, av as suiToMist, b8 as throwIfSimulationFailed, aw as truncateAddress, ax as usdcToRaw, ay as validateAddress, b9 as verifyCetusRouteCoinMatch } from './types-CgZWnHhs.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
-export { NaviAdapter, ProtocolRegistry } from './adapters/index.js';
-import '@mysten/sui/grpc';
+import '@mysten/sui/client';
 import '@cetusprotocol/aggregator-sdk';
+import '@mysten/sui/jsonRpc';
 
 declare class SafeguardEnforcer {
     private config;
@@ -30,30 +26,6 @@ declare class SafeguardEnforcer {
     private save;
 }
 
-interface Contact {
-    name: string;
-    address: string;
-}
-declare class ContactManager {
-    private contacts;
-    private readonly filePath;
-    private readonly dir;
-    constructor(configDir?: string);
-    private load;
-    private save;
-    add(name: string, address: string): {
-        action: 'added' | 'updated';
-    };
-    remove(name: string): boolean;
-    get(name: string): Contact | undefined;
-    list(): Contact[];
-    resolve(nameOrAddress: string): {
-        address: string;
-        contactName?: string;
-    };
-    private validateName;
-}
-
 interface T2000Events {
     balanceChange: (event: {
         asset: string;
@@ -85,12 +57,9 @@ declare class T2000 extends EventEmitter<T2000Events> {
     private readonly _keypair?;
     private readonly client;
     private readonly _address;
-    private readonly registry;
     readonly enforcer: SafeguardEnforcer;
-    readonly contacts: ContactManager;
     private constructor();
     private constructor();
-    private static createDefaultRegistry;
     static create(options?: T2000Options): Promise<T2000>;
     static fromPrivateKey(privateKey: string, options?: {
         network?: 'mainnet' | 'testnet';
@@ -105,8 +74,8 @@ declare class T2000 extends EventEmitter<T2000Events> {
         agent: T2000;
         address: string;
     }>;
-    /** SuiJsonRpcClient used by this agent — exposed for integrations. */
-    get suiClient(): SuiJsonRpcClient;
+    /** SuiGrpcClient used by this agent — exposed for integrations. */
+    get suiClient(): SuiGrpcClient;
     /** Ed25519Keypair used by this agent — exposed for CLI/MCP integrations. */
     get keypair(): Ed25519Keypair;
     /** Transaction signer (works for both keypair and zkLogin). */
@@ -136,8 +105,7 @@ declare class T2000 extends EventEmitter<T2000Events> {
     }): Promise<SwapQuoteResult>;
     address(): string;
     /**
-     * Send `amount` of `asset` to `to` (hex address, SuiNS name, or
-     * `@audric` handle / saved contact).
+     * Send `amount` of `asset` to `to` (hex address or SuiNS name).
      *
      * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
      *
@@ -162,34 +130,23 @@ declare class T2000 extends EventEmitter<T2000Events> {
         asset: SupportedAsset;
     }): Promise<SendResult>;
     /**
-     * [S.279 / CLI-CONTACTS-CLEANUP — 2026-05-23] Resolve a recipient
-     * string into a canonical 0x address, trying each shape in priority
-     * order:
+     * Resolve a recipient string into a canonical 0x address:
      *   1. **hex** — `0x…` is used directly (no RPC round-trip).
      *   2. **SuiNS** — `alex.sui` resolves via `suix_resolveNameServiceAddress`.
-     *   3. **saved contact** — `ContactManager.resolve()` falls back to the
-     *      legacy `~/.t2000/contacts.json` alias map. Deprecated; the
-     *      manager surfaces a one-time `console.warn` when this path fires.
      *
-     * Returns `{ address, suinsName?, contactName? }` so `send()` can stamp
-     * the name source on the receipt without re-resolving.
+     * Anything else is rejected. (The legacy `contacts.json` alias map was
+     * removed — SuiNS supersedes local contacts.)
      *
-     * Throws `T2000Error('SUINS_NOT_REGISTERED', …)` for well-formed but
-     * unregistered SuiNS names (vs. propagating the engine-style
-     * `SuinsNotRegisteredError` — keeps the SDK's error surface
-     * `T2000Error`-only, consistent with every other write helper).
+     * Returns `{ address, suinsName? }` so `send()` can stamp the name source
+     * on the receipt without re-resolving. Throws
+     * `T2000Error('SUINS_NOT_REGISTERED', …)` for well-formed but unregistered
+     * SuiNS names, keeping the SDK error surface `T2000Error`-only.
      *
-     * [S.279.1 / 2026-05-23 — patch v2.19.1] Promoted from `private` to
-     * `public` so MCP's `t2000_send` dryRun preview path can share the
-     * same resolution logic as the live execute path. Pre-2.19.1 the
-     * MCP dryRun called `agent.contacts.resolve(to)` directly, which
-     * rejected SuiNS names — preview-then-execute flows broke for
-     * `alex.sui`-style recipients. SSOT: never let preview and execute
-     * resolve the same input differently.
+     * Public so MCP's `t2000_send` dryRun preview shares one resolution path
+     * with the live execute path (never resolve the same input two ways).
      */
     resolveRecipient(input: string): Promise<{
         address: string;
-        contactName?: string;
         suinsName?: string;
     }>;
     balance(): Promise<BalanceResponse>;
@@ -221,70 +178,6 @@ declare class T2000 extends EventEmitter<T2000Events> {
         maxEpoch: number;
         rpcUrl?: string;
     }): T2000;
-    registerAdapter(adapter: LendingAdapter): Promise<void>;
-    save(params: {
-        amount: number | 'all';
-        asset?: SupportedAsset;
-        protocol?: string;
-    }): Promise<SaveResult>;
-    withdraw(params: {
-        amount: number | 'all';
-        asset?: string;
-        protocol?: string;
-    }): Promise<WithdrawResult>;
-    private withdrawAllProtocols;
-    /**
-     * [v0.51.0] Per-asset wallet balance lookup.
-     *
-     * `queryBalance.available` rolls up only `STABLE_ASSETS` (USDC), so it cannot
-     * answer "do they have enough USDsui to save 10?". This helper hits
-     * `getBalance` for the specific coin type — same mechanism `queryBalance`
-     * uses internally — and converts to a human-readable amount using the asset's
-     * decimals. Returns 0 (not a throw) when the address holds none of the asset,
-     * matching the caller's existing "insufficient balance" error path.
-     */
-    private _queryAssetBalance;
-    private _autoFundFromSavings;
-    maxWithdraw(): Promise<MaxWithdrawResult>;
-    borrow(params: {
-        amount: number;
-        asset?: SupportedAsset;
-        protocol?: string;
-    }): Promise<BorrowResult>;
-    repay(params: {
-        amount: number | 'all';
-        asset?: SupportedAsset;
-        protocol?: string;
-    }): Promise<RepayResult>;
-    private _repayAllBorrows;
-    maxBorrow(): Promise<MaxBorrowResult>;
-    healthFactor(): Promise<HealthFactorResult>;
-    getPendingRewards(): Promise<PendingReward[]>;
-    claimRewards(): Promise<ClaimRewardsResult>;
-    /**
-     * Claim pending rewards, swap non-USDC tokens to USDC via Cetus, and deposit into NAVI.
-     * Multi-step: claim (transfers to wallet) -> swap each reward token to USDC -> deposit USDC.
-     * Minimum threshold: skips if total rewards < $0.10 (gas not worth it).
-     */
-    compoundRewards(options?: {
-        minValueUsd?: number;
-    }): Promise<CompoundRewardsResult>;
-    positions(): Promise<PositionsResult>;
-    rates(): Promise<RatesResult>;
-    allRates(asset?: string): Promise<{
-        protocol: string;
-        protocolId: string;
-        rates: LendingRates;
-    }[]>;
-    allRatesAcrossAssets(): Promise<{
-        protocol: string;
-        protocolId: string;
-        asset: string;
-        rates: LendingRates;
-    }[]>;
-    earnings(): Promise<EarningsResult>;
-    fundStatus(): Promise<FundStatusResult>;
-    private resolveLending;
     private emitBalanceChange;
 }
 
@@ -459,7 +352,7 @@ declare function getAddress(keypair: Ed25519Keypair): string;
  * than a silent currency substitution.
  */
 declare function buildSendTx({ client, address, to, amount, asset, }: {
-    client: SuiJsonRpcClient;
+    client: SuiCoreClient;
     address: string;
     to: string;
     amount: number;
@@ -572,23 +465,7 @@ declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, r
  * 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';
-interface SaveDepositInput {
-    amount: number;
-    asset?: 'USDC' | 'USDsui';
-}
-interface WithdrawInput {
-    amount: number;
-    asset?: 'USDC' | 'USDsui';
-}
-interface BorrowInput {
-    amount: number;
-    asset?: 'USDC' | 'USDsui';
-}
-interface RepayDebtInput {
-    amount: number;
-    asset?: 'USDC' | 'USDsui';
-}
+type WriteToolName = 'send_transfer' | 'swap_execute';
 /**
  * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
  * `asset` is now REQUIRED (no more silent USDC default). The parameter
@@ -633,19 +510,6 @@ interface SwapExecuteInput {
      */
     precomputedRoute?: SwapRouteResult;
 }
-type ClaimRewardsInput = Record<string, never>;
-/**
- * [Track B] `harvest_rewards` accepts only optional tunables — no required
- * inputs, since the user's choice is binary ("harvest now" or not). Default
- * slippage 1%, default dust floor $0.01. The audric host's HARVEST chip
- * passes literal `{}` and gets sensible defaults.
- */
-interface HarvestRewardsInput {
-    /** Per-swap slippage tolerance (0.001–0.05). Default 0.01 (1%). */
-    slippage?: number;
-    /** USD floor for "is this worth swapping?" — dust below transfers to wallet. Default $0.01. */
-    minRewardUsd?: number;
-}
 /**
  * Discriminated union mapping `toolName` → `input`. Used to type
  * `WriteStep` so consumers get autocomplete + compile-time validation
@@ -658,26 +522,8 @@ interface HarvestRewardsInput {
  * bypassing the wallet pre-fetch path. The producer's terminal
  * `tx.transferObjects([coin], sender)` is suppressed automatically so
  * the same handle isn't double-consumed.
- *
- * Producer-only tools (`withdraw`, `borrow`, `claim_rewards`) don't
- * accept the field — they have no input coin slot. Consumer +
- * dual-mode tools all accept it.
  */
 type WriteStep = {
-    toolName: 'save_deposit';
-    input: SaveDepositInput;
-    inputCoinFromStep?: number;
-} | {
-    toolName: 'withdraw';
-    input: WithdrawInput;
-} | {
-    toolName: 'borrow';
-    input: BorrowInput;
-} | {
-    toolName: 'repay_debt';
-    input: RepayDebtInput;
-    inputCoinFromStep?: number;
-} | {
     toolName: 'send_transfer';
     input: SendTransferInput;
     inputCoinFromStep?: number;
@@ -685,17 +531,11 @@ type WriteStep = {
     toolName: 'swap_execute';
     input: SwapExecuteInput;
     inputCoinFromStep?: number;
-} | {
-    toolName: 'claim_rewards';
-    input: ClaimRewardsInput;
-} | {
-    toolName: 'harvest_rewards';
-    input: HarvestRewardsInput;
 };
 interface ComposeTxOptions {
     sender: string;
     steps: WriteStep[];
-    client: SuiJsonRpcClient;
+    client: SuiCoreClient;
     /**
      * S.38 Pyth flag (sponsorship-critical). When true:
      * - NAVI borrow/withdraw appenders apply `skipPythUpdate: true`
@@ -721,75 +561,9 @@ interface ComposeTxOptions {
      * `addSwapToTx`'s `input.overlayFee`.
      */
     overlayFee?: OverlayFeeConfig;
-    /**
-     * Optional fee-injection hooks for save_deposit + borrow. Fires inside
-     * the appender at the exact moment the user's coin is in hand and BEFORE
-     * the protocol step consumes (save) or the canonical transferObjects
-     * finalizes (borrow). Audric host uses this to inline `addFeeTransfer`
-     * for USDC SAVE_FEE_BPS / BORROW_FEE_BPS without ever leaving the
-     * canonical write contract — keeps the SDK fee-free per CLAUDE.md
-     * rule #9 while letting hosts charge their own overlay fees.
-     *
-     * Hooks are fire-and-forget (no return value). They mutate `tx` directly
-     * (e.g., `addFeeTransfer(tx, coin, ...)` splits the fee chunk off and
-     * appends a top-level `transferObjects` to the host's fee wallet — that
-     * recipient automatically appears in `derivedAllowedAddresses`).
-     */
-    feeHooks?: ComposeTxFeeHooks;
-}
-/**
- * Per-tool fee-injection callbacks. Each hook fires at a tool-specific
- * moment in the appender flow (see field JSDoc). Currently scoped to
- * the 2 fee-eligible tools — extend if/when new ones land.
- */
-interface ComposeTxFeeHooks {
-    /**
-     * Fires inside the `save_deposit` appender AFTER the user's USDC/USDsui
-     * coin is split into the deposit amount, BEFORE NAVI's `deposit` move
-     * call consumes the coin. Order matters: the `coin` reference passed in
-     * is the SAME `TransactionObjectArgument` that flows into the deposit,
-     * so any `splitCoins(coin, [feeAmount])` inside the hook reduces the
-     * deposit by exactly that fee.
-     */
-    save_deposit?: (ctx: ComposeTxFeeHookContext<SaveDepositInput>) => void | Promise<void>;
-    /**
-     * Fires inside the `borrow` appender AFTER NAVI returns the borrowed
-     * coin, BEFORE the canonical `transferObjects(coin, sender)` finalizes.
-     * The `coin` reference is the borrowed-and-not-yet-transferred output;
-     * splitting a fee here means the user receives the remainder.
-     */
-    borrow?: (ctx: ComposeTxFeeHookContext<BorrowInput>) => void | Promise<void>;
-}
-/**
- * Context object passed to every fee hook. Carries the `tx` (mutate it),
- * the in-flight `coin` (split fees off it), the resolved tool input
- * (asset/amount for fee-policy decisions), and the sender (rarely needed
- * but kept for symmetry with `AppenderContext`).
- */
-interface ComposeTxFeeHookContext<TInput> {
-    tx: Transaction;
-    coin: TransactionObjectArgument;
-    input: TInput;
-    sender: string;
 }
 /** Per-step preview returned by each registry appender. Tool-specific shape. */
 type StepPreview = {
-    toolName: 'save_deposit';
-    effectiveAmount: number;
-    asset: 'USDC' | 'USDsui';
-} | {
-    toolName: 'withdraw';
-    effectiveAmount: number;
-    asset: 'USDC' | 'USDsui';
-} | {
-    toolName: 'borrow';
-    effectiveAmount: number;
-    asset: 'USDC' | 'USDsui';
-} | {
-    toolName: 'repay_debt';
-    effectiveAmount: number;
-    asset: 'USDC' | 'USDsui';
-} | {
     toolName: 'send_transfer';
     effectiveAmount: number;
     recipient: string;
@@ -799,26 +573,6 @@ type StepPreview = {
     effectiveAmountIn: number;
     expectedAmountOut: number;
     route: SwapRouteResult;
-} | {
-    toolName: 'claim_rewards';
-    rewards: PendingReward$1[];
-} | {
-    toolName: 'harvest_rewards';
-    claimed: PendingReward$1[];
-    swaps: Array<{
-        fromSymbol: string;
-        fromCoinType: string;
-        toSymbol: 'USDC';
-        inputAmount: number;
-        expectedOutputUsdc: number;
-    }>;
-    skipped: Array<{
-        symbol: string;
-        coinType: string;
-        amount: number;
-        reason: 'untradeable' | 'dust' | 'no-route';
-    }>;
-    expectedUsdcDeposited: number;
 };
 interface ComposeTxResult {
     tx: Transaction;
@@ -843,11 +597,10 @@ interface ComposeTxResult {
  * fee config (Cetus swaps), and SPEC 13 Phase 1 chain-mode fields.
  */
 interface AppenderContext {
-    client: SuiJsonRpcClient;
+    client: SuiCoreClient;
     sender: string;
     sponsoredContext: boolean;
     overlayFee?: OverlayFeeConfig;
-    feeHooks?: ComposeTxFeeHooks;
     /**
      * [SPEC 13 Phase 1] When set, the consumer appender consumes this
      * coin handle directly instead of pre-fetching from the wallet via
@@ -887,12 +640,12 @@ interface AppenderContext {
 /**
  * [SPEC 13 Phase 1] Appender return shape. Producers populate
  * `outputCoin` so the orchestration loop can thread it into a
- * downstream consumer's `chainedCoin`. Terminal consumers
- * (`save_deposit`, `repay_debt`, `send_transfer`) omit it.
+ * downstream consumer's `chainedCoin`. The terminal consumer
+ * (`send_transfer`) omits it.
  *
  * `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.)
+ * AND populates `outputCoin`. (Pre-S.444 the DeFi tools
+ * save/withdraw/borrow/repay were also producers/consumers; removed with NAVI.)
  */
 interface AppenderResult<TPreview extends StepPreview> {
     preview: TPreview;
@@ -925,34 +678,18 @@ 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 8 `WriteToolName` values have an entry — TypeScript will
+ * that all `WriteToolName` values have an entry — TypeScript will
  * fail the build if a tool is missing.
+ *
+ * [S.444] Narrowed to send_transfer + swap_execute after the NAVI/DeFi cut.
  */
 declare const WRITE_APPENDER_REGISTRY: {
-    save_deposit: AppenderFn<SaveDepositInput, Extract<StepPreview, {
-        toolName: 'save_deposit';
-    }>>;
-    withdraw: AppenderFn<WithdrawInput, Extract<StepPreview, {
-        toolName: 'withdraw';
-    }>>;
-    borrow: AppenderFn<BorrowInput, Extract<StepPreview, {
-        toolName: 'borrow';
-    }>>;
-    repay_debt: AppenderFn<RepayDebtInput, Extract<StepPreview, {
-        toolName: 'repay_debt';
-    }>>;
     send_transfer: AppenderFn<SendTransferInput, Extract<StepPreview, {
         toolName: 'send_transfer';
     }>>;
     swap_execute: AppenderFn<SwapExecuteInput, Extract<StepPreview, {
         toolName: 'swap_execute';
     }>>;
-    claim_rewards: AppenderFn<ClaimRewardsInput, Extract<StepPreview, {
-        toolName: 'claim_rewards';
-    }>>;
-    harvest_rewards: AppenderFn<HarvestRewardsInput, Extract<StepPreview, {
-        toolName: 'harvest_rewards';
-    }>>;
 };
 /**
  * Walks the assembled PTB's command list and extracts every recipient
@@ -982,255 +719,6 @@ declare function deriveAllowedAddressesFromPtb(tx: Transaction): string[];
  */
 declare function composeTx(opts: ComposeTxOptions): Promise<ComposeTxResult>;
 
-declare const HF_WARN_THRESHOLD = 1.8;
-declare const HF_CRITICAL_THRESHOLD = 1.3;
-type FinancialSummaryOptions = Record<string, never>;
-/**
- * Fetch a complete financial snapshot for one wallet in parallel.
- * Designed for the indexer HF hook + chain-memory cron.
- *
- * Every sub-call has a fallback so a single RPC failure doesn't
- * crash the entire batch. Callers can check individual zero values
- * to detect degraded data.
- */
-declare function getFinancialSummary(client: SuiJsonRpcClient, walletAddress: string, _options?: FinancialSummaryOptions): Promise<FinancialSummary>;
-
-declare function getRates(client: SuiJsonRpcClient): Promise<RatesResult>;
-/**
- * [Track B follow-up / 2026-05-08] Stateless wrapper around `getPendingRewards`
- * that creates its own `SuiJsonRpcClient`. Used by the engine's
- * `pending_rewards` tool — engine doesn't import `@mysten/sui` directly
- * (would expand its dep surface), so this helper accepts just `(address,
- * suiRpcUrl?)` and instantiates the client internally.
- *
- * **Why this exists.** Pre-fix the engine tool went through
- * `requireAgent(context).getPendingRewards()`, which threw
- * "Tool requires a T2000 agent instance — pass `agent` in EngineConfig"
- * in audric prod (audric uses sponsored-tx flow, never instantiates a
- * T2000 agent). Live mainnet smoke on funkii's wallet 2026-05-08 caught
- * this immediately when the LLM correctly called pending_rewards before
- * harvest_rewards. This helper makes the audric/CLI paths symmetric
- * (both work, neither requires an agent).
- *
- * Defaults `suiRpcUrl` to mainnet fullnode for CLI / standalone callers
- * that don't pass one. Errors propagate with the same `T2000Error`
- * shape as the underlying `getPendingRewards` (PROTOCOL_UNAVAILABLE on
- * NAVI degradation, etc.) so the engine tool's catch path is unchanged.
- */
-declare function getPendingRewardsByAddress(address: string, suiRpcUrl?: string): Promise<PendingReward$1[]>;
-declare function getPendingRewards(client: SuiJsonRpcClient, address: string): Promise<PendingReward$1[]>;
-declare function addClaimRewardsToTx(tx: Transaction, client: SuiJsonRpcClient, address: string): Promise<PendingReward$1[]>;
-/**
- * Standalone builder for the `claim_rewards` tool. Wraps the existing
- * `addClaimRewardsToTx` appender into a complete PTB so the SPEC 7
- * `composeTx` registry adapter has a single-step builder it can dispatch
- * to when `claim_rewards` is invoked alone (the chain-mode path uses
- * `addClaimRewardsToTx` directly inside a multi-step PTB).
- *
- * Multi-protocol claim flows (e.g. NAVI + Suilend in a future world)
- * still go through the `T2000` class's `claimRewards()` method, which
- * iterates every registered lending adapter via the adapter registry —
- * this standalone builder is intentionally NAVI-only to keep the shape
- * symmetric with the rest of SPEC 7's Layer 1 builders.
- *
- * Returns `{ tx, rewards }`:
- * - `tx` — built PTB with sender set; if no rewards are claimable, no
- *   move calls are appended (caller should skip executing).
- * - `rewards` — what WILL be claimed by `tx`. Empty array means nothing
- *   to claim.
- */
-declare function buildClaimRewardsTx(client: SuiJsonRpcClient, address: string): Promise<{
-    tx: Transaction;
-    rewards: PendingReward$1[];
-}>;
-/**
- * Minimal shape we read off the NAVI SDK's `LendingReward` rows. Kept
- * structural rather than imported so the tests don't have to reproduce
- * the full upstream type and the function works for any future caller
- * that has the same fields.
- */
-interface ClaimableRewardLike {
-    userClaimableReward: number | string;
-    rewardCoinType: string;
-    assetId?: number | string;
-}
-/**
- * Aggregate raw NAVI `claimable` rows into the `PendingReward[]` shape
- * the engine surfaces to the LLM and the UI. Aggregates by reward coin
- * type so a user with rewards from multiple pools (e.g. USDC pool + SUI
- * pool both rewarding vSUI) sees a single "0.0165 vSUI" line rather
- * than three separate dust entries. Filters out non-finite / non-positive
- * amounts so dust noise can't sneak in as "$0.00 REWARD" rows.
- */
-declare function aggregateClaimableRewards(claimable: ClaimableRewardLike[]): PendingReward$1[];
-
-/**
- * NAVI rewards harvest — single-PTB compound flow.
- *
- * **Goal.** Bundle the three-step "claim → swap → save" reward-cycling
- * routine into ONE atomic Programmable Transaction Block so the user
- * sees ONE confirm card instead of three sequential ones, and so the
- * legs settle together (or revert together — no half-claimed-but-
- * unsaved drift).
- *
- * **Flow.**
- *   1. Read pending rewards via NAVI's `getUserAvailableLendingRewards`
- *      (same source as `getPendingRewards` + `addClaimRewardsToTx`, so
- *      what the user sees in `pending_rewards` is exactly what gets
- *      harvested — no drift).
- *   2. Append `claimLendingRewardsPTB(... { customCoinReceive: { type: 'skip' }})`
- *      so the claimed coin handles are returned as `TransactionObjectArgument`
- *      handles instead of being transferred to the wallet — they stay
- *      consumable inside the same PTB.
- *   3. For each claimed handle:
- *        • If the reward IS USDC, hold the handle for the deposit step.
- *        • If the reward is in `COIN_REGISTRY` AND tradeable on Cetus
- *          (any tier-2 token effectively), append `addSwapToTx` in chain
- *          mode using the claimed coin as `inputCoin`. Collect the USDC
- *          output handle.
- *        • Else (untradeable / non-registry), transfer the claimed coin
- *          back to the user's wallet — preserves the reward but skips
- *          the auto-deposit (the user keeps it as a wallet asset).
- *   4. Merge all collected USDC handles via `tx.mergeCoins`, then deposit
- *      via `addSaveToTx`.
- *
- * **Atomicity.** Single PTB = single transaction = single sponsored-gas
- * envelope. Either ALL legs settle (claim + swap(s) + deposit) or none
- * do. No partial-state recovery code needed.
- *
- * **Sponsored-gas posture.** This builder appends ONLY chained move
- * calls — no `tx.gas` reads, no Pyth fee writes, no oracle Pyth updates.
- * Cetus chain-mode swaps with `slippage` ≤ 5% don't require Pyth either
- * (Cetus aggregator routes around Pyth-dependent providers when callers
- * pass `providers: getProvidersExcluding(...)`). Audric's host wires
- * the provider exclusion automatically for Enoki sponsorship — see
- * `cetus-swap.ts` JSDoc.
- *
- * **Dust filter.** Rewards with `amount * priceCache.get(symbol) <
- * minRewardUsd` are skipped from the swap leg AND from the deposit —
- * not worth the gas to swap dust. They get transferred back to the
- * wallet (preserving on-chain truth: the claim happened, the swap
- * didn't). Default minRewardUsd = $0.01.
- *
- * **Failure modes.**
- *   - PROTOCOL_UNAVAILABLE — NAVI rewards lookup or claim PTB build failed.
- *     Engine surfaces "NAVI is degraded right now."
- *   - SWAP_NO_ROUTE — a reward asset has no Cetus route. Logged + that
- *     leg is skipped (rewards transferred to wallet). Other legs proceed.
- *   - INVALID_AMOUNT — rewards array empty after dust filter (nothing
- *     worth harvesting). Throws so the engine narrates "nothing to
- *     harvest right now" instead of building a no-op PTB.
- *
- * **Why a separate file (not inside `navi.ts`).** This composition
- * crosses two protocols (NAVI + Cetus) — keeping it out of `navi.ts`
- * preserves the single-protocol-per-file invariant the rest of the SDK
- * follows. Mirrors how `cetus-swap.ts` already lives separately even
- * though it composes through `composeTx.ts`.
- */
-
-interface HarvestSwapLeg {
-    /** Reward symbol pre-swap (e.g. 'vSUI', 'NAVX'). */
-    fromSymbol: string;
-    /** Reward coinType pre-swap. */
-    fromCoinType: string;
-    /** Always 'USDC' — this builder only deposits to the USDC pool. */
-    toSymbol: 'USDC';
-    /** Display-units input amount (the entire claimed reward for that coin). */
-    inputAmount: number;
-    /** Display-units USDC the swap quote estimated. Actual on-chain may differ within slippage. */
-    expectedOutputUsdc: number;
-}
-interface HarvestSkippedLeg {
-    /** Reward symbol skipped (untradeable, dust, or no-route). */
-    symbol: string;
-    coinType: string;
-    /** Display-units claimed amount (still credited to user's wallet — just not auto-deposited). */
-    amount: number;
-    /** 'untradeable' | 'dust' | 'no-route' */
-    reason: 'untradeable' | 'dust' | 'no-route';
-}
-interface HarvestPlan {
-    /** Every reward that WILL be claimed by this PTB. */
-    claimed: PendingReward$1[];
-    /** Each non-USDC reward that WILL be swapped to USDC inline. */
-    swaps: HarvestSwapLeg[];
-    /** Rewards claimed but transferred back to wallet (no auto-deposit). */
-    skipped: HarvestSkippedLeg[];
-    /** Display-units USDC that will be deposited to the NAVI USDC pool. */
-    expectedUsdcDeposited: number;
-}
-/**
- * Callback invoked right before the harvest's internal `addSaveToTx`.
- * Mirrors the shape of `composeTx`'s `feeHooks.save_deposit` so audric's
- * existing hook can be threaded straight through without adapters. The
- * SDK never invents a fee — the host decides whether to skim from
- * `coin` and to where. See CLAUDE.md rule #9 (fees are a host concern).
- */
-type HarvestSaveFeeHook = (ctx: {
-    tx: Transaction;
-    coin: TransactionObjectArgument;
-    input: {
-        asset: 'USDC';
-        amount: number;
-    };
-    sender: string;
-}) => void | Promise<void>;
-interface BuildHarvestRewardsTxOptions {
-    /** Per-swap slippage tolerance (0.001–0.05). Defaults to 0.01 (1%). */
-    slippage?: number;
-    /**
-     * USD floor for "is this worth swapping?". Rewards below this threshold
-     * get transferred back to the wallet instead of swapped. Default $0.01.
-     * Pass 0 to disable the filter (always swap; useful for tests).
-     */
-    minRewardUsd?: number;
-    /**
-     * Symbol → USD price map. Sourced from the engine's `ToolContext.priceCache`
-     * in production; tests can pass a literal Map. When undefined, the dust
-     * filter degrades to "skip nothing" (every reward is swapped) so we don't
-     * accidentally drop large rewards just because we couldn't price them.
-     */
-    priceCache?: Map<string, number>;
-    /**
-     * Cetus provider allow-list. Sponsored callers (Enoki) pass
-     * `getProvidersExcluding(['pyth-dependent-list'])` to keep the PTB
-     * Pyth-free. Non-sponsored callers omit this.
-     */
-    providers?: string[];
-    /**
-     * [v1.24.2 fee wiring] Overlay fee forwarded to EACH internal
-     * `addSwapToTx` call. When set, every swap leg charges the rate to
-     * the receiver (typically `T2000_OVERLAY_FEE_WALLET` for audric).
-     * Omit for fee-free harvests (CLI / direct SDK callers).
-     */
-    overlayFee?: OverlayFeeConfig;
-    /**
-     * [v1.24.2 fee wiring] Fired immediately before the internal
-     * `addSaveToTx` consumes the merged USDC deposit coin. The hook
-     * receives the deposit handle so it can split a fee off via
-     * `addFeeTransfer(...)` (host's call). Audric threads its
-     * `feeHooks.save_deposit` straight through here so a harvest's
-     * deposit leg pays the same `SAVE_FEE_BPS` as a single-op `save`.
-     *
-     * Order is load-bearing: this hook fires AFTER all USDC handles
-     * are merged into one and BEFORE the NAVI deposit consumes it.
-     * Fee receiver gets recorded as a top-level transferObjects, so
-     * it's automatically picked up by `derivedAllowedAddresses`.
-     */
-    saveFeeHook?: HarvestSaveFeeHook;
-}
-/**
- * Standalone harvest builder — creates a fresh PTB, sets the sender,
- * appends the full harvest flow, and returns both the tx and the plan.
- * Used by CLI / direct SDK callers (smoke tests, scripts). The audric
- * host goes through `composeTx({ steps: [{ toolName: 'harvest_rewards' }] })`
- * which wires the appender + Enoki sponsorship.
- */
-declare function buildHarvestRewardsTx(client: SuiJsonRpcClient, address: string, options?: BuildHarvestRewardsTxOptions): Promise<{
-    tx: Transaction;
-    plan: HarvestPlan;
-}>;
-
 declare function getSwapQuote(params: {
     walletAddress: string;
     from: string;
@@ -1400,4 +888,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 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, 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, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, validateLabel, walletExists };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ComposeTxOptions, type ComposeTxResult, DepositInfo, InvalidAddressError, type LabelValidationResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, ZkLoginProof, addSendToTx, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getSponsoredSwapProviders, getSwapQuote, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, validateLabel, walletExists };