@t2000/sdk 0.45.0 → 0.46.0

package/dist/{token-registry-B3EV3AdW.d.ts → token-registry-C1UN5EFV.d.ts}

@@ -1,7 +1,7 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
-import { G as GasMethod } from './types-DxNs-mLT.js';
+import { G as GasMethod } from './types-DfwfwsAN.js';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -241,6 +241,76 @@ declare const GAS_RESERVE_MIN = 0.05;
 declare function validateAddress(address: string): string;
 declare function truncateAddress(address: string): string;
 
+/**
+ * Shared transaction classifier.
+ *
+ * Consumed by both the SDK's `parseTxRecord` (production agent path) and
+ * the engine's `transaction_history` tool (cold-start RPC path). Keeping
+ * a single source of truth here prevents the two paths from drifting —
+ * see v1.5.3 regression where the SDK path was emitting `action:
+ * 'transaction'` (rendered as "On-chain") while the engine path was
+ * already producing fine-grained labels.
+ */
+/**
+ * Coarse action bucket — one of `'send' | 'lending' | 'swap' |
+ * 'transaction'`. Used by the ACI `action` filter on the
+ * `transaction_history` tool. STABLE: downstream queries depend on
+ * exactly these values.
+ */
+declare const KNOWN_TARGETS: readonly [RegExp, string][];
+/**
+ * Finer-grained display labels — derived from MoveCall function names.
+ * The card renders `label ?? action`, so when this map matches we get
+ * "Deposit" / "Withdraw" / "Borrow" / "Repay" / "Payment link" instead
+ * of the generic "Lending" or "Transaction".
+ *
+ * Order matters: more specific patterns first. Each entry is
+ * (regex, label) where the regex is matched against the
+ * fully-qualified MoveCall target `pkg::module::function`.
+ */
+declare const LABEL_PATTERNS: readonly [RegExp, string][];
+interface ClassifyBalanceChange {
+    owner: {
+        AddressOwner?: string;
+    } | string;
+    coinType: string;
+    amount: string;
+}
+declare function classifyAction(targets: string[], commandTypes: string[]): string;
+/**
+ * Fallback label when no `LABEL_PATTERNS` match.
+ *
+ * Returns the first MoveCall's *module* name (e.g. "navi", "cetus",
+ * "spam") so the card shows something more useful than the literal
+ * word "transaction". When no MoveCall exists, returns 'on-chain'
+ * instead — strictly more informative than "transaction".
+ */
+declare function fallbackLabel(targets: string[]): string;
+declare function classifyLabel(targets: string[], commandTypes: string[]): string;
+/**
+ * Balance-direction tiebreaker for ambiguous lending calls.
+ *
+ * Many lending modules expose generic entry points (NAVI's bundled
+ * flash actions, `lending_core::*::entry_*`, etc.) that don't carry
+ * a `deposit`/`withdraw`/`borrow`/`repay` keyword in the function
+ * name. When `classifyLabel` falls back to a bare module name like
+ * `"lending"` for a known lending tx, infer direction from the user's
+ * non-SUI balance change:
+ *   - net outflow of the supplied asset → deposit (also covers repay,
+ *     but repay-without-keyword is essentially never emitted).
+ *   - net inflow of the supplied asset → withdraw (also covers borrow).
+ * SUI is excluded so gas-only transactions don't get mislabeled.
+ *
+ * If `LABEL_PATTERNS` matched a specific keyword, the existing label is
+ * returned unchanged.
+ */
+declare function refineLendingLabel(currentAction: string, currentLabel: string, moveCallTargets: string[], changes: ClassifyBalanceChange[], address: string): string;
+interface ClassifyResult {
+    action: string;
+    label: string;
+}
+declare function classifyTransaction(moveCallTargets: string[], commandTypes: string[], balanceChanges: ClassifyBalanceChange[], address: string): ClassifyResult;
+
 declare function mistToSui(mist: bigint): number;
 declare function suiToMist(sui: number): bigint;
 declare function usdcToRaw(amount: number): bigint;
@@ -369,4 +439,4 @@ declare const IKA_TYPE: string;
 declare const LOFI_TYPE: string;
 declare const MANIFEST_TYPE: string;
 
-export { formatAssetAmount as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, USDSUI_TYPE as H, IKA_TYPE as I, USDT_TYPE as J, KeypairSigner as K, LOFI_TYPE as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, WBTC_TYPE as Q, ZkLoginSigner as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, addCollectFeeToTx as V, WAL_TYPE as W, calculateFee as X, executeAutoTopUp as Y, type ZkLoginProof as Z, executeWithGas as _, type AutoTopUpResult as a, formatSui as a0, formatUsd as a1, getDecimals as a2, getDecimalsForCoinType as a3, getGasStatus as a4, getTier as a5, isSupported as a6, isTier1 as a7, isTier2 as a8, mapMoveAbortCode as a9, mapWalletError as aa, mistToSui as ab, rawToStable as ac, rawToUsdc as ad, resolveSymbol as ae, resolveTokenType as af, shouldAutoTopUp as ag, stableToRaw as ah, suiToMist as ai, truncateAddress as aj, usdcToRaw as ak, validateAddress as al, SafeguardEnforcer as am, BORROW_FEE_BPS as an, CETUS_USDC_SUI_POOL as ao, OPERATION_ASSETS as ap, type Operation as aq, SAVE_FEE_BPS as ar, assertAllowedAsset as as, isAllowedAsset as at, simulateTransaction as au, throwIfSimulationFailed as av, COIN_REGISTRY as b, type CoinMeta as c, DEFAULT_SAFEGUARD_CONFIG as d, type GasExecutionResult as e, type GasRequestType as f, type GasSponsorResponse as g, type GasStatusResponse as h, MIST_PER_SUI as i, SUI_DECIMALS as j, SUI_TYPE as k, SUPPORTED_ASSETS as l, type SafeguardConfig as m, SafeguardError as n, type SafeguardErrorDetails as o, type SafeguardRule as p, type SimulationResult as q, type StableAsset as r, type SupportedAsset as s, type T2000ErrorCode as t, type T2000ErrorData as u, TOKEN_MAP as v, type TransactionSigner as w, type TxMetadata as x, USDC_TYPE as y, USDE_TYPE as z };
+export { addCollectFeeToTx as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type TransactionSigner as H, IKA_TYPE as I, type TxMetadata as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, USDC_TYPE as Q, USDE_TYPE as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, USDSUI_TYPE as V, USDT_TYPE as W, WAL_TYPE as X, WBTC_TYPE as Y, type ZkLoginProof as Z, ZkLoginSigner as _, type AutoTopUpResult as a, calculateFee as a0, classifyAction as a1, classifyLabel as a2, classifyTransaction as a3, executeAutoTopUp as a4, executeWithGas as a5, fallbackLabel as a6, formatAssetAmount as a7, formatSui as a8, formatUsd as a9, SAVE_FEE_BPS as aA, assertAllowedAsset as aB, isAllowedAsset as aC, simulateTransaction as aD, throwIfSimulationFailed as aE, getDecimals as aa, getDecimalsForCoinType as ab, getGasStatus as ac, getTier as ad, isSupported as ae, isTier1 as af, isTier2 as ag, mapMoveAbortCode as ah, mapWalletError as ai, mistToSui as aj, rawToStable as ak, rawToUsdc as al, refineLendingLabel as am, resolveSymbol as an, resolveTokenType as ao, shouldAutoTopUp as ap, stableToRaw as aq, suiToMist as ar, truncateAddress as as, usdcToRaw as at, validateAddress as au, SafeguardEnforcer as av, BORROW_FEE_BPS as aw, CETUS_USDC_SUI_POOL as ax, OPERATION_ASSETS as ay, type Operation as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type GasExecutionResult as g, type GasRequestType as h, type GasSponsorResponse as i, type GasStatusResponse as j, KeypairSigner as k, LOFI_TYPE as l, MIST_PER_SUI as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SupportedAsset as w, type T2000ErrorCode as x, type T2000ErrorData as y, TOKEN_MAP as z };

package/dist/{token-registry-BEvCPkp9.d.cts → token-registry-mycv_b90.d.cts}

@@ -1,7 +1,7 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
-import { G as GasMethod } from './types-DxNs-mLT.cjs';
+import { G as GasMethod } from './types-DfwfwsAN.cjs';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -241,6 +241,76 @@ declare const GAS_RESERVE_MIN = 0.05;
 declare function validateAddress(address: string): string;
 declare function truncateAddress(address: string): string;
 
+/**
+ * Shared transaction classifier.
+ *
+ * Consumed by both the SDK's `parseTxRecord` (production agent path) and
+ * the engine's `transaction_history` tool (cold-start RPC path). Keeping
+ * a single source of truth here prevents the two paths from drifting —
+ * see v1.5.3 regression where the SDK path was emitting `action:
+ * 'transaction'` (rendered as "On-chain") while the engine path was
+ * already producing fine-grained labels.
+ */
+/**
+ * Coarse action bucket — one of `'send' | 'lending' | 'swap' |
+ * 'transaction'`. Used by the ACI `action` filter on the
+ * `transaction_history` tool. STABLE: downstream queries depend on
+ * exactly these values.
+ */
+declare const KNOWN_TARGETS: readonly [RegExp, string][];
+/**
+ * Finer-grained display labels — derived from MoveCall function names.
+ * The card renders `label ?? action`, so when this map matches we get
+ * "Deposit" / "Withdraw" / "Borrow" / "Repay" / "Payment link" instead
+ * of the generic "Lending" or "Transaction".
+ *
+ * Order matters: more specific patterns first. Each entry is
+ * (regex, label) where the regex is matched against the
+ * fully-qualified MoveCall target `pkg::module::function`.
+ */
+declare const LABEL_PATTERNS: readonly [RegExp, string][];
+interface ClassifyBalanceChange {
+    owner: {
+        AddressOwner?: string;
+    } | string;
+    coinType: string;
+    amount: string;
+}
+declare function classifyAction(targets: string[], commandTypes: string[]): string;
+/**
+ * Fallback label when no `LABEL_PATTERNS` match.
+ *
+ * Returns the first MoveCall's *module* name (e.g. "navi", "cetus",
+ * "spam") so the card shows something more useful than the literal
+ * word "transaction". When no MoveCall exists, returns 'on-chain'
+ * instead — strictly more informative than "transaction".
+ */
+declare function fallbackLabel(targets: string[]): string;
+declare function classifyLabel(targets: string[], commandTypes: string[]): string;
+/**
+ * Balance-direction tiebreaker for ambiguous lending calls.
+ *
+ * Many lending modules expose generic entry points (NAVI's bundled
+ * flash actions, `lending_core::*::entry_*`, etc.) that don't carry
+ * a `deposit`/`withdraw`/`borrow`/`repay` keyword in the function
+ * name. When `classifyLabel` falls back to a bare module name like
+ * `"lending"` for a known lending tx, infer direction from the user's
+ * non-SUI balance change:
+ *   - net outflow of the supplied asset → deposit (also covers repay,
+ *     but repay-without-keyword is essentially never emitted).
+ *   - net inflow of the supplied asset → withdraw (also covers borrow).
+ * SUI is excluded so gas-only transactions don't get mislabeled.
+ *
+ * If `LABEL_PATTERNS` matched a specific keyword, the existing label is
+ * returned unchanged.
+ */
+declare function refineLendingLabel(currentAction: string, currentLabel: string, moveCallTargets: string[], changes: ClassifyBalanceChange[], address: string): string;
+interface ClassifyResult {
+    action: string;
+    label: string;
+}
+declare function classifyTransaction(moveCallTargets: string[], commandTypes: string[], balanceChanges: ClassifyBalanceChange[], address: string): ClassifyResult;
+
 declare function mistToSui(mist: bigint): number;
 declare function suiToMist(sui: number): bigint;
 declare function usdcToRaw(amount: number): bigint;
@@ -369,4 +439,4 @@ declare const IKA_TYPE: string;
 declare const LOFI_TYPE: string;
 declare const MANIFEST_TYPE: string;
 
-export { formatAssetAmount as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, USDSUI_TYPE as H, IKA_TYPE as I, USDT_TYPE as J, KeypairSigner as K, LOFI_TYPE as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, WBTC_TYPE as Q, ZkLoginSigner as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, addCollectFeeToTx as V, WAL_TYPE as W, calculateFee as X, executeAutoTopUp as Y, type ZkLoginProof as Z, executeWithGas as _, type AutoTopUpResult as a, formatSui as a0, formatUsd as a1, getDecimals as a2, getDecimalsForCoinType as a3, getGasStatus as a4, getTier as a5, isSupported as a6, isTier1 as a7, isTier2 as a8, mapMoveAbortCode as a9, mapWalletError as aa, mistToSui as ab, rawToStable as ac, rawToUsdc as ad, resolveSymbol as ae, resolveTokenType as af, shouldAutoTopUp as ag, stableToRaw as ah, suiToMist as ai, truncateAddress as aj, usdcToRaw as ak, validateAddress as al, SafeguardEnforcer as am, BORROW_FEE_BPS as an, CETUS_USDC_SUI_POOL as ao, OPERATION_ASSETS as ap, type Operation as aq, SAVE_FEE_BPS as ar, assertAllowedAsset as as, isAllowedAsset as at, simulateTransaction as au, throwIfSimulationFailed as av, COIN_REGISTRY as b, type CoinMeta as c, DEFAULT_SAFEGUARD_CONFIG as d, type GasExecutionResult as e, type GasRequestType as f, type GasSponsorResponse as g, type GasStatusResponse as h, MIST_PER_SUI as i, SUI_DECIMALS as j, SUI_TYPE as k, SUPPORTED_ASSETS as l, type SafeguardConfig as m, SafeguardError as n, type SafeguardErrorDetails as o, type SafeguardRule as p, type SimulationResult as q, type StableAsset as r, type SupportedAsset as s, type T2000ErrorCode as t, type T2000ErrorData as u, TOKEN_MAP as v, type TransactionSigner as w, type TxMetadata as x, USDC_TYPE as y, USDE_TYPE as z };
+export { addCollectFeeToTx as $, ALL_NAVI_ASSETS as A, BPS_DENOMINATOR as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type TransactionSigner as H, IKA_TYPE as I, type TxMetadata as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, USDC_TYPE as Q, USDE_TYPE as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, USDSUI_TYPE as V, USDT_TYPE as W, WAL_TYPE as X, WBTC_TYPE as Y, type ZkLoginProof as Z, ZkLoginSigner as _, type AutoTopUpResult as a, calculateFee as a0, classifyAction as a1, classifyLabel as a2, classifyTransaction as a3, executeAutoTopUp as a4, executeWithGas as a5, fallbackLabel as a6, formatAssetAmount as a7, formatSui as a8, formatUsd as a9, SAVE_FEE_BPS as aA, assertAllowedAsset as aB, isAllowedAsset as aC, simulateTransaction as aD, throwIfSimulationFailed as aE, getDecimals as aa, getDecimalsForCoinType as ab, getGasStatus as ac, getTier as ad, isSupported as ae, isTier1 as af, isTier2 as ag, mapMoveAbortCode as ah, mapWalletError as ai, mistToSui as aj, rawToStable as ak, rawToUsdc as al, refineLendingLabel as am, resolveSymbol as an, resolveTokenType as ao, shouldAutoTopUp as ap, stableToRaw as aq, suiToMist as ar, truncateAddress as as, usdcToRaw as at, validateAddress as au, SafeguardEnforcer as av, BORROW_FEE_BPS as aw, CETUS_USDC_SUI_POOL as ax, OPERATION_ASSETS as ay, type Operation as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type GasExecutionResult as g, type GasRequestType as h, type GasSponsorResponse as i, type GasStatusResponse as j, KeypairSigner as k, LOFI_TYPE as l, MIST_PER_SUI as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SupportedAsset as w, type T2000ErrorCode as x, type T2000ErrorData as y, TOKEN_MAP as z };

package/dist/{types-DxNs-mLT.d.cts → types-DfwfwsAN.d.cts}

@@ -139,7 +139,15 @@ interface PaymentRequest {
 }
 interface TransactionRecord {
     digest: string;
+    /** Coarse bucket — `'send' | 'lending' | 'swap' | 'transaction'`. STABLE. */
     action: string;
+    /**
+     * Finer-grained display label derived from the Move-call function
+     * name (e.g. `'deposit'`, `'withdraw'`, `'payment_link'`,
+     * `'on-chain'`). Optional — frontends should fall back to `action`
+     * when missing. Never used by ACI filters.
+     */
+    label?: string;
     amount?: number;
     asset?: string;
     recipient?: string;

package/dist/{types-DxNs-mLT.d.ts → types-DfwfwsAN.d.ts}

@@ -139,7 +139,15 @@ interface PaymentRequest {
 }
 interface TransactionRecord {
     digest: string;
+    /** Coarse bucket — `'send' | 'lending' | 'swap' | 'transaction'`. STABLE. */
     action: string;
+    /**
+     * Finer-grained display label derived from the Move-call function
+     * name (e.g. `'deposit'`, `'withdraw'`, `'payment_link'`,
+     * `'on-chain'`). Optional — frontends should fall back to `action`
+     * when missing. Never used by ACI filters.
+     */
+    label?: string;
     amount?: number;
     asset?: string;
     recipient?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/sdk",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "description": "TypeScript SDK for AI agent bank accounts on Sui — send, save, borrow, swap. NAVI lending + Cetus aggregator routing, sponsored gas, zkLogin compatible.",
   "type": "module",
   "main": "./dist/index.cjs",