@axonfi/sdk 0.4.4 → 0.5.0

package/dist/index.d.cts

@@ -1014,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;
@@ -3338,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_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, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, 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, 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 };

package/dist/index.d.ts

@@ -1014,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;
@@ -3338,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_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, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, 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, 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 };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { keccak256, stringToBytes, createPublicClient, http, createWalletClient, parseUnits } from 'viem';
+import { keccak256, stringToBytes, createPublicClient, http, createWalletClient, erc20Abi, parseUnits } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { arbitrumSepolia, arbitrum, baseSepolia, base } from 'viem/chains';
 import { scryptAsync } from '@noble/hashes/scrypt';
@@ -2544,8 +2544,6 @@ var AxonVaultFactoryAbi = [
     "inputs": []
   }
 ];
-
-// src/vault.ts
 function getChain(chainId) {
   switch (chainId) {
     case 8453:
@@ -2749,6 +2747,79 @@ async function deployVault(walletClient, publicClient, factoryAddress) {
   }
   throw new Error("VaultDeployed event not found in transaction receipt");
 }
+async function addBot(walletClient, publicClient, vaultAddress, botAddress, config) {
+  if (!walletClient.account) {
+    throw new Error("walletClient has no account attached");
+  }
+  const hash = await walletClient.writeContract({
+    address: vaultAddress,
+    abi: AxonVaultAbi,
+    functionName: "addBot",
+    args: [botAddress, config],
+    account: walletClient.account,
+    chain: walletClient.chain ?? null
+  });
+  await publicClient.waitForTransactionReceipt({ hash });
+  return hash;
+}
+async function updateBotConfig(walletClient, publicClient, vaultAddress, botAddress, config) {
+  if (!walletClient.account) {
+    throw new Error("walletClient has no account attached");
+  }
+  const hash = await walletClient.writeContract({
+    address: vaultAddress,
+    abi: AxonVaultAbi,
+    functionName: "updateBotConfig",
+    args: [botAddress, config],
+    account: walletClient.account,
+    chain: walletClient.chain ?? null
+  });
+  await publicClient.waitForTransactionReceipt({ hash });
+  return hash;
+}
+async function removeBot(walletClient, publicClient, vaultAddress, botAddress) {
+  if (!walletClient.account) {
+    throw new Error("walletClient has no account attached");
+  }
+  const hash = await walletClient.writeContract({
+    address: vaultAddress,
+    abi: AxonVaultAbi,
+    functionName: "removeBot",
+    args: [botAddress],
+    account: walletClient.account,
+    chain: walletClient.chain ?? null
+  });
+  await publicClient.waitForTransactionReceipt({ hash });
+  return hash;
+}
+async function deposit(walletClient, publicClient, vaultAddress, token, amount, ref = "0x0000000000000000000000000000000000000000000000000000000000000000") {
+  if (!walletClient.account) {
+    throw new Error("walletClient has no account attached");
+  }
+  const isEth = token.toLowerCase() === NATIVE_ETH.toLowerCase();
+  if (!isEth) {
+    const approveTx = await walletClient.writeContract({
+      address: token,
+      abi: erc20Abi,
+      functionName: "approve",
+      args: [vaultAddress, amount],
+      account: walletClient.account,
+      chain: walletClient.chain ?? null
+    });
+    await publicClient.waitForTransactionReceipt({ hash: approveTx });
+  }
+  const hash = await walletClient.writeContract({
+    address: vaultAddress,
+    abi: AxonVaultAbi,
+    functionName: "deposit",
+    args: [token, amount, ref],
+    account: walletClient.account,
+    chain: walletClient.chain ?? null,
+    ...isEth ? { value: amount } : {}
+  });
+  await publicClient.waitForTransactionReceipt({ hash });
+  return hash;
+}
 
 // src/tokens.ts
 var Token = /* @__PURE__ */ ((Token2) => {
@@ -4373,6 +4444,6 @@ var AxonRegistryAbi = [
   }
 ];
 
-export { AxonClient, AxonRegistryAbi, AxonVaultAbi, AxonVaultFactoryAbi, CHAIN_NAMES, Chain, DEFAULT_APPROVED_TOKENS, DEFAULT_DEADLINE_SECONDS, EIP712_DOMAIN_NAME, EIP712_DOMAIN_VERSION, EXECUTE_INTENT_TYPEHASH, EXPLORER_ADDR, EXPLORER_TX, KNOWN_TOKENS, NATIVE_ETH, PAYMENT_INTENT_TYPEHASH, PERMIT2_ADDRESS, PaymentErrorCode, RELAYER_API, SUPPORTED_CHAIN_IDS, SWAP_INTENT_TYPEHASH, Token, USDC, USDC_EIP712_DOMAIN, WINDOW, WITNESS_TYPE_STRING, X402_PROXY_ADDRESS, createAxonPublicClient, createAxonWalletClient, decryptKeystore, deployVault, 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, resolveToken, resolveTokenDecimals, signExecuteIntent, signPayment, signPermit2WitnessTransfer, signSwapIntent, signTransferWithAuthorization };
+export { AxonClient, AxonRegistryAbi, AxonVaultAbi, AxonVaultFactoryAbi, CHAIN_NAMES, Chain, DEFAULT_APPROVED_TOKENS, DEFAULT_DEADLINE_SECONDS, EIP712_DOMAIN_NAME, EIP712_DOMAIN_VERSION, EXECUTE_INTENT_TYPEHASH, EXPLORER_ADDR, EXPLORER_TX, KNOWN_TOKENS, NATIVE_ETH, PAYMENT_INTENT_TYPEHASH, PERMIT2_ADDRESS, PaymentErrorCode, RELAYER_API, SUPPORTED_CHAIN_IDS, SWAP_INTENT_TYPEHASH, Token, USDC, USDC_EIP712_DOMAIN, WINDOW, WITNESS_TYPE_STRING, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map