@sequence0/sdk 1.1.2 → 2.0.0

package/dist/chains/hedera.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Hedera Chain Adapter
+ *
+ * Hedera supports a fully EVM-compatible JSON-RPC relay (Hashio),
+ * so this adapter is a thin wrapper around ethers.js pointed at
+ * Hedera's relay endpoint. Builds EIP-1559 transactions, attaches
+ * secp256k1 ECDSA signatures from the FROST threshold signing
+ * network, and broadcasts via the Hedera JSON-RPC relay.
+ *
+ * Curve: secp256k1 (ECDSA)
+ * Native token: HBAR (1 HBAR = 1e8 tinybars, 1e18 weibars via EVM relay)
+ *
+ * Hedera EVM relay uses standard 18-decimal wei denomination
+ * (like Ethereum), even though native HBAR uses 8-decimal tinybars.
+ * All values passed to buildTransaction should be in weibars (1e18).
+ *
+ * No external dependencies beyond ethers.js (already a core SDK dep).
+ */
+import { ChainAdapter, HederaTransaction } from '../core/types';
+export declare class HederaAdapter implements ChainAdapter {
+    private provider;
+    private network;
+    private chainId;
+    private mirrorUrl;
+    constructor(network?: 'mainnet' | 'testnet', apiUrl?: string);
+    getRpcUrl(): string;
+    /**
+     * Build an unsigned EVM transaction for the Hedera JSON-RPC relay.
+     *
+     * The Hedera EVM relay is fully EIP-1559 compatible. Values are in
+     * weibars (1e18 per HBAR), consistent with standard EVM tooling.
+     *
+     * If a HederaTransaction is passed (with amount in tinybars), it is
+     * automatically converted to weibars for the EVM relay.
+     *
+     * @returns hex-encoded unsigned serialized transaction (RLP)
+     */
+    buildTransaction(tx: HederaTransaction, fromAddress: string): Promise<string>;
+    /**
+     * Attach a secp256k1 ECDSA signature to the unsigned transaction.
+     *
+     * Expects a 65-byte signature: r (32) || s (32) || v (1).
+     * Same format as Ethereum — the Hedera EVM relay accepts
+     * standard signed EVM transactions.
+     */
+    attachSignature(unsignedTx: string, signature: string): Promise<string>;
+    /**
+     * Broadcast a signed transaction via the Hedera JSON-RPC relay.
+     *
+     * The relay forwards the EVM transaction to the Hedera network
+     * where it is executed as a native HBAR transfer or contract call.
+     *
+     * @returns transaction hash
+     */
+    broadcast(signedTx: string): Promise<string>;
+    /**
+     * Get HBAR balance via the EVM relay.
+     *
+     * Returns balance in weibars (1e18 per HBAR), consistent with
+     * the EVM relay denomination. Divide by 1e18 for HBAR.
+     */
+    getBalance(address: string): Promise<string>;
+    /**
+     * Get HBAR balance in tinybars via the Mirror Node REST API.
+     *
+     * This uses the native Hedera denomination (1 HBAR = 1e8 tinybars)
+     * for applications that need the native format.
+     */
+    getBalanceTinybars(accountId: string): Promise<string>;
+    /**
+     * Resolve a Hedera account ID (0.0.XXXXX) to an EVM address.
+     *
+     * If the input is already a 0x-prefixed EVM address, returns it as-is.
+     * Otherwise queries the Mirror Node to look up the EVM address.
+     */
+    resolveAddress(address: string): Promise<string>;
+    /**
+     * Convert a Hedera account ID (0.0.XXXXX) to a "long-zero" EVM address.
+     *
+     * For accounts without an explicit EVM alias, Hedera maps account IDs
+     * to EVM addresses by zero-padding the account number into 20 bytes.
+     * e.g. 0.0.12345 -> 0x0000000000000000000000000000000000003039
+     *
+     * For accounts with an EVM alias, queries the Mirror Node.
+     */
+    private accountIdToEvmAddress;
+    /**
+     * Look up account info from the Mirror Node REST API.
+     */
+    getAccountInfo(accountId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Get transaction details from the Mirror Node REST API.
+     */
+    getTransactionInfo(txId: string): Promise<Record<string, unknown> | null>;
+    /** Estimate gas for a transaction */
+    estimateGas(tx: HederaTransaction, fromAddress: string): Promise<bigint>;
+    /** Get current gas price from the relay */
+    getGasPrice(): Promise<{
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }>;
+    /** Get current block number from the relay */
+    getBlockNumber(): Promise<number>;
+    /** Get transaction receipt from the relay */
+    getTransactionReceipt(hash: string): Promise<any>;
+    /** Wait for transaction confirmation */
+    waitForTransaction(hash: string, confirmations?: number): Promise<any>;
+}
+/** Create a mainnet Hedera adapter */
+export declare function createHederaAdapter(apiUrl?: string): HederaAdapter;
+/** Create a testnet Hedera adapter */
+export declare function createHederaTestnetAdapter(apiUrl?: string): HederaAdapter;
+//# sourceMappingURL=hedera.d.ts.map

package/dist/chains/hedera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hedera.d.ts","sourceRoot":"","sources":["../../src/chains/hedera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAqBhE,qBAAa,aAAc,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE,SAAS,GAAG,SAAqB,EAAE,MAAM,CAAC,EAAE,MAAM;IAQvE,SAAS,IAAI,MAAM;IAKnB;;;;;;;;;;OAUG;IACG,gBAAgB,CAAC,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkDnF;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB7E;;;;;;;OAOG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYlD;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB5D;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAetD;;;;;;;;OAQG;YACW,qBAAqB;IAqBnC;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAWhF;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAW/E,qCAAqC;IAC/B,WAAW,CAAC,EAAE,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa9E,2CAA2C;IACrC,WAAW,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC;IAQpF,8CAA8C;IACxC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC,6CAA6C;IACvC,qBAAqB,CAAC,IAAI,EAAE,MAAM;IAIxC,wCAAwC;IAClC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,SAAI;CAG3D;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAElE;AAED,sCAAsC;AACtC,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAEzE"}

package/dist/chains/hedera.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * Hedera Chain Adapter
+ *
+ * Hedera supports a fully EVM-compatible JSON-RPC relay (Hashio),
+ * so this adapter is a thin wrapper around ethers.js pointed at
+ * Hedera's relay endpoint. Builds EIP-1559 transactions, attaches
+ * secp256k1 ECDSA signatures from the FROST threshold signing
+ * network, and broadcasts via the Hedera JSON-RPC relay.
+ *
+ * Curve: secp256k1 (ECDSA)
+ * Native token: HBAR (1 HBAR = 1e8 tinybars, 1e18 weibars via EVM relay)
+ *
+ * Hedera EVM relay uses standard 18-decimal wei denomination
+ * (like Ethereum), even though native HBAR uses 8-decimal tinybars.
+ * All values passed to buildTransaction should be in weibars (1e18).
+ *
+ * No external dependencies beyond ethers.js (already a core SDK dep).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HederaAdapter = void 0;
+exports.createHederaAdapter = createHederaAdapter;
+exports.createHederaTestnetAdapter = createHederaTestnetAdapter;
+const ethers_1 = require("ethers");
+const errors_1 = require("../utils/errors");
+/** EVM relay endpoints */
+const DEFAULT_EVM_RELAYS = {
+    mainnet: 'https://mainnet.hashio.io/api',
+    testnet: 'https://testnet.hashio.io/api',
+};
+/** Mirror node REST API endpoints (used for Hedera-native queries) */
+const DEFAULT_MIRROR_URLS = {
+    mainnet: 'https://mainnet-public.mirrornode.hedera.com',
+    testnet: 'https://testnet.mirrornode.hedera.com',
+};
+/** Hedera EVM chain IDs */
+const CHAIN_IDS = {
+    mainnet: 295,
+    testnet: 296,
+};
+class HederaAdapter {
+    constructor(network = 'mainnet', apiUrl) {
+        this.network = network;
+        this.chainId = CHAIN_IDS[network];
+        this.mirrorUrl = DEFAULT_MIRROR_URLS[network];
+        const relayUrl = apiUrl || DEFAULT_EVM_RELAYS[network];
+        this.provider = new ethers_1.JsonRpcProvider(relayUrl);
+    }
+    getRpcUrl() {
+        // @ts-ignore - accessing internal URL
+        return this.provider._getConnection?.().url || DEFAULT_EVM_RELAYS[this.network];
+    }
+    /**
+     * Build an unsigned EVM transaction for the Hedera JSON-RPC relay.
+     *
+     * The Hedera EVM relay is fully EIP-1559 compatible. Values are in
+     * weibars (1e18 per HBAR), consistent with standard EVM tooling.
+     *
+     * If a HederaTransaction is passed (with amount in tinybars), it is
+     * automatically converted to weibars for the EVM relay.
+     *
+     * @returns hex-encoded unsigned serialized transaction (RLP)
+     */
+    async buildTransaction(tx, fromAddress) {
+        try {
+            // Convert Hedera account ID to EVM address if needed
+            const toAddress = await this.resolveAddress(tx.to);
+            const fromAddr = await this.resolveAddress(fromAddress);
+            // Convert tinybars to weibars: 1 HBAR = 1e8 tinybars = 1e18 weibars
+            // So 1 tinybar = 1e10 weibars
+            const amountTinybars = BigInt(tx.amount);
+            const amountWeibars = amountTinybars * 10000000000n;
+            // Auto-fill nonce
+            const nonce = await this.provider.getTransactionCount(fromAddr, 'latest');
+            // Fetch fee data from the relay
+            const feeData = await this.provider.getFeeData();
+            // Estimate gas (simple transfer default: 80000 for Hedera)
+            const gasLimit = await this.provider.estimateGas({
+                from: fromAddr,
+                to: toAddress,
+                value: amountWeibars,
+                data: tx.memo ? ('0x' + Buffer.from(tx.memo).toString('hex')) : '0x',
+            }).catch(() => 80000n);
+            // Build EIP-1559 transaction
+            const txObj = {
+                to: toAddress,
+                value: amountWeibars,
+                data: tx.memo ? ('0x' + Buffer.from(tx.memo).toString('hex')) : '0x',
+                nonce,
+                gasLimit,
+                chainId: this.chainId,
+                type: 2,
+                maxFeePerGas: feeData.maxFeePerGas || 300000000000n,
+                maxPriorityFeePerGas: feeData.maxPriorityFeePerGas || 2000000000n,
+            };
+            // Serialize unsigned TX
+            const unsignedTx = ethers_1.Transaction.from(txObj);
+            return unsignedTx.unsignedSerialized;
+        }
+        catch (e) {
+            if (e instanceof errors_1.ChainError)
+                throw e;
+            throw new errors_1.ChainError(`Failed to build Hedera transaction: ${e.message}`, 'hedera');
+        }
+    }
+    /**
+     * Attach a secp256k1 ECDSA signature to the unsigned transaction.
+     *
+     * Expects a 65-byte signature: r (32) || s (32) || v (1).
+     * Same format as Ethereum — the Hedera EVM relay accepts
+     * standard signed EVM transactions.
+     */
+    async attachSignature(unsignedTx, signature) {
+        try {
+            const sig = signature.startsWith('0x') ? signature.slice(2) : signature;
+            const r = '0x' + sig.slice(0, 64);
+            const s = '0x' + sig.slice(64, 128);
+            const v = parseInt(sig.slice(128, 130), 16) || 27;
+            const tx = ethers_1.Transaction.from(unsignedTx);
+            tx.signature = ethers_1.Signature.from({ r, s, v });
+            return tx.serialized;
+        }
+        catch (e) {
+            throw new errors_1.ChainError(`Failed to attach Hedera signature: ${e.message}`, 'hedera');
+        }
+    }
+    /**
+     * Broadcast a signed transaction via the Hedera JSON-RPC relay.
+     *
+     * The relay forwards the EVM transaction to the Hedera network
+     * where it is executed as a native HBAR transfer or contract call.
+     *
+     * @returns transaction hash
+     */
+    async broadcast(signedTx) {
+        try {
+            const response = await this.provider.broadcastTransaction(signedTx);
+            return response.hash;
+        }
+        catch (e) {
+            throw new errors_1.ChainError(`Failed to broadcast Hedera tx: ${e.message}`, 'hedera');
+        }
+    }
+    /**
+     * Get HBAR balance via the EVM relay.
+     *
+     * Returns balance in weibars (1e18 per HBAR), consistent with
+     * the EVM relay denomination. Divide by 1e18 for HBAR.
+     */
+    async getBalance(address) {
+        try {
+            const addr = await this.resolveAddress(address);
+            const balance = await this.provider.getBalance(addr);
+            return balance.toString();
+        }
+        catch {
+            return '0';
+        }
+    }
+    /**
+     * Get HBAR balance in tinybars via the Mirror Node REST API.
+     *
+     * This uses the native Hedera denomination (1 HBAR = 1e8 tinybars)
+     * for applications that need the native format.
+     */
+    async getBalanceTinybars(accountId) {
+        try {
+            const url = `${this.mirrorUrl}/api/v1/balances?account.id=${accountId}`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`Mirror node returned ${response.status}`);
+            }
+            const data = await response.json();
+            if (data.balances && data.balances.length > 0) {
+                return data.balances[0].balance.toString();
+            }
+            return '0';
+        }
+        catch {
+            return '0';
+        }
+    }
+    /**
+     * Resolve a Hedera account ID (0.0.XXXXX) to an EVM address.
+     *
+     * If the input is already a 0x-prefixed EVM address, returns it as-is.
+     * Otherwise queries the Mirror Node to look up the EVM address.
+     */
+    async resolveAddress(address) {
+        // Already an EVM address
+        if (address.startsWith('0x') && address.length === 42) {
+            return address;
+        }
+        // Hedera account ID format: 0.0.XXXXX
+        if (/^\d+\.\d+\.\d+$/.test(address)) {
+            return this.accountIdToEvmAddress(address);
+        }
+        // Return as-is and let the relay handle it
+        return address;
+    }
+    /**
+     * Convert a Hedera account ID (0.0.XXXXX) to a "long-zero" EVM address.
+     *
+     * For accounts without an explicit EVM alias, Hedera maps account IDs
+     * to EVM addresses by zero-padding the account number into 20 bytes.
+     * e.g. 0.0.12345 -> 0x0000000000000000000000000000000000003039
+     *
+     * For accounts with an EVM alias, queries the Mirror Node.
+     */
+    async accountIdToEvmAddress(accountId) {
+        try {
+            // Try Mirror Node first to get the real EVM address
+            const url = `${this.mirrorUrl}/api/v1/accounts/${accountId}`;
+            const response = await fetch(url);
+            if (response.ok) {
+                const data = await response.json();
+                if (data.evm_address) {
+                    return data.evm_address;
+                }
+            }
+        }
+        catch {
+            // Fall through to long-zero conversion
+        }
+        // Long-zero address fallback: pad the account number
+        const parts = accountId.split('.');
+        const accountNum = parseInt(parts[2], 10);
+        return '0x' + accountNum.toString(16).padStart(40, '0');
+    }
+    /**
+     * Look up account info from the Mirror Node REST API.
+     */
+    async getAccountInfo(accountId) {
+        try {
+            const url = `${this.mirrorUrl}/api/v1/accounts/${accountId}`;
+            const response = await fetch(url);
+            if (!response.ok)
+                return null;
+            return await response.json();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get transaction details from the Mirror Node REST API.
+     */
+    async getTransactionInfo(txId) {
+        try {
+            const url = `${this.mirrorUrl}/api/v1/transactions/${txId}`;
+            const response = await fetch(url);
+            if (!response.ok)
+                return null;
+            return await response.json();
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Estimate gas for a transaction */
+    async estimateGas(tx, fromAddress) {
+        const fromAddr = await this.resolveAddress(fromAddress);
+        const toAddr = await this.resolveAddress(tx.to);
+        const amountWeibars = BigInt(tx.amount) * 10000000000n;
+        return this.provider.estimateGas({
+            from: fromAddr,
+            to: toAddr,
+            value: amountWeibars,
+            data: tx.memo ? ('0x' + Buffer.from(tx.memo).toString('hex')) : '0x',
+        });
+    }
+    /** Get current gas price from the relay */
+    async getGasPrice() {
+        const feeData = await this.provider.getFeeData();
+        return {
+            maxFeePerGas: feeData.maxFeePerGas || 300000000000n,
+            maxPriorityFeePerGas: feeData.maxPriorityFeePerGas || 2000000000n,
+        };
+    }
+    /** Get current block number from the relay */
+    async getBlockNumber() {
+        return this.provider.getBlockNumber();
+    }
+    /** Get transaction receipt from the relay */
+    async getTransactionReceipt(hash) {
+        return this.provider.getTransactionReceipt(hash);
+    }
+    /** Wait for transaction confirmation */
+    async waitForTransaction(hash, confirmations = 1) {
+        return this.provider.waitForTransaction(hash, confirmations);
+    }
+}
+exports.HederaAdapter = HederaAdapter;
+/** Create a mainnet Hedera adapter */
+function createHederaAdapter(apiUrl) {
+    return new HederaAdapter('mainnet', apiUrl);
+}
+/** Create a testnet Hedera adapter */
+function createHederaTestnetAdapter(apiUrl) {
+    return new HederaAdapter('testnet', apiUrl);
+}
+//# sourceMappingURL=hedera.js.map

package/dist/chains/hedera.js.map

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

package/dist/chains/icp.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Internet Computer (ICP) Chain Adapter
+ *
+ * Builds ICP ledger transfer requests, computes the signing payload
+ * as SHA-256 of the request envelope, attaches secp256k1 ECDSA
+ * signatures from the FROST threshold signing network, and
+ * broadcasts via the IC HTTP API.
+ *
+ * Curve: secp256k1 (ECDSA)
+ * Native token: ICP (1 ICP = 1e8 e8s)
+ * API: IC HTTP API at https://ic0.app
+ *
+ * No external dependencies — uses raw HTTP calls and built-in crypto.
+ *
+ * The ICP transaction model is canister-call based. A transfer is a
+ * call to the ICP ledger canister (ryjl3-tyaaa-aaaaa-aaaba-cai) with
+ * the "transfer" method. The signing payload is the SHA-256 hash of
+ * the CBOR-encoded request ID derived from the request content map.
+ */
+import { ChainAdapter, IcpTransaction } from '../core/types';
+export declare class IcpAdapter implements ChainAdapter {
+    private apiUrl;
+    private network;
+    constructor(network?: 'mainnet' | 'local', apiUrl?: string);
+    getRpcUrl(): string;
+    /**
+     * Build an unsigned ICP ledger transfer request.
+     *
+     * Constructs the transfer call content map, computes the request ID
+     * (signing payload), and returns the hex-encoded payload containing
+     * all information needed for signing and broadcast.
+     *
+     * The signing payload is: SHA-256(domain_separator || request_id)
+     * where domain_separator = "\x0Aic-request"
+     *
+     * @param tx - ICP transfer details (to, amount in e8s, optional memo/fee)
+     * @param fromAddress - Sender's principal or account ID (hex)
+     * @returns hex-encoded JSON payload with signingHash and request data
+     */
+    buildTransaction(tx: IcpTransaction, fromAddress: string): Promise<string>;
+    /**
+     * Extract the signing payload (SHA-256 hash) from the build output.
+     *
+     * The signing payload is the SHA-256 of (domain_separator || request_id).
+     * This is the 32-byte hash that the FROST network signs with secp256k1.
+     */
+    getSigningPayload(unsignedTx: string): string;
+    /**
+     * Attach a secp256k1 ECDSA signature to the ICP request envelope.
+     *
+     * The IC expects the signature in DER-encoded format within a
+     * CBOR envelope. We store the 65-byte raw signature (r||s||v)
+     * and convert during broadcast.
+     */
+    attachSignature(unsignedTx: string, signature: string): Promise<string>;
+    /**
+     * Broadcast a signed ICP transaction via the IC HTTP API.
+     *
+     * Submits the signed request envelope to:
+     * POST /api/v2/canister/{canister_id}/call
+     *
+     * The IC returns a 202 Accepted on success with the request ID
+     * that can be polled for status.
+     *
+     * @returns request ID (hex) which serves as the transaction identifier
+     */
+    broadcast(signedTx: string): Promise<string>;
+    /**
+     * Get ICP balance in e8s (1 ICP = 1e8 e8s).
+     *
+     * Queries the ledger canister using the read_state/query endpoint
+     * with the "icrc1_balance_of" method.
+     *
+     * @param address - Principal ID or account ID (hex)
+     * @returns balance in e8s as string
+     */
+    getBalance(address: string): Promise<string>;
+    /**
+     * Check the status of a submitted request.
+     *
+     * After broadcast, callers can poll this method with the request ID
+     * to check whether the transfer was accepted by the ledger canister.
+     *
+     * @param requestId - hex-encoded request ID from broadcast()
+     * @returns status string: 'received', 'processing', 'replied', 'rejected', 'done', or 'unknown'
+     */
+    getRequestStatus(requestId: string): Promise<string>;
+    /**
+     * Get the ICP ledger canister ID.
+     */
+    getLedgerCanisterId(): string;
+}
+/** Create a mainnet ICP adapter */
+export declare function createIcpAdapter(apiUrl?: string): IcpAdapter;
+//# sourceMappingURL=icp.d.ts.map

package/dist/chains/icp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icp.d.ts","sourceRoot":"","sources":["../../src/chains/icp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAgJ7D,qBAAa,UAAW,YAAW,YAAY;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,SAAS,GAAG,OAAmB,EAAE,MAAM,CAAC,EAAE,MAAM;IAKrE,SAAS,IAAI,MAAM;IAInB;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoEhF;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAS7C;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB7E;;;;;;;;;;OAUG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+DlD;;;;;;;;OAQG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2DlD;;;;;;;;OAQG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmD1D;;OAEG;IACH,mBAAmB,IAAI,MAAM;CAGhC;AA0FD,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAE5D"}