@t2000/sdk 3.3.0 → 4.0.1

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 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-C1DH4kPA.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-C1DH4kPA.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 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';
@@ -10,6 +10,7 @@ export { A as AssetRates, G as GasReserve, t as HFAlertLevel, O as OVERLAY_FEE_R
 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;
@@ -134,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
@@ -177,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?: {
@@ -377,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
@@ -408,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
@@ -605,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;
@@ -790,7 +891,7 @@ type StepPreview = {
     toolName: 'send_transfer';
     effectiveAmount: number;
     recipient: string;
-    asset: SupportedAsset;
+    asset: SendableAsset;
 } | {
     toolName: 'swap_execute';
     effectiveAmountIn: number;
@@ -1387,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, 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, 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 };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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-DjeENMuV.js';
-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-DjeENMuV.js';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, v as SupportedAsset, _ as ZkLoginProof, ax as SendableAsset } from './types-_U9XXGFR.js';
+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-_U9XXGFR.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, j as SwapRouteResult, s as FinancialSummary } from './types-HJGbXJ37.js';
@@ -10,6 +10,7 @@ export { A as AssetRates, G as GasReserve, t as HFAlertLevel, O as OVERLAY_FEE_R
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.js';
+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;
@@ -134,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
@@ -177,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?: {
@@ -377,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
@@ -408,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
@@ -605,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;
@@ -790,7 +891,7 @@ type StepPreview = {
     toolName: 'send_transfer';
     effectiveAmount: number;
     recipient: string;
-    asset: SupportedAsset;
+    asset: SendableAsset;
 } | {
     toolName: 'swap_execute';
     effectiveAmountIn: number;
@@ -1387,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, 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, 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 };