@fastxyz/allset-sdk 0.1.1 → 0.1.3

package/README.md

@@ -1,112 +1,249 @@
 # AllSet SDK
 
-Official TypeScript SDK for the AllSet bridge. Bridge tokens between Fast network and supported EVM routes, with the current branch focused on Arbitrum Sepolia and Fast testnet flows.
+Bridge tokens between Fast network and EVM chains.
 
-## Install
+## Installation
+
+Pure helpers only:
 
 ```bash
 npm install @fastxyz/allset-sdk
 ```
 
+FastWallet-backed withdrawals and intent execution:
+
+```bash
+npm install @fastxyz/allset-sdk @fastxyz/sdk
+```
+
+`@fastxyz/sdk` is optional for pure helpers and EVM -> Fast deposits. Install it when you use `FastWallet` flows such as `sendToExternal(...)` or `executeIntent(...)`.
+
+## Entrypoints
+
+| Entrypoint | Use for | Browser-safe |
+| --- | --- | --- |
+| `@fastxyz/allset-sdk` | Pure deposit planners, intent builders, Fast address conversion | Yes |
+| `@fastxyz/allset-sdk/core` | Explicit alias of the root pure helper surface | Yes |
+| `@fastxyz/allset-sdk/browser` | Browser-safe frontend import path for pure helpers | Yes |
+| `@fastxyz/allset-sdk/node` | Provider, executor, wallet, bridge execution, file-backed config | No |
+
 ## Quick Start
 
-### Deposit (EVM → Fast)
+### Pure deposit planning
 
 ```ts
-import { createEvmExecutor, allsetProvider } from '@fastxyz/allset-sdk';
-
-const evmExecutor = createEvmExecutor(
-  process.env.EVM_PRIVATE_KEY!,
-  'https://sepolia-rollup.arbitrum.io/rpc',
-  421614
-);
-
-const result = await allsetProvider.bridge({
-  fromChain: 'arbitrum',
-  toChain: 'fast',
-  fromToken: 'USDC',
-  toToken: 'fastUSDC',
-  fromDecimals: 6,
-  amount: '1000000', // 1 USDC (6 decimals)
-  senderAddress: '0xYourEvmAddress',
-  receiverAddress: 'fast1yourfastaddress',
-  evmExecutor,
+import { buildDepositTransaction } from '@fastxyz/allset-sdk';
+
+const plan = buildDepositTransaction({
+  network: 'testnet',
+  chain: 'arbitrum',
+  token: 'USDC',
+  amount: 1_000_000n,
+  receiver: 'fast1receiveraddress...',
 });
 
-console.log(result.txHash);
+console.log(plan.to);
+console.log(plan.data);
+console.log(plan.value);
 ```
 
-### Withdraw (Fast → EVM)
+For deployments that are not bundled in the SDK yet, pass your own route config:
 
 ```ts
-import { createFastWallet } from '@fastxyz/allset-sdk';
-
-const wallet = createFastWallet();
-console.log(wallet.address);
-// Persist wallet.privateKey and wallet.publicKey securely.
+const plan = buildDepositTransaction({
+  network: 'mainnet',
+  chain: 'base',
+  token: 'fastUSDC',
+  amount: 1_000_000n,
+  receiver: 'fast1receiveraddress...',
+  networkConfig: {
+    chains: {
+      base: {
+        chainId: 8453,
+        bridgeContract: '0xYourAllSetBridge',
+        tokens: {
+          USDC: {
+            evmAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+            decimals: 6,
+          },
+        },
+      },
+    },
+  },
+});
 ```
 
-Store that keypair securely, then use it with `createFastClient()`:
+This is the intended temporary path for Base mainnet until the authoritative deployment config is published in the SDK defaults.
 
-```ts
-import { createFastClient, allsetProvider } from '@fastxyz/allset-sdk';
+### Node execution
 
-const fastClient = createFastClient({
-  privateKey: process.env.FAST_PRIVATE_KEY!, // 32-byte hex
-  publicKey: process.env.FAST_PUBLIC_KEY!,   // 32-byte hex
+```ts
+import { FastProvider, FastWallet } from '@fastxyz/sdk';
+import {
+  AllSetProvider,
+  createEvmExecutor,
+  createEvmWallet,
+} from '@fastxyz/allset-sdk/node';
+
+const fastProvider = new FastProvider({ network: 'testnet' });
+const allset = new AllSetProvider({ network: 'testnet' });
+const fastWallet = await FastWallet.fromKeyfile('~/.fast/keys/default.json', fastProvider);
+
+// Create EVM account
+const account = createEvmWallet('~/.evm/keys/default.json');
+// Or: const account = createEvmWallet('0xprivateKey...');
+// Or: const account = createEvmWallet(); // persist account.privateKey if generated
+
+// Create EVM clients
+const evmClients = createEvmExecutor(account, 'https://sepolia-rollup.arbitrum.io/rpc', 421614);
+
+// Deposit: EVM → Fast
+await allset.sendToFast({
+  chain: 'arbitrum',
+  token: 'USDC',
+  amount: '1000000',
+  from: account.address,
+  to: fastWallet.address,
+  evmClients,
 });
 
-const result = await allsetProvider.bridge({
-  fromChain: 'fast',
-  toChain: 'arbitrum',
-  fromToken: 'fastUSDC',
-  toToken: 'USDC',
-  fromDecimals: 6,
-  amount: '1000000', // 1 USDC (6 decimals)
-  senderAddress: fastClient.address!,
-  receiverAddress: '0xYourEvmAddress',
-  fastClient,
+// Withdraw: Fast → EVM
+await allset.sendToExternal({
+  chain: 'arbitrum',
+  token: 'fastUSDC',
+  amount: '1000000',
+  from: fastWallet.address,
+  to: account.address,
+  fastWallet,
 });
-
-console.log(result.txHash);
-// { txHash: '0x...', orderId: '0x...', estimatedTime: '1-5 minutes' }
 ```
 
-Best practice: generate the Fast wallet once, store the private/public keys in your secret manager or environment, and pass those stored values into `createFastClient()`. Do not generate a fresh wallet on every app start unless that is explicitly what you want.
+## createEvmWallet
 
-## Features
+Returns an Account-compatible object with viem signing methods and `privateKey`.
 
-- **Deposit** - Bridge USDC from EVM chains to fastUSDC on Fast
-- **Withdraw** - Bridge fastUSDC from Fast to USDC on EVM chains
-- **EVM Executor** - Built-in viem-based transaction executor
-- **Fast Client** - Built-in Fast network client for withdrawals
-- **Fast Wallet Generator** - Generate a Fast keypair and address without another SDK
+```ts
+// Generate new wallet
+const generatedAccount = createEvmWallet();
+console.log(generatedAccount.privateKey); // persist this if you generated it
 
-## Supported Networks
+// Derive from private key
+const derivedAccount = createEvmWallet('0x1234...64hexchars');
 
-Current SDK implementation in this branch:
+// Load from keyfile
+const keyfileAccount = createEvmWallet('~/.evm/keys/default.json');
+```
 
-- Testnet-only bridge flows
-- Arbitrum Sepolia (`421614`) + Fast testnet
-- Token mapping for `USDC` <-> `fastUSDC`
+**Keyfile format:**
+```json
+{
+  "privateKey": "abc123...64hexchars",
+  "address": "0x..." // optional, for reference
+}
+```
 
-Environment target matrix for AllSet deployments:
+## createEvmExecutor
 
-- Mainnet: Polygon, Arbitrum, Base with `USDC` -> `fastUSDC`
-- Testnet: Sepolia, Arbitrum Sepolia, Tempo with testnet `USDC` -> `testUSDC`
+Returns `{ walletClient, publicClient }` for EVM operations.
 
-## Documentation
+```ts
+const { walletClient, publicClient } = createEvmExecutor(account, rpcUrl, chainId);
+```
 
-See [SKILL.md](./SKILL.md) for detailed API documentation and troubleshooting.
+Accepts viem `Account` values, including the objects returned by `createEvmWallet()`.
 
-## Development
+### Pure intent builders
 
-```bash
-npm install
-npm run build
-npm test
+```ts
+import {
+  buildTransferIntent,
+  buildExecuteIntent,
+  buildDepositBackIntent,
+} from '@fastxyz/allset-sdk/browser';
+
+const intents = [
+  buildTransferIntent('0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d', '0xRecipient'),
+  buildExecuteIntent('0xContractAddress', '0xabcdef'),
+  buildDepositBackIntent('0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d', 'fast1receiveraddress...'),
+];
+```
+
+## Advanced: Custom Intents
+
+```ts
+import { buildExecuteIntent, buildTransferIntent } from '@fastxyz/allset-sdk';
+
+await allset.executeIntent({
+  chain: 'arbitrum',
+  fastWallet,
+  token: 'fastUSDC',
+  amount: '1000000',
+  intents: [
+    buildTransferIntent(USDC_ADDRESS, '0xRecipient'),
+    buildExecuteIntent(CONTRACT_ADDRESS, '0xabcdef'),
+  ],
+});
 ```
 
+## Supported Networks
+
+| Network | Chain | Status |
+| --- | --- | --- |
+| Testnet | Arbitrum Sepolia | ✅ |
+| Testnet | Ethereum Sepolia | ✅ |
+| Testnet | Base (mainnet chain) | ✅ |
+| Mainnet | Coming soon | 🔜 |
+
+## Current Hosted Endpoints
+
+These are the currently used hosted endpoints and token IDs for the public testnet environment:
+
+- Portal: `https://testnet.allset.fast.xyz`
+- Fast proxy: `https://testnet.api.fast.xyz/proxy`
+- Cross-sign: `https://testnet.cross-sign.allset.fast.xyz`
+
+Current Fast token IDs:
+
+- `testUSDC` testnet token id
+  - Base64: `nFL+lGX1e8UmwRqgwEj9hwmqRqvAbRXIDL7ZJj1NTfg=`
+  - Hex: `9c52fe9465f57bc526c11aa0c048fd8709aa46abc06d15c80cbed9263d4d4df8`
+- `fastUSDC` mainnet token id
+  - Base64: `tP2rhGNydA90frS2SsDCLqoVkRPy01sHUCcGX7pBk2U=`
+  - Hex: `b4fdab846372740f747eb4b64ac0c22eaa159113f2d35b075027065fba419365`
+
+Bundled testnet chain routes:
+
+- Ethereum Sepolia
+  - Bridge contract: `0x67C5f02df93f2144C6a4e4Fb48D92cE91Cfbc3A6`
+  - Fast bridge: `fast1fxtkgpwcy7hnakw96gg7relph4wxx7ghrukm723p3l9adxuxljzsc6f958`
+  - Relayer base URL: `https://testnet.allset.fast.xyz/ethereum-sepolia/relayer`
+  - Bundled relayer submit URL: `https://testnet.allset.fast.xyz/ethereum-sepolia/relayer/relay`
+  - Fast token id: `testUSDC`
+- Arbitrum Sepolia
+  - Bridge contract: `0x67C5f02df93f2144C6a4e4Fb48D92cE91Cfbc3A6`
+  - Fast bridge: `fast1tkmtqxulhnzeeg9zhuwxy3x95wr7waytm9cq40ndf7tkuwwcc6jseg24j8`
+  - Relayer base URL: `https://testnet.allset.fast.xyz/arbitrum-sepolia/relayer`
+  - Bundled relayer submit URL: `https://testnet.allset.fast.xyz/arbitrum-sepolia/relayer/relay`
+  - Fast token id: `testUSDC`
+- Base
+  - Bridge contract: `0x41cE437493f2a9DDA9214aE7b3662175bBe54a6c`
+  - Fast bridge: `fast1a4fza9xc8jcm7jp64a0ugtuyw3hkkmje02e8af9aaer4r0je4dpqz4uf58`
+  - Relayer base URL: `https://testnet.allset.fast.xyz/base/relayer`
+  - Bundled relayer submit URL: `https://testnet.allset.fast.xyz/base/relayer/relay`
+  - Bundled Fast token id: `fastUSDC`
+
+Note: the SDK currently posts to the explicit `/relay` endpoint. The plain `/relayer` URL above is included as a reference base URL.
+
+## Migration
+
+- Root imports are now pure-helper only.
+- Move provider, executor, wallet, and config imports to `@fastxyz/allset-sdk/node`.
+- Use the root, `core`, or `browser` entrypoints for deposit planning and intent building.
+
+## Documentation
+
+See [SKILL.md](./SKILL.md) for detailed API documentation.
+
 ## License
 
 MIT

package/dist/browser/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+export * from '../core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/core/address.d.ts

@@ -0,0 +1,4 @@
+import type { Hex } from 'viem';
+export declare function bytesToHex(bytes: Uint8Array): Hex;
+export declare function fastAddressToBytes32(address: string): Hex;
+//# sourceMappingURL=address.d.ts.map

package/dist/core/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/core/address.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAMjD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAoBzD"}

package/dist/core/address.js

@@ -0,0 +1,27 @@
+import { bech32m } from 'bech32';
+export function bytesToHex(bytes) {
+    let hex = '';
+    for (const byte of bytes) {
+        hex += byte.toString(16).padStart(2, '0');
+    }
+    return `0x${hex}`;
+}
+export function fastAddressToBytes32(address) {
+    let decoded;
+    try {
+        decoded = bech32m.decode(address, 90);
+    }
+    catch (error) {
+        throw new Error(`Invalid Fast address "${address}": ${error.message}`);
+    }
+    const { prefix, words } = decoded;
+    if (prefix !== 'fast') {
+        throw new Error(`Fast address must use the "fast" prefix. Got: "${prefix}"`);
+    }
+    const bytes = new Uint8Array(bech32m.fromWords(words));
+    if (bytes.length !== 32) {
+        throw new Error(`Fast address must decode to 32 bytes. Got: ${bytes.length}`);
+    }
+    return bytesToHex(bytes);
+}
+//# sourceMappingURL=address.js.map

package/dist/core/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src/core/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGjC,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,GAAG,EAAS,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,OAA0C,CAAC;IAE/C,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAClC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,kDAAkD,MAAM,GAAG,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/core/deposit.d.ts

@@ -0,0 +1,59 @@
+export interface DepositPlanningTokenConfig {
+    evmAddress: string;
+    decimals: number;
+    isNative?: boolean;
+}
+export interface DepositPlanningChainConfig {
+    chainId: number;
+    bridgeContract: string;
+    tokens: Record<string, DepositPlanningTokenConfig>;
+}
+export interface DepositPlanningNetworkConfig {
+    chains: Record<string, DepositPlanningChainConfig>;
+}
+export interface DepositRouteOverrides {
+    bridgeAddress?: string;
+    tokenAddress?: string;
+    chainId?: number;
+    decimals?: number;
+    isNative?: boolean;
+}
+export interface ResolveDepositRouteParams {
+    network?: 'testnet' | 'mainnet';
+    chain: string;
+    token: string;
+    overrides?: DepositRouteOverrides;
+    networkConfig?: DepositPlanningNetworkConfig;
+}
+export interface DepositRoute {
+    network: 'testnet' | 'mainnet';
+    chain: string;
+    token: string;
+    chainId: number;
+    bridgeAddress: `0x${string}`;
+    tokenAddress: `0x${string}`;
+    decimals: number;
+    isNative: boolean;
+}
+export interface EncodeDepositCalldataParams {
+    tokenAddress: string;
+    amount: bigint;
+    receiverBytes32: `0x${string}`;
+}
+export interface BuildDepositTransactionParams extends ResolveDepositRouteParams {
+    amount: bigint;
+    receiver: string;
+}
+export interface DepositTransactionPlan {
+    chainId: number;
+    to: `0x${string}`;
+    data: `0x${string}`;
+    value: bigint;
+    receiverBytes32: `0x${string}`;
+    route: DepositRoute;
+}
+export declare function resolveDepositRoute(params: ResolveDepositRouteParams): DepositRoute;
+export declare function encodeDepositCalldata(params: EncodeDepositCalldataParams): `0x${string}`;
+export declare function buildDepositTransactionFromRoute(route: DepositRoute, amount: bigint, receiver: string): DepositTransactionPlan;
+export declare function buildDepositTransaction(params: BuildDepositTransactionParams): DepositTransactionPlan;
+//# sourceMappingURL=deposit.d.ts.map

package/dist/core/deposit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.d.ts","sourceRoot":"","sources":["../../src/core/deposit.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,aAAa,CAAC,EAAE,4BAA4B,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;CACrB;AAiDD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,YAAY,CA6BnF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,KAAK,MAAM,EAAE,CAUxF;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,sBAAsB,CAcxB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,sBAAsB,CAGxB"}

package/dist/core/deposit.js

@@ -0,0 +1,93 @@
+import { encodeFunctionData } from 'viem';
+import { DEFAULT_NETWORKS_CONFIG } from '../default-config.js';
+import { fastAddressToBytes32 } from './address.js';
+const BRIDGE_DEPOSIT_ABI = [{
+        type: 'function',
+        name: 'deposit',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+            { name: 'receiver', type: 'bytes32' },
+        ],
+        outputs: [],
+        stateMutability: 'payable',
+    }];
+function normalizeDepositToken(token) {
+    const lowerToken = token.toLowerCase();
+    if (lowerToken === 'fastusdc' || lowerToken === 'testusdc') {
+        return 'USDC';
+    }
+    return token;
+}
+function resolveTokenEntry(chainConfig, token) {
+    const normalizedToken = normalizeDepositToken(token);
+    const exactConfig = chainConfig.tokens[normalizedToken];
+    if (exactConfig) {
+        return { tokenKey: normalizedToken, tokenConfig: exactConfig };
+    }
+    const upperToken = normalizedToken.toUpperCase();
+    const upperConfig = chainConfig.tokens[upperToken];
+    if (upperConfig) {
+        return { tokenKey: upperToken, tokenConfig: upperConfig };
+    }
+    const loweredAddress = token.toLowerCase();
+    for (const [tokenKey, tokenConfig] of Object.entries(chainConfig.tokens)) {
+        if (tokenConfig.evmAddress.toLowerCase() === loweredAddress) {
+            return { tokenKey, tokenConfig };
+        }
+    }
+    return null;
+}
+export function resolveDepositRoute(params) {
+    const network = params.network ?? 'testnet';
+    const networkConfig = params.networkConfig ?? DEFAULT_NETWORKS_CONFIG[network];
+    const chainConfig = networkConfig.chains[params.chain];
+    if (!chainConfig) {
+        throw new Error(`AllSet does not support EVM chain "${params.chain}" on ${network}. Supported: ${Object.keys(networkConfig.chains).join(', ') || 'none'}`);
+    }
+    const tokenEntry = resolveTokenEntry(chainConfig, params.token);
+    if (!tokenEntry) {
+        throw new Error(`Cannot resolve token "${params.token}" on AllSet for chain "${params.chain}".`);
+    }
+    return {
+        network,
+        chain: params.chain,
+        token: tokenEntry.tokenKey,
+        chainId: params.overrides?.chainId ?? chainConfig.chainId,
+        bridgeAddress: (params.overrides?.bridgeAddress ?? chainConfig.bridgeContract),
+        tokenAddress: (params.overrides?.tokenAddress ?? tokenEntry.tokenConfig.evmAddress),
+        decimals: params.overrides?.decimals ?? tokenEntry.tokenConfig.decimals,
+        isNative: params.overrides?.isNative ?? tokenEntry.tokenConfig.isNative ?? false,
+    };
+}
+export function encodeDepositCalldata(params) {
+    return encodeFunctionData({
+        abi: BRIDGE_DEPOSIT_ABI,
+        functionName: 'deposit',
+        args: [
+            params.tokenAddress,
+            params.amount,
+            params.receiverBytes32,
+        ],
+    });
+}
+export function buildDepositTransactionFromRoute(route, amount, receiver) {
+    const receiverBytes32 = fastAddressToBytes32(receiver);
+    return {
+        chainId: route.chainId,
+        to: route.bridgeAddress,
+        data: encodeDepositCalldata({
+            tokenAddress: route.tokenAddress,
+            amount,
+            receiverBytes32,
+        }),
+        value: route.isNative ? amount : 0n,
+        receiverBytes32,
+        route,
+    };
+}
+export function buildDepositTransaction(params) {
+    const route = resolveDepositRoute(params);
+    return buildDepositTransactionFromRoute(route, params.amount, params.receiver);
+}
+//# sourceMappingURL=deposit.js.map

package/dist/core/deposit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.js","sourceRoot":"","sources":["../../src/core/deposit.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { buildDepositTransaction, encodeDepositCalldata, resolveDepositRoute, } from './deposit.js';
+export { fastAddressToBytes32 } from './address.js';
+export { IntentAction, buildTransferIntent, buildExecuteIntent, buildDepositBackIntent, buildRevokeIntent, } from '../intents.js';
+export type { Intent } from '../intents.js';
+export type { BuildDepositTransactionParams, DepositPlanningChainConfig, DepositPlanningNetworkConfig, DepositPlanningTokenConfig, DepositRoute, DepositRouteOverrides, DepositTransactionPlan, EncodeDepositCalldataParams, ResolveDepositRouteParams, } from './deposit.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,4 @@
+export { buildDepositTransaction, encodeDepositCalldata, resolveDepositRoute, } from './deposit.js';
+export { fastAddressToBytes32 } from './address.js';
+export { IntentAction, buildTransferIntent, buildExecuteIntent, buildDepositBackIntent, buildRevokeIntent, } from '../intents.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/default-config.d.ts

@@ -0,0 +1,51 @@
+export declare const DEFAULT_NETWORKS_CONFIG: {
+    testnet: {
+        crossSignUrl: string;
+        chains: {
+            ethereum: {
+                chainId: number;
+                bridgeContract: string;
+                fastBridgeAddress: string;
+                relayerUrl: string;
+                tokens: {
+                    USDC: {
+                        evmAddress: string;
+                        fastTokenId: string;
+                        decimals: number;
+                    };
+                };
+            };
+            arbitrum: {
+                chainId: number;
+                bridgeContract: string;
+                fastBridgeAddress: string;
+                relayerUrl: string;
+                tokens: {
+                    USDC: {
+                        evmAddress: string;
+                        fastTokenId: string;
+                        decimals: number;
+                    };
+                };
+            };
+            base: {
+                chainId: number;
+                bridgeContract: string;
+                fastBridgeAddress: string;
+                relayerUrl: string;
+                tokens: {
+                    USDC: {
+                        evmAddress: string;
+                        fastTokenId: string;
+                        decimals: number;
+                    };
+                };
+            };
+        };
+    };
+    mainnet: {
+        crossSignUrl: string;
+        chains: {};
+    };
+};
+//# sourceMappingURL=default-config.d.ts.map

package/dist/default-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.d.ts","sourceRoot":"","sources":["../src/default-config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDP,CAAC"}