@fastxyz/allset-sdk 0.1.12 → 1.0.0

package/dist/node/evm-executor.js

@@ -1,160 +0,0 @@
-/**
- * evm-executor.ts — EVM client utilities using viem
- *
- * Provides createEvmExecutor() to create viem wallet and public clients,
- * and createEvmWallet() to generate or load EVM wallets.
- *
- * Wallet keyfiles are managed by the user at ~/.evm/keys/ or custom paths.
- * Expected format: { "privateKey": "...", "address": "..." (optional) }
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { createPublicClient, createWalletClient, http, parseAbi, } from 'viem';
-import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
-import { arbitrum, arbitrumSepolia, base, mainnet as ethereum, sepolia } from 'viem/chains';
-// Default EVM keys directory
-const DEFAULT_EVM_KEYS_DIR = join(process.env.HOME || process.env.USERPROFILE || '', '.evm', 'keys');
-/**
- * Get the default EVM keys directory (~/.evm/keys).
- */
-export function getEvmKeysDir() {
-    return DEFAULT_EVM_KEYS_DIR;
-}
-/**
- * Expand ~ to home directory
- */
-function expandPath(path) {
-    if (path.startsWith('~/')) {
-        const home = process.env.HOME || process.env.USERPROFILE || '';
-        return path.replace('~', home);
-    }
-    return path;
-}
-/**
- * Detect if a string is a file path (vs a private key)
- */
-function isFilePath(input) {
-    return input.includes('/') || input.startsWith('~') || input.endsWith('.json');
-}
-function normalizePrivateKey(privateKey) {
-    return (privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`);
-}
-/**
- * Create or load an EVM wallet and return an Account-compatible object.
- *
- * @param keyOrPath - Optional. Can be:
- *   - Omitted: generates a new random wallet
- *   - Private key (64 hex chars, with or without 0x): derives account from it
- *   - File path (contains `/` or `~`, or ends with `.json`): loads from JSON keyfile
- *
- * The keyfile must be a JSON file containing:
- * - `privateKey` (required): hex string, with or without 0x prefix
- * - `address` (optional): for user reference only
- *
- * It is the user's responsibility to create and manage keyfiles.
- * Generated accounts expose `privateKey` so callers can persist them.
- *
- * @returns Account-compatible object with viem signing methods and `privateKey`
- *
- * @example
- * ```ts
- * // Generate new wallet
- * const account = createEvmWallet();
- * console.log(account.address); // 0x...
- * console.log(account.privateKey); // persist this if you generated the wallet
- *
- * // Derive from private key
- * const account = createEvmWallet('0x1234...64hexchars');
- *
- * // Load from keyfile
- * const account = createEvmWallet('~/.evm/keys/default.json');
- *
- * // Use with createEvmExecutor
- * const { walletClient, publicClient } = createEvmExecutor(account, rpcUrl, chainId);
- * ```
- *
- * @example Keyfile format
- * ```json
- * {
- *   "privateKey": "abc123...64hexchars",
- *   "address": "0x..." // optional, for reference
- * }
- * ```
- */
-export function createEvmWallet(keyOrPath) {
-    let key;
-    if (!keyOrPath) {
-        // Generate new wallet
-        key = generatePrivateKey();
-    }
-    else if (isFilePath(keyOrPath)) {
-        // Load from file
-        const fullPath = expandPath(keyOrPath);
-        if (!existsSync(fullPath)) {
-            throw new Error(`Wallet file not found: ${keyOrPath}`);
-        }
-        const content = readFileSync(fullPath, 'utf-8');
-        const data = JSON.parse(content);
-        if (!data.privateKey) {
-            throw new Error(`Invalid wallet file: missing privateKey`);
-        }
-        key = normalizePrivateKey(data.privateKey);
-    }
-    else {
-        // Treat as private key
-        key = normalizePrivateKey(keyOrPath);
-    }
-    return Object.assign(privateKeyToAccount(key), { privateKey: key });
-}
-/** ERC20 ABI for allowance and approve */
-export const ERC20_ABI = parseAbi([
-    'function approve(address spender, uint256 amount) returns (bool)',
-    'function allowance(address owner, address spender) view returns (uint256)',
-]);
-/** Bundled supported chain mappings */
-export const CHAIN_MAP = {
-    1: ethereum,
-    11155111: sepolia,
-    421614: arbitrumSepolia,
-    42161: arbitrum,
-    8453: base,
-};
-/**
- * Create viem wallet and public clients for EVM operations.
- *
- * @param account - viem Account from createEvmWallet() or privateKeyToAccount()
- * @param rpcUrl - RPC endpoint URL
- * @param chainId - Chain ID (11155111 for Sepolia, 421614 for Arbitrum Sepolia, 8453 for Base)
- * @returns Object with walletClient and publicClient
- *
- * @example
- * ```ts
- * // Using Account from createEvmWallet (loads from keyfile)
- * const account = createEvmWallet('~/.evm/keys/default.json');
- * const { walletClient, publicClient } = createEvmExecutor(account, 'https://sepolia-rollup.arbitrum.io/rpc', 421614);
- *
- * // Using viem's privateKeyToAccount directly
- * import { privateKeyToAccount } from 'viem/accounts';
- * const account = privateKeyToAccount('0xabc123...');
- * const { walletClient, publicClient } = createEvmExecutor(account, rpcUrl, chainId);
- *
- * // Use clients for bridge deposit
- * await allset.sendToFast({ ..., evmClients: { walletClient, publicClient } });
- * ```
- */
-export function createEvmExecutor(account, rpcUrl, chainId) {
-    const chain = CHAIN_MAP[chainId];
-    if (!chain) {
-        throw new Error(`Unsupported EVM chain ID: ${chainId}. Supported: ${Object.keys(CHAIN_MAP).join(', ')}`);
-    }
-    const walletClient = createWalletClient({
-        account,
-        chain,
-        transport: http(rpcUrl),
-    });
-    const publicClient = createPublicClient({
-        chain,
-        transport: http(rpcUrl),
-    });
-    return { walletClient, publicClient };
-}

package/dist/node/index.d.ts

@@ -1,15 +0,0 @@
-export * from '../core/index.js';
-export * from './eip7702.js';
-export { AllSetProvider, getAllSetDir, getEvmKeysDir as getAllSetEvmKeysDir, ensureAllSetDirs, initUserConfig, } from './provider.js';
-export { createEvmExecutor, createEvmWallet, getEvmKeysDir, } from './evm-executor.js';
-export { loadNetworksConfig, getNetworkConfig, getChainConfig, getTokenConfig, clearConfigCache, } from './config.js';
-export type { BridgeProvider, BridgeParams, BridgeResult, FastWalletLike, AllSetChainConfig, AllSetTokenInfo, SendToFastParams, SendToExternalParams, ExecuteIntentParams, } from './types.js';
-export type { Intent } from '../intents.js';
-export type { EvmSignResult } from './bridge.js';
-export type { EvmAccount, EvmClients } from './evm-executor.js';
-export type { NetworkConfig, ChainConfig, TokenConfig, AllNetworksConfig } from './config.js';
-export type { AllSetProviderOptions } from './provider.js';
-export declare function evmSign(...args: Parameters<typeof import('./bridge.js').evmSign>): ReturnType<typeof import('./bridge.js').evmSign>;
-export declare function executeBridge(...args: Parameters<typeof import('./bridge.js').executeBridge>): ReturnType<typeof import('./bridge.js').executeBridge>;
-export declare function executeIntent(...args: Parameters<typeof import('./bridge.js').executeIntent>): ReturnType<typeof import('./bridge.js').executeIntent>;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,gBAAgB,EAChB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9F,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,wBAAsB,OAAO,CAC3B,GAAG,IAAI,EAAE,UAAU,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,GACxD,UAAU,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,CAGlD;AAED,wBAAsB,aAAa,CACjC,GAAG,IAAI,EAAE,UAAU,CAAC,cAAc,aAAa,EAAE,aAAa,CAAC,GAC9D,UAAU,CAAC,cAAc,aAAa,EAAE,aAAa,CAAC,CAGxD;AAED,wBAAsB,aAAa,CACjC,GAAG,IAAI,EAAE,UAAU,CAAC,cAAc,aAAa,EAAE,aAAa,CAAC,GAC9D,UAAU,CAAC,cAAc,aAAa,EAAE,aAAa,CAAC,CAGxD"}

package/dist/node/index.js

@@ -1,17 +0,0 @@
-export * from '../core/index.js';
-export * from './eip7702.js';
-export { AllSetProvider, getAllSetDir, getEvmKeysDir as getAllSetEvmKeysDir, ensureAllSetDirs, initUserConfig, } from './provider.js';
-export { createEvmExecutor, createEvmWallet, getEvmKeysDir, } from './evm-executor.js';
-export { loadNetworksConfig, getNetworkConfig, getChainConfig, getTokenConfig, clearConfigCache, } from './config.js';
-export async function evmSign(...args) {
-    const mod = await import('./bridge.js');
-    return mod.evmSign(...args);
-}
-export async function executeBridge(...args) {
-    const mod = await import('./bridge.js');
-    return mod.executeBridge(...args);
-}
-export async function executeIntent(...args) {
-    const mod = await import('./bridge.js');
-    return mod.executeIntent(...args);
-}

package/dist/node/provider.d.ts

@@ -1,162 +0,0 @@
-/**
- * provider.ts — AllSetProvider for bridge configuration and operations
- *
- * Similar to FastProvider, AllSetProvider manages network configuration
- * and provides the bridge() method for bridging tokens.
- */
-import type { NetworkConfig, ChainConfig, TokenConfig, AllNetworksConfig } from './config.js';
-import type { BridgeResult, SendToFastParams, SendToExternalParams, ExecuteIntentParams } from './types.js';
-export interface AllSetProviderOptions {
-    /**
-     * Network to use: 'testnet' or 'mainnet'
-     * @default 'testnet'
-     */
-    network?: 'testnet' | 'mainnet';
-    /**
-     * Custom path to networks.json config file.
-     * If not provided, loads from:
-     * 1. ~/.allset/networks.json (user override)
-     * 2. Embedded package defaults
-     */
-    configPath?: string;
-    /**
-     * Custom cross-sign URL (overrides config)
-     */
-    crossSignUrl?: string;
-}
-/**
- * AllSetProvider manages AllSet bridge configuration.
- *
- * @example
- * ```ts
- * // Default testnet configuration
- * const provider = new AllSetProvider();
- *
- * // Mainnet configuration
- * const provider = new AllSetProvider({ network: 'mainnet' });
- *
- * // Custom config file
- * const provider = new AllSetProvider({ configPath: './my-config.json' });
- *
- * // Access configuration
- * const chainConfig = provider.getChainConfig('arbitrum-sepolia');
- * const tokenConfig = provider.getTokenConfig('arbitrum-sepolia', 'USDC');
- * ```
- */
-export declare class AllSetProvider {
-    private readonly _network;
-    private readonly _config;
-    private readonly _networkConfig;
-    private readonly _crossSignUrl;
-    constructor(options?: AllSetProviderOptions);
-    /**
-     * Get the current network name.
-     */
-    get network(): 'testnet' | 'mainnet';
-    /**
-     * Get the cross-sign service URL.
-     */
-    get crossSignUrl(): string;
-    /**
-     * Get list of supported chain names.
-     */
-    get chains(): string[];
-    /**
-     * Get configuration for a specific chain.
-     */
-    getChainConfig(chain: string): ChainConfig | null;
-    /**
-     * Get token configuration for a chain.
-     * Handles testUSDC -> USDC normalization for testnet.
-     */
-    getTokenConfig(chain: string, token: string): TokenConfig | null;
-    /**
-     * Get the full network configuration.
-     */
-    getNetworkConfig(): NetworkConfig;
-    /**
-     * Get the raw config (both testnet and mainnet).
-     */
-    getRawConfig(): AllNetworksConfig;
-    /**
-     * Deposit tokens from EVM chain to Fast network.
-     *
-     * @example
-     * ```ts
-     * const result = await allset.sendToFast({
-     *   chain: 'arbitrum-sepolia',
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   from: '0xYourEvmAddress',
-     *   to: 'fast1receiveraddress',
-     *   evmClients,
-     * });
-     * ```
-     */
-    sendToFast(params: SendToFastParams): Promise<BridgeResult>;
-    /**
-     * Withdraw tokens from Fast network to EVM chain.
-     *
-     * @example
-     * ```ts
-     * const result = await allset.sendToExternal({
-     *   chain: 'base',
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   from: fastWallet.address,
-     *   to: '0xReceiverEvmAddress',
-     *   fastWallet,
-     * });
-     * ```
-     */
-    sendToExternal(params: SendToExternalParams): Promise<BridgeResult>;
-    /**
-     * Execute custom intents on an EVM chain.
-     *
-     * This is the advanced API for composing custom operations like swaps,
-     * multi-step transactions, or protocol integrations.
-     *
-     * @example
-     * ```ts
-     * import { buildTransferIntent, buildExecuteIntent } from '@fastxyz/allset-sdk';
-     *
-     * // Simple transfer
-     * const result = await allset.executeIntent({
-     *   chain: 'base',
-     *   fastWallet, // Compatible Fast wallet, e.g. FastWallet from @fastxyz/sdk
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   intents: [buildTransferIntent(USDC_ADDRESS, '0xRecipient')],
-     * });
-     *
-     * // Custom contract call
-     * const result = await allset.executeIntent({
-     *   chain: 'base',
-     *   fastWallet, // Compatible Fast wallet, e.g. FastWallet from @fastxyz/sdk
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   intents: [buildExecuteIntent(CONTRACT, calldata)],
-     *   externalAddress: CONTRACT,
-     * });
-     * ```
-     */
-    executeIntent(params: ExecuteIntentParams): Promise<BridgeResult>;
-}
-/**
- * Get the AllSet home directory (~/.allset).
- */
-export declare function getAllSetDir(): string;
-/**
- * Get the EVM keys directory (~/.allset/.evm/keys).
- */
-export declare function getEvmKeysDir(): string;
-/**
- * Ensure the AllSet directory structure exists.
- */
-export declare function ensureAllSetDirs(): void;
-/**
- * Initialize user config by writing the embedded defaults to ~/.allset/.
- * Does nothing if user config already exists.
- */
-export declare function initUserConfig(): string;
-//# sourceMappingURL=provider.d.ts.map

package/dist/node/provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/node/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAa5G,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAEhC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,qBAA0B;IAY/C;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIjD;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAehE;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,YAAY,IAAI,iBAAiB;IAIjC;;;;;;;;;;;;;;OAcG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBjE;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;CAKxE;AAMD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAevC"}

package/dist/node/provider.js

@@ -1,272 +0,0 @@
-/**
- * provider.ts — AllSetProvider for bridge configuration and operations
- *
- * Similar to FastProvider, AllSetProvider manages network configuration
- * and provides the bridge() method for bridging tokens.
- */
-import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { DEFAULT_NETWORKS_CONFIG } from '../default-config.js';
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-const ALLSET_DIR = join(process.env.HOME || process.env.USERPROFILE || '', '.allset');
-const EVM_KEYS_DIR = join(ALLSET_DIR, '.evm', 'keys');
-// ---------------------------------------------------------------------------
-// Helper Functions
-// ---------------------------------------------------------------------------
-function expandHome(path) {
-    if (path.startsWith('~/')) {
-        const home = process.env.HOME || process.env.USERPROFILE || '';
-        return path.replace('~', home);
-    }
-    return path;
-}
-function getUserConfigPath() {
-    return join(ALLSET_DIR, 'networks.json');
-}
-function loadConfig(customPath) {
-    // Priority: customPath > ~/.allset/networks.json > embedded default config
-    const paths = [
-        customPath,
-        getUserConfigPath(),
-    ].filter((p) => !!p);
-    for (const configPath of paths) {
-        const resolved = expandHome(configPath);
-        if (existsSync(resolved)) {
-            try {
-                const raw = readFileSync(resolved, 'utf-8');
-                return JSON.parse(raw);
-            }
-            catch {
-                // Continue to next path
-            }
-        }
-    }
-    return structuredClone(DEFAULT_NETWORKS_CONFIG);
-}
-// ---------------------------------------------------------------------------
-// AllSetProvider Class
-// ---------------------------------------------------------------------------
-/**
- * AllSetProvider manages AllSet bridge configuration.
- *
- * @example
- * ```ts
- * // Default testnet configuration
- * const provider = new AllSetProvider();
- *
- * // Mainnet configuration
- * const provider = new AllSetProvider({ network: 'mainnet' });
- *
- * // Custom config file
- * const provider = new AllSetProvider({ configPath: './my-config.json' });
- *
- * // Access configuration
- * const chainConfig = provider.getChainConfig('arbitrum-sepolia');
- * const tokenConfig = provider.getTokenConfig('arbitrum-sepolia', 'USDC');
- * ```
- */
-export class AllSetProvider {
-    _network;
-    _config;
-    _networkConfig;
-    _crossSignUrl;
-    constructor(options = {}) {
-        this._network = options.network ?? 'testnet';
-        this._config = loadConfig(options.configPath);
-        this._networkConfig = this._config[this._network];
-        if (!this._networkConfig) {
-            throw new Error(`Network "${this._network}" not found in config`);
-        }
-        this._crossSignUrl = options.crossSignUrl ?? this._networkConfig.crossSignUrl;
-    }
-    /**
-     * Get the current network name.
-     */
-    get network() {
-        return this._network;
-    }
-    /**
-     * Get the cross-sign service URL.
-     */
-    get crossSignUrl() {
-        return this._crossSignUrl;
-    }
-    /**
-     * Get list of supported chain names.
-     */
-    get chains() {
-        return Object.keys(this._networkConfig.chains);
-    }
-    /**
-     * Get configuration for a specific chain.
-     */
-    getChainConfig(chain) {
-        return this._networkConfig.chains[chain] ?? null;
-    }
-    /**
-     * Get token configuration for a chain.
-     * Handles testUSDC -> USDC normalization for testnet.
-     */
-    getTokenConfig(chain, token) {
-        const chainConfig = this.getChainConfig(chain);
-        if (!chainConfig)
-            return null;
-        // Normalize: testUSDC on Fast testnet maps to USDC on EVM
-        const lowerToken = token.toLowerCase();
-        const normalizedToken = lowerToken === 'fastusdc' || lowerToken === 'testusdc' ? 'USDC' : token;
-        return (chainConfig.tokens[normalizedToken] ??
-            chainConfig.tokens[normalizedToken.toUpperCase()] ??
-            null);
-    }
-    /**
-     * Get the full network configuration.
-     */
-    getNetworkConfig() {
-        return this._networkConfig;
-    }
-    /**
-     * Get the raw config (both testnet and mainnet).
-     */
-    getRawConfig() {
-        return this._config;
-    }
-    /**
-     * Deposit tokens from EVM chain to Fast network.
-     *
-     * @example
-     * ```ts
-     * const result = await allset.sendToFast({
-     *   chain: 'arbitrum-sepolia',
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   from: '0xYourEvmAddress',
-     *   to: 'fast1receiveraddress',
-     *   evmClients,
-     * });
-     * ```
-     */
-    async sendToFast(params) {
-        const normalizedToken = params.token.toLowerCase();
-        // Map USDC to the correct Fast token: USDC for mainnet, testUSDC for testnet
-        const fastToken = normalizedToken === 'usdc'
-            ? (this._network === 'mainnet' ? 'USDC' : 'testUSDC')
-            : params.token;
-        const { executeBridge } = await import('./bridge.js');
-        return executeBridge({
-            fromChain: params.chain,
-            toChain: 'fast',
-            fromToken: params.token,
-            toToken: fastToken,
-            fromDecimals: 6,
-            amount: params.amount,
-            senderAddress: params.from,
-            receiverAddress: params.to,
-            evmClients: params.evmClients,
-        }, this);
-    }
-    /**
-     * Withdraw tokens from Fast network to EVM chain.
-     *
-     * @example
-     * ```ts
-     * const result = await allset.sendToExternal({
-     *   chain: 'base',
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   from: fastWallet.address,
-     *   to: '0xReceiverEvmAddress',
-     *   fastWallet,
-     * });
-     * ```
-     */
-    async sendToExternal(params) {
-        const normalizedToken = params.token.toLowerCase();
-        const { executeBridge } = await import('./bridge.js');
-        return executeBridge({
-            fromChain: 'fast',
-            toChain: params.chain,
-            fromToken: params.token,
-            toToken: normalizedToken === 'fastusdc' || normalizedToken === 'testusdc' ? 'USDC' : params.token,
-            fromDecimals: 6,
-            amount: params.amount,
-            senderAddress: params.from,
-            receiverAddress: params.to,
-            fastWallet: params.fastWallet,
-        }, this);
-    }
-    /**
-     * Execute custom intents on an EVM chain.
-     *
-     * This is the advanced API for composing custom operations like swaps,
-     * multi-step transactions, or protocol integrations.
-     *
-     * @example
-     * ```ts
-     * import { buildTransferIntent, buildExecuteIntent } from '@fastxyz/allset-sdk';
-     *
-     * // Simple transfer
-     * const result = await allset.executeIntent({
-     *   chain: 'base',
-     *   fastWallet, // Compatible Fast wallet, e.g. FastWallet from @fastxyz/sdk
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   intents: [buildTransferIntent(USDC_ADDRESS, '0xRecipient')],
-     * });
-     *
-     * // Custom contract call
-     * const result = await allset.executeIntent({
-     *   chain: 'base',
-     *   fastWallet, // Compatible Fast wallet, e.g. FastWallet from @fastxyz/sdk
-     *   token: 'USDC',
-     *   amount: '1000000',
-     *   intents: [buildExecuteIntent(CONTRACT, calldata)],
-     *   externalAddress: CONTRACT,
-     * });
-     * ```
-     */
-    async executeIntent(params) {
-        const { executeIntent: execIntent } = await import('./bridge.js');
-        return execIntent(params, this);
-    }
-}
-// ---------------------------------------------------------------------------
-// Directory Utilities
-// ---------------------------------------------------------------------------
-/**
- * Get the AllSet home directory (~/.allset).
- */
-export function getAllSetDir() {
-    return ALLSET_DIR;
-}
-/**
- * Get the EVM keys directory (~/.allset/.evm/keys).
- */
-export function getEvmKeysDir() {
-    return EVM_KEYS_DIR;
-}
-/**
- * Ensure the AllSet directory structure exists.
- */
-export function ensureAllSetDirs() {
-    if (!existsSync(ALLSET_DIR)) {
-        mkdirSync(ALLSET_DIR, { recursive: true, mode: 0o700 });
-    }
-    if (!existsSync(EVM_KEYS_DIR)) {
-        mkdirSync(EVM_KEYS_DIR, { recursive: true, mode: 0o700 });
-    }
-}
-/**
- * Initialize user config by writing the embedded defaults to ~/.allset/.
- * Does nothing if user config already exists.
- */
-export function initUserConfig() {
-    ensureAllSetDirs();
-    const userConfigPath = getUserConfigPath();
-    if (existsSync(userConfigPath)) {
-        return userConfigPath;
-    }
-    writeFileSync(userConfigPath, `${JSON.stringify(DEFAULT_NETWORKS_CONFIG, null, 2)}\n`, { mode: 0o600 });
-    return userConfigPath;
-}