@hyperbridge/sdk 1.8.0 → 1.8.2

package/dist/node/index.d.ts

@@ -590,6 +590,307 @@ declare const _default: {
     }];
 };
 
+declare class ChainConfigService {
+    private rpcUrls;
+    constructor(env?: NodeJS.ProcessEnv);
+    private getConfig;
+    getChainConfig(chain: string): ChainConfig;
+    getIntentGatewayAddress(chain: string): HexString;
+    getTokenGatewayAddress(chain: string): HexString;
+    getHostAddress(chain: string): HexString;
+    getWrappedNativeAssetWithDecimals(chain: string): {
+        asset: HexString;
+        decimals: number;
+    };
+    getDaiAsset(chain: string): HexString;
+    getUsdtAsset(chain: string): HexString;
+    getUsdcAsset(chain: string): HexString;
+    getUsdcDecimals(chain: string): number;
+    getUsdtDecimals(chain: string): number;
+    getCNgnAsset(chain: string): HexString | undefined;
+    getCNgnDecimals(chain: string): number | undefined;
+    getExtAsset(chain: string): HexString | undefined;
+    getExtDecimals(chain: string): number | undefined;
+    getChainId(chain: string): number;
+    getConsensusStateId(chain: string): HexString;
+    getHyperbridgeChainId(): number;
+    getRpcUrl(chain: string): string;
+    getUniswapRouterV2Address(chain: string): HexString;
+    getUniswapV2FactoryAddress(chain: string): HexString;
+    getUniswapV3FactoryAddress(chain: string): HexString;
+    getUniversalRouterAddress(chain: string): HexString;
+    getUniswapV3QuoterAddress(chain: string): HexString;
+    getUniswapV4QuoterAddress(chain: string): HexString;
+    getPermit2Address(chain: string): HexString;
+    getSolverAccountAddress(chain: string): HexString | undefined;
+    getCoingeckoId(chain: string): string | undefined;
+    getEtherscanApiKey(): string | undefined;
+    getCalldispatcherAddress(chain: string): HexString;
+    getTokenStorageSlots(chain: string, tokenAddress: string): {
+        balanceSlot: number;
+        allowanceSlot: number;
+    } | undefined;
+    getPopularTokens(chain: string): string[];
+    getIntentGatewayV2Address(chain: string): HexString;
+    getEntryPointV08Address(chain: string): HexString;
+    getHyperbridgeAddress(): string;
+    /**
+     * Get the LayerZero Endpoint ID for the chain
+     * Used for USDT0 cross-chain transfers via LayerZero OFT
+     */
+    getLayerZeroEid(chain: string): number | undefined;
+    /**
+     * Get the USDT0 OFT contract address for the chain
+     * On Ethereum: OFT Adapter (locks/unlocks USDT)
+     * On other chains: OFT contract (mints/burns USDT0)
+     */
+    getUsdt0OftAddress(chain: string): HexString | undefined;
+}
+
+/**
+ * The default address used as fallback when no address is provided.
+ * This represents the zero address in EVM chains.
+ */
+declare const DEFAULT_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Parameters for an EVM chain.
+ */
+interface EvmChainParams {
+    /**
+     * The chain ID of the EVM chain
+     */
+    chainId: number;
+    /**
+     * The RPC URL of the EVM chain
+     */
+    rpcUrl: string;
+    /**
+     * The host address of the EVM chain (IsmpHost contract address)
+     */
+    host: HexString;
+    /**
+     * Consensus state identifier of this chain on hyperbridge
+     */
+    consensusStateId?: string;
+    /**
+     * Optional ERC-4337 bundler URL for account abstraction support
+     */
+    bundlerUrl?: string;
+}
+/**
+ * Encapsulates an EVM chain.
+ */
+declare class EvmChain implements IChain {
+    private readonly params;
+    private publicClient;
+    private chainConfigService;
+    private constructor();
+    /**
+     * Creates an `EvmChain` instance directly from a fully-specified config object.
+     * Use this when you already know the chain ID, host address, and other parameters.
+     *
+     * This is the only public way to construct an `EvmChain` with explicit params — the constructor is private.
+     *
+     * @param params - Full EVM chain configuration
+     * @returns An `EvmChain` instance
+     */
+    static fromParams(params: EvmChainParams): EvmChain;
+    /**
+     * Creates an `EvmChain` instance by auto-detecting the chain ID from the RPC endpoint
+     * and resolving the correct `IsmpHost` contract address for that chain.
+     *
+     * This is the only public way to construct an `EvmChain` — the constructor is private.
+     *
+     * @param rpcUrl - HTTP(S) RPC URL of the EVM node
+     * @param bundlerUrl - Optional ERC-4337 bundler URL for account abstraction support
+     * @returns A fully initialised `EvmChain` ready for use
+     * @throws If the chain ID returned by the RPC is not a known Hyperbridge deployment
+     *
+     * @example
+     * ```typescript
+     * const chain = await EvmChain.create("https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY")
+     * const chain = await EvmChain.create("https://mainnet.base.org", "https://bundler.example.com")
+     * ```
+     */
+    static create(rpcUrl: string, bundlerUrl?: string): Promise<EvmChain>;
+    get client(): PublicClient;
+    get host(): HexString;
+    get bundlerUrl(): string | undefined;
+    get config(): IEvmConfig;
+    get configService(): ChainConfigService;
+    /**
+     * 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 commitments.
+     * @param {IMessage} message - The message to query.
+     * @param {string} counterparty - The counterparty address.
+     * @param {bigint} [at] - The block number to query at.
+     * @returns {Promise<HexString>} The proof.
+     */
+    queryProof(message: IMessage, 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.
+     * @param {HexString} address - Optional contract address to fetch storage proof else default to host contract
+     * @returns {Promise<HexString>} The encoded storage proof.
+     */
+    queryStateProof(at: bigint, keys: HexString[], address?: HexString): Promise<HexString>;
+    /**
+     * Returns the current timestamp of the chain.
+     * @returns {Promise<bigint>} The current timestamp.
+     */
+    timestamp(): Promise<bigint>;
+    /**
+     * Get the latest state machine height for a given state machine ID.
+     * @param {StateMachineIdParams} stateMachineId - The state machine ID.
+     * @returns {Promise<bigint>} The latest state machine height.
+     */
+    latestStateMachineHeight(stateMachineId: StateMachineIdParams): Promise<bigint>;
+    /**
+     * Get the state machine update time for a given state machine height.
+     * @param {StateMachineHeight} stateMachineHeight - The state machine height.
+     * @returns {Promise<bigint>} The statemachine update time in seconds.
+     */
+    stateMachineUpdateTime(stateMachineHeight: StateMachineHeight): Promise<bigint>;
+    /**
+     * Retrieves the placeOrder calldata from a transaction using debug_traceTransaction.
+     */
+    getPlaceOrderCalldata(txHash: string, intentGatewayAddress: string): Promise<HexString>;
+    /**
+     * Get the challenge period for a given state machine id.
+     * @param {StateMachineIdParams} stateMachineId - The state machine ID.
+     * @returns {Promise<bigint>} The challenge period in seconds.
+     */
+    challengePeriod(stateMachineId: StateMachineIdParams): 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;
+    /**
+     * Calculates the fee required to send a post request to the destination chain.
+     * The fee is calculated based on the per-byte fee for the destination chain
+     * multiplied by the size of the request body.
+     *
+     * @param request - The post request to calculate the fee for
+     * @returns The total fee in wei required to send the post request
+     */
+    quote(request: IPostRequest | IGetRequest): Promise<bigint>;
+    quoteNative(request: IPostRequest | IGetRequest, fee: bigint): Promise<bigint>;
+    private getAmountsIn;
+    /**
+     * Estimates the gas required for a post request execution on this chain.
+     * This function generates mock proofs for the post request, creates a state override
+     * with the necessary overlay root, and estimates the gas cost for executing the
+     * handlePostRequests transaction on the handler contract.
+     *
+     * @param request - The post request to estimate gas for
+     * @param paraId - The ID of the parachain (Hyperbridge) that will process the request
+     * @returns The estimated gas amount in gas units and the generated calldata
+     */
+    estimateGas(request: IPostRequest): Promise<{
+        gas: bigint;
+        postRequestCalldata: HexString;
+    }>;
+    /**
+     * Gets the fee token address and decimals for the chain.
+     * This function gets the fee token address and decimals for the chain.
+     *
+     * @returns The fee token address and decimals
+     */
+    getFeeTokenWithDecimals(): Promise<{
+        address: HexString;
+        decimals: number;
+    }>;
+    /**
+     * Gets the nonce of the host.
+     * This function gets the nonce of the host.
+     *
+     * @returns The nonce of the host
+     */
+    getHostNonce(): Promise<bigint>;
+    broadcastTransaction(signedTransaction: HexString): Promise<TransactionReceipt>;
+    getTransactionReceipt(hash: HexString): Promise<TransactionReceipt>;
+}
+/**
+ * Factory function for creating EVM chain instances with common defaults
+ *
+ * @param chainId - The EVM chain ID
+ * @param host - The IsmpHost contract address
+ * @param options - Optional configuration overrides
+ * @returns A new EvmChain instance
+ *
+ * @example
+ * ```typescript
+ * // Create with minimal config
+ * const ethChain = createEvmChain(1, "0x87ea45..", {
+ *   rpcUrl: "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+ * })
+ *
+ * // Create with custom consensus state ID
+ * const arbChain = createEvmChain(42161, "0x87ea42345..", {
+ *   rpcUrl: "https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY",
+ *   consensusStateId: "ARB_CUSTOM"
+ * })
+ * ```
+ */
+declare function createEvmChain(chainId: number, host: HexString, options: {
+    rpcUrl: string;
+    consensusStateId?: string;
+}): EvmChain;
+/**
+ * Slot for storing request commitments.
+ */
+declare const REQUEST_COMMITMENTS_SLOT = 0n;
+/**
+ * Slot index for response commitments map
+ */
+declare const RESPONSE_COMMITMENTS_SLOT = 1n;
+/**
+ * Slot index for requests receipts map
+ */
+declare const REQUEST_RECEIPTS_SLOT = 2n;
+/**
+ * Slot index for response receipts map
+ */
+declare const RESPONSE_RECEIPTS_SLOT = 3n;
+/**
+ * Slot index for state commitment map
+ */
+declare const STATE_COMMITMENTS_SLOT = 5n;
+declare function requestCommitmentKey(key: Hex): {
+    slot1: Hex;
+    slot2: Hex;
+};
+/**
+ * Derives the storage slot for a specific field in the StateCommitment struct
+ *
+ * struct StateCommitment {
+ *   uint256 timestamp;     // slot + 0
+ *   bytes32 overlayRoot;   // slot + 1
+ *   bytes32 stateRoot;     // slot + 2
+ * }
+ *
+ * @param stateMachineId - The state machine ID
+ * @param height - The block height
+ * @param field - The field index in the struct (0 for timestamp, 1 for overlayRoot, 2 for stateRoot)
+ * @returns The storage slot for the specific field
+ */
+declare function getStateCommitmentFieldSlot(stateMachineId: bigint, height: bigint, field: 0 | 1 | 2): HexString;
+declare function getStateCommitmentSlot(stateMachineId: bigint, height: bigint): HexString;
+
 /**
  * Generates a Merkle Mountain Range (MMR) root hash and proof for a post request.
  *
@@ -674,9 +975,6 @@ declare function postRequestCommitment(post: IPostRequest): {
     commitment: HexString;
     encodePacked: HexString;
 };
-declare function orderCommitment(order: Order): HexString;
-/** Calculates the order commitment hash */
-declare function orderV2Commitment(order: OrderV2): HexString;
 /**
  * Converts a bytes32 token address to bytes20 format
  * This removes the extra padded zeros from the address
@@ -719,18 +1017,18 @@ declare function estimateGasForPost(params: {
  * Used as the GET-request context for cancel-from-source, and as the inner
  * payload (after the RequestKind prefix) for POST-based escrow operations.
  */
-declare function encodeWithdrawalRequest(order: Order | OrderV2, beneficiary: HexString): HexString;
+declare function encodeWithdrawalRequest(order: Order | Order, beneficiary: HexString): HexString;
 /**
  * Constructs the request body for a redeem escrow operation.
  * This function encodes the order commitment, beneficiary address, and token inputs
  * to match the format expected by the IntentGateway contract.
  */
-declare function constructRedeemEscrowRequestBody(order: Order | OrderV2, beneficiary: HexString): HexString;
+declare function constructRedeemEscrowRequestBody(order: Order | Order, beneficiary: HexString): HexString;
 /**
  * Constructs the request body for a refund escrow operation (cancel from destination).
  * Uses RequestKind.RefundEscrow to match the IntentGatewayV2 contract's _cancelFromDest.
  */
-declare function constructRefundEscrowRequestBody(order: Order | OrderV2, beneficiary: HexString): HexString;
+declare function constructRefundEscrowRequestBody(order: Order | Order, beneficiary: HexString): HexString;
 declare function fetchPrice(identifier: string | undefined, chainId?: number, apiKey?: string): Promise<number>;
 /**
  * Fetches the current network gas price from an Etherscan-family explorer API.
@@ -819,373 +1117,94 @@ declare const USE_ETHERSCAN_CHAINS: Set<string>;
  */
 declare const TESTNET_CHAINS: Set<string>;
 /**
- * Retrieves the calldata used to call a target contract within a transaction using debug_traceTransaction
- * with the callTracer. Unlike the indexer helper, this returns the calldata whether the target is called
- * directly by the transaction or via nested calls.
- *
- * @param client - viem PublicClient connected to an RPC node with debug API enabled
- * @param txHash - The transaction hash
- * @param targetContractAddress - The target contract address to find the call for
- * @returns The input (calldata) as a hex string, or null if the target is not found in the trace
- * @throws Error if the RPC call fails or returns an unexpected response
- */
-declare function getContractCallInput(client: PublicClient, txHash: HexString, targetContractAddress: string): Promise<HexString | null>;
-/**
- * Calculates the balance mapping location for a given slot and holder address.
- * This function handles the different encoding formats used by Solidity and Vyper.
- *
- * @param slot - The slot number to calculate the mapping location for.
- * @param holder - The address of the holder to calculate the mapping location for.
- * @param language - The language of the contract.
- * @returns The balance mapping location as a HexString.
- */
-declare function calculateBalanceMappingLocation(slot: bigint, holder: string, language: EvmLanguage): HexString;
-/**
- * Calculates the allowance mapping location for a given slot, owner, and spender.
- * ERC20 allowance is a nested mapping: mapping(address owner => mapping(address spender => uint256))
- *
- * @param slot - The base slot number for the allowance mapping
- * @param owner - The address of the token owner (first parameter in allowance(owner, spender))
- * @param spender - The address approved to spend tokens (second parameter)
- * @param language - The language of the contract (Solidity or Vyper)
- * @returns The allowance mapping location as a HexString
- */
-declare function calculateAllowanceMappingLocation(slot: bigint, owner: string, spender: string, language: EvmLanguage): HexString;
-
-declare class SubstrateChain implements IChain {
-    private readonly params;
-    api?: ApiPromise;
-    private rpcClient;
-    constructor(params: ISubstrateConfig);
-    /**
-     * Creates a `SubstrateChain` instance and immediately connects to the
-     * WebSocket endpoint, returning a fully initialised chain client.
-     *
-     * @param params - Substrate chain configuration (wsUrl, stateMachineId, etc.).
-     * @returns A connected `SubstrateChain` instance.
-     */
-    static connect(params: ISubstrateConfig): Promise<SubstrateChain>;
-    get config(): ISubstrateConfig;
-    /**
-     * Connects to the Substrate chain using the provided WebSocket URL.
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnects the Substrate chain connection.
-     */
-    disconnect(): 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 commitments.
-     * @param {IMessage} message - The message to query.
-     * @param {string} counterparty - The counterparty address.
-     * @param {bigint} [at] - The block number to query at.
-     * @returns {Promise<HexString>} The proof.
-     */
-    queryProof(message: IMessage, 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;
-        timestamp: 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.
-     * @param _address - Optional address (ignored for Substrate; present for IChain compatibility).
-     * @returns The state proof as a hexadecimal string.
-     */
-    queryStateProof(at: bigint, keys: HexString[], _address?: HexString): Promise<HexString>;
-    /**
-     * Get the latest state machine height for a given state machine ID.
-     * @param {StateMachineIdParams} stateMachineId - The state machine ID.
-     * @returns {Promise<bigint>} The latest state machine height.
-     */
-    latestStateMachineHeight(stateMachineId: StateMachineIdParams): Promise<bigint>;
-    /**
-     * Get the state machine update time for a given state machine height.
-     * @param {StateMachineHeight} stateMachineHeight - The state machine height.
-     * @returns {Promise<bigint>} The statemachine update time in seconds.
-     */
-    stateMachineUpdateTime(stateMachineHeight: StateMachineHeight): Promise<bigint>;
-    /**
-     * Get the challenge period for a given state machine id.
-     * @param {StateMachineIdParams} stateMachineId - The state machine ID.
-     * @returns {Promise<bigint>} The challenge period in seconds.
-     */
-    challengePeriod(stateMachineId: StateMachineIdParams): Promise<bigint>;
-    /**
-     * 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.
- */
-declare function convertStateMachineIdToEnum(id: string): IStateMachine;
-/**
- * Converts a state machine enum representation to a string.
- * @param {IStateMachine} stateMachine - The state machine enum object.
- * @returns {string} The state machine ID string like "EVM-97" or "SUBSTRATE-cere".
- */
-declare function convertStateMachineEnumToString(stateMachine: {
-    tag: string;
-    value: number | number[];
-}): string;
-/**
- * Converts a stateId object back to the state_id format used by the RPC.
- * @param stateId - The stateId object from StateMachineIdParams
- * @returns The string representation like "EVM-11155111" or "SUBSTRATE-cere"
- */
-declare function convertStateIdToStateMachineId(stateId: {
-    Evm?: number;
-    Substrate?: HexString;
-    Polkadot?: number;
-    Kusama?: number;
-}): string;
-/**
- * Converts an IGetRequest object to a codec representation.
- * @param {IGetRequest} request - The IGetRequest object.
- * @returns The codec representation of the request.
- */
-declare function convertIGetRequestToCodec(request: IGetRequest): {
-    readonly source: IStateMachine;
-    readonly dest: IStateMachine;
-    readonly from: number[];
-    readonly nonce: bigint;
-    readonly keys: number[][];
-    readonly context: number[];
-    readonly timeoutTimestamp: bigint;
-    readonly height: bigint;
-};
-/**
- * Convert codec representation back to IGetRequest
- */
-declare function convertCodecToIGetRequest(codec: {
-    source: {
-        tag: string;
-        value: number | number[];
-    };
-    dest: {
-        tag: string;
-        value: number | number[];
-    };
-    from: number[];
-    nonce: bigint;
-    keys: number[][];
-    height: bigint;
-    context: number[];
-    timeoutTimestamp: bigint;
-}): IGetRequest;
-/**
- * Converts an IProof object to a codec representation.
- * @param {IProof} proof - The IProof object.
- * @returns The codec representation of the proof.
- */
-declare function convertIProofToCodec(proof: IProof): {
-    readonly height: {
-        readonly height: bigint;
-        readonly id: {
-            readonly consensusStateId: number[];
-            readonly id: IStateMachine;
-        };
-    };
-    readonly proof: number[];
-};
-/**
- * Converts a codec representation back to an IProof object.
- * @param {any} codec - The codec representation of the proof.
- * @returns {IProof} The IProof object.
+ * Retrieves the calldata used to call a target contract within a transaction using debug_traceTransaction
+ * with the callTracer. Unlike the indexer helper, this returns the calldata whether the target is called
+ * directly by the transaction or via nested calls.
+ *
+ * @param client - viem PublicClient connected to an RPC node with debug API enabled
+ * @param txHash - The transaction hash
+ * @param targetContractAddress - The target contract address to find the call for
+ * @returns The input (calldata) as a hex string, or null if the target is not found in the trace
+ * @throws Error if the RPC call fails or returns an unexpected response
  */
-declare function convertCodecToIProof(codec: {
-    height: {
-        height: bigint;
-        id: {
-            consensusStateId: number[];
-            id: {
-                tag: string;
-                value: number | number[];
-            };
-        };
-    };
-    proof: number[];
-}): IProof;
-declare function encodeISMPMessage(message: IIsmpMessage): Uint8Array;
-
-declare class ChainConfigService {
-    private rpcUrls;
-    constructor(env?: NodeJS.ProcessEnv);
-    private getConfig;
-    getChainConfig(chain: string): ChainConfig;
-    getIntentGatewayAddress(chain: string): HexString;
-    getTokenGatewayAddress(chain: string): HexString;
-    getHostAddress(chain: string): HexString;
-    getWrappedNativeAssetWithDecimals(chain: string): {
-        asset: HexString;
-        decimals: number;
-    };
-    getDaiAsset(chain: string): HexString;
-    getUsdtAsset(chain: string): HexString;
-    getUsdcAsset(chain: string): HexString;
-    getUsdcDecimals(chain: string): number;
-    getUsdtDecimals(chain: string): number;
-    getCNgnAsset(chain: string): HexString | undefined;
-    getCNgnDecimals(chain: string): number | undefined;
-    getExtAsset(chain: string): HexString | undefined;
-    getExtDecimals(chain: string): number | undefined;
-    getChainId(chain: string): number;
-    getConsensusStateId(chain: string): HexString;
-    getHyperbridgeChainId(): number;
-    getRpcUrl(chain: string): string;
-    getUniswapRouterV2Address(chain: string): HexString;
-    getUniswapV2FactoryAddress(chain: string): HexString;
-    getUniswapV3FactoryAddress(chain: string): HexString;
-    getUniversalRouterAddress(chain: string): HexString;
-    getUniswapV3QuoterAddress(chain: string): HexString;
-    getUniswapV4QuoterAddress(chain: string): HexString;
-    getPermit2Address(chain: string): HexString;
-    getSolverAccountAddress(chain: string): HexString | undefined;
-    getCoingeckoId(chain: string): string | undefined;
-    getEtherscanApiKey(): string | undefined;
-    getCalldispatcherAddress(chain: string): HexString;
-    getTokenStorageSlots(chain: string, tokenAddress: string): {
-        balanceSlot: number;
-        allowanceSlot: number;
-    } | undefined;
-    getPopularTokens(chain: string): string[];
-    getIntentGatewayV2Address(chain: string): HexString;
-    getEntryPointV08Address(chain: string): HexString;
-    getHyperbridgeAddress(): string;
-    /**
-     * Get the LayerZero Endpoint ID for the chain
-     * Used for USDT0 cross-chain transfers via LayerZero OFT
-     */
-    getLayerZeroEid(chain: string): number | undefined;
-    /**
-     * Get the USDT0 OFT contract address for the chain
-     * On Ethereum: OFT Adapter (locks/unlocks USDT)
-     * On other chains: OFT contract (mints/burns USDT0)
-     */
-    getUsdt0OftAddress(chain: string): HexString | undefined;
-}
-
+declare function getContractCallInput(client: PublicClient, txHash: HexString, targetContractAddress: string): Promise<HexString | null>;
 /**
- * The default address used as fallback when no address is provided.
- * This represents the zero address in EVM chains.
+ * Calculates the balance mapping location for a given slot and holder address.
+ * This function handles the different encoding formats used by Solidity and Vyper.
+ *
+ * @param slot - The slot number to calculate the mapping location for.
+ * @param holder - The address of the holder to calculate the mapping location for.
+ * @param language - The language of the contract.
+ * @returns The balance mapping location as a HexString.
  */
-declare const DEFAULT_ADDRESS = "0x0000000000000000000000000000000000000000";
+declare function calculateBalanceMappingLocation(slot: bigint, holder: string, language: EvmLanguage): HexString;
 /**
- * Parameters for an EVM chain.
+ * Calculates the allowance mapping location for a given slot, owner, and spender.
+ * ERC20 allowance is a nested mapping: mapping(address owner => mapping(address spender => uint256))
+ *
+ * @param slot - The base slot number for the allowance mapping
+ * @param owner - The address of the token owner (first parameter in allowance(owner, spender))
+ * @param spender - The address approved to spend tokens (second parameter)
+ * @param language - The language of the contract (Solidity or Vyper)
+ * @returns The allowance mapping location as a HexString
  */
-interface EvmChainParams {
-    /**
-     * The chain ID of the EVM chain
-     */
-    chainId: number;
+declare function calculateAllowanceMappingLocation(slot: bigint, owner: string, spender: string, language: EvmLanguage): HexString;
+
+declare class SubstrateChain implements IChain {
+    private readonly params;
+    api?: ApiPromise;
+    private rpcClient;
+    private constructor();
     /**
-     * The RPC URL of the EVM chain
+     * Creates a `SubstrateChain` instance and immediately connects to the
+     * WebSocket endpoint, returning a fully initialised chain client.
+     *
+     * This is the only public way to construct a `SubstrateChain` — the constructor is private.
+     *
+     * @param params - Substrate chain configuration (wsUrl, stateMachineId, etc.).
+     * @returns A connected `SubstrateChain` instance.
      */
-    rpcUrl: string;
+    static connect(params: ISubstrateConfig): Promise<SubstrateChain>;
+    get config(): ISubstrateConfig;
     /**
-     * The host address of the EVM chain (IsmpHost contract address)
+     * Connects to the Substrate chain using the provided WebSocket URL.
      */
-    host: HexString;
+    connect(): Promise<void>;
     /**
-     * Consensus state identifier of this chain on hyperbridge
+     * Disconnects the Substrate chain connection.
      */
-    consensusStateId?: string;
+    disconnect(): Promise<void>;
     /**
-     * Optional ERC-4337 bundler URL for account abstraction support
+     * 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
      */
-    bundlerUrl?: string;
-}
-/**
- * Encapsulates an EVM chain.
- */
-declare class EvmChain implements IChain {
-    private readonly params;
-    private publicClient;
-    private chainConfigService;
-    constructor(params: EvmChainParams);
+    requestReceiptKey(key: HexString): HexString;
     /**
-     * Creates an `EvmChain` instance by auto-detecting the chain ID from the RPC endpoint
-     * and resolving the correct `IsmpHost` contract address for that chain.
-     *
-     * @param rpcUrl - HTTP(S) RPC URL of the EVM node
-     * @param bundlerUrl - Optional ERC-4337 bundler URL for account abstraction support
-     * @returns A fully initialised `EvmChain` ready for use
-     * @throws If the chain ID returned by the RPC is not a known Hyperbridge deployment
-     *
-     * @example
-     * ```typescript
-     * const chain = await EvmChain.create("https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY")
-     * const chain = await EvmChain.create("https://mainnet.base.org", "https://bundler.example.com")
-     * ```
+     * 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
      */
-    static create(rpcUrl: string, bundlerUrl?: string): Promise<EvmChain>;
-    get client(): PublicClient;
-    get host(): HexString;
-    get bundlerUrl(): string | undefined;
-    get config(): IEvmConfig;
-    get configService(): ChainConfigService;
+    requestCommitmentKey(key: HexString): HexString;
     /**
-     * Derives the key for the request receipt.
-     * @param {HexString} commitment - The commitment to derive the key from.
-     * @returns {HexString} The derived key.
+     * 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.
      */
-    requestReceiptKey(commitment: HexString): HexString;
+    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 commitments.
      * @param {IMessage} message - The message to query.
@@ -1195,18 +1214,24 @@ declare class EvmChain implements IChain {
      */
     queryProof(message: IMessage, 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.
-     * @param {HexString} address - Optional contract address to fetch storage proof else default to host contract
-     * @returns {Promise<HexString>} The encoded storage proof.
+     * 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.
      */
-    queryStateProof(at: bigint, keys: HexString[], address?: HexString): Promise<HexString>;
+    submitUnsigned(message: IIsmpMessage): Promise<{
+        transactionHash: string;
+        blockHash: string;
+        blockNumber: number;
+        timestamp: number;
+    }>;
     /**
-     * Returns the current timestamp of the chain.
-     * @returns {Promise<bigint>} The current timestamp.
+     * 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.
+     * @param _address - Optional address (ignored for Substrate; present for IChain compatibility).
+     * @returns The state proof as a hexadecimal string.
      */
-    timestamp(): Promise<bigint>;
+    queryStateProof(at: bigint, keys: HexString[], _address?: HexString): Promise<HexString>;
     /**
      * Get the latest state machine height for a given state machine ID.
      * @param {StateMachineIdParams} stateMachineId - The state machine ID.
@@ -1219,10 +1244,6 @@ declare class EvmChain implements IChain {
      * @returns {Promise<bigint>} The statemachine update time in seconds.
      */
     stateMachineUpdateTime(stateMachineHeight: StateMachineHeight): Promise<bigint>;
-    /**
-     * Retrieves the placeOrder calldata from a transaction using debug_traceTransaction.
-     */
-    getPlaceOrderCalldata(txHash: string, intentGatewayAddress: string): Promise<HexString>;
     /**
      * Get the challenge period for a given state machine id.
      * @param {StateMachineIdParams} stateMachineId - The state machine ID.
@@ -1230,122 +1251,112 @@ declare class EvmChain implements IChain {
      */
     challengePeriod(stateMachineId: StateMachineIdParams): Promise<bigint>;
     /**
-     * Encodes an ISMP message for the EVM chain.
-     * @param {IIsmpMessage} message The ISMP message to encode.
-     * @returns {HexString} The encoded calldata.
+     * 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;
     /**
-     * Calculates the fee required to send a post request to the destination chain.
-     * The fee is calculated based on the per-byte fee for the destination chain
-     * multiplied by the size of the request body.
-     *
-     * @param request - The post request to calculate the fee for
-     * @returns The total fee in wei required to send the post request
-     */
-    quote(request: IPostRequest | IGetRequest): Promise<bigint>;
-    quoteNative(request: IPostRequest | IGetRequest, fee: bigint): Promise<bigint>;
-    private getAmountsIn;
-    /**
-     * Estimates the gas required for a post request execution on this chain.
-     * This function generates mock proofs for the post request, creates a state override
-     * with the necessary overlay root, and estimates the gas cost for executing the
-     * handlePostRequests transaction on the handler contract.
-     *
-     * @param request - The post request to estimate gas for
-     * @param paraId - The ID of the parachain (Hyperbridge) that will process the request
-     * @returns The estimated gas amount in gas units and the generated calldata
-     */
-    estimateGas(request: IPostRequest): Promise<{
-        gas: bigint;
-        postRequestCalldata: HexString;
-    }>;
-    /**
-     * Gets the fee token address and decimals for the chain.
-     * This function gets the fee token address and decimals for the chain.
-     *
-     * @returns The fee token address and decimals
-     */
-    getFeeTokenWithDecimals(): Promise<{
-        address: HexString;
-        decimals: number;
-    }>;
-    /**
-     * Gets the nonce of the host.
-     * This function gets the nonce of the host.
-     *
-     * @returns The nonce of the host
+     * 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.
      */
-    getHostNonce(): Promise<bigint>;
-    broadcastTransaction(signedTransaction: HexString): Promise<TransactionReceipt>;
-    getTransactionReceipt(hash: HexString): Promise<TransactionReceipt>;
+    private getPalletIndex;
 }
 /**
- * Factory function for creating EVM chain instances with common defaults
- *
- * @param chainId - The EVM chain ID
- * @param host - The IsmpHost contract address
- * @param options - Optional configuration overrides
- * @returns A new EvmChain instance
- *
- * @example
- * ```typescript
- * // Create with minimal config
- * const ethChain = createEvmChain(1, "0x87ea45..", {
- *   rpcUrl: "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
- * })
- *
- * // Create with custom consensus state ID
- * const arbChain = createEvmChain(42161, "0x87ea42345..", {
- *   rpcUrl: "https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY",
- *   consensusStateId: "ARB_CUSTOM"
- * })
- * ```
+ * Converts a state machine ID string to an enum value.
+ * @param {string} id - The state machine ID string.
+ * @returns {IStateMachine} The corresponding enum value.
  */
-declare function createEvmChain(chainId: number, host: HexString, options: {
-    rpcUrl: string;
-    consensusStateId?: string;
-}): EvmChain;
+declare function convertStateMachineIdToEnum(id: string): IStateMachine;
 /**
- * Slot for storing request commitments.
+ * Converts a state machine enum representation to a string.
+ * @param {IStateMachine} stateMachine - The state machine enum object.
+ * @returns {string} The state machine ID string like "EVM-97" or "SUBSTRATE-cere".
  */
-declare const REQUEST_COMMITMENTS_SLOT = 0n;
+declare function convertStateMachineEnumToString(stateMachine: {
+    tag: string;
+    value: number | number[];
+}): string;
 /**
- * Slot index for response commitments map
+ * Converts a stateId object back to the state_id format used by the RPC.
+ * @param stateId - The stateId object from StateMachineIdParams
+ * @returns The string representation like "EVM-11155111" or "SUBSTRATE-cere"
  */
-declare const RESPONSE_COMMITMENTS_SLOT = 1n;
+declare function convertStateIdToStateMachineId(stateId: {
+    Evm?: number;
+    Substrate?: HexString;
+    Polkadot?: number;
+    Kusama?: number;
+}): string;
 /**
- * Slot index for requests receipts map
+ * Converts an IGetRequest object to a codec representation.
+ * @param {IGetRequest} request - The IGetRequest object.
+ * @returns The codec representation of the request.
  */
-declare const REQUEST_RECEIPTS_SLOT = 2n;
+declare function convertIGetRequestToCodec(request: IGetRequest): {
+    readonly source: IStateMachine;
+    readonly dest: IStateMachine;
+    readonly from: number[];
+    readonly nonce: bigint;
+    readonly keys: number[][];
+    readonly context: number[];
+    readonly timeoutTimestamp: bigint;
+    readonly height: bigint;
+};
 /**
- * Slot index for response receipts map
+ * Convert codec representation back to IGetRequest
  */
-declare const RESPONSE_RECEIPTS_SLOT = 3n;
+declare function convertCodecToIGetRequest(codec: {
+    source: {
+        tag: string;
+        value: number | number[];
+    };
+    dest: {
+        tag: string;
+        value: number | number[];
+    };
+    from: number[];
+    nonce: bigint;
+    keys: number[][];
+    height: bigint;
+    context: number[];
+    timeoutTimestamp: bigint;
+}): IGetRequest;
 /**
- * Slot index for state commitment map
+ * Converts an IProof object to a codec representation.
+ * @param {IProof} proof - The IProof object.
+ * @returns The codec representation of the proof.
  */
-declare const STATE_COMMITMENTS_SLOT = 5n;
-declare function requestCommitmentKey(key: Hex): {
-    slot1: Hex;
-    slot2: Hex;
+declare function convertIProofToCodec(proof: IProof): {
+    readonly height: {
+        readonly height: bigint;
+        readonly id: {
+            readonly consensusStateId: number[];
+            readonly id: IStateMachine;
+        };
+    };
+    readonly proof: number[];
 };
 /**
- * Derives the storage slot for a specific field in the StateCommitment struct
- *
- * struct StateCommitment {
- *   uint256 timestamp;     // slot + 0
- *   bytes32 overlayRoot;   // slot + 1
- *   bytes32 stateRoot;     // slot + 2
- * }
- *
- * @param stateMachineId - The state machine ID
- * @param height - The block height
- * @param field - The field index in the struct (0 for timestamp, 1 for overlayRoot, 2 for stateRoot)
- * @returns The storage slot for the specific field
+ * Converts a codec representation back to an IProof object.
+ * @param {any} codec - The codec representation of the proof.
+ * @returns {IProof} The IProof object.
  */
-declare function getStateCommitmentFieldSlot(stateMachineId: bigint, height: bigint, field: 0 | 1 | 2): HexString;
-declare function getStateCommitmentSlot(stateMachineId: bigint, height: bigint): HexString;
+declare function convertCodecToIProof(codec: {
+    height: {
+        height: bigint;
+        id: {
+            consensusStateId: number[];
+            id: {
+                tag: string;
+                value: number | number[];
+            };
+        };
+    };
+    proof: number[];
+}): IProof;
+declare function encodeISMPMessage(message: IIsmpMessage): Uint8Array;
 
 /**
  * Encodes a PackedUserOperation using SCALE codec for submission to Hyperbridge.
@@ -1409,11 +1420,6 @@ declare class IntentsCoprocessor {
      * Supports both hex seed (without 0x prefix) and mnemonic phrases
      */
     getKeyPair(): KeyringPair;
-    /**
-     * Checks if the connected node exposes intents_* RPC methods.
-     * Result is cached after the first check.
-     */
-    private checkIntentsRpc;
     /**
      * Signs and sends an extrinsic, handling status updates and errors
      * Implements retry logic with progressive tip increases for stuck transactions
@@ -1484,7 +1490,16 @@ declare class TronChain implements IChain {
     private readonly params;
     private readonly evm;
     private readonly tronWebInstance;
-    constructor(params: TronChainParams);
+    /**
+     * Creates a `TronChain` instance from a fully-specified config object.
+     *
+     * This is the only public way to construct a `TronChain` — the constructor is private.
+     *
+     * @param params - Tron chain configuration
+     * @returns A `TronChain` instance
+     */
+    static fromParams(params: TronChainParams): Promise<TronChain>;
+    private constructor();
     /** Underlying viem public client (delegated from the internal EvmChain) */
     get client(): PublicClient;
     /** Host contract address for this chain (delegated from the internal EvmChain) */
@@ -1693,21 +1708,6 @@ interface IEvmChain extends IChain {
     broadcastTransaction(signedTransaction: HexString): Promise<TransactionReceipt>;
     getTransactionReceipt(hash: HexString): Promise<TransactionReceipt>;
 }
-/**
- * Returns the chain interface for a given state machine identifier.
- *
- * - For standard EVM chains, returns an `EvmChain`.
- * - For Substrate chains, returns a connected `SubstrateChain`.
- * - For Tron chains (identified by chain ID), constructs a `TronChain`
- *   that delegates EVM behavior to an internal `EvmChain` and manages
- *   its own TronWeb instance using the provided RPC URL.
- *
- * @param chainConfig - Chain configuration
- * @returns Chain interface
- */
-declare function getChain(chainConfig: IEvmConfig | ISubstrateConfig): Promise<IChain>;
-declare function getEvmChain(chainConfig: IEvmConfig): IChain;
-declare function getSubstrateChain(chainConfig: ISubstrateConfig): Promise<SubstrateChain>;
 
 type EstimateGasCallData = ContractFunctionArgs<typeof _default.ABI, "nonpayable" | "payable", "handlePostRequests">;
 type HexString = `0x${string}`;
@@ -2155,87 +2155,7 @@ interface TokenInfo {
      */
     amount: bigint;
 }
-/**
- * Represents payment information for an order
- */
-interface PaymentInfo extends TokenInfo {
-    /**
-     * The address to receive the output tokens
-     */
-    beneficiary: HexString;
-}
-/**
- * Represents an order in the IntentGateway
- */
-interface Order {
-    /**
-     * The unique identifier for the order
-     */
-    id?: string;
-    /**
-     * The address of the user who is initiating the transfer
-     */
-    user: HexString;
-    /**
-     * The state machine identifier of the origin chain
-     */
-    sourceChain: string;
-    /**
-     * The state machine identifier of the destination chain
-     */
-    destChain: string;
-    /**
-     * The block number by which the order must be filled on the destination chain
-     */
-    deadline: bigint;
-    /**
-     * The nonce of the order
-     */
-    nonce: bigint;
-    /**
-     * Represents the dispatch fees associated with the IntentGateway
-     */
-    fees: bigint;
-    /**
-     * The tokens that the filler will provide
-     */
-    outputs: PaymentInfo[];
-    /**
-     * The tokens that are escrowed for the filler
-     */
-    inputs: TokenInfo[];
-    /**
-     * A bytes array to store the calls if any
-     */
-    callData: HexString;
-    /**
-     * The transaction hash of the order
-     */
-    transactionHash?: HexString;
-}
 interface DecodedOrderPlacedLog extends Log {
-    eventName: string;
-    args: {
-        user: HexString;
-        sourceChain: Hex;
-        destChain: Hex;
-        deadline: bigint;
-        nonce: bigint;
-        fees: bigint;
-        outputs: Array<{
-            token: HexString;
-            amount: bigint;
-            beneficiary: HexString;
-        }>;
-        inputs: Array<{
-            token: HexString;
-            amount: bigint;
-        }>;
-        callData: HexString;
-    };
-    transactionHash: HexString;
-}
-interface DecodedOrderV2PlacedLog extends Log {
     eventName: string;
     args: {
         user: HexString;
@@ -2291,15 +2211,6 @@ interface DecodedPostResponseEvent extends Log {
     };
     transactionHash: HexString;
 }
-/**
- * Options for filling an order
- */
-interface FillOptions {
-    /**
-     * The fee paid to the relayer for processing transactions
-     */
-    relayerFee: bigint;
-}
 /**
  * Options for canceling an order
  */
@@ -2756,20 +2667,16 @@ interface StorageFacade {
     set<T>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
 }
-interface TokenInfoV2 {
-    token: HexString;
-    amount: bigint;
-}
-interface PaymentInfoV2 {
+interface PaymentInfo {
     beneficiary: HexString;
-    assets: TokenInfoV2[];
+    assets: TokenInfo[];
     call: HexString;
 }
-interface DispatchInfoV2 {
-    assets: TokenInfoV2[];
+interface DispatchInfo {
+    assets: TokenInfo[];
     call: HexString;
 }
-interface OrderV2 {
+interface Order {
     id?: string;
     user: HexString;
     source: HexString;
@@ -2778,15 +2685,14 @@ interface OrderV2 {
     nonce: bigint;
     fees: bigint;
     session: HexString;
-    predispatch: DispatchInfoV2;
-    inputs: TokenInfoV2[];
-    output: PaymentInfoV2;
-    transactionHash?: HexString;
+    predispatch: DispatchInfo;
+    inputs: TokenInfo[];
+    output: PaymentInfo;
 }
-interface FillOptionsV2 {
+interface FillOptions {
     relayerFee: bigint;
     nativeDispatchFee: bigint;
-    outputs: TokenInfoV2[];
+    outputs: TokenInfo[];
 }
 interface PackedUserOperation {
     sender: HexString;
@@ -2800,8 +2706,8 @@ interface PackedUserOperation {
     signature: HexString;
 }
 interface SubmitBidOptions {
-    order: OrderV2;
-    fillOptions: FillOptionsV2;
+    order: Order;
+    fillOptions: FillOptions;
     solverAccount: HexString;
     solverPrivateKey: HexString;
     nonce: bigint;
@@ -2814,8 +2720,8 @@ interface SubmitBidOptions {
     /** Pre-built ERC-7821 calldata encoding the UserOp execution (approvals + fillOrder). */
     callData: HexString;
 }
-interface EstimateFillOrderV2Params {
-    order: OrderV2;
+interface EstimateFillOrderParams {
+    order: Order;
     /**
      * Optional percentage to bump maxPriorityFeePerGas.
      * This is added on top of the base gasPrice.
@@ -2829,8 +2735,8 @@ interface EstimateFillOrderV2Params {
      */
     maxFeePerGasBumpPercent?: number;
 }
-interface FillOrderEstimateV2 {
-    fillOptions: FillOptionsV2;
+interface FillOrderEstimate {
+    fillOptions: FillOptions;
     callGasLimit: bigint;
     verificationGasLimit: bigint;
     preVerificationGas: bigint;
@@ -2920,13 +2826,13 @@ type IntentOrderStatusUpdate = {
     sessionPrivateKey: HexString;
 } | {
     status: "ORDER_PLACED";
-    order: OrderV2;
-    transactionHash: HexString;
+    order: Order;
+    receipt: TransactionReceipt;
 } | {
     status: "AWAITING_BIDS";
     commitment: HexString;
-    totalFilledAmount: bigint;
-    remainingAmount: bigint;
+    totalFilledAssets: TokenInfo[];
+    remainingAssets: TokenInfo[];
 } | {
     status: "BIDS_RECEIVED";
     commitment: HexString;
@@ -2950,28 +2856,28 @@ type IntentOrderStatusUpdate = {
     userOpHash: HexString;
     selectedSolver: HexString;
     transactionHash?: HexString;
-    totalFilledAmount: bigint;
-    remainingAmount: bigint;
+    totalFilledAssets: TokenInfo[];
+    remainingAssets: TokenInfo[];
 } | {
     status: "PARTIAL_FILL";
     commitment: HexString;
     userOpHash: HexString;
     selectedSolver: HexString;
     transactionHash?: HexString;
-    filledAmount?: bigint;
-    totalFilledAmount: bigint;
-    remainingAmount: bigint;
+    filledAssets: TokenInfo[];
+    totalFilledAssets: TokenInfo[];
+    remainingAssets: TokenInfo[];
 } | {
     status: "PARTIAL_FILL_EXHAUSTED";
     commitment: HexString;
-    totalFilledAmount?: bigint;
-    remainingAmount?: bigint;
+    totalFilledAssets?: TokenInfo[];
+    remainingAssets?: TokenInfo[];
     error: string;
 } | {
     status: "FAILED";
     commitment?: HexString;
-    totalFilledAmount?: bigint;
-    remainingAmount?: bigint;
+    totalFilledAssets?: TokenInfo[];
+    remainingAssets?: TokenInfo[];
     error: string;
 };
 /** Result of selecting a bid and submitting to the bundler */
@@ -2982,16 +2888,26 @@ interface SelectBidResult {
     commitment: HexString;
     txnHash?: HexString;
     fillStatus?: "full" | "partial";
-    /** Amount filled in this user operation (best-effort, based on on-chain logs) */
-    filledAmount?: bigint;
+    /** Assets filled in this user operation (best-effort, based on on-chain PartialFill logs) */
+    filledAssets?: TokenInfo[];
 }
 /** Options for executing an intent order */
 interface ExecuteIntentOrderOptions {
-    order: OrderV2;
+    order: Order;
     sessionPrivateKey?: HexString;
     minBids?: number;
     bidTimeoutMs?: number;
     pollIntervalMs?: number;
+    /**
+     * If set, bids are restricted to the given solver until `timeoutMs` elapses,
+     * after which any solver is accepted.
+     */
+    solver?: {
+        /** Only bids from this address (matched against userOp.sender) will be considered */
+        address: HexString;
+        /** After this many ms without a matching bid, execution falls back to any solver */
+        timeoutMs: number;
+    };
 }
 /** Type for ERC-7821 Call struct */
 type ERC7821Call = {
@@ -3000,29 +2916,6 @@ type ERC7821Call = {
     data: `0x${string}`;
 };
 
-/**
- * Helper function to create chain configuration from legacy config format
- * This helps migrate from the old config format to the new IChain-based format
- *
- * @param config - Legacy configuration object (IEvmConfig, ISubstrateConfig, or IHyperbridgeConfig)
- * @returns Promise resolving to chain configuration with IChain instance
- */
-declare function createChain(config: IEvmConfig | ISubstrateConfig | IHyperbridgeConfig): Promise<IChain>;
-/**
- * Helper function to create IndexerClient with legacy config format
- * @deprecated Use the constructor with IChain instances directly for better performance
- *
- * @param config - Legacy configuration with IEvmConfig/ISubstrateConfig/IHyperbridgeConfig
- * @returns Promise resolving to IndexerClient instance
- */
-declare function createIndexerClient(config: {
-    pollInterval?: number;
-    queryClient: IndexerQueryClient;
-    tracing?: boolean;
-    source: IEvmConfig | ISubstrateConfig;
-    dest: IEvmConfig | ISubstrateConfig;
-    hyperbridge: IHyperbridgeConfig;
-}): Promise<IndexerClient>;
 /**
  * IndexerClient provides methods for interacting with the Hyperbridge indexer.
  *
@@ -3045,14 +2938,13 @@ declare function createIndexerClient(config: {
  *
  * @example
  * ```typescript
- * // New approach: Create IChain instances directly
- * const sourceChain = new EvmChain({
+ * const sourceChain = EvmChain.fromParams({
  *   chainId: 1,
  *   rpcUrl: "https://eth-rpc.com",
  *   host: "0x87ea45..",
  *   consensusStateId: "ETH0"
  * })
- * const destChain = new EvmChain({
+ * const destChain = EvmChain.fromParams({
  *   chainId: 42161,
  *   rpcUrl: "https://arb-rpc.com",
  *   host: "0x87ea42345..",
@@ -3073,29 +2965,6 @@ declare function createIndexerClient(config: {
  *   hyperbridge: hyperbridgeChain
  * });
  *
- * // Legacy approach: Use the helper function (deprecated)
- * const client = await createIndexerClient({
- *   queryClient: queryClient,
- *   pollInterval: 2000,
- *   source: {
- *     stateMachineId: "EVM-1",
- *     consensusStateId: "ETH0",
- *     rpcUrl: "https://eth-rpc.com",
- *     host: "0x87ea45.."
- *   },
- *   dest: {
- *     stateMachineId: "EVM-42161",
- *     consensusStateId: "ETH0",
- *     rpcUrl: "https://arb-rpc.com",
- *     host: "0x87ea42345.."
- *   },
- *   hyperbridge: {
- *     stateMachineId: "POLKADOT-3367",
- *     consensusStateId: "DOT0",
- *     wsUrl: "ws://localhost:9944"
- *   }
- * });
- *
  * // Query a request status
  * const status = await client.queryRequestWithStatus("0x1234...");
  *
@@ -3842,10 +3711,10 @@ interface BundlerGasEstimate {
  *
  * - `DESTINATION_FINALIZED` – a state proof from the destination chain is ready.
  * - `AWAITING_CANCEL_TRANSACTION` – the caller must sign and submit the cancel tx.
+ * - `CANCEL_STARTED` – the cancel transaction was confirmed on-chain.
  * - `SOURCE_FINALIZED` – the cancel request has been finalised on the source chain.
  * - `HYPERBRIDGE_DELIVERED` – the cancel message has been delivered to Hyperbridge.
  * - `HYPERBRIDGE_FINALIZED` – the cancel message has been finalised on Hyperbridge.
- * - `SOURCE_PROOF_RECEIVED` – a proof of the source-chain state has been received.
  * - `CANCELLATION_COMPLETE` – the escrow has been refunded; cancellation is done.
  */
 type CancelEvent = {
@@ -3874,9 +3743,6 @@ type CancelEvent = {
     metadata: Extract<RequestStatusWithMetadata, {
         status: "HYPERBRIDGE_FINALIZED";
     }>["metadata"];
-} | {
-    status: "SOURCE_PROOF_RECEIVED";
-    proof: IProof;
 } | {
     status: "CANCELLATION_COMPLETE";
     blockNumber: number;
@@ -4031,12 +3897,16 @@ declare class IntentGateway {
      * @throws If the `placeOrder` generator behaves unexpectedly, or if gas
      *   estimation returns zero.
      */
-    execute(order: OrderV2, graffiti?: HexString, options?: {
+    execute(order: Order, graffiti?: HexString, options?: {
         maxPriorityFeePerGasBumpPercent?: number;
         maxFeePerGasBumpPercent?: number;
         minBids?: number;
         bidTimeoutMs?: number;
         pollIntervalMs?: number;
+        solver?: {
+            address: HexString;
+            timeoutMs: number;
+        };
     }): AsyncGenerator<IntentOrderStatusUpdate, void, HexString>;
     /**
      * Quotes the native token cost for cancelling an order.
@@ -4048,7 +3918,7 @@ declare class IntentGateway {
      *   Defaults to `false` (source-side cancellation).
      * @returns The native token amount required to submit the cancel transaction.
      */
-    quoteCancelNative(order: OrderV2, fromDest?: boolean): Promise<bigint>;
+    quoteCancelNative(order: Order, fromDest?: boolean): Promise<bigint>;
     /**
      * Async generator that cancels an order and streams status events until
      * cancellation is complete.
@@ -4061,7 +3931,7 @@ declare class IntentGateway {
      *   Defaults to `false` (source-side cancellation).
      * @yields {@link CancelEvent} objects describing each cancellation stage.
      */
-    cancelOrder(order: OrderV2, indexerClient: IndexerClient, fromDest?: boolean): AsyncGenerator<CancelEvent>;
+    cancelOrder(order: Order, indexerClient: IndexerClient, fromDest?: boolean): AsyncGenerator<CancelEvent>;
     /**
      * Constructs a signed `PackedUserOperation` for a solver to submit as a bid.
      *
@@ -4085,18 +3955,18 @@ declare class IntentGateway {
      * @returns A {@link SelectBidResult} with the submitted UserOperation, hashes,
      *   and fill status.
      */
-    selectBid(order: OrderV2, bids: FillerBid[], sessionPrivateKey?: HexString): Promise<SelectBidResult>;
+    selectBid(order: Order, bids: FillerBid[], sessionPrivateKey?: HexString): Promise<SelectBidResult>;
     /**
      * Estimates the gas cost for filling the given order, returning individual
      * gas components and fee-token-denominated totals.
      *
-     * Delegates to {@link GasEstimator.estimateFillOrderV2}.
+     * Delegates to {@link GasEstimator.estimateFillOrder}.
      *
      * @param params - Estimation parameters including the order and optional
      *   gas-price bump percentages.
-     * @returns A {@link FillOrderEstimateV2} with all gas components.
+     * @returns A {@link FillOrderEstimate} with all gas components.
      */
-    estimateFillOrderV2(params: EstimateFillOrderV2Params): Promise<FillOrderEstimateV2>;
+    estimateFillOrder(params: EstimateFillOrderParams): Promise<FillOrderEstimate>;
     /**
      * Encodes a list of calls into ERC-7821 `execute` calldata using
      * single-batch mode.
@@ -4125,7 +3995,7 @@ declare class IntentGateway {
      * @returns `true` if the order's commitment slot on the destination chain is
      *   non-zero (i.e. `fillOrder` has been called successfully).
      */
-    isOrderFilled(order: OrderV2): Promise<boolean>;
+    isOrderFilled(order: Order): Promise<boolean>;
     /**
      * Checks whether all escrowed inputs for an order have been refunded on the
      * source chain.
@@ -4136,7 +4006,7 @@ declare class IntentGateway {
      * @returns `true` if every input token's escrowed amount has been zeroed out
      *   in the `_orders` mapping on the source chain.
      */
-    isOrderRefunded(order: OrderV2): Promise<boolean>;
+    isOrderRefunded(order: Order): Promise<boolean>;
 }
 
 /**
@@ -4162,7 +4032,7 @@ declare class OrderStatusChecker {
      * @param order - The V2 order to check. `order.id` is used as the commitment; if not set it is computed.
      * @returns True if the order has been filled on the destination chain, false otherwise.
      */
-    isOrderFilled(order: OrderV2): Promise<boolean>;
+    isOrderFilled(order: Order): Promise<boolean>;
     /**
      * Checks if a V2 order has been refunded by reading the `_orders` mapping on the source chain.
      *
@@ -4173,7 +4043,7 @@ declare class OrderStatusChecker {
      * @param order - The V2 order to check. `order.id` is used as the commitment; if not set it is computed.
      * @returns True if all escrowed inputs have been returned to the user on the source chain, false otherwise.
      */
-    isOrderRefunded(order: OrderV2): Promise<boolean>;
+    isOrderRefunded(order: Order): Promise<boolean>;
 }
 
 /**
@@ -4208,10 +4078,10 @@ declare function encodeERC7821ExecuteBatch(calls: ERC7821Call[]): HexString;
  */
 declare function fetchSourceProof(commitment: HexString, source: IEvmChain, sourceStateMachine: string, sourceConsensusStateId: string, sourceHeight: bigint): Promise<IProof>;
 /**
- * Strips SDK-only fields from an {@link OrderV2} and normalises all fields to
+ * Strips SDK-only fields from an {@link Order} and normalises all fields to
  * the encoding the IntentGatewayV2 contract ABI expects:
  *
- * - `id` and `transactionHash` are removed (not part of the on-chain struct).
+ * - `id` is removed (not part of the on-chain struct).
  * - `source` and `destination` are hex-encoded if currently plain string
  *   state-machine IDs.
  * - `inputs[i].token`, `output.beneficiary`, `output.assets[i].token`, and
@@ -4221,9 +4091,20 @@ declare function fetchSourceProof(commitment: HexString, source: IEvmChain, sour
  *   these fields back to `address`. Values already at 32 bytes are unchanged.
  *
  * @param order - The SDK-level order to transform.
- * @returns A contract-compatible order struct without `id` or `transactionHash`.
+ * @returns A contract-compatible order struct without `id`.
+ */
+declare function transformOrderForContract(order: Order): Omit<Order, "id">;
+/**
+ * Calculates the commitment hash for an order by ABI-encoding the
+ * contract-normalised form of the order and hashing it.
+ *
+ * Calls `transformOrderForContract` before encoding to ensure all address
+ * fields are padded to 32 bytes and SDK-only fields are stripped.
+ *
+ * @param order - The SDK-level order to hash.
+ * @returns The keccak256 commitment hash.
  */
-declare function transformOrderForContract(order: OrderV2): Omit<OrderV2, "id" | "transactionHash">;
+declare function orderCommitment(order: Order): HexString;
 
 /**
  * EIP-712 type hash for the `SelectSolver` struct.
@@ -8148,4 +8029,4 @@ declare const getChainId: (stateMachineId: string) => number | undefined;
 declare const getViemChain: (chainId: number) => Chain | undefined;
 declare const hyperbridgeAddress = "";
 
-export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BundlerGasEstimate, BundlerMethod, type CancelEvent, type CancelOptions, type ChainConfig, type ChainConfigData, ChainConfigService, Chains, type ClientConfig, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedOrderPlacedLog, type DecodedOrderV2PlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type DispatchGet, type DispatchInfoV2, type DispatchPost, ERC20Method, type ERC7821Call, ERC7821_BATCH_MODE, type EstimateFillOrderV2Params, type EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, type ExecuteIntentOrderOptions, type ExecutionResult, type FillOptions, type FillOptionsV2, type FillOrderEstimateV2, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString, type HostParams, HyperClientStatus, type HyperbridgeTxEvents, type IChain, type IConfig, type IEvmChain, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, IndexerClient, type IndexerQueryClient, IntentGateway, type IntentGatewayContext, type IntentGatewayParams, ABI$1 as IntentGatewayV2ABI, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, IntentsCoprocessor, type IsmpRequest, MOCK_ADDRESS, type NewDeployment, ORDER_V2_PARAM_TYPE, type Order, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type OrderV2, type OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PaymentInfoV2, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type QuoteNativeResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, type RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, type SelectBidResult, type SelectOptions, type StateMachineHeight, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, type SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenInfoV2, type TokenPrice, type TokenPricesResponse, type Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createChain, createEvmChain, createIndexerClient, createQueryClient, decodeUserOpScale, encodeERC7821ExecuteBatch, encodeISMPMessage, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChain, getChainId, getConfigByStateMachineId, getContractCallInput, getEvmChain, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getSubstrateChain, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, orderCommitment, orderV2Commitment, parseStateMachineId, polkadotAssetHubPaseo, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
+export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BundlerGasEstimate, BundlerMethod, type CancelEvent, type CancelOptions, type ChainConfig, type ChainConfigData, ChainConfigService, Chains, type ClientConfig, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type DispatchGet, type DispatchInfo, type DispatchPost, ERC20Method, type ERC7821Call, ERC7821_BATCH_MODE, type EstimateFillOrderParams, type EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, type ExecuteIntentOrderOptions, type ExecutionResult, type FillOptions, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString, type HostParams, HyperClientStatus, type HyperbridgeTxEvents, type IChain, type IConfig, type IEvmChain, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, IndexerClient, type IndexerQueryClient, IntentGateway, type IntentGatewayContext, type IntentGatewayParams, ABI$1 as IntentGatewayV2ABI, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, IntentsCoprocessor, type IsmpRequest, MOCK_ADDRESS, type NewDeployment, ORDER_V2_PARAM_TYPE, type Order, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type QuoteNativeResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, type RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, type SelectBidResult, type SelectOptions, type StateMachineHeight, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, type SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeUserOpScale, encodeERC7821ExecuteBatch, encodeISMPMessage, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, orderCommitment, parseStateMachineId, polkadotAssetHubPaseo, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };