@axonfi/sdk 0.4.3 → 0.5.0

package/dist/index.d.cts

@@ -10,6 +10,7 @@ declare enum Token {
     cbETH = "cbETH",
     wstETH = "wstETH",
     rETH = "rETH",
+    weETH = "weETH",
     LINK = "LINK",
     UNI = "UNI",
     AAVE = "AAVE",
@@ -117,9 +118,19 @@ declare const KNOWN_TOKENS: {
         readonly name: "Rocket Pool ETH";
         readonly decimals: 18;
         readonly addresses: {
+            readonly 8453: "0xB6fe221Fe9EeF5aBa221c348bA20A1Bf5e73624c";
             readonly 42161: "0xEC70Dcb4A1EFa46b8F2D97C310C9c4790ba5ffA8";
         };
     };
+    readonly weETH: {
+        readonly symbol: "weETH";
+        readonly name: "EtherFi Wrapped eETH";
+        readonly decimals: 18;
+        readonly addresses: {
+            readonly 8453: "0x04C0599Ae5A44757c0af6F9eC3b93da8976c150A";
+            readonly 42161: "0x35751007a407ca6FEFfE80b3cB397736D2cf4dbe";
+        };
+    };
     readonly LINK: {
         readonly symbol: "LINK";
         readonly name: "Chainlink";
@@ -200,6 +211,16 @@ declare const KNOWN_TOKENS: {
     };
 };
 type KnownTokenSymbol = keyof typeof KNOWN_TOKENS;
+/**
+ * Tokens that new vaults should pre-approve as protocols at deploy time.
+ * This enables the two-step approval pattern (approve token → call DeFi protocol)
+ * without the owner having to manually add common tokens.
+ *
+ * Used by: AxonRegistry (on-chain default list), deploy scripts, dashboard.
+ */
+declare const DEFAULT_APPROVED_TOKENS: KnownTokenSymbol[];
+/** Get default approved token addresses for a specific chain. */
+declare function getDefaultApprovedTokens(chainId: number): Address[];
 /** All known tokens available on a specific chain. */
 declare function getKnownTokensForChain(chainId: number): (KnownToken & {
     address: Address;
@@ -477,7 +498,7 @@ interface PayInput {
 interface ExecuteIntent {
     /** Bot's own address. Must be registered in the vault. */
     bot: Address;
-    /** Target DeFi protocol contract address. Must be in vault's approvedProtocols. */
+    /** Target contract address (protocol or token). Must be approved via approveProtocol() or be a registry default token. */
     protocol: Address;
     /** keccak256 of the callData bytes. Verified by relayer before submission. */
     calldataHash: Hex;
@@ -791,8 +812,8 @@ declare class AxonClient {
      * 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 whether a contract address (protocol or token) is approved for executeProtocol() calls (via relayer). */
+    isContractApproved(protocol: Address): Promise<boolean>;
     /**
      * Returns the effective rebalance token whitelist for this vault.
      *
@@ -993,6 +1014,66 @@ declare function isRebalanceTokenWhitelisted(publicClient: PublicClient, vaultAd
  * @returns                 Address of the newly deployed vault.
  */
 declare function deployVault(walletClient: WalletClient, publicClient: PublicClient, factoryAddress: Address): Promise<Address>;
+/**
+ * Register a bot on the vault with its initial spending configuration.
+ *
+ * Must be called by the vault owner (or operator if ceilings allow).
+ * This is an on-chain transaction — requires gas on the owner's wallet.
+ *
+ * @param walletClient    Owner wallet (must be vault owner or authorized operator).
+ * @param publicClient    Public client for the vault's chain.
+ * @param vaultAddress    Vault to register the bot on.
+ * @param botAddress      Public address of the bot to register.
+ * @param config          Bot spending configuration (limits, AI threshold, etc.).
+ * @returns               Transaction hash.
+ */
+declare function addBot(walletClient: WalletClient, publicClient: PublicClient, vaultAddress: Address, botAddress: Address, config: BotConfigParams): Promise<Hex>;
+/**
+ * Update an existing bot's spending configuration.
+ *
+ * Must be called by the vault owner (or operator within ceilings).
+ * On-chain transaction — requires gas.
+ *
+ * @param walletClient    Owner/operator wallet.
+ * @param publicClient    Public client for the vault's chain.
+ * @param vaultAddress    Vault the bot is registered on.
+ * @param botAddress      Bot to update.
+ * @param config          New spending configuration.
+ * @returns               Transaction hash.
+ */
+declare function updateBotConfig(walletClient: WalletClient, publicClient: PublicClient, vaultAddress: Address, botAddress: Address, config: BotConfigParams): Promise<Hex>;
+/**
+ * Remove a bot from the vault whitelist.
+ *
+ * Must be called by the vault owner (or operator).
+ * The bot will immediately lose the ability to sign valid intents.
+ * On-chain transaction — requires gas.
+ *
+ * @param walletClient    Owner/operator wallet.
+ * @param publicClient    Public client for the vault's chain.
+ * @param vaultAddress    Vault to remove the bot from.
+ * @param botAddress      Bot to remove.
+ * @returns               Transaction hash.
+ */
+declare function removeBot(walletClient: WalletClient, publicClient: PublicClient, vaultAddress: Address, botAddress: Address): Promise<Hex>;
+/**
+ * Deposit tokens or native ETH into the vault.
+ *
+ * Permissionless — anyone can deposit. For ERC-20 tokens, this function
+ * handles the approve + deposit in one call. For native ETH, pass
+ * `NATIVE_ETH` (or `'ETH'`) as the token.
+ *
+ * On-chain transaction — requires gas on the depositor's wallet.
+ *
+ * @param walletClient    Wallet sending the deposit (anyone, not just owner).
+ * @param publicClient    Public client for the vault's chain.
+ * @param vaultAddress    Vault to deposit into.
+ * @param token           Token address, or NATIVE_ETH for ETH deposits.
+ * @param amount          Amount in base units (e.g. 5_000_000n for 5 USDC, 10n**16n for 0.01 ETH).
+ * @param ref             Optional bytes32 reference linking to an off-chain record. Defaults to 0x0.
+ * @returns               Transaction hash of the deposit.
+ */
+declare function deposit(walletClient: WalletClient, publicClient: PublicClient, vaultAddress: Address, token: Address, amount: bigint, ref?: Hex): Promise<Hex>;
 
 interface KeystoreV3 {
     version: 3;
@@ -1320,21 +1401,21 @@ declare const AxonVaultAbi: readonly [{
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "addProtocol";
+    readonly name: "addRebalanceTokens";
     readonly inputs: readonly [{
-        readonly name: "protocol";
-        readonly type: "address";
-        readonly internalType: "address";
+        readonly name: "tokens";
+        readonly type: "address[]";
+        readonly internalType: "address[]";
     }];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "addRebalanceTokens";
+    readonly name: "approveProtocol";
     readonly inputs: readonly [{
-        readonly name: "tokens";
-        readonly type: "address[]";
-        readonly internalType: "address[]";
+        readonly name: "protocol";
+        readonly type: "address";
+        readonly internalType: "address";
     }];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
@@ -1763,7 +1844,7 @@ declare const AxonVaultAbi: readonly [{
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "isProtocolApproved";
+    readonly name: "isContractApproved";
     readonly inputs: readonly [{
         readonly name: "protocol";
         readonly type: "address";
@@ -1935,16 +2016,6 @@ declare const AxonVaultAbi: readonly [{
     }];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "removeProtocol";
-    readonly inputs: readonly [{
-        readonly name: "protocol";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "removeRebalanceTokens";
@@ -1961,6 +2032,16 @@ declare const AxonVaultAbi: readonly [{
     readonly inputs: readonly [];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "revokeProtocol";
+    readonly inputs: readonly [{
+        readonly name: "protocol";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "setOperator";
@@ -2361,7 +2442,7 @@ declare const AxonVaultAbi: readonly [{
     readonly anonymous: false;
 }, {
     readonly type: "event";
-    readonly name: "ProtocolAdded";
+    readonly name: "ProtocolApproved";
     readonly inputs: readonly [{
         readonly name: "protocol";
         readonly type: "address";
@@ -2401,7 +2482,7 @@ declare const AxonVaultAbi: readonly [{
     readonly anonymous: false;
 }, {
     readonly type: "event";
-    readonly name: "ProtocolRemoved";
+    readonly name: "ProtocolRevoked";
     readonly inputs: readonly [{
         readonly name: "protocol";
         readonly type: "address";
@@ -2558,6 +2639,10 @@ declare const AxonVaultAbi: readonly [{
     readonly type: "error";
     readonly name: "CalldataHashMismatch";
     readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ContractNotApproved";
+    readonly inputs: readonly [];
 }, {
     readonly type: "error";
     readonly name: "DeadlineExpired";
@@ -2686,10 +2771,6 @@ declare const AxonVaultAbi: readonly [{
     readonly type: "error";
     readonly name: "ProtocolNotApproved";
     readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ProtocolNotInList";
-    readonly inputs: readonly [];
 }, {
     readonly type: "error";
     readonly name: "RebalanceTokenNotAllowed";
@@ -2967,6 +3048,16 @@ declare const AxonRegistryAbi: readonly [{
         readonly internalType: "address";
     }];
     readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "VERSION";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "acceptOwnership";
@@ -2993,6 +3084,16 @@ declare const AxonRegistryAbi: readonly [{
     }];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "approveDefaultToken";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "isApprovedSwapRouter";
@@ -3021,6 +3122,20 @@ declare const AxonRegistryAbi: readonly [{
         readonly internalType: "bool";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isDefaultToken";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "owner";
@@ -3067,6 +3182,16 @@ declare const AxonRegistryAbi: readonly [{
     readonly inputs: readonly [];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "revokeDefaultToken";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "setOracleConfig";
@@ -3125,6 +3250,26 @@ declare const AxonRegistryAbi: readonly [{
         readonly internalType: "address";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "DefaultTokenApproved";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DefaultTokenRevoked";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
 }, {
     readonly type: "event";
     readonly name: "OracleConfigUpdated";
@@ -3253,4 +3398,4 @@ declare const AxonRegistryAbi: readonly [{
     readonly inputs: readonly [];
 }];
 
-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, PERMIT2_ADDRESS, type PayInput, PaymentErrorCode, type PaymentIntent, type PaymentResult, type PaymentStatus, type Permit2Authorization, RELAYER_API, type RebalanceTokensResult, SUPPORTED_CHAIN_IDS, SWAP_INTENT_TYPEHASH, type SpendingLimit, type SupportedChainId, type SwapInput, type SwapIntent, Token, type TokenInput, type TosStatus, type TransferAuthorization, USDC, USDC_EIP712_DOMAIN, type VaultInfo, WINDOW, WITNESS_TYPE_STRING, type X402HandleResult, type X402PaymentOption, type X402PaymentRequired, type X402Resource, X402_PROXY_ADDRESS, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, encodeRef, encryptKeystore, extractX402Metadata, findMatchingOption, formatPaymentSignature, getBotConfig, getChain, getDomainSeparator, getKnownTokensForChain, getOperatorCeilings, getRebalanceTokenCount, getTokenSymbolByAddress, getVaultOperator, getVaultOwner, getVaultVersion, isBotActive, isDestinationAllowed, isRebalanceTokenWhitelisted, isVaultPaused, operatorMaxDrainPerDay, parseAmount, parseChainId, parsePaymentRequired, randomNonce, randomPermit2Nonce, resolveToken, resolveTokenDecimals, signExecuteIntent, signPayment, signPermit2WitnessTransfer, signSwapIntent, signTransferWithAuthorization };
+export { type AmountInput, AxonClient, type AxonClientConfig, AxonRegistryAbi, AxonVaultAbi, AxonVaultFactoryAbi, type BotConfig, type BotConfigParams, CHAIN_NAMES, Chain, DEFAULT_APPROVED_TOKENS, 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, PERMIT2_ADDRESS, type PayInput, PaymentErrorCode, type PaymentIntent, type PaymentResult, type PaymentStatus, type Permit2Authorization, RELAYER_API, type RebalanceTokensResult, SUPPORTED_CHAIN_IDS, SWAP_INTENT_TYPEHASH, type SpendingLimit, type SupportedChainId, type SwapInput, type SwapIntent, Token, type TokenInput, type TosStatus, type TransferAuthorization, USDC, USDC_EIP712_DOMAIN, type VaultInfo, WINDOW, WITNESS_TYPE_STRING, type X402HandleResult, type X402PaymentOption, type X402PaymentRequired, type X402Resource, X402_PROXY_ADDRESS, addBot, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, deposit, encodeRef, encryptKeystore, extractX402Metadata, findMatchingOption, formatPaymentSignature, getBotConfig, getChain, getDefaultApprovedTokens, getDomainSeparator, getKnownTokensForChain, getOperatorCeilings, getRebalanceTokenCount, getTokenSymbolByAddress, getVaultOperator, getVaultOwner, getVaultVersion, isBotActive, isDestinationAllowed, isRebalanceTokenWhitelisted, isVaultPaused, operatorMaxDrainPerDay, parseAmount, parseChainId, parsePaymentRequired, randomNonce, randomPermit2Nonce, removeBot, resolveToken, resolveTokenDecimals, signExecuteIntent, signPayment, signPermit2WitnessTransfer, signSwapIntent, signTransferWithAuthorization, updateBotConfig };