@hyperbridge/sdk 1.0.0

package/dist/chains/evm.d.ts

@@ -0,0 +1,86 @@
+import { IChain, IIsmpMessage } from "../chain";
+import { HexString } from "../types";
+/**
+ * The default address used as fallback when no address is provided.
+ * This represents the zero address in EVM chains.
+ */
+export declare const DEFAULT_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Parameters for an EVM chain.
+ */
+export interface EvmChainParams {
+    /**
+     * The chain ID of the EVM chain.
+     */
+    chainId: number;
+    /**
+     * The host address of the EVM chain.
+     */
+    host: HexString;
+    /**
+     * The URL of the EVM chain.
+     */
+    url: string;
+}
+/**
+ * Encapsulates an EVM chain.
+ */
+export declare class EvmChain implements IChain {
+    private readonly params;
+    private publicClient;
+    constructor(params: EvmChainParams);
+    /**
+     * Derives the key for the request receipt.
+     * @param {HexString} commitment - The commitment to derive the key from.
+     * @returns {HexString} The derived key.
+     */
+    requestReceiptKey(commitment: HexString): HexString;
+    /**
+     * Queries the request receipt.
+     * @param {HexString} commitment - The commitment to query.
+     * @returns {Promise<HexString | undefined>} The relayer address responsible for delivering the request.
+     */
+    queryRequestReceipt(commitment: HexString): Promise<HexString | undefined>;
+    /**
+     * Queries the proof of the requests.
+     * @param {HexString[]} requests - The requests to query.
+     * @param {string} counterparty - The counterparty address.
+     * @param {bigint} [at] - The block number to query at.
+     * @returns {Promise<HexString>} The proof.
+     */
+    queryRequestsProof(requests: HexString[], counterparty: string, at?: bigint): Promise<HexString>;
+    /**
+     * Query and return the encoded storage proof for the provided keys at the given height.
+     * @param {bigint} at - The block height at which to query the storage proof.
+     * @param {HexString[]} keys - The keys for which to query the storage proof.
+     * @returns {Promise<HexString>} The encoded storage proof.
+     */
+    queryStateProof(at: bigint, keys: HexString[]): Promise<HexString>;
+    /**
+     * Returns the current timestamp of the chain.
+     * @returns {Promise<bigint>} The current timestamp.
+     */
+    timestamp(): Promise<bigint>;
+    /**
+     * Encodes an ISMP message for the EVM chain.
+     * @param {IIsmpMessage} message The ISMP message to encode.
+     * @returns {HexString} The encoded calldata.
+     */
+    encode(message: IIsmpMessage): HexString;
+}
+/**
+ * Slot for storing request commitments.
+ */
+export declare const REQUEST_COMMITMENTS_SLOT = 0n;
+/**
+ * Slot index for response commitments map
+ */
+export declare const RESPONSE_COMMITMENTS_SLOT = 1n;
+/**
+ * Slot index for requests receipts map
+ */
+export declare const REQUEST_RECEIPTS_SLOT = 2n;
+/**
+ * Slot index for response receipts map
+ */
+export declare const RESPONSE_RECEIPTS_SLOT = 3n;

package/dist/chains/evm.js

@@ -0,0 +1,249 @@
+import { bytesToBigInt, bytesToHex, createPublicClient, encodeFunctionData, hexToBytes, http, toHex, keccak256, toBytes, pad, } from "viem";
+import { mainnet, arbitrum, arbitrumSepolia, optimism, optimismSepolia, base, baseSepolia, soneium, bsc, bscTestnet, gnosis, gnosisChiado, } from "viem/chains";
+import flatten from "lodash/flatten";
+import zip from "lodash/zip";
+import { match } from "ts-pattern";
+import EvmHost from "../abis/evmHost.js";
+import HandlerV1 from "../abis/handler.js";
+import { calculateMMRSize, EvmStateProof, mmrPositionToKIndex, MmrProof, SubstrateStateProof } from "../utils.js";
+const chains = {
+    [mainnet.id]: mainnet,
+    [arbitrum.id]: arbitrum,
+    [arbitrumSepolia.id]: arbitrumSepolia,
+    [optimism.id]: optimism,
+    [optimismSepolia.id]: optimismSepolia,
+    [base.id]: base,
+    [baseSepolia.id]: baseSepolia,
+    [soneium.id]: soneium,
+    [bsc.id]: bsc,
+    [bscTestnet.id]: bscTestnet,
+    [gnosis.id]: gnosis,
+    [gnosisChiado.id]: gnosisChiado,
+};
+/**
+ * The default address used as fallback when no address is provided.
+ * This represents the zero address in EVM chains.
+ */
+export const DEFAULT_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Encapsulates an EVM chain.
+ */
+export class EvmChain {
+    constructor(params) {
+        this.params = params;
+        // @ts-ignore
+        this.publicClient = createPublicClient({
+            // @ts-ignore
+            chain: chains[params.chainId],
+            transport: http(params.url),
+        });
+    }
+    /**
+     * Derives the key for the request receipt.
+     * @param {HexString} commitment - The commitment to derive the key from.
+     * @returns {HexString} The derived key.
+     */
+    requestReceiptKey(commitment) {
+        return deriveMapKey(hexToBytes(commitment), REQUEST_RECEIPTS_SLOT);
+    }
+    /**
+     * Queries the request receipt.
+     * @param {HexString} commitment - The commitment to query.
+     * @returns {Promise<HexString | undefined>} The relayer address responsible for delivering the request.
+     */
+    async queryRequestReceipt(commitment) {
+        const relayer = await this.publicClient.readContract({
+            address: this.params.host,
+            abi: EvmHost.ABI,
+            functionName: "requestReceipts",
+            args: [commitment],
+        });
+        // solidity returns zeroes if the storage slot is empty
+        return relayer === DEFAULT_ADDRESS ? undefined : relayer;
+    }
+    /**
+     * Queries the proof of the requests.
+     * @param {HexString[]} requests - The requests to query.
+     * @param {string} counterparty - The counterparty address.
+     * @param {bigint} [at] - The block number to query at.
+     * @returns {Promise<HexString>} The proof.
+     */
+    async queryRequestsProof(requests, counterparty, at) {
+        const self = this;
+        // for each request derive the commitment key collect into a new array
+        const commitmentKeys = requests.map(requestCommitmentKey);
+        const config = {
+            address: this.params.host,
+            storageKeys: commitmentKeys,
+        };
+        if (!at) {
+            config.blockTag = "latest";
+        }
+        else {
+            config.blockNumber = at;
+        }
+        const proof = await self.publicClient.getProof(config);
+        const flattenedProof = Array.from(new Set(flatten(proof.storageProof.map((item) => item.proof))));
+        const encoded = EvmStateProof.enc({
+            contractProof: proof.accountProof.map((item) => Array.from(hexToBytes(item))),
+            storageProof: [
+                [Array.from(hexToBytes(self.params.host)), flattenedProof.map((item) => Array.from(hexToBytes(item)))],
+            ],
+        });
+        return toHex(encoded);
+    }
+    /**
+     * Query and return the encoded storage proof for the provided keys at the given height.
+     * @param {bigint} at - The block height at which to query the storage proof.
+     * @param {HexString[]} keys - The keys for which to query the storage proof.
+     * @returns {Promise<HexString>} The encoded storage proof.
+     */
+    async queryStateProof(at, keys) {
+        const self = this;
+        const config = {
+            address: this.params.host,
+            storageKeys: keys,
+        };
+        if (!at) {
+            config.blockTag = "latest";
+        }
+        else {
+            config.blockNumber = at;
+        }
+        const proof = await self.publicClient.getProof(config);
+        const flattenedProof = Array.from(new Set(flatten(proof.storageProof.map((item) => item.proof))));
+        const encoded = EvmStateProof.enc({
+            contractProof: proof.accountProof.map((item) => Array.from(hexToBytes(item))),
+            storageProof: [
+                [Array.from(hexToBytes(self.params.host)), flattenedProof.map((item) => Array.from(hexToBytes(item)))],
+            ],
+        });
+        return toHex(encoded);
+    }
+    /**
+     * Returns the current timestamp of the chain.
+     * @returns {Promise<bigint>} The current timestamp.
+     */
+    async timestamp() {
+        const data = await this.publicClient.readContract({
+            address: this.params.host,
+            abi: EvmHost.ABI,
+            functionName: "timestamp",
+        });
+        return BigInt(data);
+    }
+    /**
+     * Encodes an ISMP message for the EVM chain.
+     * @param {IIsmpMessage} message The ISMP message to encode.
+     * @returns {HexString} The encoded calldata.
+     */
+    encode(message) {
+        const encoded = match(message)
+            .with({ kind: "PostRequest" }, (request) => {
+            const mmrProof = MmrProof.dec(request.proof.proof);
+            const requests = zip(request.requests, mmrProof.leafIndexAndPos)
+                .map(([req, leafIndexAndPos]) => {
+                if (!req || !leafIndexAndPos)
+                    return;
+                const [[, kIndex]] = mmrPositionToKIndex([leafIndexAndPos?.pos], calculateMMRSize(mmrProof.leafCount));
+                return {
+                    request: {
+                        source: toHex(req.source),
+                        dest: toHex(req.dest),
+                        to: req.to,
+                        from: req.from,
+                        nonce: req.nonce,
+                        timeoutTimestamp: req.timeoutTimestamp,
+                        body: req.body,
+                    },
+                    index: leafIndexAndPos?.leafIndex,
+                    kIndex,
+                };
+            })
+                .filter((item) => !!item);
+            const proof = {
+                height: {
+                    stateMachineId: BigInt(parseInt(request.proof.stateMachine.split("-")[1])),
+                    height: request.proof.height,
+                },
+                multiproof: mmrProof.items.map((item) => bytesToHex(new Uint8Array(item))),
+                leafCount: mmrProof.leafCount,
+            };
+            const encoded = encodeFunctionData({
+                abi: HandlerV1.ABI,
+                functionName: "handlePostRequests",
+                args: [
+                    this.params.host,
+                    {
+                        proof,
+                        requests,
+                    },
+                ],
+            });
+            return encoded;
+        })
+            .with({ kind: "TimeoutPostRequest" }, (timeout) => {
+            const proof = SubstrateStateProof.dec(timeout.proof.proof).value.storageProof.map((item) => toHex(new Uint8Array(item)));
+            const encoded = encodeFunctionData({
+                abi: HandlerV1.ABI,
+                functionName: "handlePostRequestTimeouts",
+                args: [
+                    this.params.host,
+                    {
+                        height: {
+                            stateMachineId: BigInt(parseInt(timeout.proof.stateMachine.split("-")[1])),
+                            height: timeout.proof.height,
+                        },
+                        timeouts: timeout.requests.map((req) => ({
+                            source: toHex(req.source),
+                            dest: toHex(req.dest),
+                            to: req.to,
+                            from: req.from,
+                            nonce: req.nonce,
+                            timeoutTimestamp: req.timeoutTimestamp,
+                            body: req.body,
+                        })),
+                        proof,
+                    },
+                ],
+            });
+            return encoded;
+        })
+            .exhaustive();
+        return encoded;
+    }
+}
+/**
+ * Slot for storing request commitments.
+ */
+export const REQUEST_COMMITMENTS_SLOT = 0n;
+/**
+ * Slot index for response commitments map
+ */
+export const RESPONSE_COMMITMENTS_SLOT = 1n;
+/**
+ * Slot index for requests receipts map
+ */
+export const REQUEST_RECEIPTS_SLOT = 2n;
+/**
+ * Slot index for response receipts map
+ */
+export const RESPONSE_RECEIPTS_SLOT = 3n;
+function requestCommitmentKey(key) {
+    // First derive the map key
+    const keyBytes = hexToBytes(key);
+    const mappedKey = deriveMapKey(keyBytes, REQUEST_COMMITMENTS_SLOT);
+    // Convert the derived key to BigInt and add 1
+    const number = bytesToBigInt(hexToBytes(mappedKey)) + 1n;
+    // Convert back to 32-byte hex
+    return pad(`0x${number.toString(16)}`, { size: 32 });
+}
+function deriveMapKey(key, slot) {
+    // Convert slot to 32-byte big-endian representation
+    const slotBytes = pad(`0x${slot.toString(16)}`, { size: 32 });
+    // Combine key and slot bytes
+    const combined = new Uint8Array([...key, ...toBytes(slotBytes)]);
+    // Calculate keccak256 hash
+    return keccak256(combined);
+}
+//# sourceMappingURL=evm.js.map

package/dist/chains/evm.js.map

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

package/dist/chains/substrate.d.ts

@@ -0,0 +1,88 @@
+import { ApiPromise } from "@polkadot/api";
+import { IStateMachine } from "../utils";
+import { IChain, IIsmpMessage } from "../chain";
+import { HexString } from "../types";
+export interface SubstrateChainParams {
+    ws: string;
+    hasher: "Keccak" | "Blake2";
+}
+export declare class SubstrateChain implements IChain {
+    private readonly params;
+    api?: ApiPromise;
+    constructor(params: SubstrateChainParams);
+    connect(): Promise<void>;
+    /**
+     * Returns the storage key for a request receipt in the child trie
+     * The request commitment is the key
+     * @param key - The H256 hash key (as a 0x-prefixed hex string)
+     * @returns The storage key as a hex string
+     */
+    requestReceiptKey(key: HexString): HexString;
+    /**
+     * Returns the storage key for a request commitment in the child trie
+     * The request commitment is the key
+     * @param key - The H256 hash key (as a 0x-prefixed hex string)
+     * @returns The storage key as a hex string
+     */
+    requestCommitmentKey(key: HexString): HexString;
+    /**
+     * Queries a request commitment from the ISMP child trie storage.
+     * @param {HexString} commitment - The commitment hash to look up.
+     * @returns {Promise<HexString | undefined>} The commitment data if found, undefined otherwise.
+     */
+    queryRequestCommitment(commitment: HexString): Promise<HexString | undefined>;
+    /**
+     * Queries the request receipt.
+     * @param {HexString} commitment - The commitment to query.
+     * @returns {Promise<HexString | undefined>} The relayer address responsible for delivering the request.
+     */
+    queryRequestReceipt(commitment: HexString): Promise<HexString | undefined>;
+    /**
+     * Returns the current timestamp of the chain.
+     * @returns {Promise<bigint>} The current timestamp.
+     */
+    timestamp(): Promise<bigint>;
+    /**
+     * Queries the proof of the requests.
+     * @param {HexString[]} requests - The requests to query.
+     * @param {string} counterparty - The counterparty address.
+     * @param {bigint} [at] - The block number to query at.
+     * @returns {Promise<HexString>} The proof.
+     */
+    queryRequestsProof(requests: HexString[], counterparty: string, at?: bigint): Promise<HexString>;
+    /**
+     * Submit an unsigned ISMP transaction to the chain. Resolves when the transaction is finalized.
+     * @param message - The message to be submitted.
+     * @returns A promise that resolves to an object containing the transaction hash, block hash, and block number.
+     */
+    submitUnsigned(message: IIsmpMessage): Promise<{
+        transactionHash: string;
+        blockHash: string;
+        blockNumber: number;
+    }>;
+    /**
+     * Query the state proof for a given set of keys at a specific block height.
+     * @param at The block height to query the state proof at.
+     * @param keys The keys to query the state proof for.
+     * @returns The state proof as a hexadecimal string.
+     */
+    queryStateProof(at: bigint, keys: HexString[]): Promise<HexString>;
+    /**
+     * Encode an ISMP calldata for a substrate chain.
+     * @param message The ISMP message to encode.
+     * @returns The encoded message as a hexadecimal string.
+     */
+    encode(message: IIsmpMessage): HexString;
+    /**
+     * Returns the index of a pallet by its name, by looking up the pallets in the runtime metadata.
+     * @param {string} name - The name of the pallet.
+     * @returns {number} The index of the pallet.
+     */
+    private getPalletIndex;
+}
+/**
+ * Converts a state machine ID string to an enum value.
+ * @param {string} id - The state machine ID string.
+ * @returns {IStateMachine} The corresponding enum value.
+ */
+export declare function convertStateMachineIdToEnum(id: string): IStateMachine;