@hyperbridge/sdk 1.9.5 → 1.9.6

package/dist/node/index.d.ts

@@ -1613,6 +1613,94 @@ declare class PolkadotHubChain implements IChain {
     getTransactionReceipt(hash: HexString): Promise<TransactionReceipt>;
 }
 
+/**
+ * Chain parameters for a Pharos EVM chain. Pharos reuses the EVM JSON-RPC
+ * surface for reads, writes and host queries — proof fetching is the only
+ * place where the Pharos client deviates from a standard EVM chain.
+ */
+type PharosChainParams = EvmChainParams;
+/**
+ * Pharos EVM chain client.
+ *
+ * Delegates every standard EVM interaction to {@link EvmChain} and overrides
+ * {@link PharosChain.queryProof} / {@link PharosChain.queryStateProof} to speak
+ * Pharos's custom `eth_getProof` response format — mirroring the Rust
+ * `tesseract-messaging-pharos-evm` client.
+ */
+declare class PharosChain implements IChain {
+    private readonly params;
+    private readonly evm;
+    private readonly rpc;
+    static fromParams(params: PharosChainParams): PharosChain;
+    /**
+     * Creates a `PharosChain` by auto-detecting the EVM chain ID and `IsmpHost`
+     * address via {@link EvmChain.create}.
+     *
+     * @param rpcUrl - HTTP(S) JSON-RPC URL of the Pharos node
+     * @param bundlerUrl - Optional ERC-4337 bundler URL forwarded to `EvmChain.create`
+     */
+    static create(rpcUrl: string, bundlerUrl?: string): Promise<PharosChain>;
+    private constructor();
+    get client(): PublicClient;
+    get host(): HexString;
+    get bundlerUrl(): string | undefined;
+    get configService(): ChainConfigService;
+    get config(): IPharosConfig;
+    private hostAddress;
+    /**
+     * Fetch a storage proof for `slotKeys` under `address` at the given block and
+     * merge the response into the supplied accumulator. Mirrors the membership
+     * proof path of `PharosEvmClient::fetch_pharos_proof` on the Rust side.
+     */
+    private fetchStorageProofInto;
+    /**
+     * Fetch an account proof (no storage keys) at the given block and record it on
+     * the accumulator. Mirrors `PharosEvmClient::fetch_account_proof`.
+     */
+    private fetchAccountProofInto;
+    timestamp(): Promise<bigint>;
+    requestReceiptKey(commitment: HexString): HexString;
+    queryRequestReceipt(commitment: HexString): Promise<HexString | undefined>;
+    /**
+     * Query a Pharos state proof for the request/response commitments in `message`.
+     *
+     * Mirrors `PharosEvmClient::query_requests_proof` / `query_responses_proof`:
+     * for every commitment we derive the second storage slot (`slot1` from
+     * {@link requestCommitmentKey} / {@link responseCommitmentKey}) and request it
+     * from the ISMP host via `eth_getProof`.
+     */
+    queryProof(message: IMessage, _counterparty: string, at?: bigint): Promise<HexString>;
+    /**
+     * Query a Pharos state proof for arbitrary keys.
+     *
+     * Supports the same key shapes as `PharosEvmClient::query_state_proof`:
+     *   - 32-byte keys: ISMP host storage slots
+     *   - 52-byte keys: `address (20) || slot (32)` grouped by contract
+     *   - 20-byte keys: account queries (proves the account leaf itself)
+     *
+     * If `address` is provided, all keys are treated as 32-byte slots under that
+     * contract (matching the `EvmChain.queryStateProof` contract-override shape).
+     */
+    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.
  */
@@ -1724,7 +1812,7 @@ interface IChain {
     /**
      * Returns the configuration for this chain
      */
-    get config(): IEvmConfig | ISubstrateConfig | IPolkadotHubConfig;
+    get config(): IEvmConfig | ISubstrateConfig | IPolkadotHubConfig | IPharosConfig;
     timestamp(): Promise<bigint>;
     /**
      * Returns the state trie key for the request-receipt storage item for the given request commitment.
@@ -1776,8 +1864,8 @@ interface IEvmChain extends IChain {
 type EstimateGasCallData = ContractFunctionArgs<typeof _default.ABI, "nonpayable" | "payable", "handlePostRequests">;
 type HexString = `0x${string}`;
 interface IConfig {
-    source: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig;
-    dest: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig;
+    source: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig | IPharosConfig;
+    dest: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig | IPharosConfig;
     hyperbridge: IHyperbridgeConfig;
     tracing?: boolean;
 }
@@ -1794,6 +1882,14 @@ interface IEvmConfig {
 interface IPolkadotHubConfig extends IEvmConfig {
     substrateRpcUrl: string;
 }
+/**
+ * Pharos EVM chain — same as {@link IEvmConfig}. Pharos uses a non-standard
+ * `eth_getProof` response format (hexary hash tree proof nodes with offsets plus
+ * SHA-256 hashing), so proof fetching is handled by the Pharos-specific chain
+ * client rather than viem's standard `getProof`.
+ */
+interface IPharosConfig extends IEvmConfig {
+}
 interface ISubstrateConfig {
     wsUrl: string;
     consensusStateId: string;
@@ -8006,7 +8102,9 @@ declare enum Chains {
     POLYGON_AMOY = "EVM-80002",
     POLKADOT_ASSET_HUB_PASEO = "EVM-420420417",
     TRON_MAINNET = "EVM-728126428",
-    TRON_NILE = "EVM-3448148188"
+    TRON_NILE = "EVM-3448148188",
+    PHAROS_MAINNET = "EVM-688600",
+    PHAROS_ATLANTIC = "EVM-688689"
 }
 /** Polkadot Asset Hub Paseo testnet (chain ID 420420417) — not in viem/chains */
 declare const polkadotAssetHubPaseo: {
@@ -8056,6 +8154,114 @@ declare const polkadotAssetHubPaseo: {
     serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
     verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
 };
+/** Pharos Mainnet (chain ID 688600) — not in viem/chains */
+declare const pharosMainnet: {
+    blockExplorers?: {
+        [key: string]: {
+            name: string;
+            url: string;
+            apiUrl?: string | undefined;
+        };
+        default: {
+            name: string;
+            url: string;
+            apiUrl?: string | undefined;
+        };
+    } | undefined | undefined;
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 688600;
+    name: "Pharos Mainnet";
+    nativeCurrency: {
+        readonly name: "PHRS";
+        readonly symbol: "PHRS";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://atlantic.dplabs-internal.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+/** Pharos Atlantic Testnet (chain ID 688689) — not in viem/chains */
+declare const pharosAtlantic: {
+    blockExplorers?: {
+        [key: string]: {
+            name: string;
+            url: string;
+            apiUrl?: string | undefined;
+        };
+        default: {
+            name: string;
+            url: string;
+            apiUrl?: string | undefined;
+        };
+    } | undefined | undefined;
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 688689;
+    name: "Pharos Atlantic Testnet";
+    nativeCurrency: {
+        readonly name: "PHRS";
+        readonly symbol: "PHRS";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://atlantic.dplabs-internal.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
 /** Tron Nile Testnet (chain ID 3448148188) — not in viem/chains */
 declare const tronNile: {
     blockExplorers: {
@@ -8186,4 +8392,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 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 ResumeIntentOrderOptions, 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 };
+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 IPharosConfig, 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, PharosChain, type PharosChainParams, 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 ResumeIntentOrderOptions, 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, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };