@fastxyz/allset-sdk 0.1.2 → 0.1.4

package/README.md

@@ -4,31 +4,107 @@ Bridge tokens between Fast network and EVM chains.
 
 ## Installation
 
+Pure helpers only:
+
+```bash
+npm install @fastxyz/allset-sdk
+```
+
+FastWallet-backed withdrawals and intent execution:
+
 ```bash
-npm install @fastxyz/sdk @fastxyz/allset-sdk
+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
 
+### Pure deposit planning
+
+```ts
+import { buildDepositTransaction } from '@fastxyz/allset-sdk';
+
+const plan = buildDepositTransaction({
+  network: 'testnet',
+  chain: 'arbitrum',
+  token: 'USDC',
+  amount: 1_000_000n,
+  receiver: 'fast1receiveraddress...',
+});
+
+console.log(plan.to);
+console.log(plan.data);
+console.log(plan.value);
+```
+
+For deployments that are not bundled in the SDK yet, pass your own route config:
+
+```ts
+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,
+          },
+        },
+      },
+    },
+  },
+});
+```
+
+This is the intended temporary path for Base mainnet until the authoritative deployment config is published in the SDK defaults.
+
+### Node execution
+
 ```ts
 import { FastProvider, FastWallet } from '@fastxyz/sdk';
-import { AllSetProvider, createEvmExecutor, createEvmWallet } from '@fastxyz/allset-sdk';
+import {
+  AllSetProvider,
+  createEvmExecutor,
+  createEvmWallet,
+} from '@fastxyz/allset-sdk/node';
 
-// Setup
 const fastProvider = new FastProvider({ network: 'testnet' });
 const allset = new AllSetProvider({ network: 'testnet' });
 const fastWallet = await FastWallet.fromKeyfile('~/.fast/keys/default.json', fastProvider);
-const evmWallet = createEvmWallet('~/.allset/.evm/keys/default.json');
+
+// 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
-const evmExecutor = createEvmExecutor(evmWallet.privateKey, 'https://sepolia-rollup.arbitrum.io/rpc', 421614);
 await allset.sendToFast({
   chain: 'arbitrum',
   token: 'USDC',
   amount: '1000000',
-  from: evmWallet.address,
+  from: account.address,
   to: fastWallet.address,
-  evmExecutor,
+  evmClients,
 });
 
 // Withdraw: Fast → EVM
@@ -37,17 +113,66 @@ await allset.sendToExternal({
   token: 'fastUSDC',
   amount: '1000000',
   from: fastWallet.address,
-  to: evmWallet.address,
+  to: account.address,
   fastWallet,
 });
 ```
 
+## createEvmWallet
+
+Returns an Account-compatible object with viem signing methods and `privateKey`.
+
+```ts
+// Generate new wallet
+const generatedAccount = createEvmWallet();
+console.log(generatedAccount.privateKey); // persist this if you generated it
+
+// Derive from private key
+const derivedAccount = createEvmWallet('0x1234...64hexchars');
+
+// Load from keyfile
+const keyfileAccount = createEvmWallet('~/.evm/keys/default.json');
+```
+
+**Keyfile format:**
+```json
+{
+  "privateKey": "abc123...64hexchars",
+  "address": "0x..." // optional, for reference
+}
+```
+
+## createEvmExecutor
+
+Returns `{ walletClient, publicClient }` for EVM operations.
+
+```ts
+const { walletClient, publicClient } = createEvmExecutor(account, rpcUrl, chainId);
+```
+
+Accepts viem `Account` values, including the objects returned by `createEvmWallet()`.
+
+### Pure intent builders
+
+```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 { buildTransferIntent, buildExecuteIntent } from '@fastxyz/allset-sdk';
+import { buildExecuteIntent, buildTransferIntent } from '@fastxyz/allset-sdk';
 
-// Execute custom intents on EVM chain
 await allset.executeIntent({
   chain: 'arbitrum',
   fastWallet,
@@ -55,21 +180,66 @@ await allset.executeIntent({
   amount: '1000000',
   intents: [
     buildTransferIntent(USDC_ADDRESS, '0xRecipient'),
-    // Add more intents: swaps, protocol calls, etc.
+    buildExecuteIntent(CONTRACT_ADDRESS, '0xabcdef'),
   ],
 });
 ```
 
-For intents without a transfer recipient or execute target, pass `externalAddress` so the relayer has an explicit EVM target.
-
 ## 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.

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"}

package/dist/default-config.js

@@ -0,0 +1,52 @@
+// Single source of truth for the SDK's bundled default network support matrix.
+export const DEFAULT_NETWORKS_CONFIG = {
+    testnet: {
+        crossSignUrl: 'https://testnet.cross-sign.allset.fast.xyz',
+        chains: {
+            ethereum: {
+                chainId: 11155111,
+                bridgeContract: '0x67C5f02df93f2144C6a4e4Fb48D92cE91Cfbc3A6',
+                fastBridgeAddress: 'fast1fxtkgpwcy7hnakw96gg7relph4wxx7ghrukm723p3l9adxuxljzsc6f958',
+                relayerUrl: 'https://testnet.allset.fast.xyz/ethereum-sepolia/relayer/relay',
+                tokens: {
+                    USDC: {
+                        evmAddress: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+                        fastTokenId: '9c52fe9465f57bc526c11aa0c048fd8709aa46abc06d15c80cbed9263d4d4df8',
+                        decimals: 6,
+                    },
+                },
+            },
+            arbitrum: {
+                chainId: 421614,
+                bridgeContract: '0x67C5f02df93f2144C6a4e4Fb48D92cE91Cfbc3A6',
+                fastBridgeAddress: 'fast1tkmtqxulhnzeeg9zhuwxy3x95wr7waytm9cq40ndf7tkuwwcc6jseg24j8',
+                relayerUrl: 'https://testnet.allset.fast.xyz/arbitrum-sepolia/relayer/relay',
+                tokens: {
+                    USDC: {
+                        evmAddress: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
+                        fastTokenId: '9c52fe9465f57bc526c11aa0c048fd8709aa46abc06d15c80cbed9263d4d4df8',
+                        decimals: 6,
+                    },
+                },
+            },
+            base: {
+                chainId: 8453,
+                bridgeContract: '0x41cE437493f2a9DDA9214aE7b3662175bBe54a6c',
+                fastBridgeAddress: 'fast1a4fza9xc8jcm7jp64a0ugtuyw3hkkmje02e8af9aaer4r0je4dpqz4uf58',
+                relayerUrl: 'https://testnet.allset.fast.xyz/base/relayer/relay',
+                tokens: {
+                    USDC: {
+                        evmAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+                        fastTokenId: 'b4fdab846372740f747eb4b64ac0c22eaa159113f2d35b075027065fba419365',
+                        decimals: 6,
+                    },
+                },
+            },
+        },
+    },
+    mainnet: {
+        crossSignUrl: 'https://cross-sign.allset.fast.xyz',
+        chains: {},
+    },
+};
+//# sourceMappingURL=default-config.js.map

package/dist/default-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.js","sourceRoot":"","sources":["../src/default-config.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO,EAAE;QACP,YAAY,EAAE,4CAA4C;QAC1D,MAAM,EAAE;YACN,QAAQ,EAAE;gBACR,OAAO,EAAE,QAAQ;gBACjB,cAAc,EAAE,4CAA4C;gBAC5D,iBAAiB,EAAE,iEAAiE;gBACpF,UAAU,EAAE,gEAAgE;gBAC5E,MAAM,EAAE;oBACN,IAAI,EAAE;wBACJ,UAAU,EAAE,4CAA4C;wBACxD,WAAW,EAAE,kEAAkE;wBAC/E,QAAQ,EAAE,CAAC;qBACZ;iBACF;aACF;YACD,QAAQ,EAAE;gBACR,OAAO,EAAE,MAAM;gBACf,cAAc,EAAE,4CAA4C;gBAC5D,iBAAiB,EAAE,iEAAiE;gBACpF,UAAU,EAAE,gEAAgE;gBAC5E,MAAM,EAAE;oBACN,IAAI,EAAE;wBACJ,UAAU,EAAE,4CAA4C;wBACxD,WAAW,EAAE,kEAAkE;wBAC/E,QAAQ,EAAE,CAAC;qBACZ;iBACF;aACF;YACD,IAAI,EAAE;gBACJ,OAAO,EAAE,IAAI;gBACb,cAAc,EAAE,4CAA4C;gBAC5D,iBAAiB,EAAE,iEAAiE;gBACpF,UAAU,EAAE,oDAAoD;gBAChE,MAAM,EAAE;oBACN,IAAI,EAAE;wBACJ,UAAU,EAAE,4CAA4C;wBACxD,WAAW,EAAE,kEAAkE;wBAC/E,QAAQ,EAAE,CAAC;qBACZ;iBACF;aACF;SACF;KACF;IACD,OAAO,EAAE;QACP,YAAY,EAAE,oCAAoC;QAClD,MAAM,EAAE,EAAE;KACX;CAC0B,CAAC"}