@hyperbridge/sdk 2.8.8 → 2.8.10

package/dist/node/{intents-helpers-BCsIHRts.d.cts → intents-helpers-BKj42imQ.d.cts}

@@ -6,6 +6,7 @@ import { PublicClient, TransactionReceipt, Hex, Log, ContractFunctionArgs, Chain
 import { Chain } from 'viem/chains';
 import { ApiPromise } from '@polkadot/api';
 import { KeyringPair } from '@polkadot/keyring/types';
+import { RuntimeVersion } from '@polkadot/types/interfaces';
 
 declare const _default$1: {
     ABI: readonly [{
@@ -1027,50 +1028,50 @@ declare class ChainConfigService {
     constructor(env?: NodeJS.ProcessEnv);
     private getConfig;
     getChainConfig(chain: string): ChainConfig;
-    getIntentGatewayAddress(chain: string): HexString$1;
-    getTokenGatewayAddress(chain: string): HexString$1;
-    getHostAddress(chain: string): HexString$1;
+    getIntentGatewayAddress(chain: string): HexString$2;
+    getTokenGatewayAddress(chain: string): HexString$2;
+    getHostAddress(chain: string): HexString$2;
     getWrappedNativeAssetWithDecimals(chain: string): {
-        asset: HexString$1;
+        asset: HexString$2;
         decimals: number;
     };
-    getDaiAsset(chain: string): HexString$1;
-    getAssetAddress(chain: string, symbol: ConfiguredAssetSymbol): HexString$1 | undefined;
+    getDaiAsset(chain: string): HexString$2;
+    getAssetAddress(chain: string, symbol: ConfiguredAssetSymbol): HexString$2 | undefined;
     /**
      * Resolves configured token metadata from an address on a specific chain.
      * This is used by SDK helpers that accept token addresses rather than caller-
      * supplied symbols or decimals.
      */
-    getAssetMetadataByAddress(chain: string, address: HexString$1): {
+    getAssetMetadataByAddress(chain: string, address: HexString$2): {
         symbol: ConfiguredAssetSymbol;
-        address: HexString$1;
+        address: HexString$2;
         decimals?: number;
     } | undefined;
-    getUsdtAsset(chain: string): HexString$1;
-    getUsdcAsset(chain: string): HexString$1;
+    getUsdtAsset(chain: string): HexString$2;
+    getUsdcAsset(chain: string): HexString$2;
     getUsdcDecimals(chain: string): number;
     getUsdtDecimals(chain: string): number;
-    getCNgnAsset(chain: string): HexString$1 | undefined;
+    getCNgnAsset(chain: string): HexString$2 | undefined;
     /**
      * Address of `symbol` on `chain` from the per-chain asset table, matched
      * case-insensitively ("cNGN" ≡ "CNGN"). This table is the single source of
      * truth for token addresses — the simplex asset registry resolves through
      * it, so a new asset is added once in `chain.ts` and nowhere else.
      */
-    getAssetBySymbol(chain: string, symbol: string): HexString$1 | undefined;
+    getAssetBySymbol(chain: string, symbol: string): HexString$2 | undefined;
     /** Resolves a configured token symbol case-insensitively on a specific chain. */
     getAssetMetadataBySymbol(chain: string, symbol: string): {
         symbol: ConfiguredAssetSymbol;
-        address: HexString$1;
+        address: HexString$2;
         decimals?: number;
     } | undefined;
     getCNgnDecimals(chain: string): number | undefined;
-    getExtAsset(chain: string): HexString$1 | undefined;
+    getExtAsset(chain: string): HexString$2 | undefined;
     getExtDecimals(chain: string): number | undefined;
     /** Configured exotic (non-USD) tokens on a chain, for selection UIs. EXT is a test asset and is not offered. */
     getKnownExoticTokens(chain: string): Array<{
         symbol: string;
-        address: HexString$1;
+        address: HexString$2;
         decimals?: number;
     }>;
     /** Known ERC-4626 treasury vaults on a chain, for selection UIs. */
@@ -1079,30 +1080,30 @@ declare class ChainConfigService {
     getConsensusStateId(chain: string): string;
     getHyperbridgeChainId(): number;
     getRpcUrl(chain: string): string;
-    getUniswapRouterV2Address(chain: string): HexString$1;
-    getAerodromeRouterAddress(chain: string): HexString$1;
-    getUniswapV2FactoryAddress(chain: string): HexString$1;
-    getUniswapV3FactoryAddress(chain: string): HexString$1;
-    getUniversalRouterAddress(chain: string): HexString$1;
-    getUniswapV3QuoterAddress(chain: string): HexString$1;
-    getUniswapV4QuoterAddress(chain: string): HexString$1;
-    getUniswapV4PositionManagerAddress(chain: string): HexString$1;
-    getUniswapV4PoolManagerAddress(chain: string): HexString$1;
-    getUniswapV4StateViewAddress(chain: string): HexString$1;
+    getUniswapRouterV2Address(chain: string): HexString$2;
+    getAerodromeRouterAddress(chain: string): HexString$2;
+    getUniswapV2FactoryAddress(chain: string): HexString$2;
+    getUniswapV3FactoryAddress(chain: string): HexString$2;
+    getUniversalRouterAddress(chain: string): HexString$2;
+    getUniswapV3QuoterAddress(chain: string): HexString$2;
+    getUniswapV4QuoterAddress(chain: string): HexString$2;
+    getUniswapV4PositionManagerAddress(chain: string): HexString$2;
+    getUniswapV4PoolManagerAddress(chain: string): HexString$2;
+    getUniswapV4StateViewAddress(chain: string): HexString$2;
     getUniswapV4PoolConfigs(chain: string): UniswapV4PoolConfigData[];
-    getPermit2Address(chain: string): HexString$1;
-    getSolverAccountAddress(chain: string): HexString$1 | undefined;
+    getPermit2Address(chain: string): HexString$2;
+    getSolverAccountAddress(chain: string): HexString$2 | undefined;
     getCoingeckoId(chain: string): string | undefined;
     getEtherscanApiKey(): string | undefined;
-    getCalldispatcherAddress(chain: string): HexString$1;
+    getCalldispatcherAddress(chain: string): HexString$2;
     getTokenStorageSlots(chain: string, tokenAddress: string): {
         balanceSlot: number;
         allowanceSlot: number;
     } | undefined;
     getPopularTokens(chain: string): string[];
-    getEntryPointV08Address(chain: string): HexString$1;
-    getCirclePaymasterAddress(chain: string): HexString$1 | undefined;
-    getSimplexPaymasterAddress(chain: string): HexString$1 | undefined;
+    getEntryPointV08Address(chain: string): HexString$2;
+    getCirclePaymasterAddress(chain: string): HexString$2 | undefined;
+    getSimplexPaymasterAddress(chain: string): HexString$2 | undefined;
     getHyperbridgeAddress(): string;
     /**
      * Get the LayerZero Endpoint ID for the chain
@@ -1114,7 +1115,7 @@ declare class ChainConfigService {
      * On Ethereum: OFT Adapter (locks/unlocks USDT)
      * On other chains: OFT contract (mints/burns USDT0)
      */
-    getUsdt0OftAddress(chain: string): HexString$1 | undefined;
+    getUsdt0OftAddress(chain: string): HexString$2 | undefined;
 }
 
 type IStateMachine = {
@@ -1164,33 +1165,33 @@ declare class SubstrateChain implements IChain {
      * @param key - The H256 hash key (as a 0x-prefixed hex string)
      * @returns The storage key as a hex string
      */
-    requestReceiptKey(key: HexString$1): HexString$1;
+    requestReceiptKey(key: HexString$2): HexString$2;
     /**
      * Returns the storage key for a request commitment in the child trie
      * The request commitment is the key
      * @param key - The H256 hash key (as a 0x-prefixed hex string)
      * @returns The storage key as a hex string
      */
-    requestCommitmentKey(key: HexString$1): HexString$1;
+    requestCommitmentKey(key: HexString$2): HexString$2;
     /**
      * Queries a request commitment from the ISMP child trie storage.
      * @param {HexString} commitment - The commitment hash to look up.
      * @returns {Promise<HexString | undefined>} The commitment data if found, undefined otherwise.
      */
-    queryRequestCommitment(commitment: HexString$1): Promise<HexString$1 | undefined>;
+    queryRequestCommitment(commitment: HexString$2): Promise<HexString$2 | undefined>;
     /**
      * Queries the request receipt.
      * @param {HexString} commitment - The commitment to query.
      * @returns {Promise<HexString | undefined>} The relayer address responsible for delivering the request.
      */
-    queryRequestReceipt(commitment: HexString$1): Promise<HexString$1 | undefined>;
+    queryRequestReceipt(commitment: HexString$2): Promise<HexString$2 | undefined>;
     /**
      * Returns the storage key for a response receipt in the child trie.
      * A response receipt is keyed by the originating *request* commitment.
      * @param {HexString} key - The request commitment (0x-prefixed H256 hex string)
      * @returns {HexString} The storage key as a hex string
      */
-    responseReceiptKey(key: HexString$1): HexString$1;
+    responseReceiptKey(key: HexString$2): HexString$2;
     /**
      * Queries the response receipt for a request commitment. For a GET, Hyperbridge
      * produces the response as it processes the request, so the presence of a response
@@ -1198,7 +1199,7 @@ declare class SubstrateChain implements IChain {
      * @param {HexString} commitment - The originating request commitment to query.
      * @returns {Promise<HexString | undefined>} The receipt data if present, otherwise undefined.
      */
-    queryResponseReceipt(commitment: HexString$1): Promise<HexString$1 | undefined>;
+    queryResponseReceipt(commitment: HexString$2): Promise<HexString$2 | undefined>;
     /**
      * Queries the state-machine commitment Hyperbridge holds for a counterparty chain at an
      * exact height — the `BoundedStateCommitments` map that `state_machine_commitment` (and thus
@@ -1207,7 +1208,7 @@ declare class SubstrateChain implements IChain {
      * @param {StateMachineHeight} height - The counterparty state machine id + height.
      * @returns {Promise<HexString | undefined>} The committed state root, or undefined if absent.
      */
-    queryStateMachineCommitment(height: StateMachineHeight): Promise<HexString$1 | undefined>;
+    queryStateMachineCommitment(height: StateMachineHeight): Promise<HexString$2 | undefined>;
     /**
      * Returns the current timestamp of the chain.
      * @returns {Promise<bigint>} The current timestamp.
@@ -1220,7 +1221,7 @@ declare class SubstrateChain implements IChain {
      * @param {bigint} [at] - The block number to query at.
      * @returns {Promise<HexString>} The proof.
      */
-    queryProof(message: IMessage, counterparty: string, at?: bigint): Promise<HexString$1>;
+    queryProof(message: IMessage, counterparty: string, at?: bigint): Promise<HexString$2>;
     /**
      * Submit an unsigned ISMP transaction to the chain. Resolves when the transaction is finalized.
      * @param message - The message to be submitted.
@@ -1239,7 +1240,7 @@ declare class SubstrateChain implements IChain {
      * @param _address - Optional address (ignored for Substrate; present for IChain compatibility).
      * @returns The state proof as a hexadecimal string.
      */
-    queryStateProof(at: bigint, keys: HexString$1[], _address?: HexString$1): Promise<HexString$1>;
+    queryStateProof(at: bigint, keys: HexString$2[], _address?: HexString$2): Promise<HexString$2>;
     /**
      * Get the latest state machine height for a given state machine ID.
      * @param {StateMachineIdParams} stateMachineId - The state machine ID.
@@ -1266,7 +1267,7 @@ declare class SubstrateChain implements IChain {
      * @param message The ISMP message to encode.
      * @returns The encoded message as a hexadecimal string.
      */
-    encode(message: IIsmpMessage): HexString$1;
+    encode(message: IIsmpMessage): HexString$2;
     /**
      * Queries the latest proven height for this chain from pallet-ismp.
      */
@@ -1280,7 +1281,7 @@ declare class SubstrateChain implements IChain {
      * @param currentEpoch - The current authority set id on the destination EVM chain
      */
     queryConsensusProofs(neededHeight: bigint, currentEpoch: bigint): Promise<{
-        proofs: HexString$1[];
+        proofs: HexString$2[];
         provenHeight: bigint;
     } | undefined>;
     private getPalletIndex;
@@ -1307,7 +1308,7 @@ declare function convertStateMachineEnumToString(stateMachine: {
  */
 declare function convertStateIdToStateMachineId(stateId: {
     Evm?: number;
-    Substrate?: HexString$1;
+    Substrate?: HexString$2;
     Polkadot?: number;
     Kusama?: number;
 }): string;
@@ -1406,22 +1407,22 @@ declare function deriveHttpUrl(wsUrl: string): string;
  * @param userOp - The PackedUserOperation to encode
  * @returns Hex-encoded SCALE bytes
  */
-declare function encodeUserOpScale(userOp: PackedUserOperation): HexString$1;
+declare function encodeUserOpScale(userOp: PackedUserOperation): HexString$2;
 /**
  * Decodes a SCALE-encoded PackedUserOperation.
  *
  * @param hex - The hex-encoded SCALE bytes
  * @returns The decoded PackedUserOperation
  */
-declare function decodeUserOpScale(hex: HexString$1): PackedUserOperation;
+declare function decodeUserOpScale(hex: HexString$2): PackedUserOperation;
 /** One directed leg of a phantom order: `standardAmount` of `tokenA` quoted in `tokenB`. */
 interface PhantomOrderLeg {
-    tokenA: HexString$1;
-    tokenB: HexString$1;
+    tokenA: HexString$2;
+    tokenB: HexString$2;
     standardAmount: bigint;
 }
 interface PhantomOrderEvent {
-    commitment: HexString$1;
+    commitment: HexString$2;
     chain: string;
     createdAt: number;
     /**
@@ -1430,21 +1431,35 @@ interface PhantomOrderEvent {
      */
     legs: PhantomOrderLeg[];
 }
+/** The pallet's phantom order timings, as the chain currently has them. */
+interface PhantomTimings {
+    /**
+     * Blocks after registration during which the pallet accepts a bid: the `PhantomBidWindow`
+     * storage value, or the `PhantomOrderBidWindowBlocks` runtime constant when that value is zero,
+     * which is the same fallback the pallet's own `phantom_bid_window()` applies.
+     */
+    bidWindowBlocks: number;
+    /**
+     * Blocks between generations (`PhantomOrderInterval`). Zero is meaningful rather than unset —
+     * the pallet generates once and never regenerates — so there is no constant to fall back to.
+     */
+    intervalBlocks: number;
+}
 /** One phantom bid to place, and the bid it replaces on the same chain. */
 interface PhantomBid {
     /** The phantom order commitment being bid on. */
-    commitment: HexString$1;
+    commitment: HexString$2;
     /** The SCALE-encoded PackedUserOperation backing the quote. */
-    userOp: HexString$1;
+    userOp: HexString$2;
     /**
      * A live bid from a previous interval on the same chain, retracted alongside this one to
      * reclaim its deposit. Best-effort: a retraction that fails never affects the bid.
      */
-    retractCommitment?: HexString$1;
+    retractCommitment?: HexString$2;
 }
 /** What became of one bid in a batch. */
 interface PhantomBidOutcome {
-    commitment: HexString$1;
+    commitment: HexString$2;
     success: boolean;
     /** The dispatch error that rejected this bid, when it failed. */
     error?: string;
@@ -1453,8 +1468,8 @@ interface PhantomBidBatchResult {
     /** One entry per submitted bid, in the order they were given. */
     bids: PhantomBidOutcome[];
     /** The block and extrinsic the bids landed in. */
-    blockHash?: HexString$1;
-    extrinsicHash?: HexString$1;
+    blockHash?: HexString$2;
+    extrinsicHash?: HexString$2;
     /**
      * The batch reached the pool but its inclusion was not observed, so no per-bid outcome is
      * known. Same contract as {@link BidSubmissionResult.pending}: in flight, do not re-sign.
@@ -1468,17 +1483,22 @@ interface PollPhantomOrdersOptions {
     intervalMs?: number;
     /**
      * Most blocks scanned in a single poll, so a long outage catches up over several ticks instead of
-     * one unbounded scan. Defaults to 500.
+     * one burst. Defaults to 10 — several times the rate the chain produces blocks, so recovery is
+     * still quick, but small enough to bound both the work one `state_queryStorage` call asks of the
+     * node and the requests the per-block fallback queues ahead of a bid submission.
      */
     maxBlocksPerPoll?: number;
-    /**
-     * How many blocks before the current head to start from on the first poll. Defaults to 0 (start
-     * at the head). Set this to the runtime's bid window to have a restarting process pick up orders
-     * whose window is still open.
-     */
-    lookbackBlocks?: number;
     /** Notified when a poll fails; polling continues regardless. */
     onError?: (err: unknown) => void;
+    /**
+     * Notified when the cursor was forced forward past a backlog too old to bid on, with the range
+     * that was never scanned. Nothing else reports it, and skipping blocks is worth a line in the log.
+     */
+    onSkip?: (skipped: {
+        from: number;
+        to: number;
+        head: number;
+    }) => void;
 }
 /**
  * Service for interacting with Hyperbridge's pallet-intents coprocessor.
@@ -1492,8 +1512,14 @@ declare class IntentsCoprocessor {
     private ownsConnection;
     /** Cached result of whether the node exposes intents_* RPC methods */
     private hasIntentsRpc;
+    /** The pallet's phantom timings, read once. Cleared on failure so the read retries. */
+    private phantomTimingsRead;
     /** The HTTP-backed api, connected on first use. Cleared after a failed attempt so it retries. */
     private httpApi;
+    /** Last runtime version read from the node, for {@link confirmedRuntimeVersion} to compare against. */
+    private lastRuntimeVersion;
+    /** Set once the node refuses `state_queryStorage`, so the poll stops asking for it. */
+    private rangeQueryUnavailable;
     private submissionQueue;
     /**
      * Creates and connects an IntentsCoprocessor to a Hyperbridge node.
@@ -1651,7 +1677,7 @@ declare class IntentsCoprocessor {
      * @param userOp - The encoded PackedUserOperation as hex string
      * @returns BidSubmissionResult with success status and block/extrinsic hash
      */
-    submitBid(commitment: HexString$1, userOp: HexString$1): Promise<BidSubmissionResult>;
+    submitBid(commitment: HexString$2, userOp: HexString$2): Promise<BidSubmissionResult>;
     /**
      * Retracts a bid from Hyperbridge and reclaims the deposit
      *
@@ -1660,7 +1686,7 @@ declare class IntentsCoprocessor {
      * @param commitment - The order commitment hash (bytes32)
      * @returns BidSubmissionResult with success status and block/extrinsic hash
      */
-    retractBid(commitment: HexString$1): Promise<BidSubmissionResult>;
+    retractBid(commitment: HexString$2): Promise<BidSubmissionResult>;
     /**
      * Places a new bid and retracts a previous one in a single transaction via utility.batch.
      *
@@ -1681,7 +1707,7 @@ declare class IntentsCoprocessor {
      * @param userOp - The encoded PackedUserOperation as hex string
      * @returns BidSubmissionResult with success status and block/extrinsic hash
      */
-    submitBidWithRetraction(retractCommitment: HexString$1, bidCommitment: HexString$1, userOp: HexString$1): Promise<BidSubmissionResult>;
+    submitBidWithRetraction(retractCommitment: HexString$2, bidCommitment: HexString$2, userOp: HexString$2): Promise<BidSubmissionResult>;
     /**
      * Places every phantom bid of one interval in a single extrinsic, retracting each chain's
      * previous bid alongside it.
@@ -1723,7 +1749,7 @@ declare class IntentsCoprocessor {
      * @param commitment - The order commitment hash (bytes32)
      * @returns Array of BidStorageEntry objects
      */
-    getBidStorageEntries(commitment: HexString$1): Promise<BidStorageEntry[]>;
+    getBidStorageEntries(commitment: HexString$2): Promise<BidStorageEntry[]>;
     /**
      * Fetches all bids for a given order commitment from Hyperbridge.
      *
@@ -1734,7 +1760,7 @@ declare class IntentsCoprocessor {
      * @param commitment - The order commitment hash (bytes32)
      * @returns Array of FillerBid objects containing filler address, userOp, and deposit
      */
-    getBidsForOrder(commitment: HexString$1): Promise<FillerBid[]>;
+    getBidsForOrder(commitment: HexString$2): Promise<FillerBid[]>;
     /**
      * Fetches bids using the custom intents_getBidsForOrder RPC.
      * Single round-trip but does not include deposit amounts.
@@ -1757,11 +1783,61 @@ declare class IntentsCoprocessor {
      * Returns `null` if the key is absent (e.g. the node is not an offchain worker
      * or the commitment has expired and been cleared).
      */
-    fetchPhantomOrder(commitment: HexString$1): Promise<Order | null>;
+    fetchPhantomOrder(commitment: HexString$2): Promise<Order | null>;
     /**
      * Reads the PhantomOrderRegistered events emitted in a single block.
+     *
+     * Costs two RPCs per block when `knownVersion` is supplied and four without it, which is why the
+     * poll goes to the trouble of establishing one. `api.at(hash)` has to work out which metadata to
+     * decode the block against, and with nothing to go on it fetches the header and then the runtime
+     * version at its parent — every block, forever. Its cheaper paths are a registry already pinned
+     * to this exact hash (only ever the previous block's) or one matching a version the caller
+     * names, so naming the version is the only way out. See `getBlockRegistry` in
+     * `@polkadot/api/base/Init`; the `getUpgradeVersion` shortcut that would otherwise skip the
+     * lookup only covers chains hardcoded in `@polkadot/types-known`, which Hyperbridge is not.
+     *
+     * @param knownVersion - the runtime version this block is known to run, if the caller has
+     *   established one. Passing a version the block does not actually run decodes it against the
+     *   wrong metadata, so this is for callers that have checked, not a place to pass a guess.
+     */
+    getPhantomOrdersInBlock(blockNumber: number, knownVersion?: RuntimeVersion): Promise<PhantomOrderEvent[]>;
+    /**
+     * The same read, for a caller that already holds the block's hash.
+     *
+     * Split out so the poll can fetch a whole range's hashes in one concurrent wave — which the
+     * provider coalesces into a single batched request — and then read each block's events knowing
+     * its hash. `chain_getBlockHash` is the half of the pair that parallelises safely: it takes no
+     * historic block hash, so it never triggers polkadot-js's per-hash registry resolution, and
+     * concurrent calls cannot race each other's registry state.
+     */
+    getPhantomOrdersAtHash(blockHash: HexString$2, knownVersion?: RuntimeVersion): Promise<PhantomOrderEvent[]>;
+    /**
+     * Every block's phantom orders across a whole range, in one `state_queryStorage` call.
+     *
+     * This is the cheap path: the request cost of a scan stops depending on how many blocks it
+     * covers. The events key is the only key queried, and both bounds are block hashes the caller
+     * already holds.
+     *
+     * Two properties of the RPC shape the result.
+     *
+     * It returns *diffs*: `query_storage_unfiltered` in `sc-rpc` pushes a change set for a block only
+     * when the value differs from the previous block in the range (`has_changed`, and the set is
+     * dropped when empty), so a block whose events encode byte-for-byte identically to its
+     * predecessor's is simply absent. That happens on a quiet chain, where consecutive blocks carry
+     * nothing but the timestamp inherent's `ExtrinsicSuccess`. It is safe here because an absent
+     * block provably carries no phantom orders: a `PhantomOrderRegistered` commitment is derived from
+     * the block number (`phantom_order_commitment`), so a block that registered orders can never
+     * encode identically to any other block. Absent therefore means "same as the previous block",
+     * and the previous block having orders would contradict that.
+     *
+     * And it is gated by `--rpc-methods` (`check_if_safe` in `sc-rpc`), which answers a denied call
+     * with `Method not found`. The node this reads from must already run unsafe RPC to serve
+     * `offchain_localStorageGet` for the orders themselves, so this is normally available; the poll
+     * falls back to reading block by block when it is not.
+     *
+     * @returns one entry per block the node reported a change for, in ascending block order.
      */
-    getPhantomOrdersInBlock(blockNumber: number): Promise<PhantomOrderEvent[]>;
+    getPhantomOrdersInRange(fromBlockHash: HexString$2, toBlockHash: HexString$2): Promise<PhantomOrderEvent[][]>;
     /**
      * Polls for newly registered phantom orders, invoking the callback once per block that carries
      * any, with all of that block's orders.
@@ -1788,9 +1864,87 @@ declare class IntentsCoprocessor {
      * socket that looks alive while delivering nothing. It also means a websocket outage does not
      * pause phantom bidding at all — the two transports fail independently.
      *
+     * What the cadence does *not* describe is the request rate, which is what rate limiters police.
+     * A tick costs four requests whatever the range covers — the head, the runtime version, the two
+     * bounding block hashes as one batched request, and one `state_queryStorage` for every block's
+     * events — and they go out back-to-back, so an interval well under any per-second limit could
+     * still arrive as a burst over it. Three things keep that in bounds: the provider coalesces
+     * concurrent calls into one request and paces requests through the endpoint's token bucket (see
+     * `http`), and `maxBlocksPerPoll` bounds the range. A 429 that gets through anyway backs the
+     * poll off for a doubling number of ticks, so a limiter that is already shedding load is not
+     * handed the next window's budget in rejections too.
+     *
+     * Where the node will not serve `state_queryStorage` the poll reads block by block instead, at
+     * three requests plus one per block; see {@link scanRangeAtOnce}.
+     *
      * Returns a function that stops polling.
      */
     pollPhantomOrders(callback: (events: PhantomOrderEvent[]) => void, options?: PollPhantomOrdersOptions): () => void;
+    /**
+     * The Hyperbridge head, over HTTP like every other read here.
+     *
+     * Exposed for callers that have to know how old something is: a phantom order carries the block
+     * it was registered at, and only against the head does that become "still biddable" or "long
+     * expired".
+     */
+    latestBlockNumber(): Promise<number>;
+    /**
+     * The pallet's phantom timings, read from chain state.
+     *
+     * Both are governance-settable and neither is derivable: on Nexus today the window is 15 while
+     * the runtime constant behind it is 25, so anything hard-coded is wrong in one direction or the
+     * other — too tight and live orders are dropped, too loose and bids are sent into a closed
+     * window for the pallet to reject.
+     *
+     * Read once per instance and cached, because a governance change to either is rare and a read
+     * per poll tick would be a request per tick forever. The cost is that a change is picked up on
+     * the next restart rather than immediately. A failed read is not cached, so it retries.
+     */
+    phantomTimings(): Promise<PhantomTimings>;
+    private readPhantomTimings;
+    /**
+     * A whole range of blocks in one `state_queryStorage` call, or `null` when that is not available
+     * and the caller should read block by block.
+     *
+     * Two conditions have to hold, and both are about decoding rather than the range itself.
+     *
+     * The version must be confirmed for this tick — an upgrade inside the range means blocks decode
+     * against different metadata, and one call cannot do that.
+     *
+     * And that confirmed version must still be the one the api's own registry was built for.
+     * `state_queryStorage` declares no historic block hash, so rpc-core skips its registry swap and
+     * decodes the reply against the default registry — fixed at connect, with no
+     * `subscribeRuntimeVersion` on an HTTP api to refresh it. After an upgrade the two diverge, and
+     * the per-block path takes over for good: `api.at(hash, version)` resolves, and builds, the right
+     * registry. That costs a restart to get the cheap path back, which is the correct direction to
+     * fail in.
+     */
+    private scanRangeAtOnce;
+    /**
+     * The runtime version this tick's blocks may be decoded against, or `undefined` when that cannot
+     * be established and each block must resolve its own.
+     *
+     * Naming a version to `api.at` is what removes two of the four RPCs a block scan costs, and it
+     * is only sound while the version is actually the block's. Getting that wrong is not a loud
+     * failure: events decoded against the wrong metadata come back as a shape the scan does not
+     * recognise, so the block reads as carrying no phantom orders and the cursor advances past it —
+     * exactly the silent miss the block cursor exists to rule out.
+     *
+     * So the version is read fresh each tick and only used when it matches the previous reading.
+     * `specVersion` only ever increases, and this read happens *after* the head read, so two equal
+     * readings mean no upgrade landed anywhere in between — and therefore none in the range about to
+     * be scanned. A reading that differs means an upgrade landed inside the range: that tick falls
+     * back to per-block resolution, which is exact, and the version is used from the next tick on
+     * once it has been seen twice.
+     *
+     * The gap this leaves is a backlog reaching back past an upgrade, whose oldest blocks predate
+     * even the previous reading. Recovering from an outage that long means those bid windows closed
+     * many upgrades ago, so nothing is lost that was still winnable.
+     *
+     * A version that cannot be read at all yields `undefined` rather than an error: the scan is
+     * about to make the same request against the same endpoint and is the better place to report it.
+     */
+    private confirmedRuntimeVersion;
     /**
      * The poll cadence for the runtime this instance is connected to: Gargantua polls every block,
      * everything else every 15s. Falls back to the slower cadence if the runtime cannot be read,
@@ -1805,7 +1959,7 @@ declare class IntentsCoprocessor {
 type IIsmpMessage = IRequestMessage | ITimeoutPostRequestMessage | IGetResponseMessage | IGetRequestMessage | IConsensusMessage | IBatchConsensusAndPostRequestMessage | IBatchConsensusAndGetResponseMessage;
 interface IConsensusMessage {
     kind: "Consensus";
-    consensusProof: HexString$1;
+    consensusProof: HexString$2;
 }
 interface IRequestMessage {
     /**
@@ -1823,7 +1977,7 @@ interface IRequestMessage {
     /**
      * The signer of the message.
      */
-    signer: HexString$1;
+    signer: HexString$2;
 }
 interface IGetRequestMessage {
     /**
@@ -1845,7 +1999,7 @@ interface IGetRequestMessage {
     /**
      * The signer of the message.
      */
-    signer: HexString$1;
+    signer: HexString$2;
 }
 interface IGetResponse {
     /**
@@ -1873,7 +2027,7 @@ interface IGetResponseMessage {
     /**
      * The signer of the message.
      */
-    signer: HexString$1;
+    signer: HexString$2;
 }
 interface ITimeoutPostRequestMessage {
     /**
@@ -1891,17 +2045,17 @@ interface ITimeoutPostRequestMessage {
 }
 interface IBatchConsensusAndPostRequestMessage {
     kind: "BatchConsensusAndPostRequest";
-    consensusProofs: HexString$1[];
+    consensusProofs: HexString$2[];
     requests: IPostRequest[];
     proof: IProof;
-    signer: HexString$1;
+    signer: HexString$2;
 }
 interface IBatchConsensusAndGetResponseMessage {
     kind: "BatchConsensusAndGetResponse";
-    consensusProofs: HexString$1[];
+    consensusProofs: HexString$2[];
     responses: IGetResponse[];
     proof: IProof;
-    signer: HexString$1;
+    signer: HexString$2;
 }
 interface IProof {
     /**
@@ -1919,7 +2073,7 @@ interface IProof {
     /**
      * The encoded storage proof
      */
-    proof: HexString$1;
+    proof: HexString$2;
 }
 /**
  * Interface representing a chain.
@@ -1933,18 +2087,18 @@ interface IChain {
     /**
      * Returns the state trie key for the request-receipt storage item for the given request commitment.
      */
-    requestReceiptKey(commitment: HexString$1): HexString$1;
+    requestReceiptKey(commitment: HexString$2): HexString$2;
     /**
      * Query and return the request-receipt for the given request commitment.
      */
-    queryRequestReceipt(commitment: HexString$1): Promise<HexString$1 | undefined>;
+    queryRequestReceipt(commitment: HexString$2): Promise<HexString$2 | undefined>;
     /**
      * Query and return the encoded storage proof for the provided keys at the given height.
      * @param address - Optional contract address for EVM chains; defaults to host contract when omitted.
      */
-    queryStateProof(at: bigint, keys: HexString$1[], address?: HexString$1): Promise<HexString$1>;
-    queryProof(message: IMessage, counterparty: string, at?: bigint): Promise<HexString$1>;
-    encode(message: IIsmpMessage): HexString$1;
+    queryStateProof(at: bigint, keys: HexString$2[], address?: HexString$2): Promise<HexString$2>;
+    queryProof(message: IMessage, counterparty: string, at?: bigint): Promise<HexString$2>;
+    encode(message: IIsmpMessage): HexString$2;
     /**
      * Get the latest state machine height for a given state machine ID.
      */
@@ -1969,18 +2123,18 @@ interface IEvmChain extends IChain {
     getHostNonce(): Promise<bigint>;
     quoteNative(request: IPostRequest | IGetRequest, fee: bigint): Promise<bigint>;
     getFeeTokenWithDecimals(): Promise<{
-        address: HexString$1;
+        address: HexString$2;
         decimals: number;
     }>;
-    getPlaceOrderCalldata(txHash: string, intentGatewayAddress: string, occurrenceIndex?: number): Promise<HexString$1>;
-    broadcastTransaction(signedTransaction: HexString$1): Promise<TransactionReceipt>;
-    getTransactionReceipt(hash: HexString$1): Promise<TransactionReceipt>;
+    getPlaceOrderCalldata(txHash: string, intentGatewayAddress: string, occurrenceIndex?: number): Promise<HexString$2>;
+    broadcastTransaction(signedTransaction: HexString$2): Promise<TransactionReceipt>;
+    getTransactionReceipt(hash: HexString$2): Promise<TransactionReceipt>;
 }
 
 type EstimateGasCallData = ContractFunctionArgs<typeof _default$1.ABI, "nonpayable" | "payable", "handlePostRequests">;
-type HexString$1 = `0x${string}`;
+type HexString$2 = `0x${string}`;
 type StateMachineId = string;
-type BytesLikeHex = HexString$1;
+type BytesLikeHex = HexString$2;
 interface IConfig {
     source: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig | IPharosConfig;
     dest: IEvmConfig | ISubstrateConfig | IPolkadotHubConfig | IPharosConfig;
@@ -1990,7 +2144,7 @@ interface IConfig {
 interface IEvmConfig {
     rpcUrl: string;
     stateMachineId: string;
-    host: HexString$1;
+    host: HexString$2;
     consensusStateId: string;
 }
 /**
@@ -2022,25 +2176,25 @@ interface IHyperbridgeConfig {
 interface IPostRequest {
     source: string;
     dest: string;
-    from: HexString$1;
-    to: HexString$1;
+    from: HexString$2;
+    to: HexString$2;
     nonce: bigint;
-    body: HexString$1;
+    body: HexString$2;
     timeoutTimestamp: bigint;
 }
 interface IGetRequest {
     source: string;
     dest: string;
-    from: HexString$1;
+    from: HexString$2;
     nonce: bigint;
     height: bigint;
-    keys: HexString$1[];
+    keys: HexString$2[];
     timeoutTimestamp: bigint;
-    context: HexString$1;
+    context: HexString$2;
 }
 interface GetResponseStorageValues {
-    key: HexString$1;
-    value: HexString$1;
+    key: HexString$2;
+    value: HexString$2;
 }
 interface IPostResponse {
     post: IPostRequest;
@@ -2048,9 +2202,9 @@ interface IPostResponse {
     timeoutTimestamp: bigint;
 }
 type IMessage = {
-    Requests: HexString$1[];
+    Requests: HexString$2[];
 } | {
-    Responses: HexString$1[];
+    Responses: HexString$2[];
 };
 type IndexerQueryClient = GraphQLClient;
 interface ClientConfig {
@@ -2215,10 +2369,10 @@ interface RequestResponse {
         nodes: Array<{
             source: string;
             dest: string;
-            to: HexString$1;
-            from: HexString$1;
+            to: HexString$2;
+            from: HexString$2;
             nonce: bigint;
-            body: HexString$1;
+            body: HexString$2;
             timeoutTimestamp: bigint;
             statusMetadata: {
                 nodes: Array<{
@@ -2238,12 +2392,12 @@ interface GetRequestResponse {
         nodes: Array<{
             source: string;
             dest: string;
-            to: HexString$1;
-            from: HexString$1;
+            to: HexString$2;
+            from: HexString$2;
             nonce: bigint;
             height: bigint;
-            keys: HexString$1[];
-            context: HexString$1;
+            keys: HexString$2[];
+            context: HexString$2;
             timeoutTimestamp: bigint;
             statusMetadata: {
                 nodes: Array<{
@@ -2343,20 +2497,20 @@ type RequestStatusWithMetadata = {
 interface GenericRequestWithStatuses {
     source: string;
     dest: string;
-    from: HexString$1;
+    from: HexString$2;
     nonce: bigint;
     timeoutTimestamp: bigint;
     statuses: Array<RequestStatusWithMetadata>;
 }
 interface PostRequestWithStatus extends GenericRequestWithStatuses {
-    to: HexString$1;
-    body: HexString$1;
+    to: HexString$2;
+    body: HexString$2;
 }
 interface GetRequestWithStatus extends GenericRequestWithStatuses {
     height: bigint;
-    keys: HexString$1[];
-    context: HexString$1;
-    commitment: HexString$1;
+    keys: HexString$2[];
+    context: HexString$2;
+    commitment: HexString$2;
 }
 interface GetResponseByRequestIdResponse {
     getResponses: {
@@ -2399,7 +2553,7 @@ interface AssetTeleported {
     to: string;
     amount: bigint;
     dest: string;
-    commitment: HexString$1;
+    commitment: HexString$2;
     createdAt: Date;
     blockNumber: number;
 }
@@ -2409,7 +2563,7 @@ interface AssetTeleportedResponse {
 interface StateMachineIdParams {
     stateId: {
         Evm?: number;
-        Substrate?: HexString$1;
+        Substrate?: HexString$2;
         Polkadot?: number;
         Kusama?: number;
     };
@@ -2452,73 +2606,73 @@ interface TokenInfo {
 interface DecodedOrderPlacedLog extends Log {
     eventName: string;
     args: {
-        user: HexString$1;
+        user: HexString$2;
         source: string;
         destination: string;
         deadline: bigint;
         nonce: bigint;
         fees: bigint;
-        session: HexString$1;
-        beneficiary: HexString$1;
+        session: HexString$2;
+        beneficiary: HexString$2;
         predispatch: Array<{
-            token: HexString$1;
+            token: HexString$2;
             amount: bigint;
         }>;
         inputs: Array<{
-            token: HexString$1;
+            token: HexString$2;
             amount: bigint;
         }>;
         outputs: Array<{
-            token: HexString$1;
+            token: HexString$2;
             amount: bigint;
         }>;
         /**
          * Calldata executed via the CallDispatcher before escrow.
          * Absent on logs emitted under the pre-#1092 event schema.
          */
-        predispatchCall?: HexString$1;
+        predispatchCall?: HexString$2;
         /**
          * Calldata executed on the destination chain during the fill.
          * Absent on logs emitted under the pre-#1092 event schema.
          */
-        outputCall?: HexString$1;
+        outputCall?: HexString$2;
         /**
          * Attribution tag supplied by the order placer.
          * Absent on logs emitted under the pre-#1092 event schema.
          */
-        graffiti?: HexString$1;
+        graffiti?: HexString$2;
     };
-    transactionHash: HexString$1;
+    transactionHash: HexString$2;
 }
 interface DecodedPostRequestEvent extends Log {
     eventName: string;
     args: {
         source: string;
         dest: string;
-        from: HexString$1;
-        to: HexString$1;
+        from: HexString$2;
+        to: HexString$2;
         nonce: bigint;
         timeoutTimestamp: bigint;
-        body: HexString$1;
+        body: HexString$2;
         fee: bigint;
     };
-    transactionHash: HexString$1;
+    transactionHash: HexString$2;
 }
 interface DecodedPostResponseEvent extends Log {
     eventName: string;
     args: {
         source: string;
         dest: string;
-        from: HexString$1;
-        to: HexString$1;
+        from: HexString$2;
+        to: HexString$2;
         nonce: bigint;
         timeoutTimestamp: bigint;
-        body: HexString$1;
-        response: HexString$1;
+        body: HexString$2;
+        response: HexString$2;
         responseTimeoutTimestamp: bigint;
         fee: bigint;
     };
-    transactionHash: HexString$1;
+    transactionHash: HexString$2;
 }
 /**
  * Options for canceling an order
@@ -2540,11 +2694,11 @@ interface Deployment {
     /**
      * The raw state machine ID bytes for the deployment chain (hashed on-chain)
      */
-    chain: HexString$1;
+    chain: HexString$2;
     /**
      * The gateway identifier
      */
-    gateway: HexString$1;
+    gateway: HexString$2;
 }
 /**
  * Represents the body of a request
@@ -2553,11 +2707,11 @@ interface RequestBody {
     /**
      * Represents the commitment of an order
      */
-    commitment: HexString$1;
+    commitment: HexString$2;
     /**
      * Stores the identifier for the beneficiary
      */
-    beneficiary: HexString$1;
+    beneficiary: HexString$2;
     /**
      * An array of token identifiers
      */
@@ -2725,8 +2879,8 @@ interface ExecutionResult {
      * Any tokens exchanged during the fill process
      */
     exchanges?: Array<{
-        fromToken: HexString$1;
-        toToken: HexString$1;
+        fromToken: HexString$2;
+        toToken: HexString$2;
         fromAmount: string;
         toAmount: string;
         exchangeRate: string;
@@ -2748,15 +2902,15 @@ interface DispatchPost {
     /**
      * Bytes representation of the destination state machine
      */
-    dest: HexString$1;
+    dest: HexString$2;
     /**
      * The destination module
      */
-    to: HexString$1;
+    to: HexString$2;
     /**
      * The request body
      */
-    body: HexString$1;
+    body: HexString$2;
     /**
      * Timeout for this request in seconds
      */
@@ -2769,13 +2923,13 @@ interface DispatchPost {
     /**
      * Who pays for this request?
      */
-    payer: HexString$1;
+    payer: HexString$2;
 }
 interface DispatchGet {
     /**
      * Bytes representation of the destination state machine
      */
-    dest: HexString$1;
+    dest: HexString$2;
     /**
      * Height at which to read the state machine
      */
@@ -2783,7 +2937,7 @@ interface DispatchGet {
     /**
      * Raw storage keys to fetch values from the counterparty
      */
-    keys: HexString$1[];
+    keys: HexString$2[];
     /**
      * Timeout for this request in seconds
      */
@@ -2795,17 +2949,17 @@ interface DispatchGet {
     /**
      * Context for the request
      */
-    context: HexString$1;
+    context: HexString$2;
     /**
      * Who pays for this request?
      */
-    payer: HexString$1;
+    payer: HexString$2;
 }
 interface StateMachineHeight {
     id: {
         stateId: {
             Evm?: number;
-            Substrate?: HexString$1;
+            Substrate?: HexString$2;
             Polkadot?: number;
             Kusama?: number;
         };
@@ -2821,26 +2975,26 @@ interface HostParams {
      * The fee token contract address. This will typically be DAI.
      * but we allow it to be configurable to prevent future regrets.
      */
-    feeToken: HexString$1;
+    feeToken: HexString$2;
     /**
      * The admin account, this only has the rights to freeze, or unfreeze the bridge
      */
-    admin: HexString$1;
+    admin: HexString$2;
     /**
      * Ismp message handler contract. This performs all verification logic
      * needed to validate cross-chain messages before they are dispatched to local modules
      */
-    handler: HexString$1;
+    handler: HexString$2;
     /**
      * The authorized host manager contract, is itself an `IIsmpModule`
      * which receives governance requests from the Hyperbridge chain to either
      * withdraw revenue from the host or update its protocol parameters
      */
-    hostManager: HexString$1;
+    hostManager: HexString$2;
     /**
      * The local UniswapV2Router02 contract, used for swapping the native token to the feeToken.
      */
-    uniswapV2: HexString$1;
+    uniswapV2: HexString$2;
     /**
      * The unstaking period of Polkadot's validators. In order to prevent long-range attacks
      */
@@ -2852,7 +3006,7 @@ interface HostParams {
     /**
      * The consensus client contract which handles consensus proof verification
      */
-    consensusClient: HexString$1;
+    consensusClient: HexString$2;
     /**
      * State machines whose state commitments are accepted
      */
@@ -2860,7 +3014,7 @@ interface HostParams {
     /**
      * The state machine identifier for hyperbridge
      */
-    hyperbridge: HexString$1;
+    hyperbridge: HexString$2;
 }
 interface OrderStatusMetadata {
     status: OrderStatus;
@@ -2942,9 +3096,9 @@ interface OrderResponse {
     };
 }
 interface PhantomOrderPriceSnapshot {
-    commitment: HexString$1;
-    tokenA: HexString$1;
-    tokenB: HexString$1;
+    commitment: HexString$2;
+    tokenA: HexString$2;
+    tokenB: HexString$2;
     standardAmount: bigint;
     blockNumber: bigint;
     medianPrice: bigint;
@@ -2983,7 +3137,7 @@ interface LiquiditySlice {
 interface AvailableLiquidity {
     sourceChain: Chains;
     destinationChain: Chains;
-    tokenAddress: HexString$1;
+    tokenAddress: HexString$2;
     updatedAt: Date;
     destination: LiquiditySlice;
     unrestricted: LiquiditySlice;
@@ -3041,7 +3195,7 @@ interface Transaction {
     /**
      * The address to send the transaction to (typically the Universal Router address)
      */
-    to: HexString$1;
+    to: HexString$2;
     /**
      * The value to send with the transaction (in wei)
      */
@@ -3049,7 +3203,7 @@ interface Transaction {
     /**
      * The calldata for the transaction
      */
-    data: HexString$1;
+    data: HexString$2;
 }
 interface StorageFacade {
     get<T>(key: string): Promise<T | undefined>;
@@ -3060,15 +3214,15 @@ interface PaymentInfo {
     /** Accepts a standard 20-byte address; the SDK pads to bytes32 internally when needed. */
     beneficiary: BytesLikeHex;
     assets: TokenInfo[];
-    call: HexString$1;
+    call: HexString$2;
 }
 interface DispatchInfo {
     assets: TokenInfo[];
-    call: HexString$1;
+    call: HexString$2;
 }
 interface Order {
     id?: string;
-    user: HexString$1;
+    user: HexString$2;
     /** Accepts either `"EVM-1"` style IDs or their hex-encoded form. */
     source: StateMachineId;
     /** Accepts either `"EVM-42161"` style IDs or their hex-encoded form. */
@@ -3076,7 +3230,7 @@ interface Order {
     deadline: bigint;
     nonce: bigint;
     fees: bigint;
-    session: HexString$1;
+    session: HexString$2;
     predispatch: DispatchInfo;
     inputs: TokenInfo[];
     output: PaymentInfo;
@@ -3088,18 +3242,30 @@ interface CancelOrderOptions {
 interface FillOptions {
     relayerFee: bigint;
     nativeDispatchFee: bigint;
+    /**
+     * Last block number at which this fill may execute. `0n` means no bound.
+     *
+     * A solver bidding through the coprocessor signs this calldata and then has no further
+     * say in when it is used: the order's `deadline` is placer-chosen with no ceiling, and
+     * retracting the bid on Hyperbridge does not reach the destination chain. Without a bound
+     * the placer can sit on a signed bid and execute it once the price has moved their way.
+     *
+     * In blocks, matching `order.deadline`, so both read against the same clock. Dropped when
+     * encoding against a gateway whose implementation predates the field.
+     */
+    validUntil: bigint;
     outputs: TokenInfo[];
 }
 interface PackedUserOperation {
-    sender: HexString$1;
+    sender: HexString$2;
     nonce: bigint;
-    initCode: HexString$1;
-    callData: HexString$1;
-    accountGasLimits: HexString$1;
+    initCode: HexString$2;
+    callData: HexString$2;
+    accountGasLimits: HexString$2;
     preVerificationGas: bigint;
-    gasFees: HexString$1;
-    paymasterAndData: HexString$1;
-    signature: HexString$1;
+    gasFees: HexString$2;
+    paymasterAndData: HexString$2;
+    signature: HexString$2;
 }
 interface SigningAccount {
     /**
@@ -3112,29 +3278,29 @@ interface SigningAccount {
      * Returns the 65-byte `r ‖ s ‖ v` signature as 0x-hex, `v` 27 or 28 — the
      * `eth_signTypedData_v4` form. Bid validation recovers against exactly this.
      */
-    signTypedData: (typedData: unknown) => Promise<HexString$1>;
+    signTypedData: (typedData: unknown) => Promise<HexString$2>;
 }
 interface SubmitBidOptions {
     order: Order;
     fillOptions: FillOptions;
-    solverAccount: HexString$1;
+    solverAccount: HexString$2;
     /** Canonical signer used for bid message signing and raw-hash operations. */
     solverSigner: SigningAccount;
     nonce: bigint;
-    entryPointAddress: HexString$1;
+    entryPointAddress: HexString$2;
     callGasLimit: bigint;
     verificationGasLimit: bigint;
     preVerificationGas: bigint;
     maxFeePerGas: bigint;
     maxPriorityFeePerGas: bigint;
     /** Pre-built ERC-7821 calldata encoding the UserOp execution (approvals + fillOrder). */
-    callData: HexString$1;
+    callData: HexString$2;
     /**
      * Optional packed paymasterAndData for EntryPoint v0.8.
      * Must be built BEFORE calling prepareSubmitBid so the hash covers paymaster bytes.
      * Defaults to "0x" (EntryPoint deposit pays gas).
      */
-    paymasterAndData?: HexString$1;
+    paymasterAndData?: HexString$2;
 }
 interface EstimateFillOrderParams {
     order: Order;
@@ -3186,8 +3352,9 @@ interface OrderFeesQuote {
     /**
      * The amount to set as `Order.fees`, denominated in the source-chain fee
      * token. Same-chain fills carry a 2x margin over the estimated fill gas without
-     * a gas-price bump. Cross-chain gas is priced with 10% SDK-only headroom before
-     * adding the settlement relayer fee and a further 5% buffer over the whole sum.
+     * a gas-price bump. Cross-chain orders originating on Ethereum mainnet use 50%
+     * SDK-only gas-price headroom; other source chains use 10%. The settlement
+     * relayer fee is then added with a further 5% buffer over the whole sum.
      */
     fees: bigint;
     /**
@@ -3201,7 +3368,7 @@ interface OrderFeesQuote {
      * The source-chain fee token `fees` is denominated in — check the user's
      * balance and allowance against this address when paying the fee directly.
      */
-    feeToken: HexString$1;
+    feeToken: HexString$2;
     /** The underlying gas estimate the quote was derived from. */
     estimate: FillOrderEstimate;
 }
@@ -3216,11 +3383,11 @@ interface BidSubmissionResult {
     /**
      * Block hash where the bid was included
      */
-    blockHash?: HexString$1;
+    blockHash?: HexString$2;
     /**
      * Extrinsic hash of the bid transaction
      */
-    extrinsicHash?: HexString$1;
+    extrinsicHash?: HexString$2;
     /**
      * Error message if submission failed
      */
@@ -3241,7 +3408,7 @@ interface BidSubmissionResult {
  */
 interface BidStorageEntry {
     /** The order commitment hash (H256) */
-    commitment: HexString$1;
+    commitment: HexString$2;
     /** The filler's Substrate account ID (SS58 encoded) */
     filler: string;
     /** The deposit amount stored on-chain (BalanceOf<T> = u128) */
@@ -3264,11 +3431,11 @@ interface FillerBid {
  */
 interface SelectOptions {
     /** The order commitment hash (bytes32) */
-    commitment: HexString$1;
+    commitment: HexString$2;
     /** The solver address to select */
-    solver: HexString$1;
+    solver: HexString$2;
     /** The EIP-712 signature from the session key */
-    signature: HexString$1;
+    signature: HexString$2;
 }
 /**
  * A first-class, executable solver bid surfaced to consumers of the intents SDK.
@@ -3286,7 +3453,7 @@ interface SelectOptions {
  */
 interface Bid {
     /** The solver account that submitted this bid (`userOp.sender`). */
-    readonly solverAddress: HexString$1;
+    readonly solverAddress: HexString$2;
     /** Decoded `FillOptions.outputs` — the tokens and amounts the solver offers. */
     readonly outputs: TokenInfo[];
     /** Relayer fee from the decoded fill options. */
@@ -3335,8 +3502,8 @@ type IntentOrderStatusKey = keyof typeof IntentOrderStatus;
 /** Tagged union of all possible status updates yielded by the intent order execution stream */
 type IntentOrderStatusUpdate = {
     status: "AWAITING_PLACE_ORDER";
-    to: HexString$1;
-    data: HexString$1;
+    to: HexString$2;
+    data: HexString$2;
     /**
      * The order's native-token input amounts. Native inputs cannot be
      * pulled via allowance, so this must be part of the placement
@@ -3350,62 +3517,62 @@ type IntentOrderStatusUpdate = {
      * (fee-token rail).
      */
     nativeFee: bigint;
-    sessionPrivateKey: HexString$1;
+    sessionPrivateKey: HexString$2;
     /** Exact source-chain fee-token amount encoded in `data`. */
     feeTokenAmount: bigint;
     /** Source-chain ERC-20 token charged for `feeTokenAmount`. */
-    feeTokenAddress: HexString$1;
+    feeTokenAddress: HexString$2;
 } | {
     status: "ORDER_PLACED";
     order: Order;
     receipt: TransactionReceipt;
 } | {
     status: "AWAITING_BIDS";
-    commitment: HexString$1;
+    commitment: HexString$2;
     totalFilledAssets: TokenInfo[];
     remainingAssets: TokenInfo[];
 } | {
     status: "NEW_BID";
-    commitment: HexString$1;
+    commitment: HexString$2;
     bid: Bid;
 } | {
     status: "BIDS_RECEIVED";
-    commitment: HexString$1;
+    commitment: HexString$2;
     bidCount: number;
     bids: Bid[];
 } | {
     status: "BID_SELECTED";
-    commitment: HexString$1;
-    selectedSolver: HexString$1;
-    userOpHash: HexString$1;
+    commitment: HexString$2;
+    selectedSolver: HexString$2;
+    userOpHash: HexString$2;
     userOp: PackedUserOperation;
-    transactionHash?: HexString$1;
+    transactionHash?: HexString$2;
 } | {
     status: "FILLED";
-    commitment: HexString$1;
-    userOpHash: HexString$1;
-    selectedSolver: HexString$1;
-    transactionHash?: HexString$1;
+    commitment: HexString$2;
+    userOpHash: HexString$2;
+    selectedSolver: HexString$2;
+    transactionHash?: HexString$2;
     totalFilledAssets: TokenInfo[];
     remainingAssets: TokenInfo[];
 } | {
     status: "PARTIAL_FILL";
-    commitment: HexString$1;
-    userOpHash: HexString$1;
-    selectedSolver: HexString$1;
-    transactionHash?: HexString$1;
+    commitment: HexString$2;
+    userOpHash: HexString$2;
+    selectedSolver: HexString$2;
+    transactionHash?: HexString$2;
     filledAssets: TokenInfo[];
     totalFilledAssets: TokenInfo[];
     remainingAssets: TokenInfo[];
 } | {
     status: "EXPIRED";
-    commitment: HexString$1;
+    commitment: HexString$2;
     totalFilledAssets?: TokenInfo[];
     remainingAssets?: TokenInfo[];
     error: string;
 } | {
     status: "FAILED";
-    commitment?: HexString$1;
+    commitment?: HexString$2;
     totalFilledAssets?: TokenInfo[];
     remainingAssets?: TokenInfo[];
     error: string;
@@ -3413,10 +3580,10 @@ type IntentOrderStatusUpdate = {
 /** Result of selecting a bid and submitting to the bundler */
 interface SelectBidResult {
     userOp: PackedUserOperation;
-    userOpHash: HexString$1;
-    solverAddress: HexString$1;
-    commitment: HexString$1;
-    txnHash?: HexString$1;
+    userOpHash: HexString$2;
+    solverAddress: HexString$2;
+    commitment: HexString$2;
+    txnHash?: HexString$2;
     fillStatus?: "full" | "partial";
     /** Assets filled in this user operation (best-effort, based on on-chain PartialFill logs) */
     filledAssets?: TokenInfo[];
@@ -3424,7 +3591,7 @@ interface SelectBidResult {
 /** Options for executing an intent order */
 interface ExecuteIntentOrderOptions {
     order: Order;
-    sessionPrivateKey?: HexString$1;
+    sessionPrivateKey?: HexString$2;
     /** Duration in ms to collect bids before selecting the best one. */
     auctionTimeMs: number;
     pollIntervalMs?: number;
@@ -3434,19 +3601,19 @@ interface ExecuteIntentOrderOptions {
      */
     solver?: {
         /** Only bids from this address (matched against userOp.sender) will be considered */
-        address: HexString$1;
+        address: HexString$2;
         /** After this many ms without a matching bid, execution falls back to any solver */
         timeoutMs: number;
     };
 }
 /** Options for resuming execution of a previously placed intent order */
 interface ResumeIntentOrderOptions {
-    sessionPrivateKey?: HexString$1;
+    sessionPrivateKey?: HexString$2;
     /** Duration in ms to collect bids before selecting the best one. */
     auctionTimeMs: number;
     pollIntervalMs?: number;
     solver?: {
-        address: HexString$1;
+        address: HexString$2;
         timeoutMs: number;
     };
 }
@@ -3467,8 +3634,238 @@ declare function sortPoolSymbols<Symbol extends string>(symbolA: Symbol, symbolB
 /** Canonical indexer pool ID for a pair of canonical token symbols. */
 declare function poolSlug(symbolA: string, symbolB: string): string;
 
-declare function encodeERC7821ExecuteBatch(calls: ERC7821Call[]): HexString$1;
-declare function decodeERC7821ExecuteBatch(callData: HexString$1): ERC7821Call[] | null;
+declare function encodeERC7821ExecuteBatch(calls: ERC7821Call[]): HexString$2;
+declare function decodeERC7821ExecuteBatch(callData: HexString$2): ERC7821Call[] | null;
+
+/**
+ * `FillOptions` gained a `validUntil` field. Adding a field to a struct changes the
+ * enclosing function's selector, so `fillOrder` has two incompatible shapes in the wild:
+ *
+ *   v1  fillOrder(Order, (uint256 relayerFee, uint256 nativeDispatchFee, TokenInfo[] outputs))
+ *   v2  fillOrder(Order, (uint256 relayerFee, uint256 nativeDispatchFee, uint256 validUntil, TokenInfo[] outputs))
+ *
+ * The selectors differ (`0x5cfb1ea5` vs `0xa5470064`), so a v2 payload sent to a v1
+ * deployment finds no matching function and reverts rather than mis-decoding — which is the
+ * safe failure, but it does mean callers have to know which shape a gateway speaks.
+ */
+type FillOptionsVersion = 1 | 2;
+/**
+ * The v1 `fillOrder`, kept only so we can still talk to deployments that predate `validUntil`.
+ *
+ * Exported because consumers that cannot use {@link decodeFillOrder} still have to accept both
+ * shapes. The indexer decodes bid calldata with ethers rather than viem (viem's byte handling
+ * throws inside SubQuery's VM2 sandbox), so it rebuilds this decode itself and needs the same
+ * definition rather than a second copy that can drift out of step with this one.
+ */
+declare const FILL_ORDER_V1_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "fillOrder";
+    readonly stateMutability: "payable";
+    readonly outputs: readonly [];
+    readonly inputs: readonly [{
+        readonly name: "order";
+        readonly type: "tuple";
+        readonly internalType: "struct Order";
+        readonly components: readonly [{
+            readonly name: "user";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "source";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "destination";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "fees";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "session";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "predispatch";
+            readonly type: "tuple";
+            readonly internalType: "struct DispatchInfo";
+            readonly components: readonly [{
+                readonly name: "assets";
+                readonly type: "tuple[]";
+                readonly internalType: "struct TokenInfo[]";
+                readonly components: readonly [{
+                    readonly name: "token";
+                    readonly type: "bytes32";
+                    readonly internalType: "bytes32";
+                }, {
+                    readonly name: "amount";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }];
+            }, {
+                readonly name: "call";
+                readonly type: "bytes";
+                readonly internalType: "bytes";
+            }];
+        }, {
+            readonly name: "inputs";
+            readonly type: "tuple[]";
+            readonly internalType: "struct TokenInfo[]";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }];
+        }, {
+            readonly name: "output";
+            readonly type: "tuple";
+            readonly internalType: "struct PaymentInfo";
+            readonly components: readonly [{
+                readonly name: "beneficiary";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "assets";
+                readonly type: "tuple[]";
+                readonly internalType: "struct TokenInfo[]";
+                readonly components: readonly [{
+                    readonly name: "token";
+                    readonly type: "bytes32";
+                    readonly internalType: "bytes32";
+                }, {
+                    readonly name: "amount";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }];
+            }, {
+                readonly name: "call";
+                readonly type: "bytes";
+                readonly internalType: "bytes";
+            }];
+        }];
+    }, {
+        readonly name: "options";
+        readonly type: "tuple";
+        readonly internalType: "struct FillOptions";
+        readonly components: readonly [{
+            readonly name: "relayerFee";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "nativeDispatchFee";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "outputs";
+            readonly type: "tuple[]";
+            readonly internalType: "struct TokenInfo[]";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }];
+        }];
+    }];
+}];
+/**
+ * IntentGateway implementations deployed before `FillOptions.validUntil` existed.
+ *
+ * The list is of *legacy* implementations rather than current ones, so the default is v2 and
+ * nothing has to be added here when a new implementation ships — only when an old one is
+ * discovered. Once every deployment is upgraded this set is vestigial and still correct.
+ *
+ * The alternative, listing known-good implementations, would be the version constant this
+ * replaced wearing a different hat: a value someone must remember to update on every upgrade,
+ * where forgetting breaks every fill on the chain.
+ */
+declare const LEGACY_FILL_OPTIONS_IMPLEMENTATIONS: Set<string>;
+/**
+ * Chains whose IntentGateway has not been redeployed with `FillOptions.validUntil` yet.
+ *
+ * A blunter instrument than {@link LEGACY_FILL_OPTIONS_IMPLEMENTATIONS} and used for the same
+ * reason: those chains run a pre-`validUntil` implementation whose address is not tracked here,
+ * so the address check would wrongly read them as current and every fill would revert on a
+ * selector that does not exist.
+ *
+ * Delete a chain from this set when its gateway is redeployed. Once the set is empty the
+ * implementation-address check covers everything on its own.
+ */
+declare const CHAINS_WITHOUT_VALID_UNTIL: Set<number>;
+/** Test seam: drop memoised detection results. */
+declare function resetFillOptionsVersionCache(): void;
+/**
+ * Works out which `FillOptions` shape a gateway accepts from the implementation it delegates to.
+ *
+ * EIP-1967 standardises three slots, all holding addresses — there is no version field to read,
+ * and the contract deliberately does not carry one either: a hand-maintained version constant is
+ * a second source of truth that has to be bumped on the right upgrade. The implementation address
+ * is the value the proxy already updates, so it is what identifies the deployed code.
+ */
+declare function getFillOptionsVersion(client: PublicClient, gateway: HexString$2): Promise<FillOptionsVersion>;
+/**
+ * ABI-encodes a `fillOrder` call in the shape the target gateway understands.
+ *
+ * On a v1 gateway `validUntil` is dropped — there is nowhere to put it and no check on the
+ * other side. That is a real loss of protection, so callers that rely on the bound should
+ * surface it rather than assume it took effect.
+ */
+declare function encodeFillOrder(order: Order, options: FillOptions, version: FillOptionsVersion): HexString$2;
+/**
+ * Decodes a `fillOrder` call of either shape.
+ *
+ * v2 is tried first and v1 is the fallback; the selectors differ, so there is no shape a
+ * decode could silently get wrong. `validUntil` reads as `0n` for a v1 payload, which is the
+ * same value that means "no bound" in v2 — accurate, since a v1 fill genuinely has none.
+ *
+ * @returns The decoded order and options, or `null` if the calldata is not a `fillOrder`.
+ */
+declare function decodeFillOrder(data: HexString$2): {
+    order: Order;
+    options: FillOptions;
+} | null;
+
+type HexString$1 = `0x${string}`;
+/** A decoded `getPoolAndPositionInfo` return: the pool's key words plus the packed position info. */
+interface PoolAndPositionInfo {
+    currency0: HexString$1;
+    currency1: HexString$1;
+    /**
+     * The ABI-encoded PoolKey exactly as returned, i.e. the first five words. A static struct's
+     * abi.encode IS its concatenated words, so `keccak256` of this slice is the pool id — no
+     * re-encoding, and no chance of the re-encoding disagreeing with what the chain hashed.
+     */
+    poolKeyEncoded: HexString$1;
+    tickLower: number;
+    tickUpper: number;
+}
+/**
+ * How much of `outputToken` a position is currently worth. Zero when the token is not one of the
+ * pool's currencies, or when the price has moved the position entirely onto the other side — both
+ * ordinary outcomes, not errors.
+ */
+declare function positionAmountOfToken(params: {
+    info: PoolAndPositionInfo;
+    liquidity: bigint;
+    sqrtPriceX96: bigint;
+    outputToken: string;
+}): bigint;
 
 type HexString = `0x${string}`;
 /**
@@ -3871,6 +4268,10 @@ declare const FILL_ORDER_ABI: readonly [{
             readonly name: "nativeDispatchFee";
             readonly type: "uint256";
             readonly internalType: "uint256";
+        }, {
+            readonly name: "validUntil";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
         }, {
             readonly name: "outputs";
             readonly type: "tuple[]";
@@ -4994,6 +5395,20 @@ interface PhantomLegAggregation {
     /** The verified, inventory-backed solvers quoting this leg; bidCount === bidders.length. */
     bidders: PhantomLegBidder[];
 }
+/**
+ * A Uniswap V4 position a bid declared, after the on-chain ownership check — i.e. one this solver
+ * really holds and can fund a fill from.
+ *
+ * A bid is the only place a position is ever named, so a consumer that wants to value these between
+ * bid windows (an order fill drains a position inside the fill transaction, while wallet and vault
+ * balances barely move) has to take them from here.
+ */
+interface SolverV4Position {
+    solver: HexString;
+    /** The chain the bid was for. A bid is per chain, so no other chain's reads can see it. */
+    chain: string;
+    tokenId: bigint;
+}
 /** The aggregated result for a single phantom order's bid window. */
 interface PhantomAggregation {
     /**
@@ -5003,6 +5418,21 @@ interface PhantomAggregation {
      */
     legs: PhantomLegAggregation[];
     lpBalances: LpBalance[];
+    /**
+     * Every declared position that passed the ownership check, across all bids in this window.
+     * Empty when the chain has no configured V4 deployment, since nothing is read there.
+     */
+    positions: SolverV4Position[];
+    /**
+     * Every solver whose bid passed verification in this window, whether or not it ended up backing
+     * a leg, holding any inventory, or declaring anything.
+     *
+     * The other three fields are all filtered — `legs` drops unbacked quotes, `lpBalances` skips
+     * tokens a solver does not hold, and `positions` only lists what was declared — so a solver that
+     * bid while holding nothing anywhere appears in none of them. This is the only complete answer
+     * to "who bid this window", which is what a consumer reconciling per-solver state needs.
+     */
+    solvers: HexString[];
 }
 interface AggregationLogger {
     warn: (payload: unknown, message: string) => void;
@@ -5012,13 +5442,24 @@ interface AggregationLogger {
  *
  * A bid that declares V4 positions is quoting off those pools, and a pool price is what a trade
  * gets BEFORE the pool takes its fee — so the amount such a bid names is more than the solver
- * would actually be left holding once the swap that sources it clears. 30bps is the fee tier the
- * pools these positions sit in charge, so netting it out here is what makes a pool-priced quote
- * comparable to a wallet-funded one, whose inventory has already paid its cost of goods.
+ * would actually be left holding once the swap that sources it clears. Netting that cost out here
+ * is what makes a pool-priced quote comparable to a wallet-funded one, whose inventory has already
+ * paid its cost of goods.
+ */
+declare const UNISWAP_QUOTE_HAIRCUT_BPS = 10n;
+/**
+ * Haircut applied to every phantom quote that is NOT priced off a Uniswap V4 pool, in basis points.
+ *
+ * A wallet-funded quote is still the best case the solver sees at bid time; the published rate is
+ * what the protocol tells takers they can trade against, so it is shaded by this margin rather
+ * than being the most optimistic number any bidder named. Pool-priced quotes pay
+ * {@link UNISWAP_QUOTE_HAIRCUT_BPS} instead of this — not on top of it.
  */
-declare const UNISWAP_QUOTE_HAIRCUT_BPS = 30n;
+declare const PHANTOM_QUOTE_HAIRCUT_BPS = 5n;
 /** Applies {@link UNISWAP_QUOTE_HAIRCUT_BPS} to a quoted output amount, rounding down. */
 declare function applyUniswapQuoteHaircut(amount: bigint): bigint;
+/** Applies {@link PHANTOM_QUOTE_HAIRCUT_BPS} to a quoted output amount, rounding down. */
+declare function applyPhantomQuoteHaircut(amount: bigint): bigint;
 declare function weightedMedian(entries: {
     price: bigint;
     weight: bigint;
@@ -5054,14 +5495,61 @@ declare const recoverBidSignerViem: RecoverBidSigner;
 /** Promise-caching delegation reader produced by {@link memoizedDelegationCheck}. */
 type DelegationReader = (evmRpcUrl: string, account: string, solverAccount: string) => Promise<boolean>;
 declare function fetchBidsForOrder(nodeUrl: string, commitment: string): Promise<RpcBidInfo[]>;
+/**
+ * Sums the solver's redeemable balance of a single token on one chain: the raw ERC-20 balance plus
+ * any ERC-4626 vault positions wrapping it.
+ *
+ * This is THE definition of "a solver's balance" — the periodic sweep and any per-event re-read
+ * must use it rather than a bare `balanceOf`, because simplex funds fills straight out of a vault
+ * inside the fill transaction: the wallet ends the block roughly where it started while
+ * `maxWithdraw` is what actually moved, so a wallet-only read misses such a fill entirely.
+ *
+ * `blockTag` reads the balance as of a specific block ("0x..." or a tag), so a caller replaying an
+ * event records the balance as of that event rather than stamping today's balance onto a
+ * historical row. It defaults to the chain head, which is what a periodic sweep wants.
+ */
+declare function getTotalSolverBalance(evmRpcUrl: string, chain: string, token: string, solver: string, yieldVaults: YieldVaultMap, blockTag?: string): Promise<bigint>;
 /** PositionManager + StateView addresses for a chain's Uniswap V4 deployment. */
 interface UniswapV4Contracts {
     positionManager: string;
     stateView: string;
 }
+/** Everything a declared position's contribution depends on, read once and reused across legs. */
+interface V4PositionState {
+    /** Current on-chain owner. Compared against the bid's signer, never trusted from the bid. */
+    owner: string;
+    info: PoolAndPositionInfo;
+    liquidity: bigint;
+    sqrtPriceX96: bigint;
+}
+/**
+ * Reads a declared position: who owns it, how much liquidity it holds, and the price its pool is
+ * currently at. Null when the position does not exist — a solver may name a burned tokenId, which
+ * is not an RPC failure and must not sink the run.
+ *
+ * Exported because a bid is the only place a position is ever named: a consumer that persists the
+ * tokenIds this run verified can re-value them later (at `blockTag`) with exactly these reads, and
+ * `owner` is what tells it a position has since been transferred away.
+ */
+declare function readV4Position(params: {
+    evmRpcUrl: string;
+    contracts: UniswapV4Contracts;
+    tokenId: bigint;
+    keccak: (hex: HexString) => HexString;
+    /** Block to read at; defaults to the chain head. */
+    blockTag?: string;
+    logger?: AggregationLogger;
+}): Promise<V4PositionState | null>;
 /** Promise-caching balance reader produced by [`memoizedSolverBalance`]. */
 type SolverBalanceReader = (evmRpcUrl: string, chain: string, token: string, solver: string) => Promise<bigint>;
-declare function memoizedSolverBalance(yieldVaults: YieldVaultMap): SolverBalanceReader;
+declare function memoizedSolverBalance(yieldVaults: YieldVaultMap, 
+/**
+ * Block to read each chain at, keyed by state machine id; anything absent reads the head. Block
+ * numbers are per chain, so a caller handling an event on one chain can pin that chain to the
+ * event's block while the rest of its sweep stays at the head, where the numbers would mean
+ * nothing.
+ */
+blockTags?: Record<string, string>): SolverBalanceReader;
 /**
  * Aggregates every bid for a phantom order into a single price/liquidity snapshot.
  *
@@ -5506,6 +5994,10 @@ declare const ABI: readonly [{
             readonly name: "nativeDispatchFee";
             readonly type: "uint256";
             readonly internalType: "uint256";
+        }, {
+            readonly name: "validUntil";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
         }, {
             readonly name: "outputs";
             readonly type: "tuple[]";
@@ -6911,6 +7403,10 @@ declare const _default: {
                 readonly name: "nativeDispatchFee";
                 readonly type: "uint256";
                 readonly internalType: "uint256";
+            }, {
+                readonly name: "validUntil";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
             }, {
                 readonly name: "outputs";
                 readonly type: "tuple[]";
@@ -7928,4 +8424,4 @@ declare const _default: {
     }];
 };
 
-export { type DecodedPostResponseEvent as $, type AssetTeleported as A, type BuyAndSellRates as B, ChainConfigService as C, type SubmitBidOptions as D, type EstimateGasCallData as E, type PackedUserOperation as F, type GetRequestWithStatus as G, type HexString$1 as H, type IChain as I, type FillerBid as J, type Bid as K, type EstimateFillOrderParams as L, type FillOrderEstimate as M, type OrderFeesQuote as N, type Order as O, type PostRequestWithStatus as P, type QueryBuyAndSellRatesParams as Q, type RetryConfig as R, type StateMachineIdParams as S, type Transaction as T, type ERC7821Call as U, type OrderWithStatus as V, OrderStatus as W, type TokenGatewayAssetTeleportedWithStatus as X, TeleportStatus as Y, type DecodedOrderPlacedLog as Z, type DecodedPostRequestEvent as _, type IEvmConfig as a, type SigningAccount as a$, type AllStatusKey as a0, type AssetTeleportedResponse as a1, type BidStorageEntry as a2, type BidSubmissionResult as a3, type BlockMetadata as a4, type BytesLikeHex as a5, type CancelOptions as a6, type ChainConfig as a7, type ChainConfigData as a8, type ConfiguredAssetSymbolInput as a9, type ITimeoutPostRequestMessage as aA, ABI as aB, type IntentGatewayParams as aC, IntentOrderStatus as aD, type IntentOrderStatusKey as aE, type IsmpRequest as aF, type LiquiditySlice as aG, type OrderResponse as aH, type OrderStatusMetadata as aI, type PaymentInfo as aJ, type PhantomBid as aK, type PhantomBidBatchResult as aL, type PhantomBidDeclaration as aM, type PhantomBidOutcome as aN, type PhantomOrderEvent as aO, type PhantomOrderLeg as aP, type PhantomOrderPriceSnapshot as aQ, type PhantomOrderPriceSnapshotsResponse as aR, type PollPhantomOrdersOptions as aS, type PostRequestStatus as aT, type RequestBody as aU, type RequestCommitment as aV, RequestKind as aW, type RequestResponse as aX, RequestStatus as aY, type RequestStatusKey as aZ, type SelectOptions as a_, type Deployment as aa, type DispatchGet as ab, type DispatchInfo as ac, type DispatchPost as ad, type Erc4626VaultConfigData as ae, type ExecuteIntentOrderOptions as af, type ExecutionResult as ag, type FillOptions as ah, type FillerConfig as ai, type GetRequestResponse as aj, type GetResponseByRequestIdResponse as ak, type GetResponseStorageValues as al, type HostParams as am, HyperClientStatus as an, type IBatchConsensusAndGetResponseMessage as ao, type IBatchConsensusAndPostRequestMessage as ap, type IConfig as aq, type IConsensusMessage as ar, type IGetRequestMessage as as, type IGetResponse as at, type IGetResponseMessage as au, type IHyperbridgeConfig as av, INCLUSION_TIMEOUT_MS as aw, type IPostResponse as ax, type IRequestMessage as ay, type ISubstrateConfig as az, type IMessage as b, memoizedSolverBalance as b$, type StateMachineId as b0, type StateMachineResponse as b1, type StorageFacade as b2, TimeoutStatus as b3, type TimeoutStatusKey as b4, type TokenGatewayAssetTeleportedResponse as b5, type TokenInfo as b6, type TokenPrice as b7, type TokenPricesResponse as b8, UNISWAP_QUOTE_HAIRCUT_BPS as b9, polkadotAssetHubPaseo as bA, polkadotHubMainnet as bB, poolSlug as bC, sortPoolSymbols as bD, tronChainIds as bE, tronNile as bF, type AggregationLogger as bG, type BidNonceKeyFn as bH, type BidSignature as bI, ENTRY_POINT_V08_ADDRESS as bJ, FILL_ORDER_ABI as bK, type FetchLike as bL, type FillData as bM, type HexString as bN, _default as bO, type LpBalance as bP, type OrderCommitmentFn as bQ, type PhantomAggregation as bR, type PhantomLegAggregation as bS, type PhantomLegBidder as bT, type RecoverBidSigner as bU, type RpcBidInfo as bV, type SolverBalanceReader as bW, type YieldVaultMap as bX, aggregatePhantomBids as bY, extractFillData as bZ, fetchBidsForOrder as b_, type UniswapV4PoolConfigData as ba, applyUniswapQuoteHaircut as bb, chainConfigs as bc, convertCodecToIGetRequest as bd, convertCodecToIProof as be, convertIGetRequestToCodec as bf, convertIProofToCodec as bg, convertStateIdToStateMachineId as bh, convertStateMachineEnumToString as bi, convertStateMachineIdToEnum as bj, decodeAcceptedSourceChains as bk, decodeERC7821ExecuteBatch as bl, decodePhantomBidDeclaration as bm, decodeUserOpScale as bn, deriveHttpUrl as bo, encodeAcceptedSourceChains as bp, encodeERC7821ExecuteBatch as bq, encodeISMPMessage as br, encodePhantomBidDeclaration as bs, encodeUserOpScale as bt, getChainId as bu, getConfigByStateMachineId as bv, getViemChain as bw, hyperbridgeAddress as bx, pharosAtlantic as by, pharosMainnet as bz, type StateMachineHeight as c, orderCommitmentFromDecoded as c0, recoverBidSignerViem as c1, setAggregationFetch as c2, splitBidSignature as c3, weightedMedian as c4, zipFillLegs as c5, type IIsmpMessage as d, type IPostRequest as e, type IGetRequest as f, type IPolkadotHubConfig as g, type IPharosConfig as h, type StateMachineUpdate as i, type ResponseCommitmentWithValues as j, type RequestStatusWithMetadata as k, type PostRequestTimeoutStatus as l, SubstrateChain as m, type ClientConfig as n, type IndexerQueryClient as o, type IProof as p, type IEvmChain as q, IntentsCoprocessor as r, Chains as s, type ConfiguredAssetSymbol as t, type AvailableLiquidity as u, type IntentOrderStatusUpdate as v, type SelectBidResult as w, type ResumeIntentOrderOptions as x, type CancelOrderOptions as y, type CancelQuote as z };
+export { type DecodedPostResponseEvent as $, type AssetTeleported as A, type BuyAndSellRates as B, ChainConfigService as C, type SubmitBidOptions as D, type EstimateGasCallData as E, type PackedUserOperation as F, type GetRequestWithStatus as G, type HexString$2 as H, type IChain as I, type FillerBid as J, type Bid as K, type EstimateFillOrderParams as L, type FillOrderEstimate as M, type OrderFeesQuote as N, type Order as O, type PostRequestWithStatus as P, type QueryBuyAndSellRatesParams as Q, type RetryConfig as R, type StateMachineIdParams as S, type Transaction as T, type ERC7821Call as U, type OrderWithStatus as V, OrderStatus as W, type TokenGatewayAssetTeleportedWithStatus as X, TeleportStatus as Y, type DecodedOrderPlacedLog as Z, type DecodedPostRequestEvent as _, type IEvmConfig as a, type RequestCommitment as a$, type AllStatusKey as a0, type AssetTeleportedResponse as a1, type BidStorageEntry as a2, type BidSubmissionResult as a3, type BlockMetadata as a4, type BytesLikeHex as a5, CHAINS_WITHOUT_VALID_UNTIL as a6, type CancelOptions as a7, type ChainConfig as a8, type ChainConfigData as a9, type IPostResponse as aA, type IRequestMessage as aB, type ISubstrateConfig as aC, type ITimeoutPostRequestMessage as aD, ABI as aE, type IntentGatewayParams as aF, IntentOrderStatus as aG, type IntentOrderStatusKey as aH, type IsmpRequest as aI, LEGACY_FILL_OPTIONS_IMPLEMENTATIONS as aJ, type LiquiditySlice as aK, type OrderResponse as aL, type OrderStatusMetadata as aM, PHANTOM_QUOTE_HAIRCUT_BPS as aN, type PaymentInfo as aO, type PhantomBid as aP, type PhantomBidBatchResult as aQ, type PhantomBidDeclaration as aR, type PhantomBidOutcome as aS, type PhantomOrderEvent as aT, type PhantomOrderLeg as aU, type PhantomOrderPriceSnapshot as aV, type PhantomOrderPriceSnapshotsResponse as aW, type PhantomTimings as aX, type PollPhantomOrdersOptions as aY, type PostRequestStatus as aZ, type RequestBody as a_, type ConfiguredAssetSymbolInput as aa, type Deployment as ab, type DispatchGet as ac, type DispatchInfo as ad, type DispatchPost as ae, type Erc4626VaultConfigData as af, type ExecuteIntentOrderOptions as ag, type ExecutionResult as ah, FILL_ORDER_V1_ABI as ai, type FillOptions as aj, type FillOptionsVersion as ak, type FillerConfig as al, type GetRequestResponse as am, type GetResponseByRequestIdResponse as an, type GetResponseStorageValues as ao, type HostParams as ap, HyperClientStatus as aq, type IBatchConsensusAndGetResponseMessage as ar, type IBatchConsensusAndPostRequestMessage as as, type IConfig as at, type IConsensusMessage as au, type IGetRequestMessage as av, type IGetResponse as aw, type IGetResponseMessage as ax, type IHyperbridgeConfig as ay, INCLUSION_TIMEOUT_MS as az, type IMessage as b, type OrderCommitmentFn as b$, RequestKind as b0, type RequestResponse as b1, RequestStatus as b2, type RequestStatusKey as b3, type SelectOptions as b4, type SigningAccount as b5, type StateMachineId as b6, type StateMachineResponse as b7, type StorageFacade as b8, TimeoutStatus as b9, encodeISMPMessage as bA, encodePhantomBidDeclaration as bB, encodeUserOpScale as bC, getChainId as bD, getConfigByStateMachineId as bE, getFillOptionsVersion as bF, getViemChain as bG, hyperbridgeAddress as bH, pharosAtlantic as bI, pharosMainnet as bJ, polkadotAssetHubPaseo as bK, polkadotHubMainnet as bL, poolSlug as bM, resetFillOptionsVersionCache as bN, sortPoolSymbols as bO, tronChainIds as bP, tronNile as bQ, type AggregationLogger as bR, type BidNonceKeyFn as bS, type BidSignature as bT, ENTRY_POINT_V08_ADDRESS as bU, FILL_ORDER_ABI as bV, type FetchLike as bW, type FillData as bX, type HexString as bY, _default as bZ, type LpBalance as b_, type TimeoutStatusKey as ba, type TokenGatewayAssetTeleportedResponse as bb, type TokenInfo as bc, type TokenPrice as bd, type TokenPricesResponse as be, UNISWAP_QUOTE_HAIRCUT_BPS as bf, type UniswapV4PoolConfigData as bg, applyPhantomQuoteHaircut as bh, applyUniswapQuoteHaircut as bi, chainConfigs as bj, convertCodecToIGetRequest as bk, convertCodecToIProof as bl, convertIGetRequestToCodec as bm, convertIProofToCodec as bn, convertStateIdToStateMachineId as bo, convertStateMachineEnumToString as bp, convertStateMachineIdToEnum as bq, decodeAcceptedSourceChains as br, decodeERC7821ExecuteBatch as bs, decodeFillOrder as bt, decodePhantomBidDeclaration as bu, decodeUserOpScale as bv, deriveHttpUrl as bw, encodeAcceptedSourceChains as bx, encodeERC7821ExecuteBatch as by, encodeFillOrder as bz, type StateMachineHeight as c, type PhantomAggregation as c0, type PhantomLegAggregation as c1, type PhantomLegBidder as c2, type PoolAndPositionInfo as c3, type RecoverBidSigner as c4, type RpcBidInfo as c5, type SolverBalanceReader as c6, type SolverV4Position as c7, type UniswapV4Contracts as c8, type V4PositionState as c9, type YieldVaultMap as ca, aggregatePhantomBids as cb, extractFillData as cc, fetchBidsForOrder as cd, getTotalSolverBalance as ce, memoizedSolverBalance as cf, orderCommitmentFromDecoded as cg, positionAmountOfToken as ch, readV4Position as ci, recoverBidSignerViem as cj, setAggregationFetch as ck, splitBidSignature as cl, weightedMedian as cm, zipFillLegs as cn, type IIsmpMessage as d, type IPostRequest as e, type IGetRequest as f, type IPolkadotHubConfig as g, type IPharosConfig as h, type StateMachineUpdate as i, type ResponseCommitmentWithValues as j, type RequestStatusWithMetadata as k, type PostRequestTimeoutStatus as l, SubstrateChain as m, type ClientConfig as n, type IndexerQueryClient as o, type IProof as p, type IEvmChain as q, IntentsCoprocessor as r, Chains as s, type ConfiguredAssetSymbol as t, type AvailableLiquidity as u, type IntentOrderStatusUpdate as v, type SelectBidResult as w, type ResumeIntentOrderOptions as x, type CancelOrderOptions as y, type CancelQuote as z };