@axonfi/sdk 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,4 +1,325 @@
-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, 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";
+};
 
 /** Rolling window spending limit. Stored on-chain, enforced by relayer. */
 interface SpendingLimit {
@@ -77,8 +398,8 @@ interface PaymentIntent {
 interface PayInput {
     /** Payment recipient. */
     to: Address;
-    /** Desired output token (e.g. USDC[chainId]). */
-    token: Address;
+    /** Desired output token — an address or a Token enum symbol (e.g. Token.USDC). */
+    token: Address | Token;
     /** Amount in token base units. For USDC: 1 USDC = 1_000_000n. */
     amount: bigint;
     /**
@@ -176,8 +497,8 @@ interface ExecuteInput {
     protocol: Address;
     /** The actual calldata bytes to send to the protocol. */
     callData: Hex;
-    /** Token to approve to the protocol. */
-    token: Address;
+    /** Token to approve to the protocol — an address or a Token enum symbol. */
+    token: Address | Token;
     /** Amount to approve (in token base units). */
     amount: bigint;
     /** Human-readable description. Gets keccak256-hashed to ref. */
@@ -205,8 +526,8 @@ interface ExecuteInput {
  * the relayer's POST /v1/swap endpoint.
  */
 interface SwapInput {
-    /** Desired output token. */
-    toToken: Address;
+    /** Desired output token — an address or a Token enum symbol. */
+    toToken: Address | Token;
     /** Minimum output amount (slippage floor). */
     minToAmount: bigint;
     /** Human-readable description. Gets keccak256-hashed to ref. */
@@ -268,8 +589,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.
@@ -353,174 +674,77 @@ declare class AxonClient {
      * Returns a record mapping token address → balance.
      */
     getBalances(tokens: Address[]): Promise<Record<Address, bigint>>;
-    /** Returns whether this bot is registered and active in the vault (via relayer). */
-    isActive(): Promise<boolean>;
-    /** 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";
-};
+    /** Returns whether this bot is registered and active in the vault (via relayer). */
+    isActive(): Promise<boolean>;
+    /** 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;
+}
 
 /**
  * Sign a PaymentIntent using EIP-712 typed structured data.
@@ -556,7 +780,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,191 +901,6 @@ 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.
- *
- * 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;
-
 declare const AxonVaultAbi: readonly [{
     readonly type: "constructor";
     readonly inputs: readonly [{
@@ -2959,4 +2998,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 { 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 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, resolveToken, signExecuteIntent, signPayment, signSwapIntent };