@sodax/wallet-sdk-core 2.0.0-rc.3 → 2.0.0-rc.5

package/README.md

@@ -2,8 +2,7 @@
 
 The Sodax wallet-sdk-core is a core wallet SDK package containing implementations of wallet providers that enable multi-chain wallet connectivity. This package provides TypeScript implementations of wallet providers for various blockchain networks, making them compatible with the Core Sodax SDK (@sodax/sdk).
 
-> **AI-friendly docs:** see [`ai-exported/AGENTS.md`](./ai-exported/AGENTS.md) for the agent-readable integration & migration guide.
-> Entry points: [`ai-exported/integration/`](./ai-exported/integration/) (new setup), [`ai-exported/migration/`](./ai-exported/migration/) (upgrading from older RCs).
+> **AI-friendly docs:** shipped via [`@sodax/skills`](https://github.com/icon-project/sodax-sdks/tree/main/packages/skills) — [`skills` CLI](https://github.com/vercel-labs/skills) recommended; npm + `AGENTS.md` pointer as fallback. 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.
 
 ## Installation
 

package/dist/index.cjs

@@ -5,16 +5,15 @@ var viem = require('viem');
 var chains = require('viem/chains');
 var client = require('@mysten/sui/client');
 var ed25519$1 = require('@mysten/sui/keypairs/ed25519');
-var transactions$1 = require('@mysten/sui/transactions');
+var transactions = require('@mysten/sui/transactions');
 var walletStandard = require('@mysten/wallet-standard');
 var IconSdkRaw = require('icon-sdk-js');
 var sdkTs = require('@injectivelabs/sdk-ts');
 var splToken = require('@solana/spl-token');
 var web3_js = require('@solana/web3.js');
 var stellarSdk = require('@stellar/stellar-sdk');
-var network = require('@stacks/network');
-var transactions = require('@stacks/transactions');
-var connect = require('@stacks/connect');
+var core = require('@sodax/libs/stacks/core');
+var connect = require('@sodax/libs/stacks/connect');
 var bitcoin = require('bitcoinjs-lib');
 var ecc = require('@bitcoinerlab/secp256k1');
 var ecpair = require('ecpair');
@@ -327,7 +326,7 @@ var SodaTokens = {
   sodaNEAR: {
     symbol: "sodaNEAR",
     name: "SODA NEAR",
-    decimals: 24,
+    decimals: 18,
     address: "0xf4ba497c9b805e4bd88a8a9e6a7b8f74984c3e39",
     chainKey: ChainKeys.SONIC_MAINNET,
     hubAsset: "0xf4ba497c9b805e4bd88a8a9e6a7b8f74984c3e39",
@@ -2918,7 +2917,6 @@ var hubConfig = {
     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)
   ]});
 
@@ -3076,8 +3074,8 @@ function isBrowserExtensionSuiWallet(wallet) {
   return "wallet" in wallet && "account" in wallet;
 }
 async function toMystenTransaction(txn) {
-  if (txn instanceof transactions$1.Transaction) return txn;
-  return transactions$1.Transaction.from(await txn.toJSON());
+  if (txn instanceof transactions.Transaction) return txn;
+  return transactions.Transaction.from(await txn.toJSON());
 }
 var SuiWalletProvider = class extends BaseWalletProvider {
   chainType = "SUI";
@@ -3729,10 +3727,10 @@ function isStacksPkWallet(wallet) {
 }
 function toPostConditionModeName(mode) {
   if (mode === void 0) return void 0;
-  return mode === transactions.PostConditionMode.Allow ? "allow" : "deny";
+  return mode === core.PostConditionMode.Allow ? "allow" : "deny";
 }
 function resolveNetwork(selector, endpoint) {
-  const base2 = network.networkFrom(selector ?? "mainnet");
+  const base2 = core.networkFrom(selector ?? "mainnet");
   return endpoint ? { ...base2, client: { ...base2.client, baseUrl: endpoint } } : base2;
 }
 var StacksWalletProvider = class extends BaseWalletProvider {
@@ -3761,7 +3759,7 @@ var StacksWalletProvider = class extends BaseWalletProvider {
     return this.sendTransactionWithAdapter(finalParams, this.wallet);
   }
   async sendTransactionWithPrivateKey(txParams, wallet) {
-    const transaction = await transactions.makeContractCall({
+    const transaction = await core.makeContractCall({
       contractAddress: txParams.contractAddress,
       contractName: txParams.contractName,
       functionName: txParams.functionName,
@@ -3771,7 +3769,7 @@ var StacksWalletProvider = class extends BaseWalletProvider {
       postConditionMode: txParams.postConditionMode,
       postConditions: txParams.postConditions
     });
-    const result = await transactions.broadcastTransaction({ network: this.network, transaction });
+    const result = await core.broadcastTransaction({ network: this.network, transaction });
     return result.txid;
   }
   async sendTransactionWithAdapter(txParams, wallet) {
@@ -3791,7 +3789,7 @@ var StacksWalletProvider = class extends BaseWalletProvider {
     return result.txid;
   }
   async readContract(txParams) {
-    return transactions.fetchCallReadOnlyFunction({
+    return core.fetchCallReadOnlyFunction({
       contractAddress: txParams.contractAddress,
       contractName: txParams.contractName,
       functionName: txParams.functionName,
@@ -3802,13 +3800,13 @@ var StacksWalletProvider = class extends BaseWalletProvider {
   }
   async getWalletAddress() {
     if (isStacksPkWallet(this.wallet)) {
-      return transactions.getAddressFromPrivateKey(this.wallet.privateKey, this.network);
+      return core.getAddressFromPrivateKey(this.wallet.privateKey, this.network);
     }
     return this.wallet.address;
   }
   async getPublicKey() {
     if (isStacksPkWallet(this.wallet)) {
-      return transactions.publicKeyToHex(transactions.privateKeyToPublic(this.wallet.privateKey));
+      return core.publicKeyToHex(core.privateKeyToPublic(this.wallet.privateKey));
     }
     throw new Error("getPublicKey is only supported for private key wallet configuration");
   }
@@ -11637,7 +11635,7 @@ Object.defineProperty(exports, "Networks", {
 });
 Object.defineProperty(exports, "PostConditionMode", {
   enumerable: true,
-  get: function () { return transactions.PostConditionMode; }
+  get: function () { return core.PostConditionMode; }
 });
 exports.BaseWalletProvider = BaseWalletProvider;
 exports.BigNumberToBigInt = BigNumberToBigInt;
@@ -11682,5 +11680,3 @@ exports.isValidStellarPrivateKey = isValidStellarPrivateKey;
 exports.requestAddress = requestAddress;
 exports.requestJsonRpc = requestJsonRpc;
 exports.requestSigning = requestSigning;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { EvmRawTransaction, EvmChainKey, IEvmWalletProvider, EvmRawTransactionReceipt, ISuiWalletProvider, SuiTransaction, SuiExecutionResult, SuiPaginatedCoins, IIconWalletProvider, IcxCallTransaction, IconTransactionResult, InjectiveCoin, IInjectiveWalletProvider, JsonObject, InjectiveRawTransaction, InjectiveEoaAddress, InjectiveExecuteResponse, ISolanaWalletProvider, SolanaRpcResponseAndContext, SolanaSignatureResult, TransactionSignature, SolanaRawTransactionInstruction, SolanaSerializedTransaction, SolanaBase58PublicKey, XDR, Hex as Hex$1, IStellarWalletProvider, StellarRawTransactionReceipt, IStacksWalletProvider, StacksTransactionParams, INearWalletProvider, CallContractParams, NearRawTransaction, BtcAddressType, IBitcoinWalletProvider } from '@sodax/types';
 import * as viem from 'viem';
-import { SendTransactionParameters, WaitForTransactionReceiptParameters, PublicClientConfig, WalletClientConfig, HttpTransportConfig, WalletClient, Transport, Chain, Account, PublicClient, Address, Hash as Hash$1 } from 'viem';
+import { WalletClient, Transport, Chain, Account, PublicClient, PublicClientConfig, WalletClientConfig, HttpTransportConfig, SendTransactionParameters, WaitForTransactionReceiptParameters, Address, Hash as Hash$1 } from 'viem';
 export { Account, Address, Chain, HttpTransportConfig, PublicClient, PublicClientConfig, SendTransactionParameters, TransactionReceipt, Transport, WaitForTransactionReceiptParameters, WalletClient, WalletClientConfig } from 'viem';
-import { SuiTransactionBlockResponseOptions, SuiClient } from '@mysten/sui/client';
+import { SuiClient, SuiTransactionBlockResponseOptions } from '@mysten/sui/client';
 export { SuiTransactionBlockResponseOptions } from '@mysten/sui/client';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { WalletWithFeatures, SuiWalletFeatures, WalletAccount } from '@mysten/wallet-standard';
@@ -22,17 +22,16 @@ export { Commitment, ConnectionConfig, SendOptions } from '@solana/web3.js';
 import { SignerWalletAdapterProps } from '@solana/wallet-adapter-base';
 import { Keypair } from '@stellar/stellar-sdk';
 export { Networks } from '@stellar/stellar-sdk';
-import { PostConditionMode, ClarityValue } from '@stacks/transactions';
-export { ClarityValue, PostConditionMode, PostConditionModeName } from '@stacks/transactions';
-import { StacksProvider } from '@stacks/connect';
-export { StacksProvider } from '@stacks/connect';
+import { PostConditionMode, ClarityValue } from '@sodax/libs/stacks/core';
+export { ClarityValue, PostConditionMode, PostConditionModeName, StacksNetwork } from '@sodax/libs/stacks/core';
+import { StacksProvider } from '@sodax/libs/stacks/connect';
+export { StacksProvider } from '@sodax/libs/stacks/connect';
 import { NearConnector } from '@hot-labs/near-connect';
 export { NearConnector } from '@hot-labs/near-connect';
 import { Account as Account$1, JsonRpcProvider } from 'near-api-js';
 export { KeyPairString } from 'near-api-js';
 import { ECPairInterface } from 'ecpair';
 import * as bitcoin from 'bitcoinjs-lib';
-export { StacksNetwork } from '@stacks/network';
 export { Network as BitcoinJsNetwork } from 'bitcoinjs-lib/src/networks.js';
 
 /**

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { EvmRawTransaction, EvmChainKey, IEvmWalletProvider, EvmRawTransactionReceipt, ISuiWalletProvider, SuiTransaction, SuiExecutionResult, SuiPaginatedCoins, IIconWalletProvider, IcxCallTransaction, IconTransactionResult, InjectiveCoin, IInjectiveWalletProvider, JsonObject, InjectiveRawTransaction, InjectiveEoaAddress, InjectiveExecuteResponse, ISolanaWalletProvider, SolanaRpcResponseAndContext, SolanaSignatureResult, TransactionSignature, SolanaRawTransactionInstruction, SolanaSerializedTransaction, SolanaBase58PublicKey, XDR, Hex as Hex$1, IStellarWalletProvider, StellarRawTransactionReceipt, IStacksWalletProvider, StacksTransactionParams, INearWalletProvider, CallContractParams, NearRawTransaction, BtcAddressType, IBitcoinWalletProvider } from '@sodax/types';
 import * as viem from 'viem';
-import { SendTransactionParameters, WaitForTransactionReceiptParameters, PublicClientConfig, WalletClientConfig, HttpTransportConfig, WalletClient, Transport, Chain, Account, PublicClient, Address, Hash as Hash$1 } from 'viem';
+import { WalletClient, Transport, Chain, Account, PublicClient, PublicClientConfig, WalletClientConfig, HttpTransportConfig, SendTransactionParameters, WaitForTransactionReceiptParameters, Address, Hash as Hash$1 } from 'viem';
 export { Account, Address, Chain, HttpTransportConfig, PublicClient, PublicClientConfig, SendTransactionParameters, TransactionReceipt, Transport, WaitForTransactionReceiptParameters, WalletClient, WalletClientConfig } from 'viem';
-import { SuiTransactionBlockResponseOptions, SuiClient } from '@mysten/sui/client';
+import { SuiClient, SuiTransactionBlockResponseOptions } from '@mysten/sui/client';
 export { SuiTransactionBlockResponseOptions } from '@mysten/sui/client';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { WalletWithFeatures, SuiWalletFeatures, WalletAccount } from '@mysten/wallet-standard';
@@ -22,17 +22,16 @@ export { Commitment, ConnectionConfig, SendOptions } from '@solana/web3.js';
 import { SignerWalletAdapterProps } from '@solana/wallet-adapter-base';
 import { Keypair } from '@stellar/stellar-sdk';
 export { Networks } from '@stellar/stellar-sdk';
-import { PostConditionMode, ClarityValue } from '@stacks/transactions';
-export { ClarityValue, PostConditionMode, PostConditionModeName } from '@stacks/transactions';
-import { StacksProvider } from '@stacks/connect';
-export { StacksProvider } from '@stacks/connect';
+import { PostConditionMode, ClarityValue } from '@sodax/libs/stacks/core';
+export { ClarityValue, PostConditionMode, PostConditionModeName, StacksNetwork } from '@sodax/libs/stacks/core';
+import { StacksProvider } from '@sodax/libs/stacks/connect';
+export { StacksProvider } from '@sodax/libs/stacks/connect';
 import { NearConnector } from '@hot-labs/near-connect';
 export { NearConnector } from '@hot-labs/near-connect';
 import { Account as Account$1, JsonRpcProvider } from 'near-api-js';
 export { KeyPairString } from 'near-api-js';
 import { ECPairInterface } from 'ecpair';
 import * as bitcoin from 'bitcoinjs-lib';
-export { StacksNetwork } from '@stacks/network';
 export { Network as BitcoinJsNetwork } from 'bitcoinjs-lib/src/networks.js';
 
 /**

package/dist/index.mjs

@@ -11,10 +11,9 @@ import { getAssociatedTokenAddress } from '@solana/spl-token';
 import { Keypair, Connection, TransactionMessage, VersionedTransaction, PublicKey, TransactionInstruction } from '@solana/web3.js';
 import { Networks, Keypair as Keypair$1, Horizon, Transaction } from '@stellar/stellar-sdk';
 export { Networks } from '@stellar/stellar-sdk';
-import { networkFrom } from '@stacks/network';
-import { makeContractCall, broadcastTransaction, fetchCallReadOnlyFunction, getAddressFromPrivateKey, publicKeyToHex, privateKeyToPublic, PostConditionMode } from '@stacks/transactions';
-export { PostConditionMode } from '@stacks/transactions';
-import { request } from '@stacks/connect';
+import { makeContractCall, broadcastTransaction, fetchCallReadOnlyFunction, getAddressFromPrivateKey, publicKeyToHex, privateKeyToPublic, networkFrom, PostConditionMode } from '@sodax/libs/stacks/core';
+export { PostConditionMode } from '@sodax/libs/stacks/core';
+import { request } from '@sodax/libs/stacks/connect';
 import * as bitcoin from 'bitcoinjs-lib';
 import * as ecc from '@bitcoinerlab/secp256k1';
 import { ECPairFactory } from 'ecpair';
@@ -301,7 +300,7 @@ var SodaTokens = {
   sodaNEAR: {
     symbol: "sodaNEAR",
     name: "SODA NEAR",
-    decimals: 24,
+    decimals: 18,
     address: "0xf4ba497c9b805e4bd88a8a9e6a7b8f74984c3e39",
     chainKey: ChainKeys.SONIC_MAINNET,
     hubAsset: "0xf4ba497c9b805e4bd88a8a9e6a7b8f74984c3e39",
@@ -2892,7 +2891,6 @@ var hubConfig = {
     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)
   ]});
 
@@ -11606,5 +11604,3 @@ var BitcoinWalletProvider = class extends BaseWalletProvider {
 */
 
 export { BaseWalletProvider, BigNumberToBigInt, BitcoinWalletError, BitcoinWalletProvider, EvmWalletProvider, IconWalletProvider, InjectiveWalletProvider, NearWalletProvider, SolanaWalletProvider, StacksWalletProvider, StellarWalletError, StellarWalletProvider, SuiWalletProvider, getEvmViemChain, hyper, isBrowserExtensionEvmWalletConfig, isBrowserExtensionIconWalletConfig, isBrowserExtensionInjectiveWalletConfig, isBrowserExtensionNearWalletConfig, isBrowserExtensionStacksWalletConfig, isBrowserExtensionStellarWalletConfig, isBrowserExtensionSuiWallet, isIconAddress, isIconBrowserExtensionWallet, isIconEoaAddress, isIconPkWallet, isJsonRpcPayloadResponse, isPkSuiWallet, isPrivateKeyEvmWalletConfig, isPrivateKeyIconWalletConfig, isPrivateKeyNearWalletConfig, isPrivateKeyStacksWalletConfig, isPrivateKeyStellarWalletConfig, isResponseAddressType, isResponseSigningType, isSecretInjectiveWalletConfig, isStellarBrowserExtensionWallet, isStellarPkWallet, isValidStellarNetwork, isValidStellarPrivateKey, requestAddress, requestJsonRpc, requestSigning };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.0.0-rc.3",
+  "version": "2.0.0-rc.5",
   "license": "MIT",
   "description": "Sodax Wallet SDK Core",
   "keywords": [
@@ -28,18 +28,24 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.12.0"
   },
   "files": [
     "dist",
-    "ai-exported"
+    "!dist/**/*.map"
   ],
+  "sideEffects": false,
   "dependencies": {
     "@bitcoinerlab/secp256k1": "^1.2.0",
     "@hot-labs/near-connect": "0.10.0",
@@ -53,9 +59,6 @@
     "@solana/wallet-adapter-base": "0.9.26",
     "@solana/web3.js": "1.98.0",
     "@stellar/stellar-sdk": "15.1.0",
-    "@stacks/connect": "8.2.6",
-    "@stacks/transactions": "7.3.1",
-    "@stacks/network": "7.3.1",
     "bip322-js": "^3.0.0",
     "bitcoinjs-lib": "^6.1.5",
     "ecpair": "^2.0.1",
@@ -63,17 +66,19 @@
     "near-api-js": "7.2.0",
     "secp256k1": "^5.0.1",
     "viem": "2.29.2",
-    "@sodax/types": "2.0.0-rc.3"
+    "@sodax/types": "2.0.0-rc.5",
+    "@sodax/libs": "0.0.1-rc.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.17.4",
     "@changesets/cli": "2.29.7",
     "@types/node": "22.18.1",
     "@types/secp256k1": "^4.0.7",
-    "@vitest/coverage-v8": "2.1.9",
+    "@vitest/coverage-v8": "3.2.4",
+    "knip": "5.30.5",
     "tsup": "8.5.0",
     "typescript": "5.5.4",
-    "vitest": "2.1.9"
+    "vitest": "3.2.4"
   },
   "scripts": {
     "build": "tsup",
@@ -85,8 +90,8 @@
     "checkTs": "tsc --noEmit",
     "pretty": "biome format . --write",
     "lint": "biome lint . --write",
-    "check-exports": "attw $(pnpm pack) --ignore-rules=cjs-resolves-to-esm",
-    "check-ai-exported": "bash scripts/check-ai-exported.sh",
+    "check-exports": "attw --pack",
+    "check:knip": "knip",
     "local-release": "changeset version && changeset publish",
     "clean": "rm -rf node_modules && rm -rf dist && rm -rf .turbo"
   }

package/ai-exported/AGENTS.md

@@ -1,139 +0,0 @@
-# AGENTS.md — `@sodax/wallet-sdk-core` AI Export
-
-You are a coding agent helping a developer **integrate** or **migrate** the `@sodax/wallet-sdk-core` package. This document is your entry point. Read this first, then route to the right sub-folder.
-
-The files in this `ai-exported/` directory are designed for AI consumption: short, table-heavy, self-contained recipes, and machine-checkable checklists. Human-readable narrative lives in each folder's `README.md`.
-
----
-
-## What this package is
-
-`@sodax/wallet-sdk-core` is the **low-level** wallet layer of the SODAX stack — one provider class per chain family (9 in total: EVM, Solana, Sui, Bitcoin, Stellar, ICON, Injective, NEAR, Stacks). Each class accepts either a **private-key** config (server-side scripts, CI, Node) or a **browser-extension** config (consumer dApps with pre-built clients/wallet kits), signs transactions, and broadcasts them.
-
-It is **not** a React layer (that is `@sodax/wallet-sdk-react`) and **not** a hooks layer (that is `@sodax/dapp-kit`). Most React consumers never touch this package directly — they get a typed `IXxxWalletProvider` via `useWalletProvider(...)` and hand it to `@sodax/sdk` calls. Direct usage of `wallet-sdk-core` is the right choice for:
-
-- Backend / Node scripts (CI tests, indexers, bots).
-- Custom browser flows that don't use React.
-- Tests that need to sign with a deterministic key.
-
----
-
-## Step 1 — Identify the task
-
-| User says... | Path | Start at |
-|---|---|---|
-| "sign a tx from a script", "instantiate `EvmWalletProvider`", "first time using this lib" | **integration** | `integration/ai-rules.md` |
-| "configure default gas", "set up `defaults`", "shallow merge surprised me" | **integration** | `integration/recipes/defaults-and-overrides.md` |
-| "where do I import `WalletClient` / `SuiClient` from", "avoid direct viem dep" | **integration** | `integration/recipes/library-exports.md` |
-| "upgrade from v1 / sodax-frontend", "bump from older RC" | **migration** | `migration/ai-rules.md` |
-| Deep import from `@sodax/wallet-sdk-core/wallet-providers/EvmWalletProvider` broke | **migration** | `migration/breaking-changes/folder-layout.md` |
-| Looking up a provider class or its config shape | direct | `integration/reference/provider-classes.md` |
-| Looking up the discriminated union shape per chain | direct | `integration/features/<chain>.md` |
-
-The package name **did not change** across versions — both v1 and v2 publish as `@sodax/wallet-sdk-core`. **All v1→v2 surface changes are additive** — class names, config-type names, and config shapes are identical. The only mechanical migration is replacing deep imports from v1's flat `wallet-providers/*.ts` layout with barrel imports.
-
-If a project does anything more than that at the wallet-sdk-core surface, you are almost certainly looking at an `@sodax/sdk` / `@sodax/types` migration, not this one. Route accordingly.
-
----
-
-## Step 2 — Load the right context
-
-**For integration tasks:**
-
-1. `integration/ai-rules.md` — DO/DON'T + workflow + stop conditions
-2. `integration/architecture.md` — mental model (BaseWalletProvider, discriminants, defaults merge)
-3. `integration/quickstart.md` — copy-paste minimal example for the chain you need
-4. `integration/features/<chain>.md` — per-chain config table, methods, gotchas
-5. `integration/recipes/<task>.md` — task-specific guide (setup-private-key, bridge-to-sdk, …)
-6. `integration/reference/*.md` — full barrel exports, interfaces, chain support
-
-**For migration tasks:**
-
-1. `migration/ai-rules.md` — DO/DON'T + workflow. The headline: **v1 code drops in unchanged.** No mandatory edits at the wallet-sdk-core surface.
-2. `migration/README.md` — what (additively) changed, read order, TL;DR
-3. `migration/breaking-changes/*.md` — narrative WHY behind each additive shift (folder layout, base-class, defaults, library-exports)
-4. `migration/reference/*.md` — confirm no renames / no deletions exist
-5. `migration/recipes/<task>.md` — paired before/after for **optional** cleanup (adopt-defaults, adopt-library-exports)
-6. `migration/checklist.md` — verification loop
-
----
-
-## Step 3 — Honor flow-specific stop conditions
-
-Each flow has its own list of conditions that **HARD STOP** code generation and require asking the user:
-
-- Migration stops → [`migration/ai-rules.md`](./migration/ai-rules.md) § "Stop conditions"
-- Integration stops → [`integration/ai-rules.md`](./integration/ai-rules.md) § "Stop conditions"
-
-Read the relevant list **before** applying any change. When stopping, quote the offending file/line and present the user with concrete options. Do **not** guess.
-
-Cross-flow signals (true regardless of flow):
-
-- User asks for a chain family not in [`integration/reference/chain-support.md`](./integration/reference/chain-support.md). Adding a new chain is a maintainer task, not user-app integration.
-- User wants to extend `BaseWalletProvider` directly. That is a maintainer-only path — confirm scope before writing code.
-
----
-
-## Step 4 — Verification protocol
-
-After **every** code change you make:
-
-1. Run `pnpm checkTs` from the user's app root (or the package the change touched).
-2. If errors mention `@sodax/wallet-sdk-core`, look up the symbol in `integration/reference/` or `migration/reference/`.
-3. If a symbol isn't in any reference file, **stop and ask**. Do not invent migrations.
-4. After all errors resolve, mark the relevant items in `migration/checklist.md` (for migrations) or move to the next recipe.
-
-You are **done** when:
-- `pnpm checkTs` exits clean for the user's project.
-- All items in `migration/checklist.md` are checked (migration only).
-- The user has confirmed the changed flow works in their dev / test environment.
-
----
-
-## Conventions in this directory
-
-- **Recipes are self-contained.** A recipe file in `recipes/` contains everything needed to apply the change — before/after code, steps, verification. Do not jump between files.
-- **Reference files are tables.** `reference/*.md` contains markdown tables and paired code blocks. Treat them as lookup, not narrative.
-- **Token budget**: Each file is sized to fit comfortably in your context. If you find yourself loading more than 3 files for a single task, you are probably doing it wrong — re-route via the table above.
-- **Single source of truth**: Behavioral / breaking-change *explanations* live only in `migration/breaking-changes/*.md`. Other files reference them but do not duplicate the prose.
-
----
-
-## Quick symbol lookup
-
-If the user mentions a symbol you don't recognize, grep these files in order:
-
-```
-integration/reference/public-api.md       — every named export from the package
-integration/reference/provider-classes.md — provider class + config + interface mapping
-integration/reference/interfaces.md       — IXxxWalletProvider method signatures
-integration/reference/chain-support.md    — chain family → provider + dependencies
-migration/reference/renamed-symbols.md    — confirms zero renames between v1 and v2
-migration/reference/deleted-exports.md    — confirms zero deletions between v1 and v2
-migration/reference/added-fields.md       — additive `defaults` / `*WalletDefaults` / `*Policy` types
-```
-
-If still not found: the symbol may be **internal** (not exported from the package root) or **removed**. Ask the user to share the source file/line so you can decide.
-
----
-
-## Package context
-
-- **Name**: `@sodax/wallet-sdk-core`
-- **Version target**: latest RC / stable on npm.
-- **Peer deps**: none — chain SDKs are direct dependencies and consumers can re-import types via `library-exports`.
-- **Install**: `pnpm add @sodax/wallet-sdk-core`
-- **Runtime**: Node ≥ 18 + browser (tsup `platform: 'neutral'`).
-- **Audience**: backend engineers, script authors, and React-layer authors building higher-level wrappers (`@sodax/wallet-sdk-react`).
-
----
-
-## Pointers
-
-- [`integration/README.md`](./integration/README.md) — start here for new integrations: file index, recommended reading order, install snippet, dual-config overview.
-- [`migration/README.md`](./migration/README.md) — start here for upgrades: file index, reading order, cross-cutting checklist pointer.
-- [`integration/quickstart.md`](./integration/quickstart.md) — minimal end-to-end example per chain.
-- [`integration/architecture.md`](./integration/architecture.md) — mental model: `BaseWalletProvider`, defaults shallow merge, dual-config discriminants, `library-exports`.
-- [`integration/features/`](./integration/features/) — per-chain config table, methods, gotchas (one file per chain).
-- [`integration/reference/`](./integration/reference/) — public API, provider classes, interfaces, chain support, glossary.
-- [`migration/breaking-changes/`](./migration/breaking-changes/) — narrative WHY behind each version-to-version shift.

package/ai-exported/integration/README.md

@@ -1,108 +0,0 @@
-# Integration: First-time setup (Human-readable overview)
-
-This folder helps you integrate `@sodax/wallet-sdk-core` into a fresh project — most commonly a Node script, a backend service, or a custom non-React frontend. It is the **human-facing** entry point for new integrations. If you are a coding agent, read [`ai-rules.md`](./ai-rules.md) first.
-
-If you are upgrading from an older version of the package instead, see `../migration/`.
-
----
-
-## What this package does
-
-`@sodax/wallet-sdk-core` is a **low-level multi-chain wallet provider layer**. For each of the 9 chain families that SODAX supports it ships **one provider class** that:
-
-- Accepts a **discriminated union config** — `PrivateKey*WalletConfig | BrowserExtension*WalletConfig`.
-- Extends a small `BaseWalletProvider` to merge per-call options over a typed `defaults` shape.
-- Implements the chain-specific `IXxxWalletProvider` interface from `@sodax/types`, so it can be passed straight into `@sodax/sdk` calls.
-
-It is intentionally framework-agnostic — Node ≥ 18, browser, edge runtimes are all supported (tsup `platform: 'neutral'`).
-
-| Chain family | Provider class | Underlying chain SDK |
-|---|---|---|
-| EVM (12 chains)        | `EvmWalletProvider`       | `viem` |
-| Solana                 | `SolanaWalletProvider`    | `@solana/web3.js` |
-| Sui                    | `SuiWalletProvider`       | `@mysten/sui` + `@mysten/wallet-standard` |
-| Bitcoin                | `BitcoinWalletProvider`   | `bitcoinjs-lib` (+ `ecpair`, `secp256k1`) |
-| Stellar                | `StellarWalletProvider`   | `@stellar/stellar-sdk` |
-| ICON                   | `IconWalletProvider`      | `icon-sdk-js` |
-| Injective              | `InjectiveWalletProvider` | `@injectivelabs/sdk-ts` + `@injectivelabs/wallet-core` |
-| NEAR                   | `NearWalletProvider`      | `near-api-js` + `@hot-labs/near-connect` |
-| Stacks                 | `StacksWalletProvider`    | `@stacks/transactions` + `@stacks/connect` |
-
----
-
-## Recommended path (in order)
-
-If this is your first time using the package:
-
-1. [`architecture.md`](./architecture.md) — read once before any recipe. Explains `BaseWalletProvider`, the `defaults` shallow-merge model, dual-config discriminants, and the `library-exports` indirection. Picking the wrong config variant is the most common mistake — the mental model prevents it.
-2. [`quickstart.md`](./quickstart.md) — minimal end-to-end example for the chain you need. Copy, edit, run.
-3. [`features/<chain>.md`](./features/) — chain-specific config table, methods, and gotchas (one file per chain).
-4. Pick the right recipes:
-   - [`recipes/setup-private-key.md`](./recipes/setup-private-key.md) — server-side / CI flow.
-   - [`recipes/setup-browser-extension.md`](./recipes/setup-browser-extension.md) — consumer dApp flow.
-   - [`recipes/bridge-to-sdk.md`](./recipes/bridge-to-sdk.md) — hand off the provider to `@sodax/sdk` calls.
-   - [`recipes/defaults-and-overrides.md`](./recipes/defaults-and-overrides.md) — merge semantics for the `defaults` config.
-   - [`recipes/library-exports.md`](./recipes/library-exports.md) — re-importing upstream chain-SDK types without a direct dep.
-   - [`recipes/sign-and-broadcast.md`](./recipes/sign-and-broadcast.md) — typical send-transaction flow per chain.
-   - [`recipes/testing.md`](./recipes/testing.md) — mocking providers in unit tests.
-5. Reference docs (lookup as needed):
-   - [`reference/public-api.md`](./reference/public-api.md) — every named export from the package root.
-   - [`reference/provider-classes.md`](./reference/provider-classes.md) — provider × config × interface table.
-   - [`reference/interfaces.md`](./reference/interfaces.md) — `IXxxWalletProvider` method signatures.
-   - [`reference/chain-support.md`](./reference/chain-support.md) — chain family → spoke chain keys.
-   - [`reference/glossary.md`](./reference/glossary.md) — terms used across the docs.
-
----
-
-## Install
-
-```bash
-pnpm add @sodax/wallet-sdk-core @sodax/types
-```
-
-Most consumers will also need `@sodax/sdk` (for the hub/spoke services that accept the wallet provider) and one or more chain SDKs (for browser-extension wallet objects). Re-export the types you need via `library-exports` — see [`recipes/library-exports.md`](./recipes/library-exports.md).
-
----
-
-## Two configuration modes
-
-Every provider class supports **two** construction modes. Picking the wrong one is the most common integration mistake.
-
-| Mode | When to use | Discriminant style |
-|---|---|---|
-| **Private-key** | Node scripts, CI tests, indexers, bots — anywhere you possess the raw key | Either field presence (EVM, Solana, Sui, ICON, Injective, NEAR, Stacks) OR `type: 'PRIVATE_KEY'` (Bitcoin, Stellar) |
-| **Browser-extension** | Consumer dApps where a wallet extension provides a pre-built client / signer | Either field presence (different fields from PK variant) OR `type: 'BROWSER_EXTENSION'` (Bitcoin, Stellar) |
-
-For a chain-by-chain breakdown of the exact discriminant shape, see [`features/`](./features/) and [`architecture.md`](./architecture.md) § "Discriminant variants".
-
----
-
-## Pair with `@sodax/sdk` and `@sodax/wallet-sdk-react`
-
-The most common stack:
-
-```
-@sodax/sdk              ← business logic (swaps, lending, staking, …)
-@sodax/wallet-sdk-react ← React layer that surfaces a typed IXxxWalletProvider via hooks
-@sodax/wallet-sdk-core  ← this package — concrete provider classes
-@sodax/types            ← shared type definitions
-```
-
-In a React dApp you usually consume this package **indirectly** — `useWalletProvider({ xChainId })` (from `@sodax/wallet-sdk-react`) returns a typed `IXxxWalletProvider` that comes from a `wallet-sdk-core` instance under the hood. You only construct provider classes from `wallet-sdk-core` directly when running scripts, tests, or non-React clients.
-
----
-
-## Conventions worth knowing
-
-- **`defaults` is optional but powerful.** Every provider accepts a `defaults` config slice; per-call options shallow-merge over it. Use it to encode env-level fixed choices (RPC commitment, default gas, default memo) once.
-- **Shallow merge, not deep.** Nested objects in `defaults` are **replaced wholesale** by per-call options of the same key. See `src/utils/merge.ts` and [`recipes/defaults-and-overrides.md`](./recipes/defaults-and-overrides.md).
-- **`library-exports` removes upstream deps.** You can `import type { WalletClient } from '@sodax/wallet-sdk-core'` instead of taking a direct dep on `viem`. See [`recipes/library-exports.md`](./recipes/library-exports.md).
-- **The barrel is the source of truth.** Internal utilities (`shallowMerge`, helper functions) are **not** exported. If something isn't on `@sodax/wallet-sdk-core`'s root, do not deep-import it.
-- **No `as unknown as` casts.** The discriminated unions are precise — if TypeScript complains, your config is wrong, not the type.
-
----
-
-## Getting help
-
-- API surface lookup: [`reference/`](./reference/).
-- Bug or missing feature: [open an issue](https://github.com/icon-project/sodax-sdks/issues).