@hyperbridge/sdk 1.8.4 → 1.8.6-rc.1

package/dist/node/index.d.ts

@@ -9,6 +9,7 @@ import { SignerOptions, SubmittableExtrinsic } from '@polkadot/api/types';
 import { ISubmittableResult } from '@polkadot/types/types';
 import { Chain } from 'viem/chains';
 import { TronWeb } from 'tronweb';
+export { Account as ViemAccount } from 'viem/accounts';
 
 declare const _default: {
     ABI: readonly [{
@@ -612,7 +613,7 @@ declare class ChainConfigService {
     getExtAsset(chain: string): HexString | undefined;
     getExtDecimals(chain: string): number | undefined;
     getChainId(chain: string): number;
-    getConsensusStateId(chain: string): HexString;
+    getConsensusStateId(chain: string): string;
     getHyperbridgeChainId(): number;
     getRpcUrl(chain: string): string;
     getUniswapRouterV2Address(chain: string): HexString;
@@ -874,6 +875,7 @@ declare function requestCommitmentKey(key: Hex): {
     slot1: Hex;
     slot2: Hex;
 };
+declare function responseCommitmentKey(key: Hex): Hex;
 /**
  * Derives the storage slot for a specific field in the StateCommitment struct
  *
@@ -1549,6 +1551,63 @@ declare class TronChain implements IChain {
     }>;
 }
 
+/**
+ * Full chain params: EVM JSON-RPC + Ismp host plus a Substrate JSON-RPC URL for proof queries.
+ */
+type PolkadotHubChainParams = EvmChainParams & {
+    substrateRpcUrl: string;
+};
+/**
+ * Polkadot Hub (EVM on Substrate / Revive): EVM RPC + host for reads and txs; Substrate RPC for
+ * child-trie proofs aligned with `tesseract/messaging/substrate-evm` (`query_requests_proof` /
+ * `query_state_proof`).
+ */
+declare class PolkadotHubChain implements IChain {
+    private readonly params;
+    private readonly evm;
+    private readonly substrateRpc;
+    static fromParams(params: PolkadotHubChainParams): PolkadotHubChain;
+    /**
+     * Creates a `PolkadotHubChain` by auto-detecting the EVM chain ID and `IsmpHost` address via
+     * {@link EvmChain.create}, plus a Substrate RPC URL for Revive child-trie proofs.
+     *
+     * @param evmRpcUrl - HTTP(S) JSON-RPC URL of the EVM (Revive) node
+     * @param substrateRpcUrl - Substrate node RPC (HTTP or WebSocket) for proof queries
+     * @param bundlerUrl - Optional ERC-4337 bundler URL (forwarded to `EvmChain.create`)
+     */
+    static create(evmRpcUrl: string, substrateRpcUrl: string, bundlerUrl?: string): Promise<PolkadotHubChain>;
+    private constructor();
+    get client(): PublicClient;
+    get host(): HexString;
+    get bundlerUrl(): string | undefined;
+    get configService(): ChainConfigService;
+    get config(): IPolkadotHubConfig;
+    private hostAddress20;
+    private fetchCombinedProof;
+    timestamp(): Promise<bigint>;
+    requestReceiptKey(commitment: HexString): HexString;
+    queryRequestReceipt(commitment: HexString): Promise<HexString | undefined>;
+    queryProof(message: IMessage, _counterparty: string, at?: bigint): Promise<HexString>;
+    queryStateProof(at: bigint, keys: HexString[], _address?: HexString): Promise<HexString>;
+    encode(message: IIsmpMessage): HexString;
+    latestStateMachineHeight(stateMachineId: StateMachineIdParams): Promise<bigint>;
+    challengePeriod(stateMachineId: StateMachineIdParams): Promise<bigint>;
+    stateMachineUpdateTime(stateMachineHeight: StateMachineHeight): Promise<bigint>;
+    getHostNonce(): Promise<bigint>;
+    quoteNative(request: IPostRequest | IGetRequest, fee: bigint): Promise<bigint>;
+    getFeeTokenWithDecimals(): Promise<{
+        address: HexString;
+        decimals: number;
+    }>;
+    getPlaceOrderCalldata(txHash: string, intentGatewayAddress: string): Promise<HexString>;
+    estimateGas(request: IPostRequest): Promise<{
+        gas: bigint;
+        postRequestCalldata: HexString;
+    }>;
+    broadcastTransaction(signedTransaction: HexString): Promise<TransactionReceipt>;
+    getTransactionReceipt(hash: HexString): Promise<TransactionReceipt>;
+}
+
 /**
  * Type representing an ISMP message.
  */
@@ -1660,7 +1719,7 @@ interface IChain {
     /**
      * Returns the configuration for this chain
      */
-    get config(): IEvmConfig | ISubstrateConfig;
+    get config(): IEvmConfig | ISubstrateConfig | IPolkadotHubConfig;
     timestamp(): Promise<bigint>;
     /**
      * Returns the state trie key for the request-receipt storage item for the given request commitment.
@@ -1691,7 +1750,7 @@ interface IChain {
     stateMachineUpdateTime(stateMachineHeight: StateMachineHeight): Promise<bigint>;
 }
 /**
- * Interface for EVM-compatible chains (EVM and Tron).
+ * Interface for EVM-compatible chains (EVM, Tron, Polkadot Hub).
  * Extends IChain with methods required by IntentGatewayV2 and other EVM-specific protocols.
  */
 interface IEvmChain extends IChain {
@@ -1712,8 +1771,8 @@ interface IEvmChain extends IChain {
 type EstimateGasCallData = ContractFunctionArgs<typeof _default.ABI, "nonpayable" | "payable", "handlePostRequests">;
 type HexString = `0x${string}`;
 interface IConfig {
-    source: IEvmConfig | ISubstrateConfig;
-    dest: IEvmConfig | ISubstrateConfig;
+    source: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig;
+    dest: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig;
     hyperbridge: IHyperbridgeConfig;
     tracing?: boolean;
 }
@@ -1723,6 +1782,13 @@ interface IEvmConfig {
     host: HexString;
     consensusStateId: string;
 }
+/**
+ * EVM-on-Substrate (e.g. Polkadot Hub) — same as {@link IEvmConfig} plus a Substrate node RPC URL
+ * used for `state_getReadProof` / `state_getChildReadProof` (Revive child trie proofs).
+ */
+interface IPolkadotHubConfig extends IEvmConfig {
+    substrateRpcUrl: string;
+}
 interface ISubstrateConfig {
     wsUrl: string;
     consensusStateId: string;
@@ -2709,11 +2775,22 @@ interface PackedUserOperation {
     paymasterAndData: HexString;
     signature: HexString;
 }
+interface SigningAccount {
+    /** Signs a bid message hash for a given chain. Returns a 65-byte ECDSA signature. */
+    signMessage: (messageHash: HexString, chainId: number) => Promise<HexString>;
+    /** Signs a raw 32-byte hash, returning split signature components for EIP-7702 etc. */
+    signRawHash: (hash: HexString) => Promise<{
+        r: HexString;
+        s: HexString;
+        yParity: number;
+    }>;
+}
 interface SubmitBidOptions {
     order: Order;
     fillOptions: FillOptions;
     solverAccount: HexString;
-    solverPrivateKey: HexString;
+    /** Canonical signer used for bid message signing and raw-hash operations. */
+    solverSigner: SigningAccount;
     nonce: bigint;
     entryPointAddress: HexString;
     callGasLimit: bigint;
@@ -8034,4 +8111,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 CancelQuote, 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 };
+export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BundlerGasEstimate, BundlerMethod, type CancelEvent, type CancelOptions, type CancelQuote, 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 IPolkadotHubConfig, 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, PolkadotHubChain, type PolkadotHubChainParams, 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 SigningAccount, 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, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };