@hyperbridge/sdk 2.8.13 → 2.8.17

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 Chains, t as ConfiguredAssetSymbol, u as AvailableLiquidity, Q as QueryBuyAndSellRatesParams, B as BuyAndSellRates, v as IntentOrderStatusUpdate, w as SelectBidResult, x as ResumeIntentOrderOptions, y as CancelOrderOptions, z as CancelQuote, D as SubmitBidOptions, F as PackedUserOperation, J as FillerBid, K as Bid, L as EstimateFillOrderParams, M as FillOrderEstimate, N as OrderFeesQuote, U as ERC7821Call, V as OrderWithStatus, W as OrderStatus, X as TokenGatewayAssetTeleportedWithStatus, Y as TeleportStatus, Z as DecodedOrderPlacedLog, _ as DecodedPostRequestEvent, $ as DecodedPostResponseEvent } from './intents-helpers-fntBuoYM.cjs';
-export { a0 as AllStatusKey, a1 as AssetTeleportedResponse, a2 as BidStorageEntry, a3 as BidSubmissionResult, a4 as BlockMetadata, a5 as BytesLikeHex, a6 as CHAINS_WITHOUT_VALID_UNTIL, a7 as CancelOptions, a8 as ChainConfig, a9 as ChainConfigData, aa as ConfiguredAssetSymbolInput, ab as Deployment, ac as DispatchGet, ad as DispatchInfo, ae as DispatchPost, af as Erc4626VaultConfigData, ag as ExecuteIntentOrderOptions, ah as ExecutionResult, ai as FILL_ORDER_V1_ABI, aj as FillOptions, ak as FillOptionsVersion, al as FillerConfig, am as GetRequestResponse, an as GetResponseByRequestIdResponse, ao as GetResponseStorageValues, ap as HostParams, aq as HyperClientStatus, ar as IBatchConsensusAndGetResponseMessage, as as IBatchConsensusAndPostRequestMessage, at as IConfig, au as IConsensusMessage, av as IGetRequestMessage, aw as IGetResponse, ax as IGetResponseMessage, ay as IHyperbridgeConfig, az as INCLUSION_TIMEOUT_MS, aA as IPostResponse, aB as IRequestMessage, aC as ISubstrateConfig, aD as ITimeoutPostRequestMessage, aE as IntentGatewayABI, aF as IntentGatewayParams, aG as IntentOrderStatus, aH as IntentOrderStatusKey, aI as IsmpRequest, aJ as LEGACY_FILL_OPTIONS_IMPLEMENTATIONS, aK as LiquiditySlice, aL as OrderResponse, aM as OrderStatusMetadata, aN as PERMIT2_SPONSORSHIP_BYTES, aO as PaymentInfo, aP as PhantomBid, aQ as PhantomBidBatchResult, aR as PhantomBidDeclaration, aS as PhantomBidOutcome, aT as PhantomBidPaymasterAndData, aU as PhantomBidSponsorship, aV as PhantomOrderEvent, aW as PhantomOrderLeg, aX as PhantomOrderPriceSnapshot, aY as PhantomOrderPriceSnapshotsResponse, aZ as PhantomTimings, a_ as PollPhantomOrdersOptions, a$ as PostRequestStatus, b0 as RequestBody, b1 as RequestCommitment, b2 as RequestKind, b3 as RequestResponse, b4 as RequestStatus, b5 as RequestStatusKey, b6 as SelectOptions, b7 as SigningAccount, b8 as StateMachineId, b9 as StateMachineResponse, ba as StorageFacade, bb as TimeoutStatus, bc as TimeoutStatusKey, bd as TokenGatewayAssetTeleportedResponse, be as TokenInfo, bf as TokenPrice, bg as TokenPricesResponse, bh as UNISWAP_QUOTE_HAIRCUT_BPS, bi as UniswapV4PoolConfigData, bj as applyProtocolFeeHaircut, bk as applyUniswapQuoteHaircut, bl as chainConfigs, bm as convertCodecToIGetRequest, bn as convertCodecToIProof, bo as convertIGetRequestToCodec, bp as convertIProofToCodec, bq as convertStateIdToStateMachineId, br as convertStateMachineEnumToString, bs as convertStateMachineIdToEnum, bt as decodeAcceptedSourceChains, bu as decodeERC7821ExecuteBatch, bv as decodeFillOrder, bw as decodePhantomBidDeclaration, bx as decodePhantomBidPaymasterAndData, by as decodeUserOpScale, bz as deriveHttpUrl, bA as encodeAcceptedSourceChains, bB as encodeERC7821ExecuteBatch, bC as encodeFillOrder, bD as encodeISMPMessage, bE as encodePhantomBidDeclaration, bF as encodePhantomBidPaymasterAndData, bG as encodeUserOpScale, bH as getChainId, bI as getConfigByStateMachineId, bJ as getFillOptionsVersion, bK as getViemChain, bL as hyperbridgeAddress, bM as pharosAtlantic, bN as pharosMainnet, bO as polkadotAssetHubPaseo, bP as polkadotHubMainnet, bQ as poolSlug, bR as readProtocolFeeHaircutBps, bS as resetFillOptionsVersionCache, bT as sortPoolSymbols, bU as tronChainIds, bV as tronNile } from './intents-helpers-fntBuoYM.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 Chains, t as ConfiguredAssetSymbol, Q as QueryBuyAndSellRatesParams, u as IntentOrderStatusUpdate, v as SelectBidResult, w as ResumeIntentOrderOptions, x as CancelOrderOptions, y as CancelQuote, z as SubmitBidOptions, B as PackedUserOperation, F as FillerBid, D as Bid, J as EstimateFillOrderParams, K as FillOrderEstimate, L as OrderFeesQuote, M as ERC7821Call, N as TokenInfo, U as OrderWithStatus, V as OrderStatus, W as FillOptions, X as TokenGatewayAssetTeleportedWithStatus, Y as TeleportStatus, Z as DecodedOrderPlacedLog, _ as DecodedPostRequestEvent, $ as DecodedPostResponseEvent } from './intents-helpers-BHl2If1T.cjs';
+export { a0 as AllStatusKey, a1 as AssetTeleportedResponse, a2 as BidStorageEntry, a3 as BidSubmissionResult, a4 as BlockMetadata, a5 as BytesLikeHex, a6 as CancelOptions, a7 as ChainConfig, a8 as ChainConfigData, a9 as ConfiguredAssetSymbolInput, aa as Deployment, ab as DispatchGet, ac as DispatchInfo, ad as DispatchPost, ae as Erc4626VaultConfigData, af as ExecuteIntentOrderOptions, ag as ExecutionResult, ah as FillerConfig, ai as GetRequestResponse, aj as GetResponseByRequestIdResponse, ak as GetResponseStorageValues, al as HostParams, am as HyperClientStatus, an as IBatchConsensusAndGetResponseMessage, ao as IBatchConsensusAndPostRequestMessage, ap as IConfig, aq as IConsensusMessage, ar as IGetRequestMessage, as as IGetResponse, at as IGetResponseMessage, au as IHyperbridgeConfig, av as INCLUSION_TIMEOUT_MS, aw as IPostResponse, ax as IRequestMessage, ay as ISubstrateConfig, az as ITimeoutPostRequestMessage, aA as IntentGatewayABI, aB as IntentGatewayParams, aC as IntentOrderStatus, aD as IntentOrderStatusKey, aE as IsmpRequest, aF as MAX_DECLARED_ENTRIES, aG as OrderResponse, aH as OrderStatusMetadata, aI as PERMIT2_SPONSORSHIP_BYTES, aJ as PaymentInfo, aK as PhantomBidDeclaration, aL as PhantomBidPaymasterAndData, aM as PhantomBidSponsorship, aN as PostRequestStatus, aO as RequestBody, aP as RequestCommitment, aQ as RequestKind, aR as RequestResponse, aS as RequestStatus, aT as RequestStatusKey, aU as RpcBidInfo, aV as SelectOptions, aW as SigningAccount, aX as StateMachineId, aY as StateMachineResponse, aZ as StorageFacade, a_ as TimeoutStatus, a$ as TimeoutStatusKey, b0 as TokenGatewayAssetTeleportedResponse, b1 as TokenPrice, b2 as TokenPricesResponse, b3 as chainConfigs, b4 as convertCodecToIGetRequest, b5 as convertCodecToIProof, b6 as convertIGetRequestToCodec, b7 as convertIProofToCodec, b8 as convertStateIdToStateMachineId, b9 as convertStateMachineEnumToString, ba as convertStateMachineIdToEnum, bb as decodeAcceptedSourceChains, bc as decodeERC7821ExecuteBatch, bd as decodePhantomBidDeclaration, be as decodePhantomBidPaymasterAndData, bf as decodeUserOpScale, bg as deriveHttpUrl, bh as encodeAcceptedSourceChains, bi as encodeERC7821ExecuteBatch, bj as encodeISMPMessage, bk as encodePhantomBidDeclaration, bl as encodePhantomBidPaymasterAndData, bm as encodeUserOpScale, bn as getChainId, bo as getConfigByStateMachineId, bp as getViemChain, bq as hyperbridgeAddress, br as pharosAtlantic, bs as pharosMainnet, bt as polkadotAssetHubPaseo, bu as polkadotHubMainnet, bv as poolSlug, bw as sortPoolSymbols, bx as tronChainIds, by as tronNile } from './intents-helpers-BHl2If1T.cjs';
 import { ConsolaInstance } from 'consola';
 import { GraphQLClient } from 'graphql-request';
 import { PublicClient, TransactionReceipt, Hex, Address } from 'viem';
@@ -12,7 +12,6 @@ export { Account as ViemAccount } from 'viem/accounts';
 import 'decimal.js';
 import 'viem/chains';
 import '@polkadot/keyring/types';
-import '@polkadot/types/interfaces';
 
 /**
  * The default address used as fallback when no address is provided.
@@ -1680,152 +1679,350 @@ interface IntentGatewayContext {
     swap: Swap;
 }
 
-type IntentQuoteStrategy = "indexed_rates" | "uniswap_v4" | "phantom_snapshot";
-type IntentQuoteTradeType = "EXACT_INPUT" | "EXACT_OUTPUT";
-type IndexedRateSide = "buy" | "sell";
+/** The HyperFX orderbook deployments, one per network. */
+declare const ORDERBOOK_URLS: {
+    readonly mainnet: "https://orderbook.hyperfx.finance/mainnet/graphql";
+    readonly testnet: "https://orderbook.hyperfx.finance/testnet/graphql";
+};
+/** The orderbook deployment that serves `stateMachineId`: the testnet book for a testnet chain, else mainnet. */
+declare function orderbookUrlFor(stateMachineId: string): string;
+/** Every amount and rate the orderbook takes or returns is fixed-point at 1e18, whatever the token's decimals. */
+declare const ORDERBOOK_DECIMALS = 18;
+/** `BID` takes a swap selling the book's base; `ASK` takes a swap buying it. */
+type OrderbookSide = "BID" | "ASK";
+/** `SAME_CHAIN` is served by every order on the chain; `CROSS_CHAIN` only by orders declaring the source. */
+type OrderbookRouteKind = "SAME_CHAIN" | "CROSS_CHAIN";
+/** A swap route, by token symbol and state machine id (`EVM-8453`). */
+interface OrderbookRoute {
+    tokenIn: string;
+    tokenOut: string;
+    /** Where the swapper's `tokenIn` is escrowed. */
+    sourceChain: string;
+    /** Where `tokenOut` is delivered, which is the chain the order is filled on. */
+    destinationChain: string;
+}
+/** A configured book. Every rate on it is `quote` per 1 `base`. */
+interface OrderbookBook {
+    id: string;
+    base: string;
+    quote: string;
+}
+/** The best price level for one direction on one fill chain. Amounts and rates at 1e18. */
+interface OrderbookRate {
+    side: OrderbookSide;
+    fillChain: string;
+    /** The level's best single-order price, quote per 1 base. */
+    rate: bigint;
+    /** Virtual depth: the level's summed order sizes, in tokenIn and tokenOut. */
+    depthIn: bigint;
+    depthOut: bigint;
+    /** True liquidity: each solver's largest validated order in the level, summed, in tokenOut. */
+    backingLiquidity: bigint;
+    sourceChains: string[];
+    orderCount: number;
+    solverCount: number;
+}
+/** What a route holds, without an amount. Amounts and rates at 1e18. */
+interface OrderbookRouteLiquidity {
+    route: OrderbookRouteKind;
+    /** The book the route trades on, which names the units of `bestRate`. */
+    book: OrderbookBook;
+    /** `BID` when tokenIn is the book's base, `ASK` when it is the quote. */
+    side: OrderbookSide;
+    /** Quote per 1 base, before the protocol fee; null when no order serves the route. */
+    bestRate: bigint | null;
+    /** The destination chain's protocol fee in basis points, which the gateway takes out of what the orders deliver. */
+    slippageBps: number;
+    /** Virtual depth: the serving orders' sizes summed, in tokenIn and tokenOut. */
+    depthIn: bigint;
+    depthOut: bigint;
+    /** True liquidity in tokenOut: each serving solver's largest validated order, summed. */
+    availableLiquidity: bigint;
+    /** The largest tokenIn amount the route could fill with its orders combined. */
+    maxFillableIn: bigint;
+    orderCount: number;
+    solverCount: number;
+}
+/** One order an optimistic quote takes, at the order's own price. Amounts and rates at 1e18. */
+interface OrderbookQuoteFill {
+    /** The order's full advertised size, not just the part this fill takes. */
+    advertisedSize: bigint;
+    /** The order's own price, quote per 1 base, before the protocol fee: what this fill settles at. */
+    orderRate: bigint;
+    /** The tokenIn this fill takes, in whole raw units on the source chain. */
+    amountIn: bigint;
+    /** The tokenOut this fill delivers, after the protocol fee, floored to a whole raw unit on the destination chain. */
+    amountOut: bigint;
+}
 /**
- * Full Uniswap V4 PoolKey. V4 pools cannot be discovered from a token pair alone.
+ * An optimistic quote for an input amount on a route: the trade split across the route's orders,
+ * best price first, each at its own price. There is no one rate and no total output; the fills are
+ * the quote. Amounts and rates at 1e18.
  */
-interface UniswapV4PoolKey {
-    currency0: HexString;
-    currency1: HexString;
-    fee: number;
-    tickSpacing: number;
-    hooks: HexString;
+interface OrderbookSwapQuote {
+    route: OrderbookRouteKind;
+    side: OrderbookSide;
+    /** The tokenIn priced, floored to a whole raw unit on the source chain. */
+    amountIn: bigint;
+    /** The destination chain's protocol fee in basis points, already taken off every fill's `amountOut`. */
+    slippageBps: number;
+    fillable: boolean;
+    /** The largest tokenIn amount the route's orders could take together, each at its own price. */
+    maxFillableIn: bigint;
+    /** The orders used, best price first; empty when not fillable. */
+    fills: OrderbookQuoteFill[];
 }
-interface UniswapV4IntentQuoteOptions {
-    /** Explicit pool override for pairs not yet present in SDK chain config. */
-    poolKey?: UniswapV4PoolKey & {
-        quoterAddress?: HexString;
-        /**
-         * Destination-side address of the input currency. Defaults to
-         * `tokenIn`, which only works for same-chain quotes; pass this
-         * explicitly when source and destination chains differ. Must equal
-         * `currency0` or `currency1`.
-         */
-        currencyIn?: HexString;
-    };
+/**
+ * A pessimistic quote for an input amount on a route: one price, from the first level, best first,
+ * deep enough to fill the whole trade by itself, or else the route's worst price when its levels
+ * together can. Amounts and rates at 1e18.
+ */
+interface OrderbookLevelQuote {
+    route: OrderbookRouteKind;
+    side: OrderbookSide;
+    /** The tokenIn priced, floored to a whole raw unit on the source chain. */
+    amountIn: bigint;
+    /** The tokenOut delivered at `rate`, after the protocol fee, floored to a whole raw unit on the destination chain; 0 when not fillable. */
+    amountOut: bigint;
+    /** The worst single-order price in the level that fills it, quote per 1 base, before the protocol fee; null when not fillable. */
+    rate: bigint | null;
+    /** The price bucket of that level; null when not fillable. */
+    priceBucket: bigint | null;
+    /** The destination chain's protocol fee in basis points, already taken off `amountOut`. */
+    slippageBps: number;
+    fillable: boolean;
+    /** The largest tokenIn amount this quote could fill: any one level at its worst price, or the whole route at its worst. */
+    maxFillableIn: bigint;
 }
+/** The best bid and ask a route can reach, with the book that orients them. */
+interface OrderbookTopOfBook {
+    book: OrderbookBook;
+    /** Highest bid: the most quote a seller of 1 base receives. */
+    bid: OrderbookRate | null;
+    /** Lowest ask: the least quote a buyer of 1 base pays. */
+    ask: OrderbookRate | null;
+}
+/** The orderbook could not answer: a transport failure, or a GraphQL error such as a pair no book trades. */
+declare class OrderbookRequestError extends Error {
+    constructor(message: string);
+}
+/** Every document the client sends, so they can be checked against the orderbook's published schema. */
+declare const ORDERBOOK_QUERIES: {
+    readonly topOfBook: "\nquery TopOfBook($tokenA: String!, $tokenB: String!, $fillChain: String!, $sourceChain: String!) {\n  books { id base quote }\n  aToB: bestRate(tokenIn: $tokenA, tokenOut: $tokenB, fillChain: $fillChain, sourceChain: $sourceChain) { side fillChain rate depthIn depthOut backingLiquidity sourceChains orderCount solverCount }\n  bToA: bestRate(tokenIn: $tokenB, tokenOut: $tokenA, fillChain: $fillChain, sourceChain: $sourceChain) { side fillChain rate depthIn depthOut backingLiquidity sourceChains orderCount solverCount }\n}";
+    readonly routeLiquidity: "\nquery RouteLiquidity($route: RouteInput!) {\n  books { id base quote }\n  routeLiquidity(route: $route) {\n    route bestRate slippageBps depthIn depthOut availableLiquidity maxFillableIn orderCount solverCount\n  }\n}";
+    readonly quote: "\nquery Quote($route: RouteInput!, $amountIn: BigInt!) {\n  quote(route: $route, amountIn: $amountIn) {\n    route side amountIn slippageBps fillable maxFillableIn\n    fills { advertisedSize orderRate amountIn amountOut }\n  }\n}";
+    readonly quotePessimistic: "\nquery QuotePessimistic($route: RouteInput!, $amountIn: BigInt!) {\n  quotePessimistic(route: $route, amountIn: $amountIn) {\n    route side amountIn amountOut rate priceBucket slippageBps fillable maxFillableIn\n  }\n}";
+};
 /**
- * Parameters for `IntentGateway.quoteIntent`. The source and destination
- * chains come from the gateway instance itself.
+ * Read-only client for the HyperFX orderbook's GraphQL API.
  *
- * Quotes default to the aggregate pool's `indexed_rates`. Legacy Phantom
- * snapshots and Uniswap V4 remain available as explicit strategies. `tokenIn`
- * and `tokenOut` are token addresses; the SDK resolves configured token
- * metadata and decimals internally. Provide exactly one amount.
+ * Tokens are named by symbol and chains by state machine id. Every amount and
+ * rate is a `bigint` at 1e18, as the orderbook serves it; rates are quote per 1
+ * base of the pair's book.
+ */
+declare class HyperFxOrderbook {
+    private readonly client;
+    /** @param urlOrClient - The orderbook's GraphQL URL, or a configured `graphql-request` client. */
+    constructor(urlOrClient?: string | GraphQLClient);
+    /**
+     * The best bid and ask on `fillChain` for the pair `tokenA`/`tokenB`, counting
+     * only orders a swap from `sourceChain` can use.
+     */
+    topOfBook(params: {
+        tokenA: string;
+        tokenB: string;
+        fillChain: string;
+        sourceChain: string;
+    }): Promise<OrderbookTopOfBook>;
+    /** Total liquidity on a route, no amount required. */
+    routeLiquidity(route: OrderbookRoute): Promise<OrderbookRouteLiquidity>;
+    /**
+     * The optimistic quote for `amountIn` (1e18 tokenIn) on a route: the route's orders, best price
+     * first, each taking what it can at its own price. The fills' `amountOut`s sum to the output.
+     */
+    quote(route: OrderbookRoute, amountIn: bigint): Promise<OrderbookSwapQuote>;
+    /**
+     * The pessimistic quote for `amountIn` (1e18 tokenIn) on a route: one price, from the first level
+     * deep enough to fill the whole trade by itself, at which every order in it fills; the route's
+     * worst price when no one level can but its levels together can.
+     */
+    quotePessimistic(route: OrderbookRoute, amountIn: bigint): Promise<OrderbookLevelQuote>;
+    private request;
+}
+
+/**
+ * Parameters for `IntentGateway.quoteIntent`. The source and destination chains
+ * come from the gateway instance itself. `tokenIn` and `tokenOut` are token
+ * addresses; the SDK resolves their configured symbols and decimals. Provide
+ * exactly one amount, in the token's raw units.
  */
 interface QuoteIntentParams {
-    strategy?: IntentQuoteStrategy;
     /** Token address on the source chain. */
     tokenIn: HexString;
     /** Token address on the destination chain. */
     tokenOut: HexString;
     amountIn?: bigint;
     amountOut?: bigint;
-    uniswapV4?: UniswapV4IntentQuoteOptions;
-}
-interface UniswapV4IntentQuoteMetadata {
-    /** Chain whose Uniswap pool and quoter were used for the quote. */
-    quoteChain: string;
-    poolKey: UniswapV4PoolKey;
-    quoterAddress: HexString;
     /**
-     * IntentGateway protocol fee on the source chain, already applied to the
-     * returned amounts. Exposed so callers can reconstruct the swap-side
-     * (post-fee) amount if needed.
+     * Return the orderbook's optimistic quote (`QuoteIntentResult`): one leg per
+     * order, each at its own price. Defaults to the pessimistic quote
+     * (`PessimisticQuoteIntentResult`): the whole trade at one price.
      */
-    protocolFeeBps: bigint;
-}
-interface PhantomSnapshotIntentQuoteMetadata {
-    /** Canonical chain whose directional Phantom pair addresses identify the feed. */
-    quoteChain: string;
-    /** Phantom order whose bids produced this snapshot. */
-    commitment: HexString;
-    tokenA: HexString;
-    tokenB: HexString;
-    /** Benchmark input and liquidity-weighted median output, both in raw token units. */
-    standardAmount: bigint;
-    medianPrice: bigint;
-    lowestPrice?: bigint;
-    highestPrice?: bigint;
-    blockNumber: bigint;
-    snapshotTime: Date;
-    bidCount: number;
-    /** Source gateway protocol fee already reflected in the returned quote amounts. */
-    protocolFeeBps: bigint;
-}
-interface IndexedRateIntentQuoteMetadata {
-    sourceChain: Chains;
-    destinationChain: Chains;
-    baseTokenSymbol: ConfiguredAssetSymbol;
-    quoteTokenSymbol: ConfiguredAssetSymbol;
-    /** Directional pool rate used for this order. */
-    rateSide: IndexedRateSide;
-    /** Quote-token units per one base token. */
-    rate: string;
-    rateUpdatedAt: Date;
-    /** Source gateway protocol fee already reflected in the returned quote amounts. */
-    protocolFeeBps: bigint;
+    optimistic?: boolean;
 }
 /**
- * Quote data partners need before constructing an IntentGateway V2 order.
- *
- * `amountIn` and `amountOut` already account for the IntentGateway protocol
- * fee that the gateway deducts from order inputs (see `quoteMetadata`). No
- * further fee or slippage adjustment is required before placing the order.
+ * One order an optimistic intent quote takes, at the order's own price. Amounts
+ * are raw token units; the rate stays at 1e18.
  */
-interface UniswapV4QuoteIntentResult {
-    strategy: "uniswap_v4";
-    tradeType: IntentQuoteTradeType;
+interface IntentQuoteLeg {
+    /** The order's full advertised size in `tokenOut`, not just the part this leg takes. */
+    advertisedSize: bigint;
+    /** The order's own price, quote per 1 base at 1e18, before the protocol fee: what this leg settles at. */
+    orderRate: bigint;
+    /** The `tokenIn` this leg takes. The legs' inputs sum to the quote's `amountIn`. */
     amountIn: bigint;
+    /** The `tokenOut` this leg delivers, with the destination's protocol fee already taken off. */
     amountOut: bigint;
-    quoteMetadata: UniswapV4IntentQuoteMetadata;
 }
-interface PhantomSnapshotQuoteIntentResult {
-    strategy: "phantom_snapshot";
-    tradeType: IntentQuoteTradeType;
+/**
+ * `quoteIntent`'s result with `optimistic: true`, the orderbook's optimistic `quote`: the trade split across the
+ * route's orders, best price first, each at its own price. There is no single
+ * rate or total output; the legs are the quote, and their `amountOut`s sum to
+ * what the order should require. Amounts are raw token units.
+ */
+interface QuoteIntentResult {
+    /** `SAME_CHAIN`, or `CROSS_CHAIN` when only orders accepting the source chain can fill it. */
+    route: OrderbookRouteKind;
+    /** `BID` when the order sells the book's base token, `ASK` when it buys it. */
+    side: OrderbookSide;
+    /** The `tokenIn` priced: the requested input, or the input found to deliver the requested output. */
     amountIn: bigint;
-    amountOut: bigint;
-    quoteMetadata: PhantomSnapshotIntentQuoteMetadata;
+    /** The destination's protocol fee in basis points, already taken off every leg's `amountOut`. */
+    slippageBps: number;
+    fillable: boolean;
+    /** The largest `amountIn` the route's orders could take together, each at its own price. */
+    maxFillableIn: bigint;
+    /** The orders used, best price first. */
+    legs: IntentQuoteLeg[];
 }
-interface IndexedRateQuoteIntentResult {
-    strategy: "indexed_rates";
-    tradeType: IntentQuoteTradeType;
+/**
+ * `quoteIntent`'s default result, the orderbook's `quotePessimistic`: the whole trade at one
+ * price, the worst single-order price of the first level, best first, deep
+ * enough to fill it by itself, or the route's worst price when no one level
+ * can. Amounts are raw token units; rates stay at 1e18.
+ */
+interface PessimisticQuoteIntentResult {
+    route: OrderbookRouteKind;
+    side: OrderbookSide;
+    /** The `tokenIn` priced: the requested input, or the input found to deliver the requested output. */
     amountIn: bigint;
+    /** The `tokenOut` delivered at `rate`, with the destination's protocol fee already taken off. */
     amountOut: bigint;
-    quoteMetadata: IndexedRateIntentQuoteMetadata;
+    /** Quote per 1 base, before the protocol fee: every order in the level fills at it. */
+    rate: bigint | null;
+    /** The price bucket of that level. */
+    priceBucket: bigint | null;
+    /** The destination's protocol fee in basis points, already taken off `amountOut`. */
+    slippageBps: number;
+    fillable: boolean;
+    /** The largest `amountIn` this quote could fill: any one level at its worst price, or the whole route at its worst. */
+    maxFillableIn: bigint;
 }
-type QuoteIntentResult = IndexedRateQuoteIntentResult | UniswapV4QuoteIntentResult | PhantomSnapshotQuoteIntentResult;
-declare class UnsupportedIntentQuoteStrategyError extends Error {
-    constructor(strategy: string);
+/**
+ * What the orderbook holds for one route, with no amount given. Amounts are
+ * decimal strings in whole tokens.
+ */
+interface AvailableLiquidity {
+    sourceChain: Chains;
+    destinationChain: Chains;
+    tokenInSymbol: ConfiguredAssetSymbol;
+    tokenOutSymbol: ConfiguredAssetSymbol;
+    /** `tokenOut` on the destination chain. */
+    tokenAddress: HexString;
+    route: OrderbookRouteKind;
+    side: OrderbookSide;
+    baseTokenSymbol: ConfiguredAssetSymbol;
+    quoteTokenSymbol: ConfiguredAssetSymbol;
+    /** The best rate on the route in quote-token units per one base token, or `null` when no order serves it. */
+    bestRate: string | null;
+    /** True liquidity in `tokenOut`: each serving solver's largest balance-checked order, summed. */
+    availableLiquidity: string;
+    /** Virtual depth: every serving order's size summed, in `tokenIn` and `tokenOut`. Can exceed what solvers hold. */
+    depthIn: string;
+    depthOut: string;
+    /** The largest `tokenIn` amount the route could fill with its orders combined. */
+    maxFillableIn: string;
+    orderCount: number;
+    solverCount: number;
 }
-declare class UnsupportedIntentQuotePairError extends Error {
-    constructor(params: {
-        source: string;
-        destination: string;
-        tokenIn: HexString;
-        tokenOut: HexString;
-        quoteSource?: string;
-    });
+/**
+ * The best bid and ask for a pair on a route, in quote-token units per one base
+ * token, as decimal strings. Either side is `null` while it has no orders.
+ */
+interface BuyAndSellRates {
+    baseTokenSymbol: ConfiguredAssetSymbol;
+    quoteTokenSymbol: ConfiguredAssetSymbol;
+    sourceChain: Chains;
+    destinationChain: Chains;
+    /** Highest bid: the quote token a seller receives per one base token. */
+    bid: string | null;
+    /** Lowest ask: the quote token a buyer pays per one base token. */
+    ask: string | null;
+    /** Midpoint of `bid` and `ask`; `null` unless both sides have orders. */
+    mid: string | null;
+    /** `ask - bid`; `null` when a side is empty or the book is crossed. */
+    spread: string | null;
+    /** `spread` over `mid` in basis points, to two decimal places. */
+    spreadBps: number | null;
 }
-declare class PhantomSnapshotUnavailableError extends Error {
-    constructor(tokenA: HexString, tokenB: HexString);
+declare class UnsupportedLiquidityAssetError extends Error {
+    constructor(chain: string, asset: string);
 }
-declare class InvalidPhantomSnapshotError extends Error {
-    constructor(commitment: HexString, reason: string);
+declare class UnsupportedLiquidityChainError extends Error {
+    constructor(chainId: number | string);
 }
-declare class IndexedRateUnavailableError extends Error {
-    constructor(params: {
-        source?: string;
-        destination?: string;
-        tokenIn?: string;
-        tokenOut?: string;
-        side?: IndexedRateSide;
-    });
+/**
+ * An exact-output quote did not settle on an input within its rounds: each quoted input's clearing
+ * price still fell short of the output. The route may have the depth; the book moved or its levels
+ * are too steep to converge on in time. Retrying, or quoting an exact input, may succeed.
+ */
+declare class OrderbookQuoteNotConvergedError extends Error {
+    readonly route: {
+        tokenIn: string;
+        tokenOut: string;
+        sourceChain: string;
+        destinationChain: string;
+    };
+    readonly rounds: number;
+    /** The last input quoted, in the source token's raw units. */
+    readonly lastAmountIn: bigint;
+    constructor(route: {
+        tokenIn: string;
+        tokenOut: string;
+        sourceChain: string;
+        destinationChain: string;
+    }, rounds: number, 
+    /** The last input quoted, in the source token's raw units. */
+    lastAmountIn: bigint);
 }
-declare class InvalidIndexedRateError extends Error {
-    constructor(reason: string);
+/** The orderbook cannot fill the requested amount on this route. */
+declare class InsufficientOrderbookLiquidityError extends Error {
+    readonly route: {
+        tokenIn: string;
+        tokenOut: string;
+        sourceChain: string;
+        destinationChain: string;
+    };
+    /** The largest `amountIn` the route can fill, in the source token's raw units. */
+    readonly maxFillableIn: bigint;
+    constructor(route: {
+        tokenIn: string;
+        tokenOut: string;
+        sourceChain: string;
+        destinationChain: string;
+    }, 
+    /** The largest `amountIn` the route can fill, in the source token's raw units. */
+    maxFillableIn: bigint);
 }
 
 /**
@@ -1833,8 +2030,7 @@ declare class InvalidIndexedRateError extends Error {
  *
  * `IntentGateway` orchestrates the complete lifecycle of an intent-based
  * cross-chain swap:
- * - **Quoting** — prices the order's input/output amounts from aggregate
- *   indexed pool rates by default, with legacy quote strategies available explicitly.
+ * - **Quoting** — prices orders, liquidity and rates from the HyperFX orderbook.
  * - **Order placement** — encodes and yields `placeOrder` calldata; caller
  *   signs and submits the transaction.
  * - **Order execution** — polls the Hyperbridge coprocessor for solver bids,
@@ -1876,8 +2072,10 @@ declare class IntentGateway {
     private readonly bidManager;
     /** Estimates gas costs for filling an order and converts them to fee-token amounts. */
     private readonly gasEstimator;
-    /** Quote strategies for pricing orders before placement, keyed by strategy name. */
-    private readonly quoteStrategies;
+    /** The HyperFX orderbook quotes, liquidity and rates are read from. */
+    private orderbook;
+    /** Prices intents, liquidity and rates from {@link orderbook}. */
+    private readonly market;
     /**
      * Private constructor — use {@link IntentGateway.create} instead.
      *
@@ -1913,42 +2111,57 @@ declare class IntentGateway {
      */
     private init;
     /**
-     * Quotes an intent between this gateway's source and destination chains.
-     *
-     * Uses the indexer's latest aggregate directional pool rate by default. Pass
-     * `strategy: "phantom_snapshot"` or `strategy: "uniswap_v4"` only when
-     * explicitly requesting a legacy quote source. Provide exactly one of
-     * `amountIn` or `amountOut`.
-     *
-     * The gateway's source and destination chains resolve the configured order
-     * tokens; the indexer supplies the depth-weighted pool rate. Returned
-     * `amountIn`/`amountOut` already account for the gateway's protocol fee
-     * (`quoteMetadata.protocolFeeBps`), which the gateway deducts from order inputs.
+     * Points quotes, liquidity and rate reads at a HyperFX orderbook other than
+     * the destination chain's network deployment ({@link ORDERBOOK_URLS}).
+     * Returns `this` for chaining.
      *
-     * @param params - Token pair, amount, and optional strategy/pool overrides.
-     * @returns The quoted amounts plus strategy-specific metadata.
-     * @throws {UnsupportedIntentQuoteStrategyError} For unknown strategies.
-     * @throws {UnsupportedIntentQuotePairError} When the selected strategy does not support the pair.
-     * @throws {IndexedRateUnavailableError} When the requested direction has no indexed rate.
+     * @param orderbook - The orderbook's GraphQL URL, or a configured client.
      */
-    quoteIntent(params: QuoteIntentParams): Promise<QuoteIntentResult>;
+    withOrderbook(orderbook: string | HyperFxOrderbook): this;
     /**
-     * Returns indexed destination liquidity and its source-routing slices.
+     * Quotes an intent between this gateway's source and destination chains from
+     * the HyperFX orderbook. Provide exactly one of `amountIn` or `amountOut`, in
+     * raw token units. The result has the orderbook's shape, in raw token units.
      *
-     * Destination, unrestricted, and explicit-route capacity come exclusively
-     * from the indexer's pair-centric liquidity entities. The SDK does not decide
-     * whether unrestricted bidders cover the source chain. Amounts reflect the
-     * latest rolling sample; they are not reservations or fill guarantees.
+     * By default the quote is pessimistic (`PessimisticQuoteIntentResult`): the
+     * whole trade at one price, the worst single-order price of the first level,
+     * best first, deep enough to fill it by itself, or the route's worst price
+     * when no one level can. With `optimistic: true` it is the orderbook's
+     * optimistic quote (`QuoteIntentResult`): the route's orders, best price
+     * first, each filling what it can of the trade at its own price, one leg per
+     * order. There is no total output; the legs' `amountOut`s sum to it.
      *
-     * Requires a prior call to {@link withQueryClient}.
+     * Every `amountOut` already has the destination's protocol fee taken off. For
+     * an exact output, the quote is for an input that delivers `amountOut`. A
+     * cross-chain route only counts orders whose solvers accept the source chain.
+     *
+     * @throws {InsufficientOrderbookLiquidityError} When the route cannot fill the amount.
+     * @throws {OrderbookQuoteNotConvergedError} When an exact-output quote does not settle on an input.
+     * @throws {OrderbookRequestError} When the orderbook is unreachable or trades no book for the pair.
+     */
+    quoteIntent(params: QuoteIntentParams & {
+        optimistic: true;
+    }): Promise<QuoteIntentResult>;
+    quoteIntent(params: QuoteIntentParams & {
+        optimistic?: false;
+    }): Promise<PessimisticQuoteIntentResult>;
+    quoteIntent(params: QuoteIntentParams): Promise<QuoteIntentResult | PessimisticQuoteIntentResult>;
+    /**
+     * Returns the orderbook liquidity serving a swap of `tokenIn` on the source
+     * chain for `tokenOut` on the destination chain: the best rate, true and
+     * virtual depth, and the largest input the route can fill.
+     *
+     * Amounts reflect the live book; they are not reservations or fill guarantees.
      */
-    queryAvailableLiquidity(params: Pick<QuoteIntentParams, "tokenIn" | "tokenOut">): Promise<AvailableLiquidity | undefined>;
+    queryAvailableLiquidity(params: Pick<QuoteIntentParams, "tokenIn" | "tokenOut">): Promise<AvailableLiquidity>;
     /**
-     * Returns aggregate indexed pool buy and sell rates in less-valued quote-token
-     * units without requiring token addresses. Symbols are matched
-     * case-insensitively; chain IDs resolve configured token deployments.
+     * Returns the orderbook's best bid and ask for a pair, with the mid and
+     * spread, in quote-token units per one base token. Only orders filled on the
+     * destination chain that accept swaps from the source chain are counted.
+     * Symbols are matched case-insensitively; chain IDs resolve configured token
+     * deployments.
      */
-    queryBuyAndSellRates(params: QueryBuyAndSellRatesParams): Promise<BuyAndSellRates | undefined>;
+    queryBuyAndSellRates(params: QueryBuyAndSellRatesParams): Promise<BuyAndSellRates>;
     /**
      * Bidirectional async generator that orchestrates the full order lifecycle:
      * placement, fee estimation, bid collection, and execution.
@@ -2087,6 +2300,8 @@ declare class IntentGateway {
     /**
      * Returns both the native token cost and the relayer fee for cancelling an
      * order. Use `relayerFee` to approve the ERC-20 spend before submitting.
+     * Same-chain orders use the direct local route for either `from` option and
+     * return `{ nativeValue: 0n, relayerFee: 0n }`.
      *
      * Delegates to {@link OrderCanceller.quoteCancelOrder}.
      *
@@ -2104,9 +2319,17 @@ declare class IntentGateway {
      *
      * Delegates to {@link OrderCanceller.cancelOrder}.
      *
+     * Same-chain orders always use the direct source-gateway route. The order
+     * user may call through the deadline; any account may call strictly after
+     * it, pays the transaction gas, and cannot change the refund beneficiary.
+     * The SDK yields unsigned transaction fields and accepts either the caller's
+     * signed raw transaction or its already-broadcast transaction hash.
+     *
      * @param order - The order to cancel.
-     * @param indexerClient - Indexer client used for ISMP request status streaming.
-     * @param options - Choose the initiation side. Defaults to source-side cancellation.
+     * @param indexerClient - Indexer client used for cross-chain ISMP request
+     *   status streaming; the same-chain route does not access it.
+     * @param options - Choose the cross-chain initiation side. Defaults to source;
+     *   ignored for routing when source and destination are the same chain.
      * @yields {@link CancelEvent} objects describing each cancellation stage.
      */
     cancelOrder(order: Order, indexerClient: IsmpClient, options?: CancelOrderOptions): AsyncGenerator<CancelEvent>;
@@ -2228,15 +2451,23 @@ declare class IntentGateway {
      */
     decodeERC7821Execute(callData: HexString): ERC7821Call[] | null;
     /**
-     * Checks whether an order has been filled on the destination chain.
+     * Checks whether an order is finalized on the destination chain.
      *
      * Delegates to {@link OrderStatusChecker.isOrderFilled}.
      *
      * @param order - The order to check.
-     * @returns `true` if the order's commitment slot on the destination chain is
-     *   non-zero (i.e. `fillOrder` has been called successfully).
+     * @returns `true` once a completing fill or a destination-side cancellation
+     *   has finalized the order; `false` while it is open or only partly filled.
      */
     isOrderFilled(order: Order): Promise<boolean>;
+    /**
+     * Output credited to the order so far, one entry per leg.
+     *
+     * Delegates to {@link OrderStatusChecker.getFillProgress}.
+     *
+     * @param order - The order to check.
+     */
+    getFillProgress(order: Order): Promise<TokenInfo[]>;
     /**
      * Checks whether all escrowed inputs for an order have been refunded on the
      * source chain.
@@ -2244,8 +2475,8 @@ declare class IntentGateway {
      * Delegates to {@link OrderStatusChecker.isOrderRefunded}.
      *
      * @param order - The order to check.
-     * @returns `true` if every input token's escrowed amount has been zeroed out
-     *   in the `_orders` mapping on the source chain.
+     * @returns `true` if every input's escrowed amount has been zeroed out
+     *   in the per-leg `_orders` mapping on the source chain.
      */
     isOrderRefunded(order: Order): Promise<boolean>;
     /**
@@ -2294,16 +2525,6 @@ declare class IntentGateway {
     }, void>;
 }
 
-declare class InvalidLiquidityIndexerResponseError extends Error {
-    constructor(reason: string);
-}
-declare class UnsupportedLiquidityAssetError extends Error {
-    constructor(chain: string, asset: string);
-}
-declare class UnsupportedLiquidityChainError extends Error {
-    constructor(chainId: number | string);
-}
-
 /**
  * Checks the on-chain fill and refund status of IntentGatewayV2 orders.
  *
@@ -2318,20 +2539,28 @@ declare class OrderStatusChecker {
      */
     constructor(ctx: IntentGatewayContext);
     /**
-     * Checks if a V2 order has been filled by reading the commitment storage slot on the destination chain.
-     *
-     * Reads the storage slot returned by `calculateCommitmentSlotHash` on the IntentGatewayV2 contract.
-     * A non-zero value at that slot means the solver has called `fillOrder` and the order is complete
-     * from the user's perspective (the beneficiary has received their tokens).
+     * Whether the order is finalized on the destination chain, read from the gateway's `_filled`
+     * getter. It is set by the completing fill, and by a cancellation, which records the refund
+     * beneficiary there. A partially filled order reads false; see {@link getFillProgress}.
      *
      * @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: Order): Promise<boolean>;
+    /**
+     * Output credited to the order so far, one entry per leg, read from `_partialFills` on the
+     * destination chain. Several solvers can each fill a slice of a same-chain or cross-chain order,
+     * so this, not {@link isOrderFilled}, says how far along an open order is. Surplus paid above
+     * the order's rate is not counted.
+     *
+     * @param order - The V2 order to check. `order.id` is used as the commitment; if not set it is computed.
+     */
+    getFillProgress(order: Order): Promise<TokenInfo[]>;
     /**
      * Checks if a V2 order has been refunded by reading the `_orders` mapping on the source chain.
      *
-     * Calls `_orders(commitment, tokenAddress)` for each input token. When the order is placed the
+     * Calls `_orders(commitment, index)` for each input: escrow is held per leg, keyed by the input's
+     * index, so inputs that repeat a token are read separately. A gateway not yet upgraded to per-leg
+     * escrow is read by token instead, see {@link readLegEscrow}. When the order is placed the
      * escrowed amounts are stored there. After a successful refund the contract zeroes them out.
      * An order is considered refunded when all escrowed input amounts have been returned (i.e. are 0).
      *
@@ -2341,6 +2570,31 @@ declare class OrderStatusChecker {
     isOrderRefunded(order: Order): Promise<boolean>;
 }
 
+type ReadClient = Pick<PublicClient, "readContract">;
+/**
+ * Escrow held for leg `index` of an order on its source chain: `_orders(commitment, index)`, or
+ * `_orders(commitment, token)` on a gateway that has not been upgraded to per-leg escrow.
+ *
+ * @param client - Public client of the order's source chain.
+ * @param gateway - IntentGatewayV2 address on that chain.
+ * @param commitment - The order commitment.
+ * @param index - Leg index into `order.inputs`.
+ * @param token - `order.inputs[index].token`, as bytes32 or a 20-byte address.
+ */
+declare function readLegEscrow(client: ReadClient, gateway: HexString, commitment: HexString, index: number, token: HexString): Promise<bigint>;
+/**
+ * Output delivered so far for leg `index` of an order on its destination chain:
+ * `_partialFills(commitment, index)`, or `_partialFills(commitment, token)` on a gateway that has not
+ * been upgraded to per-leg escrow.
+ *
+ * @param client - Public client of the order's destination chain.
+ * @param gateway - IntentGatewayV2 address on that chain.
+ * @param commitment - The order commitment.
+ * @param index - Leg index into `order.output.assets`.
+ * @param token - `order.output.assets[index].token` as bytes32.
+ */
+declare function readLegPartialFill(client: ReadClient, gateway: HexString, commitment: HexString, index: number, token: HexString): Promise<bigint>;
+
 type ContractOrder = Omit<Order, "id" | "source" | "destination"> & {
     source: HexString;
     destination: HexString;
@@ -2467,17 +2721,32 @@ declare class CryptoUtils {
     static computeUserOpHash(userOp: PackedUserOperation, entryPoint: Hex, chainId: bigint): Hex;
     /**
      * Derives the ERC-4337 nonce key that binds a bid UserOperation to its
-     * order and session key: the lower 192 bits of
-     * `keccak256(commitment ‖ sessionKey)`. `SolverAccount` rejects bid
-     * operations whose nonce key differs — this is what lets the solver sign
-     * the plain userOpHash while staying committed to the order and to the
-     * session key it bid against.
+     * order, session key and calldata: the lower 192 bits of
+     * `keccak256(commitment ‖ sessionKey ‖ keccak256(callData))`. `SolverAccount`
+     * rejects bid operations whose nonce key differs — this is what lets the
+     * solver sign the plain userOpHash while staying committed to the order and
+     * to the session key it bid against.
+     *
+     * The calldata gives every bid its own key. A solver bidding several prices
+     * on one order signs one op per price, and each is sequence 0 of its own key,
+     * so they execute independently rather than in a sequence where one bid that
+     * is never selected blocks the rest.
      *
      * @param commitment - The order commitment (`order.id`).
      * @param sessionKey - The order's session key address (`order.session`).
+     * @param callData - The UserOperation's `callData`.
      * @returns The 192-bit nonce key as a bigint (pass to `EntryPoint.getNonce`).
      */
-    static bidNonceKey(commitment: HexString, sessionKey: HexString): bigint;
+    static bidNonceKey(commitment: HexString, sessionKey: HexString, callData: HexString): bigint;
+    /**
+     * The identifier Hyperbridge files a bid under: `keccak256` of the UserOp's
+     * `callData`. It is the same hash {@link bidNonceKey} takes, so a bid's
+     * identifier and its nonce key both follow from the op itself, and one
+     * solver's bids on one order are kept apart for the same reason on both sides.
+     *
+     * @param callData - The UserOperation's `callData`.
+     */
+    static bidId(callData: HexString): HexString;
     /**
      * Builds the EIP-712 typed-data payload whose digest is the EntryPoint v0.8
      * `userOpHash` (i.e. `hashTypedData(packedUserOpTypedData(...)) ===
@@ -2666,6 +2935,49 @@ declare class CryptoUtils {
     decodeERC7821Execute(callData: HexString): ERC7821Call[] | null;
 }
 
+type DecodedFillOrder = {
+    order: Order;
+    options: FillOptions;
+};
+/** `fillOrder(Order, FillOptions)` selector, pinned by codec tests; avoids import-time hashing in VM2. */
+declare const FILL_ORDER_SELECTOR: "0x68ddf058";
+/** The gateway release this SDK speaks. SolverAccount carries no version, so only the gateway is read. */
+declare const SUPPORTED_INTENTS_VERSION = 3n;
+declare const CONTRACT_VERSION_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "version";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+    }];
+}];
+/** Whether the gateway reports the supported release. RPC failures propagate. */
+declare function supportsRateFills(client: PublicClient, gateway: HexString): Promise<boolean>;
+/** The gateway must report release {@link SUPPORTED_INTENTS_VERSION}; a missing getter or any other release throws. */
+declare function assertGatewayRelease(client: PublicClient, gateway: HexString): Promise<void>;
+/** A bytes32 token whose upper 12 bytes are zero, the only form the gateway accepts. */
+declare function isCanonicalEvmToken(token: string): boolean;
+/** ABI-encodes a `fillOrder` call. Every leg must carry a validated quote. */
+declare function encodeFillOrder(order: Order, options: FillOptions): HexString;
+/**
+ * Decodes a `fillOrder` call.
+ *
+ * @returns The decoded order and options, or `null` if the calldata is not a `fillOrder` call in
+ *   the current shape or its quotes do not cover the order's legs.
+ */
+declare function decodeFillOrder(data: HexString): DecodedFillOrder | null;
+
+interface RateFillPreview {
+    credit: bigint;
+    release: bigint;
+    delivered: bigint;
+    surplus: bigint;
+}
+/** Estimates settlement at the supplied progress. The signed take/offered amounts remain caps. */
+declare function previewRateFill(escrow: bigint, required: bigint, filled: bigint, take: bigint, offered: bigint): RateFillPreview;
+
 declare const ABI: readonly [{
     readonly type: "receive";
     readonly stateMutability: "payable";
@@ -6144,4 +6456,4 @@ declare function teleport(teleport_param: {
     extrinsics?: Array<SubmittableExtrinsic<"promise", ISubmittableResult>>;
 }): Promise<ReadableStream<HyperbridgeTxEvents>>;
 
-export { ADDRESS_ZERO, AssetTeleported, AvailableLiquidity, Bid, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, BuyAndSellRates, type CancelEvent, CancelOrderOptions, CancelQuote, ChainConfigService, Chains, ClientConfig, ConfiguredAssetSymbol, 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, type IndexedRateIntentQuoteMetadata, type IndexedRateQuoteIntentResult, type IndexedRateSide, IndexedRateUnavailableError, IndexerQueryClient, IntentGateway, type IntentGatewayContext, IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidIndexedRateError, InvalidLiquidityIndexerResponseError, InvalidPhantomSnapshotError, IsmpClient, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, Order, OrderFeesQuote, 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, QueryBuyAndSellRatesParams, 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, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, 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 };
+export { ADDRESS_ZERO, AssetTeleported, type AvailableLiquidity, Bid, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type BuyAndSellRates, CONTRACT_VERSION_ABI, type CancelEvent, CancelOrderOptions, CancelQuote, ChainConfigService, Chains, ClientConfig, ConfiguredAssetSymbol, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedFillOrder, DecodedOrderPlacedLog, DecodedPostRequestEvent, DecodedPostResponseEvent, ERC20Method, ERC7821Call, ERC7821_BATCH_MODE, EstimateFillOrderParams, EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, FILL_ORDER_SELECTOR, FillOptions, FillOrderEstimate, FillerBid, GetRequestWithStatus, HexString, HyperFungibleToken, HyperFungibleTokenABI, HyperFxOrderbook, type HyperbridgeTxEvents, IChain, IEvmChain, IEvmConfig, IGetRequest, IIsmpMessage, IMessage, IPharosConfig, IPolkadotHubConfig, IPostRequest, IProof, IndexerQueryClient, InsufficientOrderbookLiquidityError, IntentGateway, type IntentGatewayContext, IntentOrderStatusUpdate, type IntentQuoteLeg, IntentsCoprocessor, IsmpClient, MOCK_ADDRESS, ORDERBOOK_DECIMALS, ORDERBOOK_QUERIES, ORDERBOOK_URLS, ORDER_V2_PARAM_TYPE, Order, OrderFeesQuote, OrderStatus, OrderStatusChecker, OrderWithStatus, type OrderbookBook, type OrderbookLevelQuote, type OrderbookQuoteFill, OrderbookQuoteNotConvergedError, type OrderbookRate, OrderbookRequestError, type OrderbookRoute, type OrderbookRouteKind, type OrderbookRouteLiquidity, type OrderbookSide, type OrderbookSwapQuote, type OrderbookTopOfBook, PACKED_USEROP_TYPEHASH, PLACE_ORDER_SELECTOR, PackedUserOperation, type Params, type PessimisticQuoteIntentResult, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, PostRequestTimeoutStatus, PostRequestWithStatus, QueryBuyAndSellRatesParams, type QuoteIntentParams, type QuoteIntentResult, type QuoteNativeResult, type QuoteResult, type QuoteUniswapParams, type QuoteUniswapResult, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, type RateFillPreview, RequestStatusWithMetadata, ResponseCommitmentWithValues, ResumeIntentOrderOptions, RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SUPPORTED_INTENTS_VERSION, SelectBidResult, StateMachineHeight, StateMachineIdParams, StateMachineUpdate, SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TokenGateway, TokenGatewayAssetTeleportedWithStatus, TokenInfo, Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, assertGatewayRelease, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, createEvmChain, createQueryClient, decodeFillOrder, encodeFillOrder, encodeStateMachineId, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, hexToString, isCanonicalEvmToken, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, orderbookUrlFor, parseStateMachineId, postRequestCommitment, previewRateFill, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readLegEscrow, readLegPartialFill, requestCommitmentKey, responseCommitmentKey, retryPromise, supportsRateFills, teleport, teleportDot, transformOrderForContract };