@hyperbridge/sdk 2.4.2 → 2.5.0

package/dist/node/index.d.cts

@@ -1,5 +1,5 @@
-import { I as IChain, H as HexString, a as IEvmConfig, C as ChainConfigService, b as IMessage, S as StateMachineIdParams, c as StateMachineHeight, d as IIsmpMessage, e as IPostRequest, f as IGetRequest, O as Order, E as EstimateGasCallData, R as RetryConfig, g as IPolkadotHubConfig, h as IPharosConfig, i as StateMachineUpdate, P as PostRequestWithStatus, G as GetRequestWithStatus, j as ResponseCommitmentWithValues, k as RequestStatusWithMetadata, l as PostRequestTimeoutStatus, m as SubstrateChain, n as ClientConfig, o as IndexerQueryClient, A as AssetTeleported, T as Transaction, p as IProof, q as IEvmChain, r as IntentsCoprocessor, s as IntentOrderStatusUpdate, t as SelectBidResult, u as ResumeIntentOrderOptions, v as CancelOrderOptions, w as CancelQuote, x as SubmitBidOptions, y as PackedUserOperation, F as FillerBid, B as Bid, z as EstimateFillOrderParams, D as FillOrderEstimate, J as ERC7821Call, K as OrderWithStatus, L as OrderStatus, M as TokenGatewayAssetTeleportedWithStatus, N as TeleportStatus, Q as DecodedOrderPlacedLog, U as DecodedPostRequestEvent, V as DecodedPostResponseEvent } from './IntentGatewayV2-PzbhFn_7.cjs';
-export { W as AllStatusKey, X as AssetTeleportedResponse, Y as BidStorageEntry, Z as BidSubmissionResult, _ as BlockMetadata, $ as BytesLikeHex, a0 as CancelOptions, a1 as ChainConfig, a2 as ChainConfigData, a3 as Chains, a4 as ConfiguredAssetSymbol, a5 as Deployment, a6 as DispatchGet, a7 as DispatchInfo, a8 as DispatchPost, a9 as ExecuteIntentOrderOptions, aa as ExecutionResult, ab as FillOptions, ac as FillerConfig, ad as GetRequestResponse, ae as GetResponseByRequestIdResponse, af as GetResponseStorageValues, ag as HostParams, ah as HyperClientStatus, ai as IBatchConsensusAndGetResponseMessage, aj as IBatchConsensusAndPostRequestMessage, ak as IConfig, al as IConsensusMessage, am as IGetRequestMessage, an as IGetResponse, ao as IGetResponseMessage, ap as IHyperbridgeConfig, aq as IPostResponse, ar as IRequestMessage, as as ISubstrateConfig, at as ITimeoutPostRequestMessage, au as IntentGatewayABI, av as IntentGatewayParams, aw as IntentOrderStatus, ax as IntentOrderStatusKey, ay as IsmpRequest, az as OrderResponse, aA as OrderStatusMetadata, aB as PaymentInfo, aC as PhantomOrderEvent, aD as PhantomOrderPriceSnapshot, aE as PhantomOrderPriceSnapshotsResponse, aF as PostRequestStatus, aG as RequestBody, aH as RequestCommitment, aI as RequestKind, aJ as RequestResponse, aK as RequestStatus, aL as RequestStatusKey, aM as SelectOptions, aN as SigningAccount, aO as StateMachineId, aP as StateMachineResponse, aQ as StorageFacade, aR as TimeoutStatus, aS as TimeoutStatusKey, aT as TokenGatewayAssetTeleportedResponse, aU as TokenInfo, aV as TokenPrice, aW as TokenPricesResponse, aX as UniswapV4PoolConfigData, aY as chainConfigs, aZ as convertCodecToIGetRequest, a_ as convertCodecToIProof, a$ as convertIGetRequestToCodec, b0 as convertIProofToCodec, b1 as convertStateIdToStateMachineId, b2 as convertStateMachineEnumToString, b3 as convertStateMachineIdToEnum, b4 as decodeERC7821ExecuteBatch, b5 as decodeUserOpScale, b6 as encodeERC7821ExecuteBatch, b7 as encodeISMPMessage, b8 as encodeUserOpScale, b9 as getChainId, ba as getConfigByStateMachineId, bb as getViemChain, bc as hyperbridgeAddress, bd as pharosAtlantic, be as pharosMainnet, bf as polkadotAssetHubPaseo, bg as polkadotHubMainnet, bh as tronChainIds, bi as tronNile } from './IntentGatewayV2-PzbhFn_7.cjs';
+import { I as IChain, H as HexString, a as IEvmConfig, C as ChainConfigService, b as IMessage, S as StateMachineIdParams, c as StateMachineHeight, d as IIsmpMessage, e as IPostRequest, f as IGetRequest, O as Order, E as EstimateGasCallData, R as RetryConfig, g as IPolkadotHubConfig, h as IPharosConfig, i as StateMachineUpdate, P as PostRequestWithStatus, G as GetRequestWithStatus, j as ResponseCommitmentWithValues, k as RequestStatusWithMetadata, l as PostRequestTimeoutStatus, m as SubstrateChain, n as ClientConfig, o as IndexerQueryClient, A as AssetTeleported, T as Transaction, p as IProof, q as IEvmChain, r as IntentsCoprocessor, s as AvailableLiquiditySnapshot, t as IntentOrderStatusUpdate, u as SelectBidResult, v as ResumeIntentOrderOptions, w as CancelOrderOptions, x as CancelQuote, y as SubmitBidOptions, z as PackedUserOperation, F as FillerBid, B as Bid, D as EstimateFillOrderParams, J as FillOrderEstimate, K as ERC7821Call, L as OrderWithStatus, M as OrderStatus, N as TokenGatewayAssetTeleportedWithStatus, Q as TeleportStatus, U as DecodedOrderPlacedLog, V as DecodedPostRequestEvent, W as DecodedPostResponseEvent } from './IntentGatewayV2-tYGohDdW.cjs';
+export { X as AllStatusKey, Y as AssetTeleportedResponse, Z as AvailableLiquidityByChain, _ as BidStorageEntry, $ as BidSubmissionResult, a0 as BlockMetadata, a1 as BytesLikeHex, a2 as CancelOptions, a3 as ChainConfig, a4 as ChainConfigData, a5 as Chains, a6 as ConfiguredAssetSymbol, a7 as Deployment, a8 as DispatchGet, a9 as DispatchInfo, aa as DispatchPost, ab as ExecuteIntentOrderOptions, ac as ExecutionResult, ad as FillOptions, ae as FillerConfig, af as GetRequestResponse, ag as GetResponseByRequestIdResponse, ah as GetResponseStorageValues, ai as HostParams, aj as HyperClientStatus, ak as IBatchConsensusAndGetResponseMessage, al as IBatchConsensusAndPostRequestMessage, am as IConfig, an as IConsensusMessage, ao as IGetRequestMessage, ap as IGetResponse, aq as IGetResponseMessage, ar as IHyperbridgeConfig, as as IPostResponse, at as IRequestMessage, au as ISubstrateConfig, av as ITimeoutPostRequestMessage, aw as IntentGatewayABI, ax as IntentGatewayParams, ay as IntentOrderStatus, az as IntentOrderStatusKey, aA as IsmpRequest, aB as OrderResponse, aC as OrderStatusMetadata, aD as PaymentInfo, aE as PhantomOrderEvent, aF as PhantomOrderPriceSnapshot, aG as PhantomOrderPriceSnapshotsResponse, aH as PollPhantomOrdersOptions, aI as PostRequestStatus, aJ as RequestBody, aK as RequestCommitment, aL as RequestKind, aM as RequestResponse, aN as RequestStatus, aO as RequestStatusKey, aP as SelectOptions, aQ as SigningAccount, aR as StateMachineId, aS as StateMachineResponse, aT as StorageFacade, aU as TimeoutStatus, aV as TimeoutStatusKey, aW as TokenGatewayAssetTeleportedResponse, aX as TokenInfo, aY as TokenPrice, aZ as TokenPricesResponse, a_ as UniswapV4PoolConfigData, a$ as chainConfigs, b0 as convertCodecToIGetRequest, b1 as convertCodecToIProof, b2 as convertIGetRequestToCodec, b3 as convertIProofToCodec, b4 as convertStateIdToStateMachineId, b5 as convertStateMachineEnumToString, b6 as convertStateMachineIdToEnum, b7 as decodeERC7821ExecuteBatch, b8 as decodeUserOpScale, b9 as encodeERC7821ExecuteBatch, ba as encodeISMPMessage, bb as encodeUserOpScale, bc as getChainId, bd as getConfigByStateMachineId, be as getViemChain, bf as hyperbridgeAddress, bg as pharosAtlantic, bh as pharosMainnet, bi as polkadotAssetHubPaseo, bj as polkadotHubMainnet, bk as tronChainIds, bl as tronNile } from './IntentGatewayV2-tYGohDdW.cjs';
 import { ConsolaInstance } from 'consola';
 import { GraphQLClient } from 'graphql-request';
 import { PublicClient, TransactionReceipt, Hex, Address } from 'viem';
@@ -364,6 +364,10 @@ declare function normalizeEvmChainId(chainId: number | string): {
 };
 declare function encodeStateMachineId(stateMachineId: string): HexString;
 declare function normalizeAddressForEvmBytes32(address: string): HexString;
+/**
+ * Validates an EVM address and returns its canonical lowercase representation.
+ */
+declare function normalizeEvmAddress(address: string, field?: string): HexString;
 declare function normalizeAddressForStateMachine(address: string, stateMachineId: string): HexString;
 /**
  * Retries a promise-returning operation with exponential backoff.
@@ -1599,9 +1603,9 @@ interface BundlerGasEstimate {
  * - `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.
- * - `CANCELLATION_COMPLETE` – the escrow has been refunded; cancellation is done.
+    * - `HYPERBRIDGE_DELIVERED` – the cancel message has been delivered to Hyperbridge.
+    * - `HYPERBRIDGE_FINALIZED` – the cancel message has been finalised on Hyperbridge.
+    * - `CANCELLATION_COMPLETE` – the escrow has been refunded; cancellation is done.
  */
 type CancelEvent = {
     status: "DESTINATION_FINALIZED";
@@ -1840,6 +1844,8 @@ declare class IntentGateway {
     private readonly gasEstimator;
     /** Quote strategies for pricing orders before placement, keyed by strategy name. */
     private readonly quoteStrategies;
+    /** Resolves order tokens to canonical Phantom snapshot market pairs. */
+    private readonly phantomSnapshotPairResolver;
     /**
      * Private constructor — use {@link IntentGateway.create} instead.
      *
@@ -1894,13 +1900,25 @@ declare class IntentGateway {
      * @throws {PhantomSnapshotUnavailableError} When an eligible cNGN pair has no snapshot.
      */
     quoteIntent(params: QuoteIntentParams): Promise<QuoteIntentResult>;
+    /**
+     * Returns the output-token liquidity measured in the latest directional
+     * Phantom snapshot for this gateway's source and destination.
+     *
+     * Pair resolution uses the same canonical Base market as {@link quoteIntent}.
+     * The snapshot itself determines the output token and chain to aggregate. The
+     * amount is in the token's smallest unit and reflects the indexer's
+     * `snapshotTime`; it is not a live reservation or fill guarantee.
+     *
+     * Requires a prior call to {@link withQueryClient}.
+     */
+    queryAvailableLiquidity(params: Pick<QuoteIntentParams, "tokenIn" | "tokenOut">): Promise<AvailableLiquiditySnapshot | undefined>;
     /**
      * Bidirectional async generator that orchestrates the full order lifecycle:
      * placement, fee estimation, bid collection, and execution.
      *
      * **Yield/receive protocol:**
-     * 1. If `order.fees` is unset or zero, estimates gas and sets same-chain
-     *    `order.fees` to twice the estimate. Cross-chain orders retain a 1% buffer
+     * 1. If `order.fees` is unset or zero, estimates gas on an internal copy and sets
+     *    same-chain fees to twice the estimate. Cross-chain orders retain a 1% buffer
      *    and include an additional 600k-gas fee uplift, while the wei cost used for
      *    the `value` field receives a 2% buffer.
      * 2. Yields `AWAITING_PLACE_ORDER` with `{ to, data, value, sessionPrivateKey }`.
@@ -1910,8 +1928,8 @@ declare class IntentGateway {
      * 4. Delegates to {@link OrderExecutor.executeOrder} and forwards all
      *    subsequent status updates until the order is filled, exhausted, or fails.
      *
-     * @param order - The order to place and execute. `order.fees` may be 0; it
-     *   will be estimated automatically if so.
+     * @param order - The order to place and execute. It is not mutated. `order.fees`
+     *   may be 0; fees are estimated automatically if so.
      * @param graffiti - Optional bytes32 tag for orderflow attribution /
      *   revenue share. Defaults to {@link DEFAULT_GRAFFITI}.
      * @param options - Optional tuning parameters:
@@ -6003,4 +6021,4 @@ declare function teleport(teleport_param: {
     extrinsics?: Array<SubmittableExtrinsic<"promise", ISubmittableResult>>;
 }): Promise<ReadableStream<HyperbridgeTxEvents>>;
 
-export { ADDRESS_ZERO, AssetTeleported, Bid, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type CancelEvent, CancelOrderOptions, CancelQuote, ChainConfigService, ClientConfig, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, DecodedOrderPlacedLog, DecodedPostRequestEvent, DecodedPostResponseEvent, ERC20Method, ERC7821Call, ERC7821_BATCH_MODE, EstimateFillOrderParams, EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, FillOrderEstimate, FillerBid, GetRequestWithStatus, HexString, HyperFungibleToken, HyperFungibleTokenABI, type HyperbridgeTxEvents, IChain, IEvmChain, IEvmConfig, IGetRequest, IIsmpMessage, IMessage, IPharosConfig, IPolkadotHubConfig, IPostRequest, IProof, IndexerQueryClient, IntentGateway, type IntentGatewayContext, IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidPhantomSnapshotError, IsmpClient, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, Order, OrderStatus, OrderStatusChecker, OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, PackedUserOperation, type Params, type PhantomSnapshotIntentQuoteMetadata, type PhantomSnapshotQuoteIntentResult, PhantomSnapshotUnavailableError, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, PostRequestTimeoutStatus, PostRequestWithStatus, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestStatusWithMetadata, ResponseCommitmentWithValues, ResumeIntentOrderOptions, RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SelectBidResult, StateMachineHeight, StateMachineIdParams, StateMachineUpdate, SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TokenGateway, TokenGatewayAssetTeleportedWithStatus, Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolKey, type UniswapV4QuoteIntentResult, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, createEvmChain, createQueryClient, encodeStateMachineId, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract };
+export { ADDRESS_ZERO, AssetTeleported, AvailableLiquiditySnapshot, Bid, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type CancelEvent, CancelOrderOptions, CancelQuote, ChainConfigService, ClientConfig, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, DecodedOrderPlacedLog, DecodedPostRequestEvent, DecodedPostResponseEvent, ERC20Method, ERC7821Call, ERC7821_BATCH_MODE, EstimateFillOrderParams, EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, FillOrderEstimate, FillerBid, GetRequestWithStatus, HexString, HyperFungibleToken, HyperFungibleTokenABI, type HyperbridgeTxEvents, IChain, IEvmChain, IEvmConfig, IGetRequest, IIsmpMessage, IMessage, IPharosConfig, IPolkadotHubConfig, IPostRequest, IProof, IndexerQueryClient, IntentGateway, type IntentGatewayContext, IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidPhantomSnapshotError, IsmpClient, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, Order, OrderStatus, OrderStatusChecker, OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, PackedUserOperation, type Params, type PhantomSnapshotIntentQuoteMetadata, type PhantomSnapshotQuoteIntentResult, PhantomSnapshotUnavailableError, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, PostRequestTimeoutStatus, PostRequestWithStatus, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestStatusWithMetadata, ResponseCommitmentWithValues, ResumeIntentOrderOptions, RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SelectBidResult, StateMachineHeight, StateMachineIdParams, StateMachineUpdate, SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TokenGateway, TokenGatewayAssetTeleportedWithStatus, Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolKey, type UniswapV4QuoteIntentResult, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, createEvmChain, createQueryClient, encodeStateMachineId, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract };

package/dist/node/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IChain, H as HexString, a as IEvmConfig, C as ChainConfigService, b as IMessage, S as StateMachineIdParams, c as StateMachineHeight, d as IIsmpMessage, e as IPostRequest, f as IGetRequest, O as Order, E as EstimateGasCallData, R as RetryConfig, g as IPolkadotHubConfig, h as IPharosConfig, i as StateMachineUpdate, P as PostRequestWithStatus, G as GetRequestWithStatus, j as ResponseCommitmentWithValues, k as RequestStatusWithMetadata, l as PostRequestTimeoutStatus, m as SubstrateChain, n as ClientConfig, o as IndexerQueryClient, A as AssetTeleported, T as Transaction, p as IProof, q as IEvmChain, r as IntentsCoprocessor, s as IntentOrderStatusUpdate, t as SelectBidResult, u as ResumeIntentOrderOptions, v as CancelOrderOptions, w as CancelQuote, x as SubmitBidOptions, y as PackedUserOperation, F as FillerBid, B as Bid, z as EstimateFillOrderParams, D as FillOrderEstimate, J as ERC7821Call, K as OrderWithStatus, L as OrderStatus, M as TokenGatewayAssetTeleportedWithStatus, N as TeleportStatus, Q as DecodedOrderPlacedLog, U as DecodedPostRequestEvent, V as DecodedPostResponseEvent } from './IntentGatewayV2-PzbhFn_7.js';
-export { W as AllStatusKey, X as AssetTeleportedResponse, Y as BidStorageEntry, Z as BidSubmissionResult, _ as BlockMetadata, $ as BytesLikeHex, a0 as CancelOptions, a1 as ChainConfig, a2 as ChainConfigData, a3 as Chains, a4 as ConfiguredAssetSymbol, a5 as Deployment, a6 as DispatchGet, a7 as DispatchInfo, a8 as DispatchPost, a9 as ExecuteIntentOrderOptions, aa as ExecutionResult, ab as FillOptions, ac as FillerConfig, ad as GetRequestResponse, ae as GetResponseByRequestIdResponse, af as GetResponseStorageValues, ag as HostParams, ah as HyperClientStatus, ai as IBatchConsensusAndGetResponseMessage, aj as IBatchConsensusAndPostRequestMessage, ak as IConfig, al as IConsensusMessage, am as IGetRequestMessage, an as IGetResponse, ao as IGetResponseMessage, ap as IHyperbridgeConfig, aq as IPostResponse, ar as IRequestMessage, as as ISubstrateConfig, at as ITimeoutPostRequestMessage, au as IntentGatewayABI, av as IntentGatewayParams, aw as IntentOrderStatus, ax as IntentOrderStatusKey, ay as IsmpRequest, az as OrderResponse, aA as OrderStatusMetadata, aB as PaymentInfo, aC as PhantomOrderEvent, aD as PhantomOrderPriceSnapshot, aE as PhantomOrderPriceSnapshotsResponse, aF as PostRequestStatus, aG as RequestBody, aH as RequestCommitment, aI as RequestKind, aJ as RequestResponse, aK as RequestStatus, aL as RequestStatusKey, aM as SelectOptions, aN as SigningAccount, aO as StateMachineId, aP as StateMachineResponse, aQ as StorageFacade, aR as TimeoutStatus, aS as TimeoutStatusKey, aT as TokenGatewayAssetTeleportedResponse, aU as TokenInfo, aV as TokenPrice, aW as TokenPricesResponse, aX as UniswapV4PoolConfigData, aY as chainConfigs, aZ as convertCodecToIGetRequest, a_ as convertCodecToIProof, a$ as convertIGetRequestToCodec, b0 as convertIProofToCodec, b1 as convertStateIdToStateMachineId, b2 as convertStateMachineEnumToString, b3 as convertStateMachineIdToEnum, b4 as decodeERC7821ExecuteBatch, b5 as decodeUserOpScale, b6 as encodeERC7821ExecuteBatch, b7 as encodeISMPMessage, b8 as encodeUserOpScale, b9 as getChainId, ba as getConfigByStateMachineId, bb as getViemChain, bc as hyperbridgeAddress, bd as pharosAtlantic, be as pharosMainnet, bf as polkadotAssetHubPaseo, bg as polkadotHubMainnet, bh as tronChainIds, bi as tronNile } from './IntentGatewayV2-PzbhFn_7.js';
+import { I as IChain, H as HexString, a as IEvmConfig, C as ChainConfigService, b as IMessage, S as StateMachineIdParams, c as StateMachineHeight, d as IIsmpMessage, e as IPostRequest, f as IGetRequest, O as Order, E as EstimateGasCallData, R as RetryConfig, g as IPolkadotHubConfig, h as IPharosConfig, i as StateMachineUpdate, P as PostRequestWithStatus, G as GetRequestWithStatus, j as ResponseCommitmentWithValues, k as RequestStatusWithMetadata, l as PostRequestTimeoutStatus, m as SubstrateChain, n as ClientConfig, o as IndexerQueryClient, A as AssetTeleported, T as Transaction, p as IProof, q as IEvmChain, r as IntentsCoprocessor, s as AvailableLiquiditySnapshot, t as IntentOrderStatusUpdate, u as SelectBidResult, v as ResumeIntentOrderOptions, w as CancelOrderOptions, x as CancelQuote, y as SubmitBidOptions, z as PackedUserOperation, F as FillerBid, B as Bid, D as EstimateFillOrderParams, J as FillOrderEstimate, K as ERC7821Call, L as OrderWithStatus, M as OrderStatus, N as TokenGatewayAssetTeleportedWithStatus, Q as TeleportStatus, U as DecodedOrderPlacedLog, V as DecodedPostRequestEvent, W as DecodedPostResponseEvent } from './IntentGatewayV2-tYGohDdW.js';
+export { X as AllStatusKey, Y as AssetTeleportedResponse, Z as AvailableLiquidityByChain, _ as BidStorageEntry, $ as BidSubmissionResult, a0 as BlockMetadata, a1 as BytesLikeHex, a2 as CancelOptions, a3 as ChainConfig, a4 as ChainConfigData, a5 as Chains, a6 as ConfiguredAssetSymbol, a7 as Deployment, a8 as DispatchGet, a9 as DispatchInfo, aa as DispatchPost, ab as ExecuteIntentOrderOptions, ac as ExecutionResult, ad as FillOptions, ae as FillerConfig, af as GetRequestResponse, ag as GetResponseByRequestIdResponse, ah as GetResponseStorageValues, ai as HostParams, aj as HyperClientStatus, ak as IBatchConsensusAndGetResponseMessage, al as IBatchConsensusAndPostRequestMessage, am as IConfig, an as IConsensusMessage, ao as IGetRequestMessage, ap as IGetResponse, aq as IGetResponseMessage, ar as IHyperbridgeConfig, as as IPostResponse, at as IRequestMessage, au as ISubstrateConfig, av as ITimeoutPostRequestMessage, aw as IntentGatewayABI, ax as IntentGatewayParams, ay as IntentOrderStatus, az as IntentOrderStatusKey, aA as IsmpRequest, aB as OrderResponse, aC as OrderStatusMetadata, aD as PaymentInfo, aE as PhantomOrderEvent, aF as PhantomOrderPriceSnapshot, aG as PhantomOrderPriceSnapshotsResponse, aH as PollPhantomOrdersOptions, aI as PostRequestStatus, aJ as RequestBody, aK as RequestCommitment, aL as RequestKind, aM as RequestResponse, aN as RequestStatus, aO as RequestStatusKey, aP as SelectOptions, aQ as SigningAccount, aR as StateMachineId, aS as StateMachineResponse, aT as StorageFacade, aU as TimeoutStatus, aV as TimeoutStatusKey, aW as TokenGatewayAssetTeleportedResponse, aX as TokenInfo, aY as TokenPrice, aZ as TokenPricesResponse, a_ as UniswapV4PoolConfigData, a$ as chainConfigs, b0 as convertCodecToIGetRequest, b1 as convertCodecToIProof, b2 as convertIGetRequestToCodec, b3 as convertIProofToCodec, b4 as convertStateIdToStateMachineId, b5 as convertStateMachineEnumToString, b6 as convertStateMachineIdToEnum, b7 as decodeERC7821ExecuteBatch, b8 as decodeUserOpScale, b9 as encodeERC7821ExecuteBatch, ba as encodeISMPMessage, bb as encodeUserOpScale, bc as getChainId, bd as getConfigByStateMachineId, be as getViemChain, bf as hyperbridgeAddress, bg as pharosAtlantic, bh as pharosMainnet, bi as polkadotAssetHubPaseo, bj as polkadotHubMainnet, bk as tronChainIds, bl as tronNile } from './IntentGatewayV2-tYGohDdW.js';
 import { ConsolaInstance } from 'consola';
 import { GraphQLClient } from 'graphql-request';
 import { PublicClient, TransactionReceipt, Hex, Address } from 'viem';
@@ -364,6 +364,10 @@ declare function normalizeEvmChainId(chainId: number | string): {
 };
 declare function encodeStateMachineId(stateMachineId: string): HexString;
 declare function normalizeAddressForEvmBytes32(address: string): HexString;
+/**
+ * Validates an EVM address and returns its canonical lowercase representation.
+ */
+declare function normalizeEvmAddress(address: string, field?: string): HexString;
 declare function normalizeAddressForStateMachine(address: string, stateMachineId: string): HexString;
 /**
  * Retries a promise-returning operation with exponential backoff.
@@ -1599,9 +1603,9 @@ interface BundlerGasEstimate {
  * - `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.
- * - `CANCELLATION_COMPLETE` – the escrow has been refunded; cancellation is done.
+    * - `HYPERBRIDGE_DELIVERED` – the cancel message has been delivered to Hyperbridge.
+    * - `HYPERBRIDGE_FINALIZED` – the cancel message has been finalised on Hyperbridge.
+    * - `CANCELLATION_COMPLETE` – the escrow has been refunded; cancellation is done.
  */
 type CancelEvent = {
     status: "DESTINATION_FINALIZED";
@@ -1840,6 +1844,8 @@ declare class IntentGateway {
     private readonly gasEstimator;
     /** Quote strategies for pricing orders before placement, keyed by strategy name. */
     private readonly quoteStrategies;
+    /** Resolves order tokens to canonical Phantom snapshot market pairs. */
+    private readonly phantomSnapshotPairResolver;
     /**
      * Private constructor — use {@link IntentGateway.create} instead.
      *
@@ -1894,13 +1900,25 @@ declare class IntentGateway {
      * @throws {PhantomSnapshotUnavailableError} When an eligible cNGN pair has no snapshot.
      */
     quoteIntent(params: QuoteIntentParams): Promise<QuoteIntentResult>;
+    /**
+     * Returns the output-token liquidity measured in the latest directional
+     * Phantom snapshot for this gateway's source and destination.
+     *
+     * Pair resolution uses the same canonical Base market as {@link quoteIntent}.
+     * The snapshot itself determines the output token and chain to aggregate. The
+     * amount is in the token's smallest unit and reflects the indexer's
+     * `snapshotTime`; it is not a live reservation or fill guarantee.
+     *
+     * Requires a prior call to {@link withQueryClient}.
+     */
+    queryAvailableLiquidity(params: Pick<QuoteIntentParams, "tokenIn" | "tokenOut">): Promise<AvailableLiquiditySnapshot | undefined>;
     /**
      * Bidirectional async generator that orchestrates the full order lifecycle:
      * placement, fee estimation, bid collection, and execution.
      *
      * **Yield/receive protocol:**
-     * 1. If `order.fees` is unset or zero, estimates gas and sets same-chain
-     *    `order.fees` to twice the estimate. Cross-chain orders retain a 1% buffer
+     * 1. If `order.fees` is unset or zero, estimates gas on an internal copy and sets
+     *    same-chain fees to twice the estimate. Cross-chain orders retain a 1% buffer
      *    and include an additional 600k-gas fee uplift, while the wei cost used for
      *    the `value` field receives a 2% buffer.
      * 2. Yields `AWAITING_PLACE_ORDER` with `{ to, data, value, sessionPrivateKey }`.
@@ -1910,8 +1928,8 @@ declare class IntentGateway {
      * 4. Delegates to {@link OrderExecutor.executeOrder} and forwards all
      *    subsequent status updates until the order is filled, exhausted, or fails.
      *
-     * @param order - The order to place and execute. `order.fees` may be 0; it
-     *   will be estimated automatically if so.
+     * @param order - The order to place and execute. It is not mutated. `order.fees`
+     *   may be 0; fees are estimated automatically if so.
      * @param graffiti - Optional bytes32 tag for orderflow attribution /
      *   revenue share. Defaults to {@link DEFAULT_GRAFFITI}.
      * @param options - Optional tuning parameters:
@@ -6003,4 +6021,4 @@ declare function teleport(teleport_param: {
     extrinsics?: Array<SubmittableExtrinsic<"promise", ISubmittableResult>>;
 }): Promise<ReadableStream<HyperbridgeTxEvents>>;
 
-export { ADDRESS_ZERO, AssetTeleported, Bid, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type CancelEvent, CancelOrderOptions, CancelQuote, ChainConfigService, ClientConfig, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, DecodedOrderPlacedLog, DecodedPostRequestEvent, DecodedPostResponseEvent, ERC20Method, ERC7821Call, ERC7821_BATCH_MODE, EstimateFillOrderParams, EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, FillOrderEstimate, FillerBid, GetRequestWithStatus, HexString, HyperFungibleToken, HyperFungibleTokenABI, type HyperbridgeTxEvents, IChain, IEvmChain, IEvmConfig, IGetRequest, IIsmpMessage, IMessage, IPharosConfig, IPolkadotHubConfig, IPostRequest, IProof, IndexerQueryClient, IntentGateway, type IntentGatewayContext, IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidPhantomSnapshotError, IsmpClient, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, Order, OrderStatus, OrderStatusChecker, OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, PackedUserOperation, type Params, type PhantomSnapshotIntentQuoteMetadata, type PhantomSnapshotQuoteIntentResult, PhantomSnapshotUnavailableError, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, PostRequestTimeoutStatus, PostRequestWithStatus, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestStatusWithMetadata, ResponseCommitmentWithValues, ResumeIntentOrderOptions, RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SelectBidResult, StateMachineHeight, StateMachineIdParams, StateMachineUpdate, SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TokenGateway, TokenGatewayAssetTeleportedWithStatus, Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolKey, type UniswapV4QuoteIntentResult, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, createEvmChain, createQueryClient, encodeStateMachineId, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract };
+export { ADDRESS_ZERO, AssetTeleported, AvailableLiquiditySnapshot, Bid, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type CancelEvent, CancelOrderOptions, CancelQuote, ChainConfigService, ClientConfig, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, DecodedOrderPlacedLog, DecodedPostRequestEvent, DecodedPostResponseEvent, ERC20Method, ERC7821Call, ERC7821_BATCH_MODE, EstimateFillOrderParams, EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, FillOrderEstimate, FillerBid, GetRequestWithStatus, HexString, HyperFungibleToken, HyperFungibleTokenABI, type HyperbridgeTxEvents, IChain, IEvmChain, IEvmConfig, IGetRequest, IIsmpMessage, IMessage, IPharosConfig, IPolkadotHubConfig, IPostRequest, IProof, IndexerQueryClient, IntentGateway, type IntentGatewayContext, IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidPhantomSnapshotError, IsmpClient, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, Order, OrderStatus, OrderStatusChecker, OrderWithStatus, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, PackedUserOperation, type Params, type PhantomSnapshotIntentQuoteMetadata, type PhantomSnapshotQuoteIntentResult, PhantomSnapshotUnavailableError, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, PostRequestTimeoutStatus, PostRequestWithStatus, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestStatusWithMetadata, ResponseCommitmentWithValues, ResumeIntentOrderOptions, RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SelectBidResult, StateMachineHeight, StateMachineIdParams, StateMachineUpdate, SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TokenGateway, TokenGatewayAssetTeleportedWithStatus, Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolKey, type UniswapV4QuoteIntentResult, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, createEvmChain, createQueryClient, encodeStateMachineId, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, responseCommitmentKey, retryPromise, teleport, teleportDot, transformOrderForContract };