@hyperbridge/sdk 2.8.17 → 2.8.19

package/dist/browser/index.d.ts

@@ -3696,6 +3696,11 @@ interface SubmitBidOptions {
      */
     paymasterAndData?: HexString$1;
 }
+/**
+ * The fields of a bid UserOperation that decide its `preVerificationGas`: everything the
+ * solver signs except the signature and the `preVerificationGas` itself.
+ */
+type BidPreVerificationGasParams = Pick<SubmitBidOptions, "solverAccount" | "nonce" | "entryPointAddress" | "callGasLimit" | "verificationGasLimit" | "maxFeePerGas" | "maxPriorityFeePerGas" | "callData" | "paymasterAndData">;
 interface EstimateFillOrderParams {
     order: Order;
     /** Positional input takes. Required with custom outputs; otherwise estimates a full fill at the order's rate. */
@@ -5182,6 +5187,10 @@ interface QuoteIntentResult {
     amountIn: bigint;
     /** The destination's protocol fee in basis points, already taken off every leg's `amountOut`. */
     slippageBps: number;
+    /**
+     * False when the route cannot fill the trade: `legs` is empty and `maxFillableIn` says how much
+     * it could. For an exact output, `amountIn` is then the input the SDK last tried.
+     */
     fillable: boolean;
     /** The largest `amountIn` the route's orders could take together, each at its own price. */
     maxFillableIn: bigint;
@@ -5207,6 +5216,11 @@ interface PessimisticQuoteIntentResult {
     priceBucket: bigint | null;
     /** The destination's protocol fee in basis points, already taken off `amountOut`. */
     slippageBps: number;
+    /**
+     * False when the route cannot fill the trade: `amountOut` is 0, `rate` and `priceBucket` are
+     * null, and `maxFillableIn` says how much it could. For an exact output, `amountIn` is then the
+     * input the SDK last tried.
+     */
     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;
@@ -5288,25 +5302,6 @@ declare class OrderbookQuoteNotConvergedError extends Error {
     /** The last input quoted, in the source token's raw units. */
     lastAmountIn: bigint);
 }
-/** 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);
-}
 
 /**
  * High-level facade for the IntentGatewayV2 protocol.
@@ -5416,9 +5411,10 @@ declare class IntentGateway {
      *
      * 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
+     * route that cannot fill the trade returns the orderbook's quote with
+     * `fillable: false` and its `maxFillableIn`, rather than throwing. 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.
      */
@@ -5689,6 +5685,14 @@ declare class IntentGateway {
      * @returns A {@link FillOrderEstimate} with all gas components.
      */
     estimateFillOrder(params: EstimateFillOrderParams): Promise<FillOrderEstimate>;
+    /**
+     * Asks the bundler for the `preVerificationGas` of a bid as it will be signed, priced at
+     * the gas price its bundle pays. Call it with the final calldata and `paymasterAndData`,
+     * before {@link prepareSubmitBid} signs the op.
+     *
+     * Delegates to {@link GasEstimator.estimateBidPreVerificationGas}.
+     */
+    estimateBidPreVerificationGas(params: BidPreVerificationGasParams): Promise<bigint>;
     /**
      * Quotes the solver fee for an order using the same policy {@link execute} /
      * {@link executeBest} apply when `order.fees` is `0n`.
@@ -11567,4 +11571,4 @@ declare function teleport(teleport_param: {
     extrinsics?: Array<SubmittableExtrinsic<"promise", ISubmittableResult>>;
 }): Promise<ReadableStream<HyperbridgeTxEvents>>;
 
-export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type AvailableLiquidity, type Bid, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type BuyAndSellRates, type BytesLikeHex, CONTRACT_VERSION_ABI, type CancelEvent, type CancelOptions, type CancelOrderOptions, type CancelQuote, type ChainConfig, type ChainConfigData, ChainConfigService, Chains, type ClientConfig, type ConfiguredAssetSymbol, type ConfiguredAssetSymbolInput, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedFillOrder, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type Deployment, type DispatchGet, type DispatchInfo, type DispatchPost, ERC20Method, type ERC7821Call, ERC7821_BATCH_MODE, type Erc4626VaultConfigData, type EstimateFillOrderParams, type EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, type ExecuteIntentOrderOptions, type ExecutionResult, FILL_ORDER_SELECTOR, type FillOptions, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString$1 as HexString, type HostParams, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, HyperFxOrderbook, type HyperbridgeTxEvents, type IBatchConsensusAndGetResponseMessage, type IBatchConsensusAndPostRequestMessage, type IChain, type IConfig, type IConsensusMessage, type IEvmChain, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, INCLUSION_TIMEOUT_MS, type IPharosConfig, type IPolkadotHubConfig, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, type IndexerQueryClient, InsufficientOrderbookLiquidityError, IntentGateway, ABI$1 as IntentGatewayABI, type IntentGatewayContext, type IntentGatewayParams, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, type IntentQuoteLeg, IntentsCoprocessor, IsmpClient, type IsmpRequest, MAX_DECLARED_ENTRIES, MOCK_ADDRESS, ORDERBOOK_DECIMALS, ORDERBOOK_QUERIES, ORDERBOOK_URLS, ORDER_V2_PARAM_TYPE, type Order, type OrderFeesQuote, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type 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, PERMIT2_SPONSORSHIP_BYTES, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PessimisticQuoteIntentResult, type PhantomBidDeclaration, type PhantomBidPaymasterAndData, type PhantomBidSponsorship, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type 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, type RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type ResumeIntentOrderOptions, type RetryConfig, type RpcBidInfo, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SUPPORTED_INTENTS_VERSION, type SelectBidResult, type SelectOptions, type SigningAccount, type StateMachineHeight, type StateMachineId, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, type SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, assertGatewayRelease, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeAcceptedSourceChains, decodeERC7821ExecuteBatch, decodeFillOrder, decodePhantomBidDeclaration, decodePhantomBidPaymasterAndData, decodeUserOpScale, deriveHttpUrl, encodeAcceptedSourceChains, encodeERC7821ExecuteBatch, encodeFillOrder, encodeISMPMessage, encodePhantomBidDeclaration, encodePhantomBidPaymasterAndData, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, isCanonicalEvmToken, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, orderbookUrlFor, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, previewRateFill, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readLegEscrow, readLegPartialFill, requestCommitmentKey, responseCommitmentKey, retryPromise, sortPoolSymbols, supportsRateFills, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
+export { ADDRESS_ZERO, type AllStatusKey, type AssetTeleported, type AssetTeleportedResponse, type AvailableLiquidity, type Bid, type BidPreVerificationGasParams, type BidStorageEntry, type BidSubmissionResult, type BlockMetadata, type BridgeParams, type BridgeStep, type BundlerGasEstimate, BundlerMethod, type BuyAndSellRates, type BytesLikeHex, CONTRACT_VERSION_ABI, type CancelEvent, type CancelOptions, type CancelOrderOptions, type CancelQuote, type ChainConfig, type ChainConfigData, ChainConfigService, Chains, type ClientConfig, type ConfiguredAssetSymbol, type ConfiguredAssetSymbolInput, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, type DecodedFillOrder, type DecodedOrderPlacedLog, type DecodedPostRequestEvent, type DecodedPostResponseEvent, type Deployment, type DispatchGet, type DispatchInfo, type DispatchPost, ERC20Method, type ERC7821Call, ERC7821_BATCH_MODE, type Erc4626VaultConfigData, type EstimateFillOrderParams, type EstimateGasCallData, EvmChain, type EvmChainParams, ABI as EvmHostABI, EvmLanguage, type ExecuteIntentOrderOptions, type ExecutionResult, FILL_ORDER_SELECTOR, type FillOptions, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString$1 as HexString, type HostParams, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, HyperFxOrderbook, type HyperbridgeTxEvents, type IBatchConsensusAndGetResponseMessage, type IBatchConsensusAndPostRequestMessage, type IChain, type IConfig, type IConsensusMessage, type IEvmChain, type IEvmConfig, type IGetRequest, type IGetRequestMessage, type IGetResponse, type IGetResponseMessage, type IHyperbridgeConfig, type IIsmpMessage, type IMessage, INCLUSION_TIMEOUT_MS, type IPharosConfig, type IPolkadotHubConfig, type IPostRequest, type IPostResponse, type IProof, type IRequestMessage, type ISubstrateConfig, type ITimeoutPostRequestMessage, type IndexerQueryClient, IntentGateway, ABI$1 as IntentGatewayABI, type IntentGatewayContext, type IntentGatewayParams, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, type IntentQuoteLeg, IntentsCoprocessor, IsmpClient, type IsmpRequest, MAX_DECLARED_ENTRIES, MOCK_ADDRESS, ORDERBOOK_DECIMALS, ORDERBOOK_QUERIES, ORDERBOOK_URLS, ORDER_V2_PARAM_TYPE, type Order, type OrderFeesQuote, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type 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, PERMIT2_SPONSORSHIP_BYTES, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PessimisticQuoteIntentResult, type PhantomBidDeclaration, type PhantomBidPaymasterAndData, type PhantomBidSponsorship, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, type PostRequestStatus, type PostRequestTimeoutStatus, type PostRequestWithStatus, type 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, type RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type ResumeIntentOrderOptions, type RetryConfig, type RpcBidInfo, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SUPPORTED_INTENTS_VERSION, type SelectBidResult, type SelectOptions, type SigningAccount, type StateMachineHeight, type StateMachineId, type StateMachineIdParams, type StateMachineResponse, type StateMachineUpdate, type StorageFacade, type SubmitBidOptions, SubstrateChain, Swap, TESTNET_CHAINS, type TeleportParams, TeleportStatus, TimeoutStatus, type TimeoutStatusKey, TokenGateway, type TokenGatewayAssetTeleportedResponse, type TokenGatewayAssetTeleportedWithStatus, type TokenInfo, type TokenPrice, type TokenPricesResponse, type Transaction, TronChain, type TronChainParams, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, assertGatewayRelease, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeAcceptedSourceChains, decodeERC7821ExecuteBatch, decodeFillOrder, decodePhantomBidDeclaration, decodePhantomBidPaymasterAndData, decodeUserOpScale, deriveHttpUrl, encodeAcceptedSourceChains, encodeERC7821ExecuteBatch, encodeFillOrder, encodeISMPMessage, encodePhantomBidDeclaration, encodePhantomBidPaymasterAndData, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, isCanonicalEvmToken, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, orderbookUrlFor, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, previewRateFill, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readLegEscrow, readLegPartialFill, requestCommitmentKey, responseCommitmentKey, retryPromise, sortPoolSymbols, supportsRateFills, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };

package/dist/browser/index.js

@@ -18313,6 +18313,16 @@ var NO_BUNDLER_FILL_GAS_BASE = 700000n;
 var NO_BUNDLER_FILL_GAS_PER_OUTPUT = 150000n;
 var NO_BUNDLER_PAYMASTER_VERIFICATION_GAS = 250000n;
 var NO_BUNDLER_PAYMASTER_POST_OP_GAS = 100000n;
+var BID_PVG_ESTIMATION_ACCOUNT_CODE = "0x60003560e01c631626ba7e1460145760206000f35b631626ba7e60e01b60005260206000f3";
+var SELECTED_BID_SIGNATURE_BYTES = 32 + 65 + 65;
+var BID_PVG_HEADROOM_PERCENT = 10n;
+var ESCROW_MAPPING_SLOT = 9n;
+function escrowSlot(commitment, leg) {
+  const byCommitment = keccak256(
+    encodeAbiParameters([{ type: "bytes32" }, { type: "uint256" }], [commitment, ESCROW_MAPPING_SLOT])
+  );
+  return keccak256(encodeAbiParameters([{ type: "uint256" }, { type: "bytes32" }], [BigInt(leg), byCommitment]));
+}
 var GasEstimator = class {
   /**
    * @param ctx - Shared IntentsV2 context providing the source and destination
@@ -18391,6 +18401,7 @@ var GasEstimator = class {
       assetsForOverrides.push({ token: feeTokenAsBytes32, amount: 0n });
     }
     const isSameChain = souceStateMachineId === destStateMachineId;
+    const commitment = orderCommitment(order);
     const [stateOverridesResult, crossChainFees] = await Promise.all([
       this.ctx.bundlerUrl ? this.buildStateOverride({
         accountAddress: solverAccountAddress,
@@ -18398,7 +18409,16 @@ var GasEstimator = class {
         outputAssets: assetsForOverrides,
         spenderAddress: intentGatewayV2Address,
         intentGatewayV2Address,
-        entryPointAddress
+        entryPointAddress,
+        // A fee quote runs before the order is placed, so nothing is escrowed under
+        // its commitment yet. Cross-chain fills release escrow on the source chain.
+        escrow: isSameChain ? {
+          commitment,
+          inputs: order.inputs.map((input) => ({
+            token: normalizeAddressForEvmBytes32(input.token),
+            amount: input.amount
+          }))
+        } : void 0
       }) : Promise.resolve({ viem: [], bundler: {} }),
       isSameChain ? Promise.resolve({ postRequestFee: 0n, relayerFeeInSourceFeeToken: 0n }) : this.estimateCrossChainFees(
         sourceFeeToken,
@@ -18427,10 +18447,8 @@ var GasEstimator = class {
     const maxFeeBumpPercent = params.maxFeePerGasBumpPercent ?? 10;
     let maxPriorityFeePerGas = gasPrice + gasPrice * BigInt(priorityFeeBumpPercent) / 100n;
     let maxFeePerGas = gasPrice + gasPrice * BigInt(maxFeeBumpPercent) / 100n;
-    const orderForEstimation = { ...order, session: solverAccountAddress };
-    const commitment = orderCommitment(orderForEstimation);
     await assertGatewayRelease(this.ctx.dest.client, intentGatewayV2Address);
-    const fillOrderCalldata = encodeFillOrder(transformOrderForContract(orderForEstimation), fillOptions);
+    const fillOrderCalldata = encodeFillOrder(transformOrderForContract(order), fillOptions);
     let callGasLimit = 500000n;
     let verificationGasLimit = 100000n;
     let preVerificationGas = 100000n;
@@ -18442,7 +18460,7 @@ var GasEstimator = class {
           ...params.prependCalls ?? [],
           { target: intentGatewayV2Address, value: totalNativeValue, data: fillOrderCalldata }
         ]);
-        const accountGasLimits = CryptoUtils.packGasLimits(100000n, callGasLimit);
+        const accountGasLimits = CryptoUtils.packGasLimits(0n, 0n);
         const gasFees = CryptoUtils.packGasFees(maxPriorityFeePerGas, maxFeePerGas);
         const nonce = 0n;
         const preliminaryUserOp = {
@@ -18451,7 +18469,7 @@ var GasEstimator = class {
           initCode: "0x",
           callData,
           accountGasLimits,
-          preVerificationGas: 100000n,
+          preVerificationGas: 0n,
           gasFees,
           paymasterAndData: "0x",
           signature: "0x"
@@ -18581,6 +18599,53 @@ var GasEstimator = class {
       inputs
     };
   }
+  /**
+   * Asks the bundler for the `preVerificationGas` of the bid UserOperation that will
+   * actually be signed, with every funding call, approval and signature byte in it.
+   *
+   * On an L2, `preVerificationGas` also pays the L1 data fee for the op's bytes, a fixed
+   * amount of wei that the bundler converts to gas at the price the op pays. A bundler
+   * admits an op priced at its `maxFeePerGas`, but bundles it at the base fee plus its
+   * priority fee, where the same wei costs more gas. An op sized only for admission is
+   * accepted and then skipped in every bundle until it expires. The estimate is taken
+   * at the bundle's price: the latest base fee plus the op's priority fee, capped at its
+   * `maxFeePerGas`.
+   *
+   * The solver account's code is overridden with {@link BID_PVG_ESTIMATION_ACCOUNT_CODE}
+   * for the call, so only the bytes are priced and the fill itself is not simulated.
+   *
+   * @param params - The bid's fields as they will be signed.
+   * @returns The `preVerificationGas` to sign, with {@link BID_PVG_HEADROOM_PERCENT} added.
+   * @throws If no bundler is configured or the bundler rejects the estimate.
+   */
+  async estimateBidPreVerificationGas(params) {
+    const { solverAccount, maxFeePerGas, maxPriorityFeePerGas } = params;
+    const latestBlock = await this.ctx.dest.client.getBlock({ blockTag: "latest" });
+    const baseFeePerGas = latestBlock.baseFeePerGas;
+    const bundlePrice = baseFeePerGas == null || baseFeePerGas + maxPriorityFeePerGas > maxFeePerGas ? maxFeePerGas : baseFeePerGas + maxPriorityFeePerGas;
+    const priorityFee = maxPriorityFeePerGas < bundlePrice ? maxPriorityFeePerGas : bundlePrice;
+    const userOp = {
+      sender: solverAccount,
+      nonce: params.nonce,
+      initCode: "0x",
+      callData: params.callData,
+      accountGasLimits: CryptoUtils.packGasLimits(params.verificationGasLimit, params.callGasLimit),
+      // Bundlers return a non-zero preVerificationGas as given rather than estimating it.
+      preVerificationGas: 0n,
+      gasFees: CryptoUtils.packGasFees(priorityFee, bundlePrice),
+      paymasterAndData: params.paymasterAndData ?? "0x",
+      signature: `0x${"ff".repeat(SELECTED_BID_SIGNATURE_BYTES)}`
+    };
+    const estimate = await this.crypto.sendBundler(
+      BundlerMethod.ETH_ESTIMATE_USER_OPERATION_GAS,
+      [
+        CryptoUtils.prepareBundlerCall(userOp),
+        params.entryPointAddress,
+        { [solverAccount]: { code: BID_PVG_ESTIMATION_ACCOUNT_CODE } }
+      ]
+    );
+    return BigInt(estimate.preVerificationGas) * (100n + BID_PVG_HEADROOM_PERCENT) / 100n;
+  }
   /**
    * Estimates the cross-chain ISMP POST request fee (the relayer fee for the
    * RedeemEscrow message), in both the source and destination fee tokens.
@@ -18633,20 +18698,38 @@ var GasEstimator = class {
    * @returns An object with `viem` and `bundler` state-override collections.
    */
   async buildStateOverride(params) {
-    const { accountAddress, chain, outputAssets, spenderAddress, intentGatewayV2Address, entryPointAddress } = params;
-    const testValue = toHex(maxUint256 / 2n, { size: 32 });
+    const {
+      accountAddress,
+      chain,
+      outputAssets,
+      spenderAddress,
+      intentGatewayV2Address,
+      entryPointAddress,
+      escrow
+    } = params;
+    const testValue = toHex(2n ** 128n, { size: 32 });
     const viemOverrides = [];
     const bundlerOverrides = {};
     if (intentGatewayV2Address) {
       const paramsSlot5 = pad(toHex(5n), { size: 32 });
       const dispatcherAddress = this.ctx.dest.configService.getCalldispatcherAddress(chain);
       const newSlot5Value = "0x" + "0".repeat(22) + "00" + dispatcherAddress.slice(2).toLowerCase();
+      const gatewayDiffs = [{ slot: paramsSlot5, value: newSlot5Value }];
+      for (const [leg, input] of (escrow?.inputs ?? []).entries()) {
+        gatewayDiffs.push({
+          slot: escrowSlot(escrow.commitment, leg),
+          value: toHex(input.amount, { size: 32 })
+        });
+      }
+      const releasesNative = escrow?.inputs.some((input) => bytes32ToBytes20(input.token) === ADDRESS_ZERO2);
       viemOverrides.push({
         address: intentGatewayV2Address,
-        stateDiff: [{ slot: paramsSlot5, value: newSlot5Value }]
+        ...releasesNative ? { balance: 2n ** 128n } : {},
+        stateDiff: gatewayDiffs
       });
       bundlerOverrides[intentGatewayV2Address] = {
-        stateDiff: { [paramsSlot5]: newSlot5Value }
+        ...releasesNative ? { balance: testValue } : {},
+        stateDiff: Object.fromEntries(gatewayDiffs.map(({ slot, value }) => [slot, value]))
       };
     }
     if (entryPointAddress) {
@@ -18677,6 +18760,25 @@ var GasEstimator = class {
         bundlerOverrides[result.address] = { stateDiff: result.bundlerStateDiffs };
       }
     }
+    if (intentGatewayV2Address && escrow) {
+      const gatewayBalances = await Promise.all(
+        escrow.inputs.map((input) => this.tokenBalanceSlot(input.token, intentGatewayV2Address, chain))
+      );
+      for (const override of gatewayBalances) {
+        if (!override) continue;
+        const existing = viemOverrides.find((entry) => entry.address === override.address && entry.stateDiff);
+        if (existing) existing.stateDiff.push({ slot: override.slot, value: testValue });
+        else
+          viemOverrides.push({
+            address: override.address,
+            stateDiff: [{ slot: override.slot, value: testValue }]
+          });
+        bundlerOverrides[override.address] = {
+          ...bundlerOverrides[override.address],
+          stateDiff: { ...bundlerOverrides[override.address]?.stateDiff, [override.slot]: testValue }
+        };
+      }
+    }
     const solverAccountContract = this.ctx.dest.configService.getSolverAccountAddress(chain);
     if (solverAccountContract) {
       try {
@@ -18699,6 +18801,21 @@ var GasEstimator = class {
     }
     return { viem: viemOverrides, bundler: bundlerOverrides };
   }
+  /**
+   * The balance slot of `holder` in an ERC-20 token, for overriding. `null` for the native
+   * token or when the slot cannot be discovered.
+   */
+  async tokenBalanceSlot(tokenHex, holder, chain) {
+    const tokenAddress = bytes32ToBytes20(tokenHex);
+    if (tokenAddress === ADDRESS_ZERO2) return null;
+    try {
+      const balanceData = "0x70a08231" /* BALANCE_OF */ + bytes20ToBytes32(holder).slice(2);
+      const slot = await getOrFetchStorageSlot(this.ctx.dest.client, chain, tokenAddress, balanceData);
+      return slot ? { address: tokenAddress, slot } : null;
+    } catch {
+      return null;
+    }
+  }
   /**
    * Resolves the balance and allowance storage slot overrides for a single
    * ERC-20 token in parallel.  Returns `null` for native-ETH tokens or when
@@ -19010,18 +19127,6 @@ var OrderbookQuoteNotConvergedError = class extends Error {
   rounds;
   lastAmountIn;
 };
-var InsufficientOrderbookLiquidityError = class extends Error {
-  constructor(route, maxFillableIn) {
-    super(
-      `The HyperFX orderbook cannot fill ${route.tokenIn} -> ${route.tokenOut} on ${route.sourceChain} -> ${route.destinationChain}; max fillable input is ${maxFillableIn} raw units`
-    );
-    this.route = route;
-    this.maxFillableIn = maxFillableIn;
-    this.name = "InsufficientOrderbookLiquidityError";
-  }
-  route;
-  maxFillableIn;
-};
 
 // src/protocols/intents/orderbook/market.ts
 var MAX_EXACT_OUTPUT_ROUNDS = 16;
@@ -19077,8 +19182,9 @@ var OrderbookMarket = class {
     };
   }
   /**
-   * The fillable quote for an exact input, or for the input found to deliver an
-   * exact output, with the assets it trades.
+   * The orderbook's quote for an exact input, or for the input found to deliver
+   * an exact output, with the assets it trades. A route that cannot fill the
+   * trade answers with an unfillable quote rather than an error.
    */
   async priceIntent(params, sourceChain, destinationChain, price, totals) {
     validateQuoteParams(params);
@@ -19087,10 +19193,7 @@ var OrderbookMarket = class {
     const route = toRoute(tokenIn, tokenOut);
     if (params.amountIn !== void 0) {
       const quote2 = await price(route, toOrderbookAmount(params.amountIn, tokenIn.decimals));
-      const { fillable, amountOut, maxFillableIn } = totals(quote2);
-      if (!fillable || fromOrderbookAmount(amountOut, tokenOut.decimals) === 0n) {
-        throw this.insufficient(route, maxFillableIn, tokenIn);
-      }
+      totals(quote2);
       return { quote: quote2, tokenIn, tokenOut };
     }
     const targetOut = toOrderbookAmount(params.amountOut, tokenOut.decimals);
@@ -19152,18 +19255,21 @@ var OrderbookMarket = class {
    * filled better than its worst rate and re-pricing the rest of `targetOut` at
    * the input-to-output ratio that part filled at, until a quote delivers it.
    * That ratio is the orderbook's own, with the protocol fee already taken off.
+   *
+   * An output the route cannot deliver is answered by quoting an input past its
+   * `maxFillableIn`, which the orderbook serves as unfillable: the smallest such
+   * input guessed from the best rate, or one raw unit when no order serves it.
    */
   async quoteExactOutput(route, targetOut, tokenIn, price, totals) {
     const liquidity = await this.orderbook().routeLiquidity(route);
-    if (liquidity.bestRate === null) throw this.insufficient(route, 0n, tokenIn);
     const inputUnit = toOrderbookAmount(1n, tokenIn.decimals);
-    let amountIn = roundUpTo(requiredInput(liquidity.side, targetOut, liquidity.bestRate), inputUnit);
+    let amountIn = liquidity.bestRate === null ? inputUnit : roundUpTo(requiredInput(liquidity.side, targetOut, liquidity.bestRate), inputUnit);
     let lastAmountIn = amountIn;
     for (let round = 0; round < MAX_EXACT_OUTPUT_ROUNDS; round++) {
-      if (amountIn > liquidity.maxFillableIn) throw this.insufficient(route, liquidity.maxFillableIn, tokenIn);
       const served = await price(route, amountIn);
       const quote = totals(served);
       if (quote.fillable && quote.amountOut >= targetOut) return served;
+      if (!quote.fillable && amountIn > liquidity.maxFillableIn) return served;
       lastAmountIn = amountIn;
       const betterIn = quote.amountIn - quote.worstIn;
       const betterOut = quote.amountOut - quote.worstOut;
@@ -19176,9 +19282,6 @@ var OrderbookMarket = class {
       fromOrderbookAmount(lastAmountIn, tokenIn.decimals)
     );
   }
-  insufficient(route, maxFillableIn, tokenIn) {
-    return new InsufficientOrderbookLiquidityError(route, fromOrderbookAmount(maxFillableIn, tokenIn.decimals));
-  }
   assetByAddress(chain, address) {
     const resolvedChain = resolveChain(chain);
     return withDecimals(
@@ -19826,6 +19929,16 @@ var IntentGateway = class _IntentGateway {
   async estimateFillOrder(params) {
     return this.gasEstimator.estimateFillOrder(params);
   }
+  /**
+   * Asks the bundler for the `preVerificationGas` of a bid as it will be signed, priced at
+   * the gas price its bundle pays. Call it with the final calldata and `paymasterAndData`,
+   * before {@link prepareSubmitBid} signs the op.
+   *
+   * Delegates to {@link GasEstimator.estimateBidPreVerificationGas}.
+   */
+  async estimateBidPreVerificationGas(params) {
+    return this.gasEstimator.estimateBidPreVerificationGas(params);
+  }
   /**
    * Quotes the solver fee for an order using the same policy {@link execute} /
    * {@link executeBest} apply when `order.fees` is `0n`.
@@ -24708,6 +24821,6 @@ async function teleportDot(param_) {
   return stream;
 }
 
-export { ADDRESS_ZERO2 as ADDRESS_ZERO, BundlerMethod, CONTRACT_VERSION_ABI, ChainConfigService, Chains, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, ERC20Method, ERC7821_BATCH_MODE, EvmChain, ABI as EvmHostABI, EvmLanguage, FILL_ORDER_SELECTOR, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, HyperFxOrderbook, INCLUSION_TIMEOUT_MS, InsufficientOrderbookLiquidityError, IntentGateway, ABI3 as IntentGatewayABI, IntentOrderStatus, IntentsCoprocessor, IsmpClient, MAX_DECLARED_ENTRIES, MOCK_ADDRESS, ORDERBOOK_DECIMALS, ORDERBOOK_QUERIES, ORDERBOOK_URLS, ORDER_V2_PARAM_TYPE, OrderStatus, OrderStatusChecker, OrderbookQuoteNotConvergedError, OrderbookRequestError, PACKED_USEROP_TYPEHASH, PERMIT2_SPONSORSHIP_BYTES, PLACE_ORDER_SELECTOR, PharosChain, PolkadotHubChain, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestKind, RequestStatus, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SUPPORTED_INTENTS_VERSION, SubstrateChain, Swap, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, TokenGateway, TronChain, USE_ETHERSCAN_CHAINS, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, __test, adjustDecimals, assertGatewayRelease, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeAcceptedSourceChains, decodeERC7821ExecuteBatch, decodeFillOrder, decodePhantomBidDeclaration, decodePhantomBidPaymasterAndData, decodeUserOpScale, deriveHttpUrl, encodeAcceptedSourceChains, encodeERC7821ExecuteBatch, encodeFillOrder, encodeISMPMessage, encodePhantomBidDeclaration, encodePhantomBidPaymasterAndData, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, isCanonicalEvmToken, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, orderbookUrlFor, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, previewRateFill, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readLegEscrow, readLegPartialFill, requestCommitmentKey, responseCommitmentKey, retryPromise, sortPoolSymbols, supportsRateFills, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
+export { ADDRESS_ZERO2 as ADDRESS_ZERO, BundlerMethod, CONTRACT_VERSION_ABI, ChainConfigService, Chains, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, ERC20Method, ERC7821_BATCH_MODE, EvmChain, ABI as EvmHostABI, EvmLanguage, FILL_ORDER_SELECTOR, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, HyperFxOrderbook, INCLUSION_TIMEOUT_MS, IntentGateway, ABI3 as IntentGatewayABI, IntentOrderStatus, IntentsCoprocessor, IsmpClient, MAX_DECLARED_ENTRIES, MOCK_ADDRESS, ORDERBOOK_DECIMALS, ORDERBOOK_QUERIES, ORDERBOOK_URLS, ORDER_V2_PARAM_TYPE, OrderStatus, OrderStatusChecker, OrderbookQuoteNotConvergedError, OrderbookRequestError, PACKED_USEROP_TYPEHASH, PERMIT2_SPONSORSHIP_BYTES, PLACE_ORDER_SELECTOR, PharosChain, PolkadotHubChain, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestKind, RequestStatus, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SUPPORTED_INTENTS_VERSION, SubstrateChain, Swap, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, TokenGateway, TronChain, USE_ETHERSCAN_CHAINS, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, __test, adjustDecimals, assertGatewayRelease, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeAcceptedSourceChains, decodeERC7821ExecuteBatch, decodeFillOrder, decodePhantomBidDeclaration, decodePhantomBidPaymasterAndData, decodeUserOpScale, deriveHttpUrl, encodeAcceptedSourceChains, encodeERC7821ExecuteBatch, encodeFillOrder, encodeISMPMessage, encodePhantomBidDeclaration, encodePhantomBidPaymasterAndData, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, isCanonicalEvmToken, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, orderbookUrlFor, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, previewRateFill, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readLegEscrow, readLegPartialFill, requestCommitmentKey, responseCommitmentKey, retryPromise, sortPoolSymbols, supportsRateFills, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map