@fastxyz/allset-sdk 0.1.0 → 0.1.2

package/dist/intents.js

@@ -0,0 +1,128 @@
+/**
+ * intents.ts — Intent builders for AllSet external execution
+ *
+ * Intents define what actions to perform on EVM chains after
+ * transferring tokens from Fast network.
+ */
+import { encodeAbiParameters } from 'viem';
+import { bech32m } from 'bech32';
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+/**
+ * Intent action types supported by AllSet bridge.
+ */
+export var IntentAction;
+(function (IntentAction) {
+    /** Generic contract call */
+    IntentAction[IntentAction["Execute"] = 0] = "Execute";
+    /** ERC-20 transfer to address */
+    IntentAction[IntentAction["DynamicTransfer"] = 1] = "DynamicTransfer";
+    /** Deposit tokens back to Fast network */
+    IntentAction[IntentAction["DynamicDeposit"] = 2] = "DynamicDeposit";
+    /** Cancel/revoke pending intent */
+    IntentAction[IntentAction["Revoke"] = 3] = "Revoke";
+})(IntentAction || (IntentAction = {}));
+// ---------------------------------------------------------------------------
+// Helper Functions
+// ---------------------------------------------------------------------------
+function fastAddressToBytes32(address) {
+    const { words } = bech32m.decode(address, 90);
+    const bytes = new Uint8Array(bech32m.fromWords(words));
+    return `0x${Buffer.from(bytes).toString('hex')}`;
+}
+// ---------------------------------------------------------------------------
+// Intent Builders
+// ---------------------------------------------------------------------------
+/**
+ * Build a transfer intent to send ERC-20 tokens to an address.
+ *
+ * @param token - ERC-20 token contract address
+ * @param receiver - Recipient EVM address
+ * @returns Intent for DynamicTransfer action
+ *
+ * @example
+ * ```ts
+ * const intent = buildTransferIntent(
+ *   '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d', // USDC
+ *   '0xRecipientAddress'
+ * );
+ * ```
+ */
+export function buildTransferIntent(token, receiver) {
+    const payload = encodeAbiParameters([{ type: 'address' }, { type: 'address' }], [token, receiver]);
+    return {
+        action: IntentAction.DynamicTransfer,
+        payload,
+        value: 0n,
+    };
+}
+/**
+ * Build a generic execute intent for arbitrary contract calls.
+ *
+ * @param target - Target contract address
+ * @param calldata - ABI-encoded function call data
+ * @param value - Native token value to send (default: 0)
+ * @returns Intent for Execute action
+ *
+ * @example
+ * ```ts
+ * // Call a contract function
+ * const calldata = encodeFunctionData({
+ *   abi: contractAbi,
+ *   functionName: 'someFunction',
+ *   args: [arg1, arg2],
+ * });
+ * const intent = buildExecuteIntent('0xContractAddress', calldata);
+ * ```
+ */
+export function buildExecuteIntent(target, calldata, value = 0n) {
+    const payload = encodeAbiParameters([{ type: 'address' }, { type: 'bytes' }], [target, calldata]);
+    return {
+        action: IntentAction.Execute,
+        payload,
+        value,
+    };
+}
+/**
+ * Build an intent to deposit tokens back to Fast network.
+ *
+ * @param token - ERC-20 token contract address on EVM
+ * @param fastReceiver - Fast network recipient address (fast1...)
+ * @returns Intent for DynamicDeposit action
+ *
+ * @example
+ * ```ts
+ * const intent = buildDepositBackIntent(
+ *   '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d', // USDC
+ *   'fast1recipientaddress...'
+ * );
+ * ```
+ */
+export function buildDepositBackIntent(token, fastReceiver) {
+    const receiverBytes = fastAddressToBytes32(fastReceiver);
+    const payload = encodeAbiParameters([{ type: 'address' }, { type: 'bytes32' }], [token, receiverBytes]);
+    return {
+        action: IntentAction.DynamicDeposit,
+        payload,
+        value: 0n,
+    };
+}
+/**
+ * Build a revoke intent to cancel pending operations.
+ *
+ * @returns Intent for Revoke action
+ *
+ * @example
+ * ```ts
+ * const intent = buildRevokeIntent();
+ * ```
+ */
+export function buildRevokeIntent() {
+    return {
+        action: IntentAction.Revoke,
+        payload: '0x',
+        value: 0n,
+    };
+}
+//# sourceMappingURL=intents.js.map

package/dist/intents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intents.js","sourceRoot":"","sources":["../src/intents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,4BAA4B;IAC5B,qDAAW,CAAA;IACX,iCAAiC;IACjC,qEAAmB,CAAA;IACnB,0CAA0C;IAC1C,mEAAkB,CAAA;IAClB,mCAAmC;IACnC,mDAAU,CAAA;AACZ,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB;AAcD,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,oBAAoB,CAAC,OAAe;IAC3C,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAmB,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,QAAgB;IACjE,MAAM,OAAO,GAAG,mBAAmB,CACjC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC1C,CAAC,KAAsB,EAAE,QAAyB,CAAC,CACpD,CAAC;IACF,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,eAAe;QACpC,OAAO;QACP,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,QAAgB,EAChB,QAAgB,EAAE;IAElB,MAAM,OAAO,GAAG,mBAAmB,CACjC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EACxC,CAAC,MAAuB,EAAE,QAAyB,CAAC,CACrD,CAAC;IACF,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,OAAO;QAC5B,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,YAAoB;IAEpB,MAAM,aAAa,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,mBAAmB,CACjC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC1C,CAAC,KAAsB,EAAE,aAAa,CAAC,CACxC,CAAC;IACF,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,cAAc;QACnC,OAAO;QACP,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,162 @@
+/**
+ * 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. Bundled data/networks.json (package default)
+     */
+    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');
+ * const tokenConfig = provider.getTokenConfig('arbitrum', '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 fastUSDC -> USDC normalization.
+     */
+    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',
+     *   token: 'USDC',
+     *   amount: '1000000',
+     *   from: '0xYourEvmAddress',
+     *   to: 'fast1receiveraddress',
+     *   evmExecutor,
+     * });
+     * ```
+     */
+    sendToFast(params: SendToFastParams): Promise<BridgeResult>;
+    /**
+     * Withdraw tokens from Fast network to EVM chain.
+     *
+     * @example
+     * ```ts
+     * const result = await allset.sendToExternal({
+     *   chain: 'arbitrum',
+     *   token: 'fastUSDC',
+     *   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: 'arbitrum',
+     *   fastWallet,
+     *   token: 'fastUSDC',
+     *   amount: '1000000',
+     *   intents: [buildTransferIntent(USDC_ADDRESS, '0xRecipient')],
+     * });
+     *
+     * // Custom contract call
+     * const result = await allset.executeIntent({
+     *   chain: 'arbitrum',
+     *   fastWallet,
+     *   token: 'fastUSDC',
+     *   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 copying bundled networks.json to ~/.allset/.
+ * Does nothing if user config already exists.
+ */
+export declare function initUserConfig(): string;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/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;AAqDD;;;;;;;;;;;;;;;;;;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;IAchE;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,YAAY,IAAI,iBAAiB;IAIjC;;;;;;;;;;;;;;OAcG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAejE;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAezE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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/provider.js

@@ -0,0 +1,276 @@
+/**
+ * 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 { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ---------------------------------------------------------------------------
+// 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 getPackageDataDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return join(__dirname, '..', 'data');
+}
+function getUserConfigPath() {
+    return join(ALLSET_DIR, 'networks.json');
+}
+function loadConfig(customPath) {
+    // Priority: customPath > ~/.allset/networks.json > bundled data/networks.json
+    const paths = [
+        customPath,
+        getUserConfigPath(),
+        join(getPackageDataDir(), 'networks.json'),
+    ].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
+            }
+        }
+    }
+    throw new Error('Failed to load AllSet networks config. Ensure data/networks.json exists in the package.');
+}
+// ---------------------------------------------------------------------------
+// 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');
+ * const tokenConfig = provider.getTokenConfig('arbitrum', '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 fastUSDC -> USDC normalization.
+     */
+    getTokenConfig(chain, token) {
+        const chainConfig = this.getChainConfig(chain);
+        if (!chainConfig)
+            return null;
+        // Normalize: fastUSDC on Fast maps to USDC on EVM
+        const normalizedToken = token.toLowerCase() === 'fastusdc' ? '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',
+     *   token: 'USDC',
+     *   amount: '1000000',
+     *   from: '0xYourEvmAddress',
+     *   to: 'fast1receiveraddress',
+     *   evmExecutor,
+     * });
+     * ```
+     */
+    async sendToFast(params) {
+        const { executeBridge } = await import('./bridge.js');
+        return executeBridge({
+            fromChain: params.chain,
+            toChain: 'fast',
+            fromToken: params.token,
+            toToken: params.token === 'USDC' ? 'fastUSDC' : params.token,
+            fromDecimals: 6,
+            amount: params.amount,
+            senderAddress: params.from,
+            receiverAddress: params.to,
+            evmExecutor: params.evmExecutor,
+        }, this);
+    }
+    /**
+     * Withdraw tokens from Fast network to EVM chain.
+     *
+     * @example
+     * ```ts
+     * const result = await allset.sendToExternal({
+     *   chain: 'arbitrum',
+     *   token: 'fastUSDC',
+     *   amount: '1000000',
+     *   from: fastWallet.address,
+     *   to: '0xReceiverEvmAddress',
+     *   fastWallet,
+     * });
+     * ```
+     */
+    async sendToExternal(params) {
+        const { executeBridge } = await import('./bridge.js');
+        return executeBridge({
+            fromChain: 'fast',
+            toChain: params.chain,
+            fromToken: params.token,
+            toToken: params.token === 'fastUSDC' ? '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: 'arbitrum',
+     *   fastWallet,
+     *   token: 'fastUSDC',
+     *   amount: '1000000',
+     *   intents: [buildTransferIntent(USDC_ADDRESS, '0xRecipient')],
+     * });
+     *
+     * // Custom contract call
+     * const result = await allset.executeIntent({
+     *   chain: 'arbitrum',
+     *   fastWallet,
+     *   token: 'fastUSDC',
+     *   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 copying bundled networks.json to ~/.allset/.
+ * Does nothing if user config already exists.
+ */
+export function initUserConfig() {
+    ensureAllSetDirs();
+    const userConfigPath = getUserConfigPath();
+    if (existsSync(userConfigPath)) {
+        return userConfigPath;
+    }
+    const bundledPath = join(getPackageDataDir(), 'networks.json');
+    if (existsSync(bundledPath)) {
+        const content = readFileSync(bundledPath, 'utf-8');
+        writeFileSync(userConfigPath, content, { mode: 0o600 });
+    }
+    return userConfigPath;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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