@axonfi/sdk 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -1,5 +1,340 @@
-import { Address, Hex, WalletClient, PublicClient, Chain } from 'viem';
+import { Address, Hex, WalletClient, PublicClient, Chain as Chain$1 } from 'viem';
 
+declare enum Token {
+    USDC = "USDC",
+    USDT = "USDT",
+    DAI = "DAI",
+    WETH = "WETH",
+    WBTC = "WBTC",
+    cbBTC = "cbBTC",
+    cbETH = "cbETH",
+    wstETH = "wstETH",
+    rETH = "rETH",
+    LINK = "LINK",
+    UNI = "UNI",
+    AAVE = "AAVE",
+    COMP = "COMP",
+    CRV = "CRV",
+    SNX = "SNX",
+    ARB = "ARB",
+    AERO = "AERO",
+    GMX = "GMX"
+}
+interface KnownToken {
+    symbol: string;
+    name: string;
+    decimals: number;
+    /** Address per chainId. Missing key = not available on that chain. */
+    addresses: Partial<Record<number, Address>>;
+}
+/**
+ * Master token registry keyed by symbol.
+ * At a glance you see which chains each token lives on.
+ *
+ * Chain IDs: 8453 = Base, 84532 = Base Sepolia, 42161 = Arbitrum One, 421614 = Arbitrum Sepolia
+ */
+declare const KNOWN_TOKENS: {
+    readonly USDC: {
+        readonly symbol: "USDC";
+        readonly name: "USD Coin";
+        readonly decimals: 6;
+        readonly addresses: {
+            readonly 8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+            readonly 84532: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+            readonly 42161: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+            readonly 421614: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+        };
+    };
+    readonly USDT: {
+        readonly symbol: "USDT";
+        readonly name: "Tether USD";
+        readonly decimals: 6;
+        readonly addresses: {
+            readonly 8453: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2";
+            readonly 42161: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9";
+        };
+    };
+    readonly DAI: {
+        readonly symbol: "DAI";
+        readonly name: "Dai Stablecoin";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb";
+            readonly 84532: "0x819ffecd4e64f193e959944bcd57eedc7755e17a";
+            readonly 42161: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1";
+        };
+    };
+    readonly WETH: {
+        readonly symbol: "WETH";
+        readonly name: "Wrapped Ether";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x4200000000000000000000000000000000000006";
+            readonly 84532: "0x4200000000000000000000000000000000000006";
+            readonly 42161: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1";
+        };
+    };
+    readonly WBTC: {
+        readonly symbol: "WBTC";
+        readonly name: "Wrapped BTC";
+        readonly decimals: 8;
+        readonly addresses: {
+            readonly 8453: "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c";
+            readonly 42161: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f";
+        };
+    };
+    readonly cbBTC: {
+        readonly symbol: "cbBTC";
+        readonly name: "Coinbase Wrapped BTC";
+        readonly decimals: 8;
+        readonly addresses: {
+            readonly 8453: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
+            readonly 42161: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
+        };
+    };
+    readonly cbETH: {
+        readonly symbol: "cbETH";
+        readonly name: "Coinbase Staked ETH";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22";
+            readonly 42161: "0x1DEBd73E752bEaF79865Fd6446b0c970EaE7732f";
+        };
+    };
+    readonly wstETH: {
+        readonly symbol: "wstETH";
+        readonly name: "Lido Wrapped stETH";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452";
+            readonly 42161: "0x5979D7b546E38E414F7E9822514be443A4800529";
+        };
+    };
+    readonly rETH: {
+        readonly symbol: "rETH";
+        readonly name: "Rocket Pool ETH";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 42161: "0xEC70Dcb4A1EFa46b8F2D97C310C9c4790ba5ffA8";
+        };
+    };
+    readonly LINK: {
+        readonly symbol: "LINK";
+        readonly name: "Chainlink";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x88Fb150BDc53A65fe94Dea0c9BA0a6dAf8C6e196";
+            readonly 84532: "0xE4aB69C077896252FAFBD49EFD26B5D171A32410";
+            readonly 42161: "0xf97f4df75117a78c1A5a0DBb814Af92458539FB4";
+        };
+    };
+    readonly UNI: {
+        readonly symbol: "UNI";
+        readonly name: "Uniswap";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0xc3De830EA07524a0761646a6a4e4be0e114a3C83";
+            readonly 42161: "0xFa7F8980b0f1E64A2062791cc3b0871572f1F7f0";
+        };
+    };
+    readonly AAVE: {
+        readonly symbol: "AAVE";
+        readonly name: "Aave";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x63706e401c06ac8513145b7687A14804d17f814b";
+            readonly 42161: "0xba5DdD1f9d7F570dc94a51479a000E3BCE967196";
+        };
+    };
+    readonly COMP: {
+        readonly symbol: "COMP";
+        readonly name: "Compound";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x9e1028F5F1D5eDE59748FFceE5532509976840E0";
+            readonly 42161: "0x354A6dA3fcde098F8389cad84b0182725c6C91dE";
+        };
+    };
+    readonly CRV: {
+        readonly symbol: "CRV";
+        readonly name: "Curve DAO";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x8Ee73c484A26e0A5df2Ee2a4960B789967dd0415";
+            readonly 42161: "0x11cDb42B0EB46D95f990BeDD4695A6e3fA034978";
+        };
+    };
+    readonly SNX: {
+        readonly symbol: "SNX";
+        readonly name: "Synthetix";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x22e6966B799c4D5B13BE962E1D117b56327FDa66";
+        };
+    };
+    readonly ARB: {
+        readonly symbol: "ARB";
+        readonly name: "Arbitrum";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 42161: "0x912CE59144191C1204E64559FE8253a0e49E6548";
+        };
+    };
+    readonly AERO: {
+        readonly symbol: "AERO";
+        readonly name: "Aerodrome";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x940181a94A35A4569E4529A3CDfB74e38FD98631";
+        };
+    };
+    readonly GMX: {
+        readonly symbol: "GMX";
+        readonly name: "GMX";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 42161: "0xfc5A1A6EB076a2C7aD06eD22C90d7E710E35ad0a";
+        };
+    };
+};
+type KnownTokenSymbol = keyof typeof KNOWN_TOKENS;
+/** All known tokens available on a specific chain. */
+declare function getKnownTokensForChain(chainId: number): (KnownToken & {
+    address: Address;
+})[];
+/** Reverse-lookup: address → symbol (case-insensitive). Returns null if unknown. */
+declare function getTokenSymbolByAddress(address: string): string | null;
+/**
+ * Resolve a Token enum symbol to its on-chain address for a given chain.
+ * If an Address (0x...) is passed, it is returned as-is.
+ *
+ * @throws if the symbol has no address on the given chain.
+ */
+declare function resolveToken(token: Address | Token | KnownTokenSymbol, chainId: number): Address;
+
+/**
+ * keccak256 of the PaymentIntent type string — used for manual digest
+ * verification. viem's signTypedData computes this internally; you don't
+ * need this value for signing, only for low-level verification.
+ */
+declare const PAYMENT_INTENT_TYPEHASH: `0x${string}`;
+/** keccak256 of the ExecuteIntent type string for DeFi protocol interactions. */
+declare const EXECUTE_INTENT_TYPEHASH: `0x${string}`;
+/** keccak256 of the SwapIntent type string for in-vault token rebalancing. */
+declare const SWAP_INTENT_TYPEHASH: `0x${string}`;
+/** EIP-712 domain name and version for AxonVault. Matches the constructor. */
+declare const EIP712_DOMAIN_NAME: "AxonVault";
+declare const EIP712_DOMAIN_VERSION: "1";
+/** Sentinel address representing native ETH in PaymentIntents and deposits. */
+declare const NATIVE_ETH: Address;
+declare const USDC: Record<number, Address>;
+declare enum Chain {
+    Base = 8453,
+    BaseSepolia = 84532,
+    Arbitrum = 42161,
+    ArbitrumSepolia = 421614
+}
+declare const SUPPORTED_CHAIN_IDS: readonly [8453, 84532, 42161, 421614];
+type SupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
+/** Human-readable chain names. */
+declare const CHAIN_NAMES: Record<number, string>;
+/** Block explorer TX URL prefix per chain. */
+declare const EXPLORER_TX: Record<number, string>;
+/** Block explorer address URL prefix per chain. */
+declare const EXPLORER_ADDR: Record<number, string>;
+/** Default intent validity window when no deadline is specified. */
+declare const DEFAULT_DEADLINE_SECONDS = 300;
+/** Window presets for SpendingLimit.windowSeconds. */
+declare const WINDOW: {
+    readonly ONE_HOUR: 3600n;
+    readonly ONE_DAY: 86400n;
+    readonly ONE_WEEK: 604800n;
+    readonly THIRTY_DAYS: 2592000n;
+};
+/**
+ * Structured error codes returned by the relayer when a payment is rejected.
+ * Bots should import these to programmatically handle failures.
+ */
+declare const PaymentErrorCode: {
+    /** Payment destination is the vault itself */
+    readonly SELF_PAYMENT: "SELF_PAYMENT";
+    /** Payment destination is the zero address */
+    readonly ZERO_ADDRESS: "ZERO_ADDRESS";
+    /** Payment amount is zero */
+    readonly ZERO_AMOUNT: "ZERO_AMOUNT";
+    /** Vault does not hold enough of the requested token */
+    readonly INSUFFICIENT_BALANCE: "INSUFFICIENT_BALANCE";
+    /** EIP-712 signature verification failed */
+    readonly INVALID_SIGNATURE: "INVALID_SIGNATURE";
+    /** Payment intent deadline has passed */
+    readonly DEADLINE_EXPIRED: "DEADLINE_EXPIRED";
+    /** Bot is temporarily paused by the operator */
+    readonly BOT_PAUSED: "BOT_PAUSED";
+    /** Bot address is not registered/active in the vault */
+    readonly BOT_NOT_ACTIVE: "BOT_NOT_ACTIVE";
+    /** Destination address is on the global or vault blacklist */
+    readonly BLACKLISTED: "BLACKLISTED";
+    /** Rolling-window spending limit (USD amount) exceeded */
+    readonly SPENDING_LIMIT_EXCEEDED: "SPENDING_LIMIT_EXCEEDED";
+    /** Rolling-window transaction count limit exceeded */
+    readonly TX_COUNT_EXCEEDED: "TX_COUNT_EXCEEDED";
+    /** Single transaction exceeds the bot's on-chain maxPerTxAmount */
+    readonly MAX_PER_TX_EXCEEDED: "MAX_PER_TX_EXCEEDED";
+    /** Vault-level daily aggregate spending limit exceeded */
+    readonly VAULT_AGGREGATE_EXCEEDED: "VAULT_AGGREGATE_EXCEEDED";
+    /** eth_call simulation of the on-chain transaction reverted */
+    readonly SIMULATION_FAILED: "SIMULATION_FAILED";
+    /** Routed to human review (AI scan flagged or no consensus) */
+    readonly PENDING_REVIEW: "PENDING_REVIEW";
+    /** Relayer wallet has insufficient gas to submit the transaction */
+    readonly RELAYER_OUT_OF_GAS: "RELAYER_OUT_OF_GAS";
+    /** On-chain transaction submission failed */
+    readonly SUBMISSION_FAILED: "SUBMISSION_FAILED";
+    /** Destination not in the vault/bot whitelist */
+    readonly DESTINATION_NOT_WHITELISTED: "DESTINATION_NOT_WHITELISTED";
+    /** Vault address is not a valid AxonVault or was not deployed by a known factory */
+    readonly INVALID_VAULT: "INVALID_VAULT";
+    /** Rebalance output token is not in the whitelist (on-chain or relayer default) */
+    readonly REBALANCE_TOKEN_NOT_ALLOWED: "REBALANCE_TOKEN_NOT_ALLOWED";
+    /** Rebalance input amount exceeds the bot's maxRebalanceAmount cap */
+    readonly MAX_REBALANCE_AMOUNT_EXCEEDED: "MAX_REBALANCE_AMOUNT_EXCEEDED";
+    /** Unknown or internal error */
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+type PaymentErrorCode = (typeof PaymentErrorCode)[keyof typeof PaymentErrorCode];
+declare const RELAYER_API: {
+    readonly PAYMENTS: "/v1/payments";
+    readonly payment: (requestId: string) => string;
+    readonly EXECUTE: "/v1/execute";
+    readonly execute: (requestId: string) => string;
+    readonly SWAP: "/v1/swap";
+    readonly swap: (requestId: string) => string;
+    readonly vaultBalance: (vault: string, token: string, chainId: number) => string;
+    readonly vaultBalances: (vault: string, chainId: number) => string;
+    readonly vaultInfo: (vault: string, chainId: number) => string;
+    readonly botStatus: (vault: string, bot: string, chainId: number) => string;
+    readonly destinationCheck: (vault: string, bot: string, destination: string, chainId: number) => string;
+    readonly protocolCheck: (vault: string, protocol: string, chainId: number) => string;
+    readonly rebalanceTokens: (vault: string, chainId: number) => string;
+    readonly rebalanceTokenCheck: (vault: string, token: string, chainId: number) => string;
+    readonly tosStatus: (wallet: string) => string;
+    readonly TOS_ACCEPT: "/v1/tos/accept";
+};
+
+/**
+ * Accepts any way to identify a token:
+ * - `Address` ('0x...') — raw contract address
+ * - `Token` enum (Token.USDC) — type-safe symbol
+ * - `KnownTokenSymbol` string ('USDC') — bare string shorthand
+ */
+type TokenInput = Address | Token | KnownTokenSymbol;
+/**
+ * Accepts amounts in any format:
+ * - `bigint` — raw base units (e.g. 5_000_000n for 5 USDC). Passed through as-is.
+ * - `number` — human-readable (e.g. 5.2 for 5.2 USDC). SDK converts using token decimals.
+ * - `string` — human-readable string (e.g. '5.2'). Recommended for computed values to avoid float precision issues.
+ */
+type AmountInput = bigint | number | string;
 /** Rolling window spending limit. Stored on-chain, enforced by relayer. */
 interface SpendingLimit {
     /** Max spend in this window (token base units, e.g. USDC has 6 decimals). */
@@ -77,10 +412,10 @@ interface PaymentIntent {
 interface PayInput {
     /** Payment recipient. */
     to: Address;
-    /** Desired output token (e.g. USDC[chainId]). */
-    token: Address;
-    /** Amount in token base units. For USDC: 1 USDC = 1_000_000n. */
-    amount: bigint;
+    /** Desired output token — an address, Token enum, or bare symbol string ('USDC'). */
+    token: TokenInput;
+    /** Amount: bigint (raw base units), number (human-readable), or string (human-readable). */
+    amount: AmountInput;
     /**
      * Human-readable payment description. Stored in relayer's PostgreSQL.
      * Gets keccak256-hashed to populate the on-chain `ref` field.
@@ -176,10 +511,10 @@ interface ExecuteInput {
     protocol: Address;
     /** The actual calldata bytes to send to the protocol. */
     callData: Hex;
-    /** Token to approve to the protocol. */
-    token: Address;
-    /** Amount to approve (in token base units). */
-    amount: bigint;
+    /** Token to approve to the protocol — an address, Token enum, or bare symbol string ('USDC'). */
+    token: TokenInput;
+    /** Amount to approve: bigint (raw base units), number (human-readable), or string (human-readable). */
+    amount: AmountInput;
     /** Human-readable description. Gets keccak256-hashed to ref. */
     memo?: string;
     /**
@@ -195,20 +530,20 @@ interface ExecuteInput {
     deadline?: bigint;
     /** Arbitrary metadata stored off-chain. */
     metadata?: Record<string, string>;
-    /** Source token for pre-swap (relayer resolves automatically if omitted). */
-    fromToken?: Address;
-    /** Max input for pre-swap. */
-    maxFromAmount?: bigint;
+    /** Source token for pre-swap — an address, Token enum, or bare symbol string. */
+    fromToken?: TokenInput;
+    /** Max input for pre-swap: bigint (raw), number (human), or string (human). */
+    maxFromAmount?: AmountInput;
 }
 /**
  * Input for AxonClient.swap(). Signs a SwapIntent and submits to
  * the relayer's POST /v1/swap endpoint.
  */
 interface SwapInput {
-    /** Desired output token. */
-    toToken: Address;
-    /** Minimum output amount (slippage floor). */
-    minToAmount: bigint;
+    /** Desired output token — an address, Token enum, or bare symbol string ('WETH'). */
+    toToken: TokenInput;
+    /** Minimum output amount (slippage floor): bigint (raw), number (human), or string (human). */
+    minToAmount: AmountInput;
     /** Human-readable description. Gets keccak256-hashed to ref. */
     memo?: string;
     /** Override ref bytes32 directly. */
@@ -217,10 +552,10 @@ interface SwapInput {
     idempotencyKey?: string;
     /** Intent expiry (defaults to 5 min). */
     deadline?: bigint;
-    /** Source token to swap from. */
-    fromToken?: Address;
-    /** Max input amount for swap. */
-    maxFromAmount?: bigint;
+    /** Source token to swap from — an address, Token enum, or bare symbol string. */
+    fromToken?: TokenInput;
+    /** Max input amount for swap: bigint (raw), number (human), or string (human). */
+    maxFromAmount?: AmountInput;
 }
 /** Possible statuses returned by the relayer. */
 type PaymentStatus = 'approved' | 'pending_review' | 'rejected';
@@ -268,8 +603,8 @@ interface TosStatus {
 interface AxonClientConfig {
     /** Vault contract address to sign against. */
     vaultAddress: Address;
-    /** Chain ID of the network the vault is deployed on. */
-    chainId: number;
+    /** Chain ID — a number or a Chain enum value (e.g. Chain.Base). */
+    chainId: Chain | number;
     /**
      * Bot's private key (hex, 0x-prefixed). Used to sign payment intents.
      * The SDK constructs a local signer internally — no RPC connection needed.
@@ -306,8 +641,8 @@ interface AxonClientConfig {
  *
  * const result = await client.pay({
  *   to: '0x...recipient...',
- *   token: USDC[84532],
- *   amount: 5_000_000n,       // 5 USDC
+ *   token: 'USDC',
+ *   amount: 5,                // 5 USDC — SDK handles decimals
  *   memo: 'API call #1234 — weather data',
  * })
  *
@@ -358,169 +693,72 @@ declare class AxonClient {
     /** Returns whether the vault is currently paused (via relayer). */
     isPaused(): Promise<boolean>;
     /** Returns high-level vault info (owner, operator, paused, version, trackUsedIntents) via relayer. */
-    getVaultInfo(): Promise<VaultInfo>;
-    /**
-     * Check whether this bot can pay to a given destination address (via relayer).
-     * Checks blacklist → global whitelist → bot whitelist, matching on-chain logic.
-     */
-    canPayTo(destination: Address): Promise<DestinationCheckResult>;
-    /** Returns whether a protocol address is approved for executeProtocol() calls (via relayer). */
-    isProtocolApproved(protocol: Address): Promise<boolean>;
-    /**
-     * Returns the effective rebalance token whitelist for this vault.
-     *
-     * If the owner set tokens on-chain, those override entirely.
-     * If no on-chain whitelist, returns relayer defaults (USDC, WETH, USDT).
-     * Use this before calling swap() to check which output tokens are allowed.
-     */
-    getRebalanceTokens(): Promise<RebalanceTokensResult>;
-    /** Check if a specific token is allowed for rebalancing (executeSwap output) on this vault. */
-    isRebalanceTokenAllowed(token: Address): Promise<{
-        allowed: boolean;
-        source: 'default' | 'on_chain';
-    }>;
-    /** Check if a wallet has accepted the current TOS version. */
-    getTosStatus(wallet: string): Promise<TosStatus>;
-    /**
-     * Sign and submit TOS acceptance. Uses the owner's wallet (not the bot key).
-     *
-     * @param signer - Object with a `signMessage` method (e.g. a viem WalletClient
-     *   or ethers Signer). This should be the vault owner's wallet, not the bot key.
-     * @param wallet - The owner's wallet address (must match the signer).
-     */
-    acceptTos(signer: {
-        signMessage: (args: {
-            message: string;
-        }) => Promise<Hex>;
-    }, wallet: string): Promise<TosStatus>;
-    /**
-     * Poll the relayer for the status of an async payment.
-     *
-     * Use this when pay() returns `status: "pending_review"`. Poll until
-     * status is `"approved"` or `"rejected"`.
-     *
-     * Recommended polling interval: 5–10 seconds.
-     */
-    poll(requestId: string): Promise<PaymentResult>;
-    /** Poll the relayer for the status of an async protocol execution. */
-    pollExecute(requestId: string): Promise<PaymentResult>;
-    /** Poll the relayer for the status of an async swap. */
-    pollSwap(requestId: string): Promise<PaymentResult>;
-    /**
-     * Sign a PaymentIntent directly without submitting to the relayer.
-     *
-     * Use this if you want to build the intent yourself and pass the signature
-     * to another system (e.g. a custom relayer integration).
-     */
-    signPayment(intent: PaymentIntent): Promise<Hex>;
-    private _get;
-    private _defaultDeadline;
-    private _resolveRef;
-    private _buildPaymentIntent;
-    private _buildExecuteIntent;
-    private _buildSwapIntent;
-    private _submitPayment;
-    private _submitExecute;
-    private _submitSwap;
-    private _post;
-}
-
-/**
- * keccak256 of the PaymentIntent type string — used for manual digest
- * verification. viem's signTypedData computes this internally; you don't
- * need this value for signing, only for low-level verification.
- */
-declare const PAYMENT_INTENT_TYPEHASH: `0x${string}`;
-/** keccak256 of the ExecuteIntent type string for DeFi protocol interactions. */
-declare const EXECUTE_INTENT_TYPEHASH: `0x${string}`;
-/** keccak256 of the SwapIntent type string for in-vault token rebalancing. */
-declare const SWAP_INTENT_TYPEHASH: `0x${string}`;
-/** EIP-712 domain name and version for AxonVault. Matches the constructor. */
-declare const EIP712_DOMAIN_NAME: "AxonVault";
-declare const EIP712_DOMAIN_VERSION: "1";
-/** Sentinel address representing native ETH in PaymentIntents and deposits. */
-declare const NATIVE_ETH: Address;
-declare const USDC: Record<number, Address>;
-declare const SUPPORTED_CHAIN_IDS: readonly [8453, 84532, 42161, 421614];
-type SupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
-/** Default intent validity window when no deadline is specified. */
-declare const DEFAULT_DEADLINE_SECONDS = 300;
-/** Window presets for SpendingLimit.windowSeconds. */
-declare const WINDOW: {
-    readonly ONE_HOUR: 3600n;
-    readonly ONE_DAY: 86400n;
-    readonly ONE_WEEK: 604800n;
-    readonly THIRTY_DAYS: 2592000n;
-};
-/**
- * Structured error codes returned by the relayer when a payment is rejected.
- * Bots should import these to programmatically handle failures.
- */
-declare const PaymentErrorCode: {
-    /** Payment destination is the vault itself */
-    readonly SELF_PAYMENT: "SELF_PAYMENT";
-    /** Payment destination is the zero address */
-    readonly ZERO_ADDRESS: "ZERO_ADDRESS";
-    /** Payment amount is zero */
-    readonly ZERO_AMOUNT: "ZERO_AMOUNT";
-    /** Vault does not hold enough of the requested token */
-    readonly INSUFFICIENT_BALANCE: "INSUFFICIENT_BALANCE";
-    /** EIP-712 signature verification failed */
-    readonly INVALID_SIGNATURE: "INVALID_SIGNATURE";
-    /** Payment intent deadline has passed */
-    readonly DEADLINE_EXPIRED: "DEADLINE_EXPIRED";
-    /** Bot is temporarily paused by the operator */
-    readonly BOT_PAUSED: "BOT_PAUSED";
-    /** Bot address is not registered/active in the vault */
-    readonly BOT_NOT_ACTIVE: "BOT_NOT_ACTIVE";
-    /** Destination address is on the global or vault blacklist */
-    readonly BLACKLISTED: "BLACKLISTED";
-    /** Rolling-window spending limit (USD amount) exceeded */
-    readonly SPENDING_LIMIT_EXCEEDED: "SPENDING_LIMIT_EXCEEDED";
-    /** Rolling-window transaction count limit exceeded */
-    readonly TX_COUNT_EXCEEDED: "TX_COUNT_EXCEEDED";
-    /** Single transaction exceeds the bot's on-chain maxPerTxAmount */
-    readonly MAX_PER_TX_EXCEEDED: "MAX_PER_TX_EXCEEDED";
-    /** Vault-level daily aggregate spending limit exceeded */
-    readonly VAULT_AGGREGATE_EXCEEDED: "VAULT_AGGREGATE_EXCEEDED";
-    /** eth_call simulation of the on-chain transaction reverted */
-    readonly SIMULATION_FAILED: "SIMULATION_FAILED";
-    /** Routed to human review (AI scan flagged or no consensus) */
-    readonly PENDING_REVIEW: "PENDING_REVIEW";
-    /** Relayer wallet has insufficient gas to submit the transaction */
-    readonly RELAYER_OUT_OF_GAS: "RELAYER_OUT_OF_GAS";
-    /** On-chain transaction submission failed */
-    readonly SUBMISSION_FAILED: "SUBMISSION_FAILED";
-    /** Destination not in the vault/bot whitelist */
-    readonly DESTINATION_NOT_WHITELISTED: "DESTINATION_NOT_WHITELISTED";
-    /** Vault address is not a valid AxonVault or was not deployed by a known factory */
-    readonly INVALID_VAULT: "INVALID_VAULT";
-    /** Rebalance output token is not in the whitelist (on-chain or relayer default) */
-    readonly REBALANCE_TOKEN_NOT_ALLOWED: "REBALANCE_TOKEN_NOT_ALLOWED";
-    /** Rebalance input amount exceeds the bot's maxRebalanceAmount cap */
-    readonly MAX_REBALANCE_AMOUNT_EXCEEDED: "MAX_REBALANCE_AMOUNT_EXCEEDED";
-    /** Unknown or internal error */
-    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
-};
-type PaymentErrorCode = (typeof PaymentErrorCode)[keyof typeof PaymentErrorCode];
-declare const RELAYER_API: {
-    readonly PAYMENTS: "/v1/payments";
-    readonly payment: (requestId: string) => string;
-    readonly EXECUTE: "/v1/execute";
-    readonly execute: (requestId: string) => string;
-    readonly SWAP: "/v1/swap";
-    readonly swap: (requestId: string) => string;
-    readonly vaultBalance: (vault: string, token: string, chainId: number) => string;
-    readonly vaultBalances: (vault: string, chainId: number) => string;
-    readonly vaultInfo: (vault: string, chainId: number) => string;
-    readonly botStatus: (vault: string, bot: string, chainId: number) => string;
-    readonly destinationCheck: (vault: string, bot: string, destination: string, chainId: number) => string;
-    readonly protocolCheck: (vault: string, protocol: string, chainId: number) => string;
-    readonly rebalanceTokens: (vault: string, chainId: number) => string;
-    readonly rebalanceTokenCheck: (vault: string, token: string, chainId: number) => string;
-    readonly tosStatus: (wallet: string) => string;
-    readonly TOS_ACCEPT: "/v1/tos/accept";
-};
+    getVaultInfo(): Promise<VaultInfo>;
+    /**
+     * Check whether this bot can pay to a given destination address (via relayer).
+     * Checks blacklist → global whitelist → bot whitelist, matching on-chain logic.
+     */
+    canPayTo(destination: Address): Promise<DestinationCheckResult>;
+    /** Returns whether a protocol address is approved for executeProtocol() calls (via relayer). */
+    isProtocolApproved(protocol: Address): Promise<boolean>;
+    /**
+     * Returns the effective rebalance token whitelist for this vault.
+     *
+     * If the owner set tokens on-chain, those override entirely.
+     * If no on-chain whitelist, returns relayer defaults (USDC, WETH, USDT).
+     * Use this before calling swap() to check which output tokens are allowed.
+     */
+    getRebalanceTokens(): Promise<RebalanceTokensResult>;
+    /** Check if a specific token is allowed for rebalancing (executeSwap output) on this vault. */
+    isRebalanceTokenAllowed(token: Address): Promise<{
+        allowed: boolean;
+        source: 'default' | 'on_chain';
+    }>;
+    /** Check if a wallet has accepted the current TOS version. */
+    getTosStatus(wallet: string): Promise<TosStatus>;
+    /**
+     * Sign and submit TOS acceptance. Uses the owner's wallet (not the bot key).
+     *
+     * @param signer - Object with a `signMessage` method (e.g. a viem WalletClient
+     *   or ethers Signer). This should be the vault owner's wallet, not the bot key.
+     * @param wallet - The owner's wallet address (must match the signer).
+     */
+    acceptTos(signer: {
+        signMessage: (args: {
+            message: string;
+        }) => Promise<Hex>;
+    }, wallet: string): Promise<TosStatus>;
+    /**
+     * Poll the relayer for the status of an async payment.
+     *
+     * Use this when pay() returns `status: "pending_review"`. Poll until
+     * status is `"approved"` or `"rejected"`.
+     *
+     * Recommended polling interval: 5–10 seconds.
+     */
+    poll(requestId: string): Promise<PaymentResult>;
+    /** Poll the relayer for the status of an async protocol execution. */
+    pollExecute(requestId: string): Promise<PaymentResult>;
+    /** Poll the relayer for the status of an async swap. */
+    pollSwap(requestId: string): Promise<PaymentResult>;
+    /**
+     * Sign a PaymentIntent directly without submitting to the relayer.
+     *
+     * Use this if you want to build the intent yourself and pass the signature
+     * to another system (e.g. a custom relayer integration).
+     */
+    signPayment(intent: PaymentIntent): Promise<Hex>;
+    private _get;
+    private _defaultDeadline;
+    private _resolveRef;
+    private _buildPaymentIntent;
+    private _buildExecuteIntent;
+    private _buildSwapIntent;
+    private _submitPayment;
+    private _submitExecute;
+    private _submitSwap;
+    private _post;
+}
 
 /**
  * Sign a PaymentIntent using EIP-712 typed structured data.
@@ -556,7 +794,7 @@ declare function signSwapIntent(walletClient: WalletClient, vaultAddress: Addres
 declare function encodeRef(memo: string): Hex;
 
 /** Returns the viem Chain object for a supported Axon chain ID. */
-declare function getChain(chainId: number): Chain;
+declare function getChain(chainId: number): Chain$1;
 /** Create a viem PublicClient for the given chain and RPC URL. */
 declare function createAxonPublicClient(chainId: number, rpcUrl: string): PublicClient;
 /** Create a viem WalletClient from a raw private key (signing-only, no RPC needed). */
@@ -677,190 +915,39 @@ declare function encryptKeystore(privateKey: Hex, passphrase: string): Promise<K
  */
 declare function decryptKeystore(keystore: KeystoreV3 | string, passphrase: string): Promise<Hex>;
 
-interface KnownToken {
-    symbol: string;
-    name: string;
-    decimals: number;
-    /** Address per chainId. Missing key = not available on that chain. */
-    addresses: Partial<Record<number, Address>>;
-}
 /**
- * Master token registry keyed by symbol.
- * At a glance you see which chains each token lives on.
+ * Look up decimals for a token by symbol, Token enum, or address.
  *
- * Chain IDs: 8453 = Base, 84532 = Base Sepolia, 42161 = Arbitrum One, 421614 = Arbitrum Sepolia
+ * @param token - A KnownTokenSymbol ('USDC'), Token enum (Token.USDC), or address ('0x...')
+ * @param chainId - Optional chain ID (unused for decimal lookup, but reserved for future use)
+ * @returns The number of decimals for the token
+ * @throws If the token is an unknown address with no entry in KNOWN_TOKENS
  */
-declare const KNOWN_TOKENS: {
-    readonly USDC: {
-        readonly symbol: "USDC";
-        readonly name: "USD Coin";
-        readonly decimals: 6;
-        readonly addresses: {
-            readonly 8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
-            readonly 84532: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
-            readonly 42161: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
-            readonly 421614: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
-        };
-    };
-    readonly USDT: {
-        readonly symbol: "USDT";
-        readonly name: "Tether USD";
-        readonly decimals: 6;
-        readonly addresses: {
-            readonly 8453: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2";
-            readonly 42161: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9";
-        };
-    };
-    readonly DAI: {
-        readonly symbol: "DAI";
-        readonly name: "Dai Stablecoin";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb";
-            readonly 84532: "0x819ffecd4e64f193e959944bcd57eedc7755e17a";
-            readonly 42161: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1";
-        };
-    };
-    readonly WETH: {
-        readonly symbol: "WETH";
-        readonly name: "Wrapped Ether";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x4200000000000000000000000000000000000006";
-            readonly 84532: "0x4200000000000000000000000000000000000006";
-            readonly 42161: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1";
-        };
-    };
-    readonly WBTC: {
-        readonly symbol: "WBTC";
-        readonly name: "Wrapped BTC";
-        readonly decimals: 8;
-        readonly addresses: {
-            readonly 8453: "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c";
-            readonly 42161: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f";
-        };
-    };
-    readonly cbBTC: {
-        readonly symbol: "cbBTC";
-        readonly name: "Coinbase Wrapped BTC";
-        readonly decimals: 8;
-        readonly addresses: {
-            readonly 8453: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
-            readonly 42161: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
-        };
-    };
-    readonly cbETH: {
-        readonly symbol: "cbETH";
-        readonly name: "Coinbase Staked ETH";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22";
-            readonly 42161: "0x1DEBd73E752bEaF79865Fd6446b0c970EaE7732f";
-        };
-    };
-    readonly wstETH: {
-        readonly symbol: "wstETH";
-        readonly name: "Lido Wrapped stETH";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452";
-            readonly 42161: "0x5979D7b546E38E414F7E9822514be443A4800529";
-        };
-    };
-    readonly rETH: {
-        readonly symbol: "rETH";
-        readonly name: "Rocket Pool ETH";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 42161: "0xEC70Dcb4A1EFa46b8F2D97C310C9c4790ba5ffA8";
-        };
-    };
-    readonly LINK: {
-        readonly symbol: "LINK";
-        readonly name: "Chainlink";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x88Fb150BDc53A65fe94Dea0c9BA0a6dAf8C6e196";
-            readonly 84532: "0xE4aB69C077896252FAFBD49EFD26B5D171A32410";
-            readonly 42161: "0xf97f4df75117a78c1A5a0DBb814Af92458539FB4";
-        };
-    };
-    readonly UNI: {
-        readonly symbol: "UNI";
-        readonly name: "Uniswap";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0xc3De830EA07524a0761646a6a4e4be0e114a3C83";
-            readonly 42161: "0xFa7F8980b0f1E64A2062791cc3b0871572f1F7f0";
-        };
-    };
-    readonly AAVE: {
-        readonly symbol: "AAVE";
-        readonly name: "Aave";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x63706e401c06ac8513145b7687A14804d17f814b";
-            readonly 42161: "0xba5DdD1f9d7F570dc94a51479a000E3BCE967196";
-        };
-    };
-    readonly COMP: {
-        readonly symbol: "COMP";
-        readonly name: "Compound";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x9e1028F5F1D5eDE59748FFceE5532509976840E0";
-            readonly 42161: "0x354A6dA3fcde098F8389cad84b0182725c6C91dE";
-        };
-    };
-    readonly CRV: {
-        readonly symbol: "CRV";
-        readonly name: "Curve DAO";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x8Ee73c484A26e0A5df2Ee2a4960B789967dd0415";
-            readonly 42161: "0x11cDb42B0EB46D95f990BeDD4695A6e3fA034978";
-        };
-    };
-    readonly SNX: {
-        readonly symbol: "SNX";
-        readonly name: "Synthetix";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x22e6966B799c4D5B13BE962E1D117b56327FDa66";
-        };
-    };
-    readonly ARB: {
-        readonly symbol: "ARB";
-        readonly name: "Arbitrum";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 42161: "0x912CE59144191C1204E64559FE8253a0e49E6548";
-        };
-    };
-    readonly AERO: {
-        readonly symbol: "AERO";
-        readonly name: "Aerodrome";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 8453: "0x940181a94A35A4569E4529A3CDfB74e38FD98631";
-        };
-    };
-    readonly GMX: {
-        readonly symbol: "GMX";
-        readonly name: "GMX";
-        readonly decimals: 18;
-        readonly addresses: {
-            readonly 42161: "0xfc5A1A6EB076a2C7aD06eD22C90d7E710E35ad0a";
-        };
-    };
-};
-type KnownTokenSymbol = keyof typeof KNOWN_TOKENS;
-/** All known tokens available on a specific chain. */
-declare function getKnownTokensForChain(chainId: number): (KnownToken & {
-    address: Address;
-})[];
-/** Reverse-lookup: address → symbol (case-insensitive). Returns null if unknown. */
-declare function getTokenSymbolByAddress(address: string): string | null;
+declare function resolveTokenDecimals(token: Address | Token | KnownTokenSymbol, chainId?: number): number;
+/**
+ * Convert a human-friendly amount to raw base units (bigint).
+ *
+ * - **bigint** → passed through as-is (already in base units)
+ * - **number** → converted to string, then parsed via `parseUnits(str, decimals)`
+ * - **string** → parsed directly via `parseUnits(str, decimals)`
+ *
+ * @param amount - The amount as bigint (raw), number (human), or string (human)
+ * @param token - Token identifier used to look up decimals (symbol, enum, or address)
+ * @param chainId - Optional chain ID (passed to resolveTokenDecimals)
+ * @returns The amount in token base units as bigint
+ *
+ * @example
+ * ```ts
+ * parseAmount(5_000_000n, 'USDC')     // 5000000n (passthrough)
+ * parseAmount(5.2, 'USDC')            // 5200000n
+ * parseAmount('5.2', 'USDC')          // 5200000n
+ * parseAmount(0.001, 'WETH')          // 1000000000000000n
+ * ```
+ *
+ * @throws If the amount has more decimal places than the token supports
+ * @throws If the token is unknown and amount is not bigint
+ */
+declare function parseAmount(amount: bigint | number | string, token: Address | Token | KnownTokenSymbol, chainId?: number): bigint;
 
 declare const AxonVaultAbi: readonly [{
     readonly type: "constructor";
@@ -2959,4 +3046,4 @@ declare const AxonRegistryAbi: readonly [{
     readonly inputs: readonly [];
 }];
 
-export { AxonClient, type AxonClientConfig, AxonRegistryAbi, AxonVaultAbi, AxonVaultFactoryAbi, type BotConfig, type BotConfigParams, DEFAULT_DEADLINE_SECONDS, type DestinationCheckResult, EIP712_DOMAIN_NAME, EIP712_DOMAIN_VERSION, EXECUTE_INTENT_TYPEHASH, type ExecuteInput, type ExecuteIntent, KNOWN_TOKENS, type KeystoreV3, type KnownToken, type KnownTokenSymbol, NATIVE_ETH, type OperatorCeilings, PAYMENT_INTENT_TYPEHASH, type PayInput, PaymentErrorCode, type PaymentIntent, type PaymentResult, type PaymentStatus, RELAYER_API, type RebalanceTokensResult, SUPPORTED_CHAIN_IDS, SWAP_INTENT_TYPEHASH, type SpendingLimit, type SupportedChainId, type SwapInput, type SwapIntent, type TosStatus, USDC, type VaultInfo, WINDOW, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, encodeRef, encryptKeystore, getBotConfig, getChain, getDomainSeparator, getKnownTokensForChain, getOperatorCeilings, getRebalanceTokenCount, getTokenSymbolByAddress, getTrackUsedIntents, getVaultOperator, getVaultOwner, getVaultVersion, isBotActive, isDestinationAllowed, isRebalanceTokenWhitelisted, isVaultPaused, operatorMaxDrainPerDay, signExecuteIntent, signPayment, signSwapIntent };
+export { type AmountInput, AxonClient, type AxonClientConfig, AxonRegistryAbi, AxonVaultAbi, AxonVaultFactoryAbi, type BotConfig, type BotConfigParams, CHAIN_NAMES, Chain, DEFAULT_DEADLINE_SECONDS, type DestinationCheckResult, EIP712_DOMAIN_NAME, EIP712_DOMAIN_VERSION, EXECUTE_INTENT_TYPEHASH, EXPLORER_ADDR, EXPLORER_TX, type ExecuteInput, type ExecuteIntent, KNOWN_TOKENS, type KeystoreV3, type KnownToken, type KnownTokenSymbol, NATIVE_ETH, type OperatorCeilings, PAYMENT_INTENT_TYPEHASH, type PayInput, PaymentErrorCode, type PaymentIntent, type PaymentResult, type PaymentStatus, RELAYER_API, type RebalanceTokensResult, SUPPORTED_CHAIN_IDS, SWAP_INTENT_TYPEHASH, type SpendingLimit, type SupportedChainId, type SwapInput, type SwapIntent, Token, type TokenInput, type TosStatus, USDC, type VaultInfo, WINDOW, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, encodeRef, encryptKeystore, getBotConfig, getChain, getDomainSeparator, getKnownTokensForChain, getOperatorCeilings, getRebalanceTokenCount, getTokenSymbolByAddress, getTrackUsedIntents, getVaultOperator, getVaultOwner, getVaultVersion, isBotActive, isDestinationAllowed, isRebalanceTokenWhitelisted, isVaultPaused, operatorMaxDrainPerDay, parseAmount, resolveToken, resolveTokenDecimals, signExecuteIntent, signPayment, signSwapIntent };