@sodax/sdk 2.0.0-rc.2 → 2.0.0-rc.4

package/README.md

@@ -98,73 +98,21 @@ How to setup local development
 
 ## AI agent docs
 
-`@sodax/sdk` ships an AI-ready documentation tree at `node_modules/@sodax/sdk/ai-exported/`. It's tool-neutral: any agent that can read files (Claude Code, Cursor, Aider, Copilot Chat, ChatGPT with file context, etc.) can use it without further setup.
+AI-readable docs for `@sodax/sdk` (and the other `@sodax/*` packages) are shipped via [`@sodax/skills`](https://github.com/icon-project/sodax-sdks/tree/main/packages/skills) — a separate npm package bundling Claude-Code SKILL.md files and a long-form knowledge tree.
 
-### Get started
+**Recommended: [`skills` CLI](https://github.com/vercel-labs/skills)** — from your project root:
 
-Point your agent at `node_modules/@sodax/sdk/ai-exported/AGENTS.md` — it routes to the rest. Three sample prompts covering the typical entry points:
-
-```
-> Read node_modules/@sodax/sdk/ai-exported/AGENTS.md and integrate
-> SODAX cross-chain swaps from Arbitrum to Stellar into my Node service.
-
-> Read node_modules/@sodax/sdk/ai-exported/AGENTS.md. My code uses
-> @sodax/sdk v1 — port my call sites to v2.
-
-> Look up the v2 SodaxError code for a relay timeout in
-> node_modules/@sodax/sdk/ai-exported/integration/reference/error-codes.md.
+```bash
+npx skills@latest add icon-project/sodax-sdks/packages/skills
 ```
 
-### What's inside
+**npm + `AGENTS.md` pointer** (fallback for web chats, or when you prefer a devDependency over the CLI):
 
+```bash
+pnpm add -D @sodax/skills
 ```
-ai-exported/
-├── AGENTS.md                          # Tool-neutral entry point — start here
-├── integration/                       # Building NEW v2 code
-│   ├── README.md, ai-rules.md         # Index + DO / DO NOT / workflow for agents
-│   ├── quickstart.md                  # Install + initialize + first-run troubleshooting
-│   ├── architecture.md                # Type system + design concepts (Result, ChainKeys, …)
-│   ├── chain-specifics.md             # Non-EVM quirks (Stellar, BTC, Solana, ICON, NEAR)
-│   ├── features/                      # 7 feature pages: swap, money-market, staking, bridge,
-│   │                                  #   dex, icx-bnusd-baln, auxiliary-services
-│   ├── recipes/                       # 8 copy-pasteable patterns: init, signed-/raw-tx flow,
-│   │                                  #   error handling, narrowing, testing, gas, backend init
-│   └── reference/                     # 5 lookup tables: chain keys, wallet providers,
-│                                      #   error codes, public API surface, glossary
-└── migration/                         # Porting EXISTING v1 code to v2
-    ├── README.md, ai-rules.md         # Index + workflow for porting agents
-    ├── checklist.md                   # 17-step cross-cutting checklist
-    ├── breaking-changes/              # 3 cross-cutting changes: type-system, architecture,
-    │                                  #   result-and-errors
-    ├── features/                      # 7 per-feature porting playbooks (same names as
-    │                                  #   integration/features/)
-    ├── recipes.md                     # Codemods + error-shape and Result adapters
-    └── reference/                     # 4 reference tables: deleted exports, sodax-config
-                                       #   reshape, error-code crosswalk, return-shape diffs
-```
-
-### Scope
-
-This tree documents `@sodax/sdk` (the Core SDK) only. It assumes:
-
-- **TypeScript** — examples are TS; the SDK ships dual ESM/CJS.
-- **Runtime-agnostic** — Node.js, browsers, bundled apps. **No React or Next.js content** — the SDK is UI-framework-agnostic and the docs reflect that.
-- **`@sodax/types` is re-exported** through `@sodax/sdk`'s barrel; consumers don't add it as a separate dependency.
-
-`@sodax/wallet-sdk-core` is **mentioned** in a few places as a pointer — it's a separate SODAX package that ships ready-made `I*WalletProvider` implementations for all 9 chain families. Consumers can install it separately or implement the wallet-provider interfaces themselves. React-layer packages (`@sodax/wallet-sdk-react`, `@sodax/dapp-kit`) are **out of scope here** and may have their own `ai-exported/` trees in their respective packages.
-
-### Integrity guarantees
-
-Every release passes four CI checks against `ai-exported/`:
-
-| Guard | What it catches |
-|---|---|
-| `check:ai-exported` | Each top-level `sodax.X` reference matches a real public member of the `Sodax` class in `src/shared/entities/Sodax.ts`. (Shallow — `sodax.partners.invented` would still pass.) |
-| `check:ai-scope` | No accidental sibling-package, React, or Next.js content leaks in. |
-| `check:ai-links` | Every relative link between markdown files resolves. |
-| `check:ai-imports` | Every `import … from '@sodax/sdk'` example in the docs typechecks against the SDK source. |
 
-If you're contributing to this repo, run them with `pnpm -C packages/sdk run check:ai-exported` (or `:scope`, `:links`, `:imports`).
+Then point your agent at `node_modules/@sodax/skills/AGENTS.md`. See [docs/ai-integration-guide.md](https://github.com/icon-project/sodax-sdks/blob/main/docs/ai-integration-guide.md) for all install modes and per-tool wiring.
 
 ***
 

package/dist/index.cjs

@@ -8,7 +8,7 @@ var transactions = require('@stacks/transactions');
 var chains = require('viem/chains');
 var rlp = require('rlp');
 var network = require('@stacks/network');
-var bitcoin = require('bitcoinjs-lib');
+var bitcoinjsLib = require('bitcoinjs-lib');
 var ecc = require('@bitcoinerlab/secp256k1');
 var infinitySdk = require('@pancakeswap/infinity-sdk');
 var transactions$1 = require('@mysten/sui/transactions');
@@ -44,9 +44,7 @@ function _interopNamespace(e) {
 }
 
 var rlp__namespace = /*#__PURE__*/_interopNamespace(rlp);
-var bitcoin__namespace = /*#__PURE__*/_interopNamespace(bitcoin);
 var ecc__namespace = /*#__PURE__*/_interopNamespace(ecc);
-var anchor__namespace = /*#__PURE__*/_interopNamespace(anchor);
 var BN__default = /*#__PURE__*/_interopDefault(BN);
 var IconSdkRaw__namespace = /*#__PURE__*/_interopNamespace(IconSdkRaw);
 var BigNumber5__default = /*#__PURE__*/_interopDefault(BigNumber5);
@@ -518,7 +516,7 @@ var SodaTokens = {
   sodaNEAR: {
     symbol: "sodaNEAR",
     name: "SODA NEAR",
-    decimals: 24,
+    decimals: 18,
     address: "0xf4ba497c9b805e4bd88a8a9e6a7b8f74984c3e39",
     chainKey: ChainKeys.SONIC_MAINNET,
     hubAsset: "0xf4ba497c9b805e4bd88a8a9e6a7b8f74984c3e39",
@@ -3233,7 +3231,8 @@ var moneyMarketSupportedTokens = {
     spokeChainConfig[ChainKeys.HYPEREVM_MAINNET].supportedTokens.HYPE,
     spokeChainConfig[ChainKeys.HYPEREVM_MAINNET].supportedTokens.bnUSD,
     spokeChainConfig[ChainKeys.HYPEREVM_MAINNET].supportedTokens.SODA,
-    spokeChainConfig[ChainKeys.HYPEREVM_MAINNET].supportedTokens.USDT0
+    spokeChainConfig[ChainKeys.HYPEREVM_MAINNET].supportedTokens.USDT0,
+    spokeChainConfig[ChainKeys.HYPEREVM_MAINNET].supportedTokens.USDC
   ],
   [ChainKeys.LIGHTLINK_MAINNET]: [
     spokeChainConfig[ChainKeys.LIGHTLINK_MAINNET].supportedTokens.ETH,
@@ -3517,7 +3516,6 @@ var swapSupportedTokens = {
     spokeChainConfig[ChainKeys.SONIC_MAINNET].supportedTokens.USDT,
     spokeChainConfig[ChainKeys.SONIC_MAINNET].supportedTokens.wS,
     spokeChainConfig[ChainKeys.SONIC_MAINNET].supportedTokens.SODA,
-    spokeChainConfig[ChainKeys.SONIC_MAINNET].supportedTokens.bnUSD,
     ...Object.values(SodaTokens)
   ],
   [ChainKeys.AVALANCHE_MAINNET]: [
@@ -3899,7 +3897,7 @@ function isValidWalletProviderForChainKey(chainKey, walletProvider) {
 }
 
 // ../types/dist/index.js
-var CONFIG_VERSION = 200;
+var CONFIG_VERSION = 202;
 function isEvmSpokeChainConfig(value) {
   return typeof value === "object" && value !== null && value.chain.type === "EVM" && value.chain.key !== HUB_CHAIN_KEY;
 }
@@ -14700,7 +14698,7 @@ function normalizePsbtToBase64(signedPsbt) {
 }
 
 // src/shared/services/spoke/BitcoinSpokeService.ts
-bitcoin__namespace.initEccLib(ecc__namespace);
+bitcoinjsLib.initEccLib(ecc__namespace);
 var BITCOIN_DEFAULT_FEE_RATE = 3;
 var DUST_THRESHOLD = 546;
 var BitcoinSpokeService = class {
@@ -14720,7 +14718,7 @@ var BitcoinSpokeService = class {
     this.maxTimeoutMs = chainConfig.pollingConfig.maxTimeoutMs;
   }
   getBtcNetwork(chainId) {
-    return this.config.getChainConfig(chainId).network === "MAINNET" ? bitcoin__namespace.networks.bitcoin : bitcoin__namespace.networks.testnet;
+    return this.config.getChainConfig(chainId).network === "MAINNET" ? bitcoinjsLib.networks.bitcoin : bitcoinjsLib.networks.testnet;
   }
   async getBalance(tokenAddress, walletAddress) {
     if (!tokenAddress || tokenAddress === "0x" || tokenAddress === "BTC") {
@@ -14732,7 +14730,7 @@ var BitcoinSpokeService = class {
   }
   async fetchScriptPubKey(utxo) {
     const txHex = await this.fetchRawTransaction(utxo.txid);
-    const tx = bitcoin__namespace.Transaction.fromHex(txHex);
+    const tx = bitcoinjsLib.Transaction.fromHex(txHex);
     const out = tx.outs[utxo.vout];
     if (!out) {
       throw new Error(`UTXO not found: ${utxo.txid}:${utxo.vout}`);
@@ -14834,7 +14832,7 @@ var BitcoinSpokeService = class {
    * Build a priority Bitcoin transaction with proper fee calculation
    */
   async buildBitcoinTransaction(utxos, outputs, changeAddress, chainId, walletProvider, feeRate) {
-    const psbt = new bitcoin__namespace.Psbt({ network: this.getBtcNetwork(chainId) });
+    const psbt = new bitcoinjsLib.Psbt({ network: this.getBtcNetwork(chainId) });
     const effectiveFeeRate = feeRate ?? await this.getFeeRateEstimate();
     const walletAddress = await walletProvider.getWalletAddress();
     const addressType = detectBitcoinAddressType(walletAddress);
@@ -14865,7 +14863,7 @@ var BitcoinSpokeService = class {
           throw new Error("Missing public key for P2SH-P2WPKH input");
         }
         const pubKeyHex = await walletProvider.getPublicKey();
-        const redeemScript = bitcoin__namespace.payments.p2wpkh({
+        const redeemScript = bitcoinjsLib.payments.p2wpkh({
           pubkey: Buffer.from(pubKeyHex, "hex"),
           network: this.getBtcNetwork(chainId)
         }).output;
@@ -15022,14 +15020,14 @@ var BitcoinSpokeService = class {
       const psbt = await this.buildBitcoinTransaction(utxos, outputs, walletAddress, srcChainKey, walletProvider);
       const OP_RADFI_SODAX_DATA = 49;
       const payload = Buffer.concat([Buffer.from([OP_RADFI_SODAX_DATA]), Buffer.from(data.slice(2), "hex")]);
-      const OP_RETURN = bitcoin__namespace.opcodes.OP_RETURN;
-      const OP_12 = bitcoin__namespace.opcodes.OP_12;
+      const OP_RETURN = bitcoinjsLib.opcodes.OP_RETURN;
+      const OP_12 = bitcoinjsLib.opcodes.OP_12;
       if (OP_RETURN === void 0 || OP_12 === void 0) {
         throw new Error("bitcoinjs-lib opcodes OP_RETURN or OP_12 are undefined");
       }
-      const script2 = bitcoin__namespace.script.compile([OP_RETURN, OP_12, payload]);
+      const compiledScript = bitcoinjsLib.script.compile([OP_RETURN, OP_12, payload]);
       psbt.addOutput({
-        script: script2,
+        script: compiledScript,
         value: 0
       });
       return psbt;
@@ -21631,7 +21629,7 @@ var SonicSpokeService = class {
   }
   /**
    * Deposit tokens to the spoke chain using the Sonic wallet abstraction.
-   * @param {SonicSpokeDepositParams<Raw>} params - The parameters for the deposit
+   * @param {DepositParams<SonicChainKey, Raw>} params - The parameters for the deposit
    * @returns {Promise<TxReturnType<SonicChainKey, Raw>>} A promise that resolves to the transaction hash
    */
   async deposit(params) {
@@ -21860,9 +21858,6 @@ var SuiSpokeService = class {
     }
     return coin;
   }
-  static getAddressBCSBytes(suiaddress) {
-    return viem.toHex(bcs.bcs.Address.serialize(suiaddress).toBytes());
-  }
   encodeSimulationParams(token, assetManager) {
     const encoder2 = new TextEncoder();
     return {
@@ -21977,8 +21972,7 @@ var SuiSpokeService = class {
   }
   /**
    * Get the balance of the token in the spoke chain.
-   * @param {Address} token - The address of the token to get the balance of.
-   * @param {SuiSpokeProvider} spokeProvider - The spoke provider.
+   * @param {GetDepositParams<SuiChainKey>} params - The src chain key, src address, and token address.
    * @returns {Promise<bigint>} The balance of the token.
    */
   async getDeposit(params) {
@@ -22002,7 +21996,7 @@ var SuiSpokeService = class {
   }
   /**
    * Fetch the asset manager config from the spoke chain.
-   * @param {SuiBaseSpokeProvider} suiSpokeProvider - The spoke provider.
+   * @param {SuiChainKey} chainId - The Sui chain key.
    * @returns {Promise<string>} The asset manager config.
    */
   async fetchAssetManagerAddress(chainId) {
@@ -22011,7 +22005,7 @@ var SuiSpokeService = class {
   }
   /**
    * Fetch the latest asset manager package id from the spoke chain.
-   * @param {SuiBaseSpokeProvider} suiSpokeProvider - The spoke provider.
+   * @param {SuiChainKey} chainId - The Sui chain key.
    * @returns {Promise<string>} The latest asset manager package id.
    */
   async fetchLatestAssetManagerPackageId(chainId) {
@@ -22625,11 +22619,11 @@ async function getProvider(base58PublicKey, rpcUrl) {
     signAllTransactions: () => Promise.reject()
   };
   const connection = new web3_js.Connection(rpcUrl);
-  return new anchor__namespace.AnchorProvider(connection, wallet, { commitment: "confirmed" });
+  return new anchor.AnchorProvider(connection, wallet, { commitment: "confirmed" });
 }
 async function getAssetManagerIdl(assetManager, provider) {
   try {
-    const idl = await anchor__namespace.Program.fetchIdl(new web3_js.PublicKey(assetManager), provider);
+    const idl = await anchor.Program.fetchIdl(new web3_js.PublicKey(assetManager), provider);
     if (!idl) {
       throw new Error("asset manager idl not available");
     }
@@ -22641,7 +22635,7 @@ async function getAssetManagerIdl(assetManager, provider) {
 }
 async function getConnectionIdl(connection, provider) {
   try {
-    const idl = await anchor__namespace.Program.fetchIdl(new web3_js.PublicKey(connection), provider);
+    const idl = await anchor.Program.fetchIdl(new web3_js.PublicKey(connection), provider);
     if (!idl) {
       throw new Error("asset manager idl not available");
     }
@@ -22654,12 +22648,12 @@ async function getConnectionIdl(connection, provider) {
 async function getAssetManagerProgram(base58PublicKey, rpcUrl, assetManager) {
   const provider = await getProvider(base58PublicKey, rpcUrl);
   const idl = await getAssetManagerIdl(assetManager, provider);
-  return new anchor__namespace.Program(idl, provider);
+  return new anchor.Program(idl, provider);
 }
 async function getConnectionProgram(base58PublicKey, rpcUrl, connection) {
   const provider = await getProvider(base58PublicKey, rpcUrl);
   const idl = await getConnectionIdl(connection, provider);
-  return new anchor__namespace.Program(idl, provider);
+  return new anchor.Program(idl, provider);
 }
 function getSolanaAddressBytes(address) {
   return `0x${Buffer.from(address.toBytes()).toString("hex")}`;
@@ -22971,7 +22965,7 @@ var IconSpokeService = class {
   }
   /**
    * Deposit tokens to the spoke chain.
-   * @param {IconSpokeDepositParams} params - The parameters for the deposit
+   * @param {DepositParams<IconChainKey, R>} params - The parameters for the deposit
    * @param {IconSpokeProviderType} spokeProvider - The provider for the spoke chain
    * @param {EvmHubProvider} hubProvider - The provider for the hub chain
    * @param {boolean} raw - The return type raw or just transaction hash
@@ -28051,7 +28045,7 @@ var MigrationService = class {
       );
       const hubWalletAddress = await this.hubProvider.getUserHubWalletAddress(
         params.srcAddress,
-        ChainKeys.SONIC_MAINNET
+        ChainKeys.ICON_MAINNET
       );
       const coreParams = {
         srcChainKey: ChainKeys.ICON_MAINNET,
@@ -29151,11 +29145,7 @@ var BridgeService = class {
    *   checking theoretical bridgeability without requiring both chains to be in the active config.
    * @returns `true` if the tokens share the same hub vault; `false` otherwise.
    */
-  isBridgeable({
-    from,
-    to,
-    unchecked = false
-  }) {
+  isBridgeable({ from, to, unchecked = false }) {
     try {
       if (!unchecked) {
         bridgeInvariant(this.config.isValidSpokeChainKey(from.chainKey), `Invalid spoke chain (${from.chainKey})`, {
@@ -34349,7 +34339,8 @@ var UiPoolDataProviderService = class {
       // The borrow index must also come from the bnUSD debt token.
       // User debt is stored scaled by bnUSD's index, so reading it back requires the same index.
       // Using the vault's index here would inflate the displayed debt amount.
-      variableBorrowIndex: bnUSDReserve.variableBorrowIndex
+      variableBorrowIndex: bnUSDReserve.variableBorrowIndex,
+      borrowingEnabled: bnUSDReserve.borrowingEnabled
     };
     return [
       [
@@ -37135,5 +37126,3 @@ exports.waitForTransactionReceipt = waitForTransactionReceipt;
 exports.waitUntilIntentExecuted = waitUntilIntentExecuted;
 exports.walletFactoryAbi = walletFactoryAbi;
 exports.wrappedSonicAbi = wrappedSonicAbi;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map