@axonfi/sdk 0.3.3 → 0.3.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Axon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -29,7 +29,7 @@ npm install @axonfi/sdk
 ### With Encrypted Keystore (recommended)
 
 ```typescript
-import { AxonClient, decryptKeystore } from '@axonfi/sdk';
+import { AxonClient, Chain, Token, decryptKeystore } from '@axonfi/sdk';
 import fs from 'fs';
 
 const keystore = fs.readFileSync('./axon-bot.json', 'utf8');
@@ -37,14 +37,14 @@ const botPrivateKey = await decryptKeystore(keystore, process.env.BOT_PASSPHRASE
 
 const axon = new AxonClient({
   vaultAddress: '0x...',
-  chainId: 8453, // Base
+  chainId: Chain.Base,
   botPrivateKey,
 });
 
 // Pay 5 USDC — SDK handles decimals automatically
 const result = await axon.pay({
   to: '0xRecipient',
-  token: 'USDC',
+  token: Token.USDC,
   amount: 5,
   memo: 'API call payment',
 });
@@ -55,11 +55,11 @@ console.log(result.status, result.txHash);
 ### With Raw Private Key
 
 ```typescript
-import { AxonClient } from '@axonfi/sdk';
+import { AxonClient, Chain } from '@axonfi/sdk';
 
 const axon = new AxonClient({
   vaultAddress: '0x...',
-  chainId: 8453,
+  chainId: Chain.Base,
   botPrivateKey: process.env.BOT_PRIVATE_KEY!,
 });
 ```
@@ -70,13 +70,13 @@ The SDK accepts amounts in three formats:
 
 ```typescript
 // Human-readable number — SDK converts using token decimals
-await axon.pay({ to, token: 'USDC', amount: 5.2 });
+await axon.pay({ to, token: Token.USDC, amount: 5.2 });
 
 // Human-readable string — recommended for computed values
-await axon.pay({ to, token: 'USDC', amount: '5.2' });
+await axon.pay({ to, token: Token.USDC, amount: '5.2' });
 
 // Raw bigint — base units, passed through as-is
-await axon.pay({ to, token: 'USDC', amount: 5_200_000n });
+await axon.pay({ to, token: Token.USDC, amount: 5_200_000n });
 ```
 
 Token field accepts addresses, `Token` enum values, or symbol strings:
@@ -98,8 +98,8 @@ Send USDC (or any ERC-20) to any address. The bot signs an EIP-712 intent — Ax
 ```typescript
 const result = await axon.pay({
   to: '0xRecipient',
-  token: 'USDC', // or Token.USDC, or an address
-  amount: 25, // or '25', or 25_000_000n
+  token: Token.USDC,
+  amount: 25,
   memo: 'Invoice #42',
 });
 
@@ -113,7 +113,7 @@ Rebalance tokens inside your vault without withdrawing. Swap between any tokens
 
 ```typescript
 const result = await axon.swap({
-  toToken: 'WETH',
+  toToken: Token.WETH,
   minToAmount: 0.001,
   memo: 'Rebalance to WETH',
 });
@@ -127,7 +127,7 @@ Interact with DeFi and Web3 protocols (Uniswap, Aave, GMX, etc.) that need permi
 const result = await axon.execute({
   protocol: '0xUniswapRouter',
   callData: '0x...',
-  token: 'USDC',
+  token: Token.USDC,
   amount: 100,
 });
 ```
@@ -184,13 +184,16 @@ Payments resolve through one of three paths:
 | Optimism     | 10    | Coming soon |
 | Polygon PoS  | 137   | Coming soon |
 
-## Documentation
+## Links
 
-- [Full SDK Reference](https://axonfi.xyz/docs/sdk/typescript/client)
-- [Quickstart Guide](https://axonfi.xyz/docs/getting-started/quickstart)
-- [How It Works](https://axonfi.xyz/docs/getting-started/how-it-works)
-- [Security Model](https://axonfi.xyz/docs/architecture/security-model)
-- [HTTP 402 Payments](https://axonfi.xyz/docs/guides/http-402)
+- [Website](https://axonfi.xyz)
+- [Dashboard](https://app.axonfi.xyz)
+- [Documentation](https://axonfi.xyz/llms.txt)
+- [npm — @axonfi/sdk](https://www.npmjs.com/package/@axonfi/sdk)
+- [PyPI — axonfi](https://pypi.org/project/axonfi/) (Python SDK)
+- [Smart Contracts](https://github.com/axonfi/contracts)
+- [Examples](https://github.com/axonfi/examples)
+- [Twitter/X — @axonfixyz](https://x.com/axonfixyz)
 
 ## License
 

package/dist/index.cjs

@@ -264,11 +264,6 @@ var AxonVaultAbi = [
         "name": "_axonRegistry",
         "type": "address",
         "internalType": "address"
-      },
-      {
-        "name": "_trackUsedIntents",
-        "type": "bool",
-        "internalType": "bool"
       }
     ],
     "stateMutability": "nonpayable"
@@ -1330,19 +1325,6 @@ var AxonVaultAbi = [
     "outputs": [],
     "stateMutability": "nonpayable"
   },
-  {
-    "type": "function",
-    "name": "trackUsedIntents",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "bool",
-        "internalType": "bool"
-      }
-    ],
-    "stateMutability": "view"
-  },
   {
     "type": "function",
     "name": "transferOwnership",
@@ -2242,6 +2224,11 @@ var AxonVaultAbi = [
       }
     ]
   },
+  {
+    "type": "error",
+    "name": "SameTokenSwap",
+    "inputs": []
+  },
   {
     "type": "error",
     "name": "SelfPayment",
@@ -2350,13 +2337,7 @@ var AxonVaultFactoryAbi = [
   {
     "type": "function",
     "name": "deployVault",
-    "inputs": [
-      {
-        "name": "trackUsedIntents",
-        "type": "bool",
-        "internalType": "bool"
-      }
-    ],
+    "inputs": [],
     "outputs": [
       {
         "name": "vault",
@@ -2533,12 +2514,6 @@ var AxonVaultFactoryAbi = [
         "type": "address",
         "indexed": false,
         "internalType": "address"
-      },
-      {
-        "name": "trackUsedIntents",
-        "type": "bool",
-        "indexed": false,
-        "internalType": "bool"
       }
     ],
     "anonymous": false
@@ -2691,13 +2666,6 @@ async function getVaultOperator(publicClient, vaultAddress) {
     functionName: "operator"
   });
 }
-async function getTrackUsedIntents(publicClient, vaultAddress) {
-  return publicClient.readContract({
-    address: vaultAddress,
-    abi: AxonVaultAbi,
-    functionName: "trackUsedIntents"
-  });
-}
 async function isDestinationAllowed(publicClient, vaultAddress, botAddress, destination) {
   const isBlacklisted = await publicClient.readContract({
     address: vaultAddress,
@@ -2759,7 +2727,7 @@ async function isRebalanceTokenWhitelisted(publicClient, vaultAddress, token) {
     args: [token]
   });
 }
-async function deployVault(walletClient, publicClient, factoryAddress, trackUsedIntents = true) {
+async function deployVault(walletClient, publicClient, factoryAddress) {
   if (!walletClient.account) {
     throw new Error("walletClient has no account attached");
   }
@@ -2767,7 +2735,7 @@ async function deployVault(walletClient, publicClient, factoryAddress, trackUsed
     address: factoryAddress,
     abi: AxonVaultFactoryAbi,
     functionName: "deployVault",
-    args: [trackUsedIntents],
+    args: [],
     account: walletClient.account,
     chain: walletClient.chain ?? null
   });
@@ -2825,6 +2793,7 @@ var KNOWN_TOKENS = {
     decimals: 6,
     addresses: {
       8453: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
+      84532: "0x323e78f944A9a1FcF3a10efcC5319DBb0bB6e673",
       42161: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9"
     }
   },
@@ -2845,7 +2814,8 @@ var KNOWN_TOKENS = {
     addresses: {
       8453: "0x4200000000000000000000000000000000000006",
       84532: "0x4200000000000000000000000000000000000006",
-      42161: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"
+      42161: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
+      421614: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"
     }
   },
   WBTC: {
@@ -2995,6 +2965,9 @@ function getTokenSymbolByAddress(address) {
 }
 function resolveToken(token, chainId) {
   if (typeof token === "string" && token.startsWith("0x")) {
+    if (token === "0x0000000000000000000000000000000000000000") {
+      throw new Error("Token address cannot be the zero address");
+    }
     return token;
   }
   const entry = KNOWN_TOKENS[token];
@@ -3178,7 +3151,7 @@ var AxonClient = class {
   // ============================================================================
   // getVaultInfo() — via relayer
   // ============================================================================
-  /** Returns high-level vault info (owner, operator, paused, version, trackUsedIntents) via relayer. */
+  /** Returns high-level vault info (owner, operator, paused, version) via relayer. */
   async getVaultInfo() {
     const path = RELAYER_API.vaultInfo(this.vaultAddress, this.chainId);
     return this._get(path);
@@ -3316,6 +3289,9 @@ Timestamp: ${timestamp}`;
     return "0x0000000000000000000000000000000000000000000000000000000000000000";
   }
   _buildPaymentIntent(input) {
+    if (input.to === "0x0000000000000000000000000000000000000000") {
+      throw new Error("Payment recipient cannot be the zero address");
+    }
     return {
       bot: this.botAddress,
       to: input.to,
@@ -3960,7 +3936,6 @@ exports.getKnownTokensForChain = getKnownTokensForChain;
 exports.getOperatorCeilings = getOperatorCeilings;
 exports.getRebalanceTokenCount = getRebalanceTokenCount;
 exports.getTokenSymbolByAddress = getTokenSymbolByAddress;
-exports.getTrackUsedIntents = getTrackUsedIntents;
 exports.getVaultOperator = getVaultOperator;
 exports.getVaultOwner = getVaultOwner;
 exports.getVaultVersion = getVaultVersion;