@t2000/sdk 0.22.3 → 0.23.0

package/dist/index.d.cts

@@ -1,14 +1,14 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { T as T2000Error, am as SafeguardEnforcer, w as TransactionSigner, Z as ZkLoginProof, s as SupportedAsset } from './token-registry-bf_caDsv.cjs';
-export { A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, an as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as CoinMeta, D as DEFAULT_NETWORK, d as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, F as FeeOperation, G as GAS_RESERVE_MIN, e as GasExecutionResult, f as GasRequestType, g as GasSponsorResponse, h as GasStatusResponse, I as IKA_TYPE, K as KeypairSigner, L as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, ao as OPERATION_ASSETS, O as OUTBOUND_OPS, ap as Operation, P as ProtocolFeeInfo, S as STABLE_ASSETS, j as SUI_DECIMALS, k as SUI_TYPE, l as SUPPORTED_ASSETS, m as SafeguardConfig, n as SafeguardError, o as SafeguardErrorDetails, p as SafeguardRule, q as SimulationResult, r as StableAsset, t as T2000ErrorCode, u as T2000ErrorData, v as TOKEN_MAP, x as TxMetadata, U as USDC_DECIMALS, y as USDC_TYPE, z as USDE_TYPE, H as USDSUI_TYPE, J as USDT_TYPE, W as WAL_TYPE, Q as WBTC_TYPE, R as ZkLoginSigner, V as addCollectFeeToTx, aq as assertAllowedAsset, X as calculateFee, Y as executeAutoTopUp, _ as executeWithGas, $ as formatAssetAmount, a0 as formatSui, a1 as formatUsd, a2 as getDecimals, a3 as getDecimalsForCoinType, a4 as getGasStatus, a5 as getTier, ar as isAllowedAsset, a6 as isSupported, a7 as isTier1, a8 as isTier2, a9 as mapMoveAbortCode, aa as mapWalletError, ab as mistToSui, ac as rawToStable, ad as rawToUsdc, ae as resolveSymbol, af as resolveTokenType, ag as shouldAutoTopUp, as as simulateTransaction, ah as stableToRaw, ai as suiToMist, at as throwIfSimulationFailed, aj as truncateAddress, ak as usdcToRaw, al as validateAddress } from './token-registry-bf_caDsv.cjs';
+import { T as T2000Error, am as SafeguardEnforcer, w as TransactionSigner, Z as ZkLoginProof, s as SupportedAsset, an as AllowanceFeature } from './token-registry-DDy743E6.cjs';
+export { ao as ALLOWANCE_FEATURES, A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, ap as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as CoinMeta, D as DEFAULT_NETWORK, d as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, F as FeeOperation, G as GAS_RESERVE_MIN, e as GasExecutionResult, f as GasRequestType, g as GasSponsorResponse, h as GasStatusResponse, I as IKA_TYPE, K as KeypairSigner, L as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, aq as OPERATION_ASSETS, O as OUTBOUND_OPS, ar as Operation, P as ProtocolFeeInfo, S as STABLE_ASSETS, j as SUI_DECIMALS, k as SUI_TYPE, l as SUPPORTED_ASSETS, m as SafeguardConfig, n as SafeguardError, o as SafeguardErrorDetails, p as SafeguardRule, q as SimulationResult, r as StableAsset, t as T2000ErrorCode, u as T2000ErrorData, v as TOKEN_MAP, x as TxMetadata, U as USDC_DECIMALS, y as USDC_TYPE, z as USDE_TYPE, H as USDSUI_TYPE, J as USDT_TYPE, W as WAL_TYPE, Q as WBTC_TYPE, R as ZkLoginSigner, V as addCollectFeeToTx, as as assertAllowedAsset, X as calculateFee, Y as executeAutoTopUp, _ as executeWithGas, $ as formatAssetAmount, a0 as formatSui, a1 as formatUsd, a2 as getDecimals, a3 as getDecimalsForCoinType, a4 as getGasStatus, a5 as getTier, at as isAllowedAsset, a6 as isSupported, a7 as isTier1, a8 as isTier2, a9 as mapMoveAbortCode, aa as mapWalletError, ab as mistToSui, ac as rawToStable, ad as rawToUsdc, ae as resolveSymbol, af as resolveTokenType, ag as shouldAutoTopUp, au as simulateTransaction, ah as stableToRaw, ai as suiToMist, av as throwIfSimulationFailed, aj as truncateAddress, ak as usdcToRaw, al as validateAddress } from './token-registry-DDy743E6.cjs';
 import { L as LendingAdapter, a as LendingRates } from './descriptors-Be4FAgN5.cjs';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, P as ProtocolDescriptor, d as allDescriptors, n as naviDescriptor } from './descriptors-Be4FAgN5.cjs';
-import { j as T2000Options, P as PayOptions, d as PayResult, k as StakeVSuiResult, U as UnstakeVSuiResult, l as SwapResult, m as SwapQuoteResult, i as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, S as SaveResult, W as WithdrawResult, c as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult } from './types-XWEUAS-X.cjs';
-export { A as AssetRates, G as GasMethod, b as GasReserve, f as PositionEntry } from './types-XWEUAS-X.cjs';
-import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
+import { j as T2000Options, P as PayOptions, d as PayResult, k as StakeVSuiResult, U as UnstakeVSuiResult, l as SwapResult, m as SwapQuoteResult, i as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, S as SaveResult, W as WithdrawResult, c as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, n as AllowanceInfo, o as FinancialSummary } from './types-DT-3gVTX.cjs';
+export { p as AllowanceCreateResult, q as AllowanceDeductResult, r as AllowanceDepositResult, s as AllowanceWithdrawResult, A as AssetRates, G as GasMethod, b as GasReserve, t as HFAlertLevel, f as PositionEntry } from './types-DT-3gVTX.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.cjs';
 
 interface Contact {
@@ -203,6 +203,67 @@ declare function getAddress(keypair: Ed25519Keypair): string;
 
 declare function solveHashcash(challenge: string): string;
 
+interface CreateAllowanceOptions {
+    permittedFeatures?: bigint;
+    expiresAt?: bigint;
+    dailyLimit?: bigint;
+}
+/**
+ * Build a PTB that creates a new shared Allowance<USDC> for the signer.
+ */
+declare function buildCreateAllowanceTx(options?: CreateAllowanceOptions): Transaction;
+/**
+ * Add an owner deposit call to an existing PTB.
+ * The caller must provide a coin reference (e.g. from `tx.splitCoins`).
+ */
+declare function addDepositAllowanceTx(tx: Transaction, allowanceId: string, paymentCoin: TransactionObjectArgument): void;
+/**
+ * Build a standalone deposit PTB that splits `amount` (raw USDC) from
+ * the given USDC coin and deposits into the allowance.
+ */
+declare function buildDepositAllowanceTx(allowanceId: string, usdcCoin: string, amount: bigint): Transaction;
+/**
+ * Build an admin-sponsored deposit PTB. Requires AdminCap in the signer's wallet.
+ */
+declare function buildAdminDepositAllowanceTx(allowanceId: string, usdcCoin: string, amount: bigint): Transaction;
+/**
+ * Build a deduct PTB. Only callable by the AdminCap holder (server/cron).
+ * Enforces on-chain: feature permission, expiry, daily limit.
+ */
+declare function buildDeductAllowanceTx(allowanceId: string, amount: bigint, feature: AllowanceFeature): Transaction;
+/**
+ * Build a full-withdrawal PTB. Returns entire remaining balance to the owner.
+ */
+declare function buildWithdrawAllowanceTx(allowanceId: string): Transaction;
+/**
+ * Build a partial-withdrawal PTB. Returns `amount` (raw USDC) to the owner.
+ */
+declare function buildWithdrawAmountAllowanceTx(allowanceId: string, amount: bigint): Transaction;
+/**
+ * Fetch the full allowance state from an on-chain Allowance<T> shared object.
+ */
+declare function getAllowance(client: SuiJsonRpcClient, allowanceId: string): Promise<AllowanceInfo>;
+/**
+ * Shorthand: get just the USDC balance of an allowance.
+ */
+declare function getAllowanceBalance(client: SuiJsonRpcClient, allowanceId: string): Promise<bigint>;
+
+declare const HF_WARN_THRESHOLD = 1.8;
+declare const HF_CRITICAL_THRESHOLD = 1.3;
+interface FinancialSummaryOptions {
+    allowanceId?: string;
+}
+/**
+ * Fetch a complete financial snapshot for one wallet in parallel.
+ * Designed for the notification cron — one call returns everything
+ * a briefing, HF alert, or rate alert needs.
+ *
+ * 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>;
 
 declare function getSwapQuote(params: {
@@ -275,4 +336,48 @@ declare function buildStakeVSuiTx(_client: SuiJsonRpcClient, address: string, am
  */
 declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, amountMist: bigint | 'all'): Promise<Transaction>;
 
-export { BalanceResponse, BorrowResult, ClaimRewardsResult, ContactManager, DepositInfo, EarningsResult, FundStatusResult, HealthFactorResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, PayOptions, PayResult, PendingReward, PositionsResult, RatesResult, RepayResult, SafeguardEnforcer, SaveResult, SendResult, StakeVSuiResult, SupportedAsset, SwapQuoteResult, SwapResult, type SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStats, WithdrawResult, ZkLoginProof, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, exportPrivateKey, findSwapRoute, generateKeypair, getAddress, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, saveKey, solveHashcash, walletExists };
+/**
+ * Short-lived signed authorization for a single autonomous cron execution.
+ * Built off-chain, verified off-chain before any on-chain PTB is constructed.
+ *
+ * Security properties:
+ * - 60s TTL (configurable) — expired intents rejected before execution
+ * - Single-use nonce — stored in IntentLog, duplicate rejected immediately
+ * - Ed25519 signature by admin key — tamper-proof envelope
+ * - maxAmount ceiling — PTB builder must not exceed this
+ */
+interface ScopedIntent {
+    version: 1;
+    userId: string;
+    walletAddress: string;
+    allowanceObjectId: string;
+    featureCode: AllowanceFeature;
+    maxAmount: number;
+    issuedAt: number;
+    expiresAt: number;
+    nonce: string;
+    signature: string;
+}
+type ScopedIntentPayload = Omit<ScopedIntent, 'signature'>;
+
+interface BuildIntentParams {
+    userId: string;
+    walletAddress: string;
+    allowanceObjectId: string;
+    featureCode: AllowanceFeature;
+    maxAmount: number;
+    ttlMs?: number;
+}
+/**
+ * Build a ScopedIntent signed by the admin keypair.
+ * Generates a cryptographically random 32-byte nonce and signs the canonical payload.
+ */
+declare function buildScopedIntent(adminKeypair: Ed25519Keypair, params: BuildIntentParams): Promise<ScopedIntent>;
+/**
+ * Verify a ScopedIntent:
+ * 1. Check TTL — reject expired intents immediately (fast path)
+ * 2. Verify Ed25519 signature over canonical payload
+ */
+declare function verifyScopedIntent(intent: ScopedIntent, adminPublicKeyBytes: Uint8Array): Promise<boolean>;
+
+export { AllowanceFeature, AllowanceInfo, BalanceResponse, BorrowResult, type BuildIntentParams, ClaimRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, HealthFactorResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, PayOptions, PayResult, PendingReward, PositionsResult, RatesResult, RepayResult, SafeguardEnforcer, SaveResult, type ScopedIntent, type ScopedIntentPayload, SendResult, StakeVSuiResult, SupportedAsset, SwapQuoteResult, SwapResult, type SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStats, WithdrawResult, ZkLoginProof, addDepositAllowanceTx, buildAdminDepositAllowanceTx, buildCreateAllowanceTx, buildDeductAllowanceTx, buildDepositAllowanceTx, buildScopedIntent, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, buildWithdrawAllowanceTx, buildWithdrawAmountAllowanceTx, exportPrivateKey, findSwapRoute, generateKeypair, getAddress, getAllowance, getAllowanceBalance, getFinancialSummary, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, saveKey, solveHashcash, verifyScopedIntent, walletExists };

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { T as T2000Error, am as SafeguardEnforcer, w as TransactionSigner, Z as ZkLoginProof, s as SupportedAsset } from './token-registry-DLEKjV8I.js';
-export { A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, an as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as CoinMeta, D as DEFAULT_NETWORK, d as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, F as FeeOperation, G as GAS_RESERVE_MIN, e as GasExecutionResult, f as GasRequestType, g as GasSponsorResponse, h as GasStatusResponse, I as IKA_TYPE, K as KeypairSigner, L as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, ao as OPERATION_ASSETS, O as OUTBOUND_OPS, ap as Operation, P as ProtocolFeeInfo, S as STABLE_ASSETS, j as SUI_DECIMALS, k as SUI_TYPE, l as SUPPORTED_ASSETS, m as SafeguardConfig, n as SafeguardError, o as SafeguardErrorDetails, p as SafeguardRule, q as SimulationResult, r as StableAsset, t as T2000ErrorCode, u as T2000ErrorData, v as TOKEN_MAP, x as TxMetadata, U as USDC_DECIMALS, y as USDC_TYPE, z as USDE_TYPE, H as USDSUI_TYPE, J as USDT_TYPE, W as WAL_TYPE, Q as WBTC_TYPE, R as ZkLoginSigner, V as addCollectFeeToTx, aq as assertAllowedAsset, X as calculateFee, Y as executeAutoTopUp, _ as executeWithGas, $ as formatAssetAmount, a0 as formatSui, a1 as formatUsd, a2 as getDecimals, a3 as getDecimalsForCoinType, a4 as getGasStatus, a5 as getTier, ar as isAllowedAsset, a6 as isSupported, a7 as isTier1, a8 as isTier2, a9 as mapMoveAbortCode, aa as mapWalletError, ab as mistToSui, ac as rawToStable, ad as rawToUsdc, ae as resolveSymbol, af as resolveTokenType, ag as shouldAutoTopUp, as as simulateTransaction, ah as stableToRaw, ai as suiToMist, at as throwIfSimulationFailed, aj as truncateAddress, ak as usdcToRaw, al as validateAddress } from './token-registry-DLEKjV8I.js';
+import { T as T2000Error, am as SafeguardEnforcer, w as TransactionSigner, Z as ZkLoginProof, s as SupportedAsset, an as AllowanceFeature } from './token-registry-Bv1I9qeU.js';
+export { ao as ALLOWANCE_FEATURES, A as ALL_NAVI_ASSETS, a as AutoTopUpResult, B as BPS_DENOMINATOR, ap as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as CoinMeta, D as DEFAULT_NETWORK, d as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, F as FeeOperation, G as GAS_RESERVE_MIN, e as GasExecutionResult, f as GasRequestType, g as GasSponsorResponse, h as GasStatusResponse, I as IKA_TYPE, K as KeypairSigner, L as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, aq as OPERATION_ASSETS, O as OUTBOUND_OPS, ar as Operation, P as ProtocolFeeInfo, S as STABLE_ASSETS, j as SUI_DECIMALS, k as SUI_TYPE, l as SUPPORTED_ASSETS, m as SafeguardConfig, n as SafeguardError, o as SafeguardErrorDetails, p as SafeguardRule, q as SimulationResult, r as StableAsset, t as T2000ErrorCode, u as T2000ErrorData, v as TOKEN_MAP, x as TxMetadata, U as USDC_DECIMALS, y as USDC_TYPE, z as USDE_TYPE, H as USDSUI_TYPE, J as USDT_TYPE, W as WAL_TYPE, Q as WBTC_TYPE, R as ZkLoginSigner, V as addCollectFeeToTx, as as assertAllowedAsset, X as calculateFee, Y as executeAutoTopUp, _ as executeWithGas, $ as formatAssetAmount, a0 as formatSui, a1 as formatUsd, a2 as getDecimals, a3 as getDecimalsForCoinType, a4 as getGasStatus, a5 as getTier, at as isAllowedAsset, a6 as isSupported, a7 as isTier1, a8 as isTier2, a9 as mapMoveAbortCode, aa as mapWalletError, ab as mistToSui, ac as rawToStable, ad as rawToUsdc, ae as resolveSymbol, af as resolveTokenType, ag as shouldAutoTopUp, au as simulateTransaction, ah as stableToRaw, ai as suiToMist, av as throwIfSimulationFailed, aj as truncateAddress, ak as usdcToRaw, al as validateAddress } from './token-registry-Bv1I9qeU.js';
 import { L as LendingAdapter, a as LendingRates } from './descriptors-Be4FAgN5.js';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, P as ProtocolDescriptor, d as allDescriptors, n as naviDescriptor } from './descriptors-Be4FAgN5.js';
-import { j as T2000Options, P as PayOptions, d as PayResult, k as StakeVSuiResult, U as UnstakeVSuiResult, l as SwapResult, m as SwapQuoteResult, i as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, S as SaveResult, W as WithdrawResult, c as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult } from './types-XWEUAS-X.js';
-export { A as AssetRates, G as GasMethod, b as GasReserve, f as PositionEntry } from './types-XWEUAS-X.js';
-import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
+import { j as T2000Options, P as PayOptions, d as PayResult, k as StakeVSuiResult, U as UnstakeVSuiResult, l as SwapResult, m as SwapQuoteResult, i as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, S as SaveResult, W as WithdrawResult, c as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, n as AllowanceInfo, o as FinancialSummary } from './types-DT-3gVTX.js';
+export { p as AllowanceCreateResult, q as AllowanceDeductResult, r as AllowanceDepositResult, s as AllowanceWithdrawResult, A as AssetRates, G as GasMethod, b as GasReserve, t as HFAlertLevel, f as PositionEntry } from './types-DT-3gVTX.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.js';
 
 interface Contact {
@@ -203,6 +203,67 @@ declare function getAddress(keypair: Ed25519Keypair): string;
 
 declare function solveHashcash(challenge: string): string;
 
+interface CreateAllowanceOptions {
+    permittedFeatures?: bigint;
+    expiresAt?: bigint;
+    dailyLimit?: bigint;
+}
+/**
+ * Build a PTB that creates a new shared Allowance<USDC> for the signer.
+ */
+declare function buildCreateAllowanceTx(options?: CreateAllowanceOptions): Transaction;
+/**
+ * Add an owner deposit call to an existing PTB.
+ * The caller must provide a coin reference (e.g. from `tx.splitCoins`).
+ */
+declare function addDepositAllowanceTx(tx: Transaction, allowanceId: string, paymentCoin: TransactionObjectArgument): void;
+/**
+ * Build a standalone deposit PTB that splits `amount` (raw USDC) from
+ * the given USDC coin and deposits into the allowance.
+ */
+declare function buildDepositAllowanceTx(allowanceId: string, usdcCoin: string, amount: bigint): Transaction;
+/**
+ * Build an admin-sponsored deposit PTB. Requires AdminCap in the signer's wallet.
+ */
+declare function buildAdminDepositAllowanceTx(allowanceId: string, usdcCoin: string, amount: bigint): Transaction;
+/**
+ * Build a deduct PTB. Only callable by the AdminCap holder (server/cron).
+ * Enforces on-chain: feature permission, expiry, daily limit.
+ */
+declare function buildDeductAllowanceTx(allowanceId: string, amount: bigint, feature: AllowanceFeature): Transaction;
+/**
+ * Build a full-withdrawal PTB. Returns entire remaining balance to the owner.
+ */
+declare function buildWithdrawAllowanceTx(allowanceId: string): Transaction;
+/**
+ * Build a partial-withdrawal PTB. Returns `amount` (raw USDC) to the owner.
+ */
+declare function buildWithdrawAmountAllowanceTx(allowanceId: string, amount: bigint): Transaction;
+/**
+ * Fetch the full allowance state from an on-chain Allowance<T> shared object.
+ */
+declare function getAllowance(client: SuiJsonRpcClient, allowanceId: string): Promise<AllowanceInfo>;
+/**
+ * Shorthand: get just the USDC balance of an allowance.
+ */
+declare function getAllowanceBalance(client: SuiJsonRpcClient, allowanceId: string): Promise<bigint>;
+
+declare const HF_WARN_THRESHOLD = 1.8;
+declare const HF_CRITICAL_THRESHOLD = 1.3;
+interface FinancialSummaryOptions {
+    allowanceId?: string;
+}
+/**
+ * Fetch a complete financial snapshot for one wallet in parallel.
+ * Designed for the notification cron — one call returns everything
+ * a briefing, HF alert, or rate alert needs.
+ *
+ * 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>;
 
 declare function getSwapQuote(params: {
@@ -275,4 +336,48 @@ declare function buildStakeVSuiTx(_client: SuiJsonRpcClient, address: string, am
  */
 declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, amountMist: bigint | 'all'): Promise<Transaction>;
 
-export { BalanceResponse, BorrowResult, ClaimRewardsResult, ContactManager, DepositInfo, EarningsResult, FundStatusResult, HealthFactorResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, PayOptions, PayResult, PendingReward, PositionsResult, RatesResult, RepayResult, SafeguardEnforcer, SaveResult, SendResult, StakeVSuiResult, SupportedAsset, SwapQuoteResult, SwapResult, type SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStats, WithdrawResult, ZkLoginProof, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, exportPrivateKey, findSwapRoute, generateKeypair, getAddress, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, saveKey, solveHashcash, walletExists };
+/**
+ * Short-lived signed authorization for a single autonomous cron execution.
+ * Built off-chain, verified off-chain before any on-chain PTB is constructed.
+ *
+ * Security properties:
+ * - 60s TTL (configurable) — expired intents rejected before execution
+ * - Single-use nonce — stored in IntentLog, duplicate rejected immediately
+ * - Ed25519 signature by admin key — tamper-proof envelope
+ * - maxAmount ceiling — PTB builder must not exceed this
+ */
+interface ScopedIntent {
+    version: 1;
+    userId: string;
+    walletAddress: string;
+    allowanceObjectId: string;
+    featureCode: AllowanceFeature;
+    maxAmount: number;
+    issuedAt: number;
+    expiresAt: number;
+    nonce: string;
+    signature: string;
+}
+type ScopedIntentPayload = Omit<ScopedIntent, 'signature'>;
+
+interface BuildIntentParams {
+    userId: string;
+    walletAddress: string;
+    allowanceObjectId: string;
+    featureCode: AllowanceFeature;
+    maxAmount: number;
+    ttlMs?: number;
+}
+/**
+ * Build a ScopedIntent signed by the admin keypair.
+ * Generates a cryptographically random 32-byte nonce and signs the canonical payload.
+ */
+declare function buildScopedIntent(adminKeypair: Ed25519Keypair, params: BuildIntentParams): Promise<ScopedIntent>;
+/**
+ * Verify a ScopedIntent:
+ * 1. Check TTL — reject expired intents immediately (fast path)
+ * 2. Verify Ed25519 signature over canonical payload
+ */
+declare function verifyScopedIntent(intent: ScopedIntent, adminPublicKeyBytes: Uint8Array): Promise<boolean>;
+
+export { AllowanceFeature, AllowanceInfo, BalanceResponse, BorrowResult, type BuildIntentParams, ClaimRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, HealthFactorResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, PayOptions, PayResult, PendingReward, PositionsResult, RatesResult, RepayResult, SafeguardEnforcer, SaveResult, type ScopedIntent, type ScopedIntentPayload, SendResult, StakeVSuiResult, SupportedAsset, SwapQuoteResult, SwapResult, type SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStats, WithdrawResult, ZkLoginProof, addDepositAllowanceTx, buildAdminDepositAllowanceTx, buildCreateAllowanceTx, buildDeductAllowanceTx, buildDepositAllowanceTx, buildScopedIntent, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, buildWithdrawAllowanceTx, buildWithdrawAmountAllowanceTx, exportPrivateKey, findSwapRoute, generateKeypair, getAddress, getAllowance, getAllowanceBalance, getFinancialSummary, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, saveKey, solveHashcash, verifyScopedIntent, walletExists };

package/dist/index.js

@@ -3,7 +3,7 @@ import { AggregatorClient, Env } from '@cetusprotocol/aggregator-sdk';
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { normalizeSuiAddress, isValidSuiAddress } from '@mysten/sui/utils';
-import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import { Ed25519Keypair, Ed25519PublicKey } from '@mysten/sui/keypairs/ed25519';
 import { decodeSuiPrivateKey } from '@mysten/sui/cryptography';
 import { createHash, randomBytes, createCipheriv, createDecipheriv, scryptSync } from 'crypto';
 import { access, mkdir, writeFile, readFile } from 'fs/promises';
@@ -488,15 +488,27 @@ function assertAllowedAsset(op, asset) {
     );
   }
 }
-var T2000_PACKAGE_ID = process.env.T2000_PACKAGE_ID ?? "0xab92e9f1fe549ad3d6a52924a73181b45791e76120b975138fac9ec9b75db9f3";
-var T2000_CONFIG_ID = process.env.T2000_CONFIG_ID ?? "0x408add9aa9322f93cfd87523d8f603006eb8713894f4c460283c58a6888dae8a";
-var T2000_TREASURY_ID = process.env.T2000_TREASURY_ID ?? "0x3bb501b8300125dca59019247941a42af6b292a150ce3cfcce9449456be2ec91";
+var T2000_PACKAGE_ID = process.env.T2000_PACKAGE_ID ?? "0xd775fcc66eae26797654d435d751dea56b82eeb999de51fd285348e573b968ad";
+var T2000_CONFIG_ID = process.env.T2000_CONFIG_ID ?? "0x08ba26f0d260b5edf6a19c71492b3eb914906a7419baf2df1426765157e5862a";
+var T2000_ADMIN_CAP_ID = "0xa97bfff140f5a2c268a03fe5422d382c228057deb7bcfdaf2967ca18b9bdbbd9";
+var T2000_TREASURY_ID = process.env.T2000_TREASURY_ID ?? "0xf420ec0dcad44433042fb56e1413fb88d3ff65be94fcf425ef9ff750164590e8";
 var DEFAULT_NETWORK = "mainnet";
 var DEFAULT_RPC_URL = "https://fullnode.mainnet.sui.io:443";
 var DEFAULT_KEY_PATH = "~/.t2000/wallet.key";
 var API_BASE_URL = process.env.T2000_API_URL ?? "https://api.t2000.ai";
 var CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
 var GAS_RESERVE_MIN = 0.05;
+var ALLOWANCE_FEATURES = {
+  BRIEFING: 0,
+  YIELD_ALERT: 1,
+  PAYMENT_ALERT: 2,
+  ACTION_REMIND: 3,
+  SESSION: 4,
+  AUTO_COMPOUND: 5,
+  DCA: 6,
+  HF_ALERT: 7
+};
+var FEATURES_ALL = 255;
 
 // src/utils/sui.ts
 init_errors();
@@ -3261,6 +3273,190 @@ async function callUsdcSponsorApi(address) {
 
 // src/index.ts
 init_errors();
+var USDC_TYPE2 = SUPPORTED_ASSETS.USDC.type;
+function buildCreateAllowanceTx(options = {}) {
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${T2000_PACKAGE_ID}::allowance::create`,
+    typeArguments: [USDC_TYPE2],
+    arguments: [
+      tx.pure.u64(options.permittedFeatures ?? BigInt(FEATURES_ALL)),
+      tx.pure.u64(options.expiresAt ?? 0n),
+      tx.pure.u64(options.dailyLimit ?? 0n),
+      tx.object(CLOCK_ID)
+    ]
+  });
+  return tx;
+}
+function addDepositAllowanceTx(tx, allowanceId, paymentCoin) {
+  tx.moveCall({
+    target: `${T2000_PACKAGE_ID}::allowance::deposit`,
+    typeArguments: [USDC_TYPE2],
+    arguments: [tx.object(allowanceId), paymentCoin]
+  });
+}
+function buildDepositAllowanceTx(allowanceId, usdcCoin, amount) {
+  const tx = new Transaction();
+  const [split] = tx.splitCoins(tx.object(usdcCoin), [tx.pure.u64(amount)]);
+  addDepositAllowanceTx(tx, allowanceId, split);
+  return tx;
+}
+function buildAdminDepositAllowanceTx(allowanceId, usdcCoin, amount) {
+  const tx = new Transaction();
+  const [split] = tx.splitCoins(tx.object(usdcCoin), [tx.pure.u64(amount)]);
+  tx.moveCall({
+    target: `${T2000_PACKAGE_ID}::allowance::admin_deposit`,
+    typeArguments: [USDC_TYPE2],
+    arguments: [
+      tx.object(allowanceId),
+      tx.object(T2000_ADMIN_CAP_ID),
+      split
+    ]
+  });
+  return tx;
+}
+function buildDeductAllowanceTx(allowanceId, amount, feature) {
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${T2000_PACKAGE_ID}::allowance::deduct`,
+    typeArguments: [USDC_TYPE2],
+    arguments: [
+      tx.object(allowanceId),
+      tx.object(T2000_CONFIG_ID),
+      tx.object(T2000_ADMIN_CAP_ID),
+      tx.pure.u64(amount),
+      tx.pure.u8(feature),
+      tx.object(CLOCK_ID)
+    ]
+  });
+  return tx;
+}
+function buildWithdrawAllowanceTx(allowanceId) {
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${T2000_PACKAGE_ID}::allowance::withdraw`,
+    typeArguments: [USDC_TYPE2],
+    arguments: [tx.object(allowanceId)]
+  });
+  return tx;
+}
+function buildWithdrawAmountAllowanceTx(allowanceId, amount) {
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${T2000_PACKAGE_ID}::allowance::withdraw_amount`,
+    typeArguments: [USDC_TYPE2],
+    arguments: [tx.object(allowanceId), tx.pure.u64(amount)]
+  });
+  return tx;
+}
+async function getAllowance(client, allowanceId) {
+  const obj = await client.getObject({
+    id: allowanceId,
+    options: { showContent: true, showType: true }
+  });
+  if (!obj.data?.content || obj.data.content.dataType !== "moveObject") {
+    throw new Error(`Allowance ${allowanceId} not found or is not a Move object`);
+  }
+  const fields = obj.data.content.fields;
+  const coinType = extractCoinType(obj.data.content.type);
+  return {
+    id: allowanceId,
+    owner: fields.owner,
+    balance: parseU64Field(fields.balance),
+    totalDeposited: parseU64Field(fields.total_deposited),
+    totalSpent: parseU64Field(fields.total_spent),
+    createdAt: Number(fields.created_at),
+    coinType,
+    permittedFeatures: parseU64Field(fields.permitted_features),
+    expiresAt: Number(fields.expires_at),
+    dailyLimit: parseU64Field(fields.daily_limit),
+    dailySpent: parseU64Field(fields.daily_spent),
+    windowStart: Number(fields.window_start)
+  };
+}
+async function getAllowanceBalance(client, allowanceId) {
+  const info = await getAllowance(client, allowanceId);
+  return info.balance;
+}
+function parseU64Field(raw) {
+  if (typeof raw === "string" || typeof raw === "number") return BigInt(raw);
+  if (typeof raw === "object" && raw !== null && "value" in raw) {
+    return BigInt(raw.value);
+  }
+  return 0n;
+}
+function extractCoinType(objectType) {
+  const match = objectType.match(/<(.+)>/);
+  return match ? match[1] : "unknown";
+}
+
+// src/protocols/financialSummary.ts
+var HF_WARN_THRESHOLD = 1.8;
+var HF_CRITICAL_THRESHOLD = 1.3;
+var HF_FALLBACK = {
+  healthFactor: Infinity,
+  supplied: 0,
+  borrowed: 0,
+  maxBorrow: 0,
+  liquidationThreshold: 0.75
+};
+function classifyHF(hf, hasBorrow) {
+  if (!hasBorrow || !Number.isFinite(hf)) return "none";
+  if (hf <= HF_CRITICAL_THRESHOLD) return "critical";
+  if (hf <= HF_WARN_THRESHOLD) return "warn";
+  return "none";
+}
+async function fetchSuiPriceUsd(client) {
+  try {
+    const pool = await client.getObject({
+      id: CETUS_USDC_SUI_POOL,
+      options: { showContent: true }
+    });
+    if (pool.data?.content?.dataType === "moveObject") {
+      const fields = pool.data.content.fields;
+      const sqrtPrice = BigInt(String(fields.current_sqrt_price ?? "0"));
+      if (sqrtPrice > 0n) {
+        const Q64 = 2n ** 64n;
+        const sqrtFloat = Number(sqrtPrice) / Number(Q64);
+        const price = 1e3 / (sqrtFloat * sqrtFloat);
+        if (price > 0.01 && price < 1e3) return price;
+      }
+    }
+  } catch {
+  }
+  return 1;
+}
+async function getFinancialSummary(client, walletAddress, options = {}) {
+  const [usdcBal, suiBal, hf, rates, suiPrice, allowance] = await Promise.all([
+    client.getBalance({ owner: walletAddress, coinType: SUPPORTED_ASSETS.USDC.type }).catch(() => ({ totalBalance: "0" })),
+    client.getBalance({ owner: walletAddress, coinType: SUPPORTED_ASSETS.SUI.type }).catch(() => ({ totalBalance: "0" })),
+    getHealthFactor(client, walletAddress).catch(() => HF_FALLBACK),
+    getRates(client),
+    fetchSuiPriceUsd(client),
+    options.allowanceId ? getAllowanceBalance(client, options.allowanceId).catch(() => null) : Promise.resolve(null)
+  ]);
+  const usdcAvailable = Number(usdcBal.totalBalance) / 10 ** SUPPORTED_ASSETS.USDC.decimals;
+  const gasReserveSui = Number(suiBal.totalBalance) / Number(MIST_PER_SUI);
+  const saveApy = rates.USDC?.saveApy ?? 0;
+  const borrowApy = rates.USDC?.borrowApy ?? 0;
+  const dailyYield = hf.supplied * (saveApy / 365);
+  return {
+    walletAddress,
+    usdcAvailable,
+    savingsBalance: hf.supplied,
+    debtBalance: hf.borrowed,
+    idleUsdc: Math.max(0, usdcAvailable),
+    healthFactor: hf.healthFactor,
+    hfAlertLevel: classifyHF(hf.healthFactor, hf.borrowed > 0),
+    saveApy,
+    borrowApy,
+    dailyYield,
+    gasReserveSui,
+    gasReserveUsd: gasReserveSui * suiPrice,
+    allowanceBalance: allowance,
+    fetchedAt: Date.now()
+  };
+}
 
 // src/utils/simulate.ts
 init_errors();
@@ -3372,7 +3568,59 @@ async function getSwapQuote(params) {
 init_cetus_swap();
 init_token_registry();
 init_volo();
+var DEFAULT_TTL_MS = 6e4;
+async function buildScopedIntent(adminKeypair, params) {
+  const now = Date.now();
+  const nonceBytes = new Uint8Array(32);
+  crypto.getRandomValues(nonceBytes);
+  const nonce = Buffer.from(nonceBytes).toString("hex");
+  const payload = {
+    version: 1,
+    userId: params.userId,
+    walletAddress: params.walletAddress,
+    allowanceObjectId: params.allowanceObjectId,
+    featureCode: params.featureCode,
+    maxAmount: params.maxAmount,
+    issuedAt: now,
+    expiresAt: now + (params.ttlMs ?? DEFAULT_TTL_MS),
+    nonce
+  };
+  const message = canonicalIntentBytes(payload);
+  const signature = await adminKeypair.sign(message);
+  return {
+    ...payload,
+    signature: Buffer.from(signature).toString("hex")
+  };
+}
+async function verifyScopedIntent(intent, adminPublicKeyBytes) {
+  if (Date.now() > intent.expiresAt) return false;
+  const payload = {
+    version: intent.version,
+    userId: intent.userId,
+    walletAddress: intent.walletAddress,
+    allowanceObjectId: intent.allowanceObjectId,
+    featureCode: intent.featureCode,
+    maxAmount: intent.maxAmount,
+    issuedAt: intent.issuedAt,
+    expiresAt: intent.expiresAt,
+    nonce: intent.nonce
+  };
+  const message = canonicalIntentBytes(payload);
+  const signatureBytes = Buffer.from(intent.signature, "hex");
+  try {
+    const publicKey = new Ed25519PublicKey(adminPublicKeyBytes);
+    return await publicKey.verify(message, signatureBytes);
+  } catch {
+    return false;
+  }
+}
+function canonicalIntentBytes(payload) {
+  const sorted = Object.fromEntries(
+    Object.entries(payload).sort(([a], [b]) => a.localeCompare(b))
+  );
+  return new TextEncoder().encode(JSON.stringify(sorted));
+}
 
-export { ALL_NAVI_ASSETS, BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, ETH_TYPE, GAS_RESERVE_MIN, IKA_TYPE, KeypairSigner, LOFI_TYPE, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, NaviAdapter, OPERATION_ASSETS, OUTBOUND_OPS, ProtocolRegistry, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, WAL_TYPE, WBTC_TYPE, ZkLoginSigner, addCollectFeeToTx, allDescriptors, assertAllowedAsset, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, findSwapRoute, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getDecimalsForCoinType, getGasStatus, getRates, getSwapQuote, getTier, getVoloStats, isAllowedAsset, isSupported, isTier1, isTier2, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, rawToStable, rawToUsdc, resolveSymbol, resolveTokenType, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };
+export { ALLOWANCE_FEATURES, ALL_NAVI_ASSETS, BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, ETH_TYPE, GAS_RESERVE_MIN, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, IKA_TYPE, KeypairSigner, LOFI_TYPE, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, NaviAdapter, OPERATION_ASSETS, OUTBOUND_OPS, ProtocolRegistry, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, WAL_TYPE, WBTC_TYPE, ZkLoginSigner, addCollectFeeToTx, addDepositAllowanceTx, allDescriptors, assertAllowedAsset, buildAdminDepositAllowanceTx, buildCreateAllowanceTx, buildDeductAllowanceTx, buildDepositAllowanceTx, buildScopedIntent, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, buildWithdrawAllowanceTx, buildWithdrawAmountAllowanceTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, findSwapRoute, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getAllowance, getAllowanceBalance, getDecimals, getDecimalsForCoinType, getFinancialSummary, getGasStatus, getRates, getSwapQuote, getTier, getVoloStats, isAllowedAsset, isSupported, isTier1, isTier2, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, rawToStable, rawToUsdc, resolveSymbol, resolveTokenType, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, verifyScopedIntent, walletExists };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map