@swapkit/toolboxes 4.2.1 → 4.3.3

package/package.json

@@ -1,79 +1,91 @@
 {
   "dependencies": {
     "@bitcoinerlab/secp256k1": "~1.2.0",
-    "@bitgo/utxo-lib": "~11.10.0",
-    "@cosmjs/amino": "~0.33.0",
-    "@cosmjs/crypto": "~0.33.0",
-    "@cosmjs/proto-signing": "~0.33.0",
-    "@cosmjs/stargate": "~0.33.0",
-    "@meshsdk/core": "1.9.0-beta.74",
-    "@mysten/bcs": "~1.8.0",
-    "@mysten/sui": "~1.38.0",
-    "@noble/hashes": "2.0.0-beta.1",
-    "@polkadot/api": "~15.9.0",
-    "@polkadot/keyring": "~13.5.0",
-    "@polkadot/util": "~13.5.0",
-    "@polkadot/util-crypto": "~13.5.0",
+    "@bitgo/utxo-lib": "~11.13.1",
+    "@cosmjs/amino": "~0.37.0",
+    "@cosmjs/crypto": "0.37.0",
+    "@cosmjs/proto-signing": "~0.37.0",
+    "@cosmjs/stargate": "~0.37.0",
+    "@meshsdk/core": "1.9.0-beta.86",
+    "@mysten/bcs": "~1.9.2",
+    "@mysten/sui": "~1.44.0",
+    "@near-js/accounts": "~2.5.0",
+    "@near-js/crypto": "~2.5.0",
+    "@near-js/providers": "~2.5.0",
+    "@near-js/signers": "~2.5.0",
+    "@near-js/transactions": "~2.5.0",
+    "@near-js/utils": "~2.5.0",
+    "@noble/hashes": "2.0.1",
+    "@polkadot/api": "15.10.2",
+    "@polkadot/keyring": "~13.5.7",
+    "@polkadot/rpc-provider": "~15.10.2",
+    "@polkadot/util": "~13.5.7",
+    "@polkadot/util-crypto": "~13.5.7",
     "@psf/bitcoincashjs-lib": "~4.0.3",
     "@radixdlt/babylon-gateway-api-sdk": "~1.10.0",
     "@radixdlt/radix-dapp-toolkit": "~2.2.0",
-    "@scure/base": "~1.2.6",
-    "@scure/bip32": "~1.7.0",
-    "@scure/bip39": "~1.6.0",
+    "@scure/base": "~2.0.0",
+    "@scure/bip32": "~2.0.1",
+    "@scure/bip39": "~2.0.1",
     "@solana/spl-memo": "~0.2.5",
-    "@solana/spl-token": "~0.4.13",
+    "@solana/spl-token": "~0.4.14",
     "@solana/web3.js": "~1.98.0",
-    "@swapkit/helpers": "4.4.5",
+    "@swapkit/helpers": "4.5.3",
     "@ton/crypto": "~3.3.0",
-    "@ton/ton": "~15.3.1",
+    "@ton/ton": "~15.4.0",
     "base64-js": "~1.5.1",
     "bitcoinjs-lib": "~6.1.0",
     "bs58check": "~4.0.0",
     "cashaddrjs": "~0.4.4",
     "coininfo": "~5.2.1",
-    "cosmjs-types": "~0.9.0",
+    "cosmjs-types": "~0.10.1",
     "ecpair": "~2.1.0",
     "ethers": "^6.14.0",
-    "micro-key-producer": "~0.7.6",
-    "near-api-js": "~6.3.0",
+    "micro-key-producer": "~0.8.2",
     "near-sdk-js": "~2.0.0",
     "near-seed-phrase": "~0.2.1",
     "protobufjs": "~7.5.4",
-    "tronweb": "~6.0.0",
-    "ts-pattern": "^5.7.0",
-    "xrpl": "~4.3.0"
+    "tronweb": "6.1.0",
+    "ts-pattern": "^5.9.0",
+    "xrpl": "~4.4.2"
   },
   "description": "SwapKit - Toolboxes",
   "devDependencies": {
     "@bitcoinerlab/secp256k1": "1.2.0",
-    "@bitgo/utxo-lib": "11.10.0",
-    "@cosmjs/amino": "0.33.1",
-    "@cosmjs/crypto": "0.33.1",
-    "@cosmjs/proto-signing": "0.33.1",
-    "@cosmjs/stargate": "0.33.1",
-    "@meshsdk/core": "1.9.0-beta.74",
-    "@mysten/bcs": "1.8.0",
-    "@mysten/sui": "1.38.0",
-    "@noble/hashes": "2.0.0-beta.1",
-    "@nomicfoundation/hardhat-ethers": "3.0.9",
-    "@nomicfoundation/hardhat-toolbox": "5.0.0",
-    "@polkadot/api": "15.9.2",
-    "@polkadot/keyring": "13.5.5",
-    "@polkadot/types": "15.9.2",
-    "@polkadot/util": "13.5.5",
-    "@polkadot/util-crypto": "13.5.5",
+    "@bitgo/utxo-lib": "11.13.1",
+    "@cosmjs/amino": "0.37.0",
+    "@cosmjs/crypto": "0.37.0",
+    "@cosmjs/proto-signing": "0.37.0",
+    "@cosmjs/stargate": "0.37.0",
+    "@meshsdk/core": "1.9.0-beta.86",
+    "@mysten/bcs": "1.9.2",
+    "@mysten/sui": "1.44.0",
+    "@near-js/accounts": "2.5.0",
+    "@near-js/crypto": "2.5.0",
+    "@near-js/providers": "2.5.0",
+    "@near-js/signers": "2.5.0",
+    "@near-js/transactions": "2.5.0",
+    "@near-js/utils": "2.5.0",
+    "@noble/hashes": "2.0.1",
+    "@nomicfoundation/hardhat-ethers": "4.0.3",
+    "@nomicfoundation/hardhat-network-helpers": "3.0.2",
+    "@nomicfoundation/hardhat-toolbox": "6.1.0",
+    "@polkadot/api": "15.10.2",
+    "@polkadot/keyring": "13.5.7",
+    "@polkadot/types": "15.10.2",
+    "@polkadot/util": "13.5.7",
+    "@polkadot/util-crypto": "13.5.7",
     "@psf/bitcoincashjs-lib": "4.0.3",
     "@radixdlt/babylon-gateway-api-sdk": "1.10.1",
     "@radixdlt/radix-dapp-toolkit": "2.2.1",
-    "@scure/base": "1.2.6",
-    "@scure/bip32": "1.7.0",
-    "@scure/bip39": "1.6.0",
+    "@scure/base": "2.0.0",
+    "@scure/bip32": "2.0.1",
+    "@scure/bip39": "2.0.1",
     "@solana/spl-memo": "0.2.5",
-    "@solana/spl-token": "0.4.13",
+    "@solana/spl-token": "0.4.14",
     "@solana/web3.js": "1.98.4",
-    "@swapkit/helpers": "4.4.5",
     "@ton/crypto": "3.3.0",
-    "@ton/ton": "15.3.1",
+    "@ton/ton": "15.4.0",
     "@types/bn.js": "5.2.0",
     "@types/crypto-js": "4.2.2",
     "@types/elliptic": "6.4.18",
@@ -82,83 +94,99 @@
     "bs58check": "4.0.0",
     "cashaddrjs": "0.4.4",
     "coininfo": "5.2.1",
-    "cosmjs-types": "0.9.0",
+    "cosmjs-types": "0.10.1",
     "ecpair": "2.1.0",
     "ethers": "6.15.0",
-    "hardhat": "2.25.0",
-    "micro-key-producer": "0.7.6",
-    "near-api-js": "6.3.0",
+    "hardhat": "3.0.11",
+    "micro-key-producer": "0.8.2",
     "near-sdk-js": "2.0.0",
     "near-seed-phrase": "0.2.1",
     "protobufjs": "7.5.4",
-    "tronweb": "6.0.4",
-    "ts-pattern": "5.8.0",
-    "xrpl": "4.3.0"
+    "tronweb": "6.1.0",
+    "ts-pattern": "5.9.0",
+    "xrpl": "4.4.2"
   },
   "exports": {
-    ".": { "default": "./dist/src/index.js", "require": "./dist/src/index.cjs", "types": "./dist/types/index.d.ts" },
+    ".": {
+      "bun": "./src/index.ts",
+      "default": "./dist/src/index.js",
+      "require": "./dist/src/index.cjs",
+      "types": "./dist/types/index.d.ts"
+    },
     "./cardano": {
+      "bun": "./src/cardano/index.ts",
       "default": "./dist/src/cardano/index.js",
       "require": "./dist/src/cardano/index.cjs",
       "types": "./dist/types/cardano/index.d.ts"
     },
     "./cosmos": {
+      "bun": "./src/cosmos/index.ts",
       "default": "./dist/src/cosmos/index.js",
       "require": "./dist/src/cosmos/index.cjs",
       "types": "./dist/types/cosmos/index.d.ts"
     },
     "./evm": {
+      "bun": "./src/evm/index.ts",
       "default": "./dist/src/evm/index.js",
       "require": "./dist/src/evm/index.cjs",
       "types": "./dist/types/evm/index.d.ts"
     },
     "./near": {
+      "bun": "./src/near/index.ts",
       "default": "./dist/src/near/index.js",
       "require": "./dist/src/near/index.cjs",
       "types": "./dist/types/near/index.d.ts"
     },
     "./radix": {
+      "bun": "./src/radix/index.ts",
       "default": "./dist/src/radix/index.js",
       "require": "./dist/src/radix/index.cjs",
       "types": "./dist/types/radix/index.d.ts"
     },
     "./ripple": {
+      "bun": "./src/ripple/index.ts",
       "default": "./dist/src/ripple/index.js",
       "require": "./dist/src/ripple/index.cjs",
       "types": "./dist/types/ripple/index.d.ts"
     },
     "./solana": {
+      "bun": "./src/solana/index.ts",
       "default": "./dist/src/solana/index.js",
       "require": "./dist/src/solana/index.cjs",
       "types": "./dist/types/solana/index.d.ts"
     },
     "./substrate": {
+      "bun": "./src/substrate/index.ts",
       "default": "./dist/src/substrate/index.js",
       "require": "./dist/src/substrate/index.cjs",
       "types": "./dist/types/substrate/index.d.ts"
     },
     "./sui": {
+      "bun": "./src/sui/index.ts",
       "default": "./dist/src/sui/index.js",
       "require": "./dist/src/sui/index.cjs",
       "types": "./dist/types/sui/index.d.ts"
     },
     "./ton": {
+      "bun": "./src/ton/index.ts",
       "default": "./dist/src/ton/index.js",
       "require": "./dist/src/ton/index.cjs",
       "types": "./dist/types/ton/index.d.ts"
     },
     "./tron": {
+      "bun": "./src/tron/index.ts",
       "default": "./dist/src/tron/index.js",
       "require": "./dist/src/tron/index.cjs",
       "types": "./dist/types/tron/index.d.ts"
     },
     "./utxo": {
+      "bun": "./src/utxo/index.ts",
       "default": "./dist/src/utxo/index.js",
       "require": "./dist/src/utxo/index.cjs",
       "types": "./dist/types/utxo/index.d.ts"
     }
   },
-  "files": ["dist/"],
+  "files": ["dist/", "src/"],
   "homepage": "https://github.com/swapkit/SwapKit",
   "license": "Apache-2.0",
   "name": "@swapkit/toolboxes",
@@ -166,12 +194,12 @@
   "scripts": {
     "build": "bun run ./build.ts",
     "build:clean": "rm -rf dist && bun run ./build.ts",
-    "clean": "rm -rf dist node_modules *.tsbuildinfo",
+    "clean": "rm -rf cache dist node_modules *.tsbuildinfo",
     "test": "bun test",
     "test:ci": "bun test --coverage",
     "type-check": "bun tsc --noEmit",
     "type-check:go": "tsgo"
   },
   "type": "module",
-  "version": "4.2.1"
+  "version": "4.3.3"
 }

package/src/__tests__/address-validation-all-chains.test.ts

@@ -0,0 +1,162 @@
+import { beforeAll, describe, expect, test } from "bun:test";
+import { Chain } from "@swapkit/helpers";
+import { getAddressValidator } from "../index";
+
+const context: { validateAddress: (params: { address: string; chain: Chain }) => boolean } = {} as any;
+
+beforeAll(async () => {
+  context.validateAddress = await getAddressValidator();
+});
+
+describe("Address Validation - All Chains", () => {
+  describe("Valid addresses for each chain", () => {
+    const validAddresses = {
+      [Chain.Ethereum]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Avalanche]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Arbitrum]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.BinanceSmartChain]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Optimism]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Polygon]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Base]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Bitcoin]: ["bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr", "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"],
+      [Chain.BitcoinCash]: ["qzhcfqxrnhcw88c433tq0fjlw0uut8c0e5d3cf8566"],
+      [Chain.Dogecoin]: ["DPrKsuhVibyfMMYRmKP49US5PBQR8zq6v4"],
+      [Chain.Litecoin]: ["ltc1qs4h7p8x0kfhs88wazmq2d40t59dwdlxd6rlpjz"],
+      [Chain.Dash]: ["XoBBveBZv32rq9MMBt88QSVsUtdj9cMCLy"],
+      [Chain.Zcash]: ["t1Mh7QW9g1gK94CSRxniD49aLAJ67s6UerX"],
+      [Chain.Cosmos]: ["cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f"],
+      [Chain.Kujira]: ["kujira12d7d2rlxp7urkp8z0p8sft2fm07ewyjrcy78ur"],
+      [Chain.Maya]: ["maya1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2t7e6j"],
+      [Chain.Noble]: ["noble12d7d2rlxp7urkp8z0p8sft2fm07ewyjrp0fhf8"],
+      [Chain.THORChain]: ["thor1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2uq4vz"],
+      [Chain.Polkadot]: ["16kQVedQo7yYoFSp2MnQ78zP39xWnFGePnZps2APEyt9K9KZ"],
+      [Chain.Chainflip]: ["cFPctKfXisvnrhss2eMV2VdiUNRm1F5pX4WfqkcT3ZrLKJXrS"],
+      [Chain.Cardano]: [
+        "addr1qxk2md7wufs2cas0dfxch0uu59079s7yc5k9pw8s49wpm25s8ynu4svqm7m4hd04d4jvm6e5vvyw7dm4gvpqyfklgn8qetu85s",
+      ],
+      [Chain.Near]: ["a03fafdf5f97d3c6be6bff9e55f057dda76fefbb7e149f5469248f41e812cb6e"],
+      [Chain.Ripple]: ["rhDQXdwWR2RstC7sLjLMbjCeWT3PuSAZVu"],
+      [Chain.Solana]: ["4UHWuPwyV3XCcnwrpEdWAEW3WLUP1RDMaK3ANNsRUjfM"],
+      [Chain.Sui]: ["0x57b861db681d8e47b586e6e9a92f6ed210dbbb440670b8122420848cf0e844fb"],
+      [Chain.Ton]: ["EQCC1GV4iL5EkQqICYshf3AF7ESbceCYhVK-go1SkOMOBTNE"],
+      [Chain.Radix]: [] as string[],
+      [Chain.Harbor]: [] as string[],
+    };
+
+    for (const [chain, addresses] of Object.entries(validAddresses)) {
+      if (addresses.length === 0) continue;
+
+      test(`should validate valid ${chain} addresses`, () => {
+        for (const address of addresses) {
+          const result = context.validateAddress({ address, chain: chain as Chain });
+          expect(result).toBe(true);
+        }
+      });
+    }
+  });
+
+  describe("Invalid addresses should be rejected", () => {
+    const invalidTestCases: Array<{ chain: Chain; addresses: string[] }> = [
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x123",
+          "0xG051176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "THr473cZqHwBLEmTWUUR1WTotxijWWbRGD",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+          "cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f",
+        ],
+        chain: Chain.Ethereum,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "THr473cZqHwBLEmTWUUR1WTotxijWWbRGD",
+          "cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f",
+          "qzhcfqxrnhcw88c433tq0fjlw0uut8c0e5d3cf8566",
+        ],
+        chain: Chain.Bitcoin,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+          "thor1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2uq4vz",
+          "maya1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2t7e6j",
+        ],
+        chain: Chain.Cosmos,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "4UHWuPwyV3XCcnwrpEdWAEW3WLUP1RDMaK3ANNsRUjfM123",
+          "123",
+        ],
+        chain: Chain.Solana,
+      },
+      { addresses: ["", "invalid!"], chain: Chain.Near },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+        ],
+        chain: Chain.Cardano,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+        ],
+        chain: Chain.Ripple,
+      },
+    ];
+
+    for (const { chain, addresses } of invalidTestCases) {
+      test(`should reject invalid ${chain} addresses`, () => {
+        for (const address of addresses) {
+          const result = context.validateAddress({ address, chain });
+          expect(result).toBe(false);
+        }
+      });
+    }
+  });
+
+  describe("Edge cases and type safety", () => {
+    test("should handle non-string inputs safely", () => {
+      const edgeCases = [null, undefined, 123, {}, [], true, false];
+
+      for (const testCase of edgeCases) {
+        expect(context.validateAddress({ address: testCase as any, chain: Chain.Ethereum })).toBe(false);
+      }
+    });
+
+    test("should reject cross-chain address usage", () => {
+      expect(
+        context.validateAddress({ address: "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0", chain: Chain.Bitcoin }),
+      ).toBe(false);
+
+      expect(
+        context.validateAddress({ address: "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr", chain: Chain.Ethereum }),
+      ).toBe(false);
+
+      expect(
+        context.validateAddress({ address: "cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f", chain: Chain.Maya }),
+      ).toBe(false);
+
+      expect(context.validateAddress({ address: "THr473cZqHwBLEmTWUUR1WTotxijWWbRGD", chain: Chain.Ethereum })).toBe(
+        false,
+      );
+    });
+  });
+});

package/src/__tests__/addressValidator.test.ts

@@ -0,0 +1,162 @@
+import { beforeAll, describe, expect, test } from "bun:test";
+import { Chain } from "@swapkit/helpers";
+import { getAddressValidator } from "../index";
+
+const context: { validateAddress: (params: { address: string; chain: Chain }) => boolean } = {} as any;
+
+beforeAll(async () => {
+  context.validateAddress = await getAddressValidator();
+});
+
+describe("Address Validation - All Chains", () => {
+  describe("Valid addresses for each chain", () => {
+    const validAddresses = {
+      [Chain.Ethereum]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Avalanche]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Arbitrum]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.BinanceSmartChain]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Optimism]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Polygon]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Base]: ["0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0"],
+      [Chain.Bitcoin]: ["bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr", "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"],
+      [Chain.BitcoinCash]: ["qzhcfqxrnhcw88c433tq0fjlw0uut8c0e5d3cf8566"],
+      [Chain.Dogecoin]: ["DPrKsuhVibyfMMYRmKP49US5PBQR8zq6v4"],
+      [Chain.Litecoin]: ["ltc1qs4h7p8x0kfhs88wazmq2d40t59dwdlxd6rlpjz"],
+      [Chain.Dash]: ["XoBBveBZv32rq9MMBt88QSVsUtdj9cMCLy"],
+      [Chain.Zcash]: ["t1Mh7QW9g1gK94CSRxniD49aLAJ67s6UerX"],
+      [Chain.Cosmos]: ["cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f"],
+      [Chain.Kujira]: ["kujira12d7d2rlxp7urkp8z0p8sft2fm07ewyjrcy78ur"],
+      [Chain.Maya]: ["maya1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2t7e6j"],
+      [Chain.Noble]: ["noble12d7d2rlxp7urkp8z0p8sft2fm07ewyjrp0fhf8"],
+      [Chain.THORChain]: ["thor1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2uq4vz"],
+      [Chain.Polkadot]: ["16kQVedQo7yYoFSp2MnQ78zP39xWnFGePnZps2APEyt9K9KZ"],
+      [Chain.Chainflip]: ["cFPctKfXisvnrhss2eMV2VdiUNRm1F5pX4WfqkcT3ZrLKJXrS"],
+      [Chain.Cardano]: [
+        "addr1qxk2md7wufs2cas0dfxch0uu59079s7yc5k9pw8s49wpm25s8ynu4svqm7m4hd04d4jvm6e5vvyw7dm4gvpqyfklgn8qetu85s",
+      ],
+      [Chain.Near]: ["a03fafdf5f97d3c6be6bff9e55f057dda76fefbb7e149f5469248f41e812cb6e"],
+      [Chain.Ripple]: ["rhDQXdwWR2RstC7sLjLMbjCeWT3PuSAZVu"],
+      [Chain.Solana]: ["4UHWuPwyV3XCcnwrpEdWAEW3WLUP1RDMaK3ANNsRUjfM"],
+      [Chain.Sui]: ["0x57b861db681d8e47b586e6e9a92f6ed210dbbb440670b8122420848cf0e844fb"],
+      [Chain.Ton]: ["EQCC1GV4iL5EkQqICYshf3AF7ESbceCYhVK-go1SkOMOBTNE"],
+      [Chain.Radix]: [] as string[],
+      [Chain.Harbor]: [] as string[],
+    };
+
+    for (const [chain, addresses] of Object.entries(validAddresses)) {
+      if (addresses.length === 0) continue;
+
+      test(`should validate valid ${chain} addresses`, () => {
+        for (const address of addresses) {
+          const result = context.validateAddress({ address, chain: chain as Chain });
+          expect(result).toBe(true);
+        }
+      });
+    }
+  });
+
+  describe("Invalid addresses should be rejected", () => {
+    const invalidTestCases: Array<{ chain: Chain; addresses: string[] }> = [
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x123",
+          "0xG051176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "THr473cZqHwBLEmTWUUR1WTotxijWWbRGD",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+          "cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f",
+        ],
+        chain: Chain.Ethereum,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "THr473cZqHwBLEmTWUUR1WTotxijWWbRGD",
+          "cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f",
+          "qzhcfqxrnhcw88c433tq0fjlw0uut8c0e5d3cf8566",
+        ],
+        chain: Chain.Bitcoin,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+          "thor1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2uq4vz",
+          "maya1hm0sdz9v2h5jwjuu0ssp8x98upvlc6py2t7e6j",
+        ],
+        chain: Chain.Cosmos,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "4UHWuPwyV3XCcnwrpEdWAEW3WLUP1RDMaK3ANNsRUjfM123",
+          "123",
+        ],
+        chain: Chain.Solana,
+      },
+      { addresses: ["", "invalid!"], chain: Chain.Near },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+        ],
+        chain: Chain.Cardano,
+      },
+      {
+        addresses: [
+          "",
+          "invalid",
+          "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0",
+          "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr",
+        ],
+        chain: Chain.Ripple,
+      },
+    ];
+
+    for (const { chain, addresses } of invalidTestCases) {
+      test(`should reject invalid ${chain} addresses`, () => {
+        for (const address of addresses) {
+          const result = context.validateAddress({ address, chain });
+          expect(result).toBe(false);
+        }
+      });
+    }
+  });
+
+  describe("Edge cases and type safety", () => {
+    test("should handle non-string inputs safely", () => {
+      const edgeCases = [null, undefined, 123, {}, [], true, false];
+
+      for (const testCase of edgeCases) {
+        expect(context.validateAddress({ address: testCase as any, chain: Chain.Ethereum })).toBe(false);
+      }
+    });
+
+    test("should reject cross-chain address usage", () => {
+      expect(
+        context.validateAddress({ address: "0x51176f5F0B7ccC8fA0376F08aaa28F316A38a2a0", chain: Chain.Bitcoin }),
+      ).toBe(false);
+
+      expect(
+        context.validateAddress({ address: "bc1qjpmp8xvg9k4ysa7nvev3lw7qcclvxzt2ex75kr", chain: Chain.Ethereum }),
+      ).toBe(false);
+
+      expect(
+        context.validateAddress({ address: "cosmos12d7d2rlxp7urkp8z0p8sft2fm07ewyjrfvul3f", chain: Chain.Maya }),
+      ).toBe(false);
+
+      expect(context.validateAddress({ address: "THr473cZqHwBLEmTWUUR1WTotxijWWbRGD", chain: Chain.Ethereum })).toBe(
+        false,
+      );
+    });
+  });
+});

package/src/cardano/__tests__/toolbox.test.ts

@@ -0,0 +1,48 @@
+import { beforeAll, describe, expect, test } from "bun:test";
+import { Chain } from "@swapkit/helpers";
+import { getCardanoToolbox } from "../toolbox";
+
+const TEST_PHRASE = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
+
+const context: { toolbox: Awaited<ReturnType<typeof getCardanoToolbox>> } = {} as any;
+
+beforeAll(async () => {
+  context.toolbox = await getCardanoToolbox({ phrase: TEST_PHRASE });
+});
+
+describe("Cardano Toolbox", () => {
+  test("should validate valid Cardano addresses", () => {
+    const validAddresses = [
+      "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
+    ];
+
+    for (const address of validAddresses) {
+      expect(context.toolbox.validateAddress(address)).toBe(true);
+    }
+  });
+
+  test("should reject invalid Cardano addresses", () => {
+    const invalidAddresses = [
+      "",
+      "invalid",
+      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+      "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
+      "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
+    ];
+
+    for (const address of invalidAddresses) {
+      expect(context.toolbox.validateAddress(address)).toBe(false);
+    }
+  });
+
+  test("should generate valid Cardano address from phrase", () => {
+    const address = context.toolbox.getAddress();
+    expect(address.startsWith("addr")).toBe(true);
+  });
+
+  test("should estimate transaction fee", async () => {
+    const fee = await context.toolbox.estimateTransactionFee();
+    expect(fee.chain).toBe(Chain.Cardano);
+    expect(fee.getValue("number")).toBeGreaterThan(0);
+  });
+});

package/src/cardano/index.ts

@@ -0,0 +1,2 @@
+export * from "./toolbox";
+export * from "./types";