@hyperbridge/sdk 2.8.11 → 2.8.13

package/dist/node/{intents-helpers-BRegx4yZ.d.cts → intents-helpers-fntBuoYM.d.cts}

@@ -2812,13 +2812,6 @@ interface FillerConfig {
      * Example: { 1: true, 56: false } - watch-only on Ethereum, normal execution on BSC
      */
     watchOnly?: Record<number, boolean>;
-    /**
-     * Source chains (state machine ids, e.g. "EVM-8453") this filler accepts payment from when
-     * filling cross-chain orders, declared inside its phantom bids' paymasterAndData. Omit to
-     * declare nothing, which downstream consumers read as "accepts all CCTP/USDT0-covered
-     * chains"; an empty array declares that no source chain is accepted.
-     */
-    acceptedSourceChains?: string[];
     /**
      * Uniswap V4 position tokenIds this filler holds, per chain (state machine id -> tokenIds as
      * decimal strings), declared inside its phantom bids' paymasterAndData for the bid's own chain.
@@ -5426,6 +5419,24 @@ declare const FILL_ORDER_ABI: readonly [{
     readonly name: "WrongChain";
     readonly inputs: readonly [];
 }];
+/** A complete Permit2-sponsored paymasterAndData, before any declaration is appended. */
+declare const PERMIT2_SPONSORSHIP_BYTES: number;
+/**
+ * The Permit2 sponsorship a bid's paymasterAndData carries when it was built on the real-bid path:
+ * which paymaster it names and the fee-token permit it signed for that paymaster. Read for the
+ * record only — the bid's authenticity comes from the solver signature over the userOpHash, which
+ * covers these bytes, so nothing here is verified further and the permit signature is not kept.
+ */
+interface PhantomBidSponsorship {
+    paymaster: HexString;
+    /** The fee token the permit draws on. */
+    token: HexString;
+    permitAmount: bigint;
+    /** Permit2 unordered nonce — random per op, which is what lets a solver's bids run in parallel. */
+    nonce: bigint;
+    /** Unix seconds after which the permit is unusable. */
+    deadline: bigint;
+}
 /** What a phantom bid's paymasterAndData declares about the solver behind it. */
 interface PhantomBidDeclaration {
     /**
@@ -5449,12 +5460,53 @@ declare function encodePhantomBidDeclaration(declaration: {
     acceptedSourceChains?: string[];
     uniswapV4Positions?: bigint[];
 }): HexString;
+/** Everything a phantom bid's paymasterAndData was found to carry. */
+interface PhantomBidPaymasterAndData {
+    /**
+     * Which shape the field was read as: a bare declaration, a Permit2-sponsored bid (with or
+     * without a declaration appended), or neither — empty, or bytes matching no known layout.
+     */
+    mode: "declaration" | "permit2" | "none";
+    /** Never null: an unreadable or missing declaration is the absent one (null sources, no positions). */
+    declaration: PhantomBidDeclaration;
+    /** The paymaster fields of a sponsored bid; null for the other two modes. */
+    sponsorship: PhantomBidSponsorship | null;
+}
 /**
- * Decodes a phantom bid's paymasterAndData. Understands both layout versions, so bids placed
+ * Decodes a phantom bid's paymasterAndData in whichever shape it takes.
+ *
+ * A bare declaration is tried first, so every bid placed before sponsored phantom bids existed
+ * decodes to the byte exactly as it did. Failing that, a blob opening with a complete
+ * Permit2-sponsored payload is read as a sponsored bid, and whatever follows the permit is parsed
+ * as its declaration. Both parsers demand exact consumption — a bare declaration must end where
+ * the bytes end, and a sponsored bid's tail must be a whole declaration or nothing — so neither
+ * shape can be half-read as the other.
+ *
+ * A malformed tail on a sponsored bid yields the absent declaration but still reports the
+ * sponsorship: the bid is still a bid, it just declared nothing readable.
+ */
+declare function decodePhantomBidPaymasterAndData(paymasterAndData: string | undefined | null): PhantomBidPaymasterAndData;
+/**
+ * Decodes the declaration out of a phantom bid's paymasterAndData, whichever shape it takes (see
+ * {@link decodePhantomBidPaymasterAndData}). Understands both declaration versions, so bids placed
  * before positions existed keep decoding unchanged. Anything absent, unversioned or malformed
  * yields a null `acceptedSources` with no positions — never a partial read.
  */
 declare function decodePhantomBidDeclaration(paymasterAndData: string | undefined | null): PhantomBidDeclaration;
+/**
+ * Builds a phantom bid's paymasterAndData: the declaration alone, or appended to a Permit2
+ * sponsorship when the bid was built on the real-bid path and carries one.
+ *
+ * `sponsorship` is the packed EntryPoint v0.8 paymasterAndData the paymaster builder produced. It
+ * must be exactly the Permit2-mode layout — the only one the decoder recognises — so a caller
+ * cannot sign bytes the aggregation would read as "no declaration"; anything else throws. Empty
+ * or omitted, the result is the bare declaration, byte-identical to what unsponsored bids carry.
+ */
+declare function encodePhantomBidPaymasterAndData(bid: {
+    sponsorship?: HexString | null;
+    acceptedSourceChains?: string[];
+    uniswapV4Positions?: bigint[];
+}): HexString;
 /** Back-compat wrapper: the source-chain half of {@link encodePhantomBidDeclaration}. */
 declare function encodeAcceptedSourceChains(chains: string[]): HexString;
 /** Back-compat wrapper: the source-chain half of {@link decodePhantomBidDeclaration}. */
@@ -5586,19 +5638,24 @@ interface AggregationLogger {
  * paid its cost of goods.
  */
 declare const UNISWAP_QUOTE_HAIRCUT_BPS = 10n;
+/** Applies {@link UNISWAP_QUOTE_HAIRCUT_BPS} to a quoted output amount, rounding down. */
+declare function applyUniswapQuoteHaircut(amount: bigint): bigint;
 /**
- * Haircut applied to every phantom quote that is NOT priced off a Uniswap V4 pool, in basis points.
+ * The protocol fee haircut: the fee the IntentGateway at `gatewayAddress` charges on order inputs,
+ * in basis points, read live from its `params()`.
  *
- * 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.
+ * A wallet-funded quote is shaded by exactly this, so the published rate is the one a taker
+ * actually realizes after the gateway takes its cut, and it moves with governance rather than
+ * with a constant someone has to remember to keep in step. Read on the phantom order's own chain,
+ * which is the chain whose gateway will collect the fee on the fills this rate is published for.
+ *
+ * Fails loudly rather than defaulting: a gateway that returns no code, or a fee at or above 100%,
+ * is a misconfiguration, and pricing a window unhaircut on the back of it would publish a rate
+ * nobody can trade at. The `PhantomRpcError` lets the run's retry loop have another go first.
  */
-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 readProtocolFeeHaircutBps(evmRpcUrl: string, gatewayAddress: string): Promise<bigint>;
+/** Applies the protocol fee haircut (see {@link readProtocolFeeHaircutBps}) to a quoted output amount, rounding down. */
+declare function applyProtocolFeeHaircut(amount: bigint, protocolFeeBps: bigint): bigint;
 declare function weightedMedian(entries: {
     price: bigint;
     weight: bigint;
@@ -8845,4 +8902,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$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 };
+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 PostRequestStatus 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, PERMIT2_SPONSORSHIP_BYTES as aN, type PaymentInfo as aO, type PhantomBid as aP, type PhantomBidBatchResult as aQ, type PhantomBidDeclaration as aR, type PhantomBidOutcome as aS, type PhantomBidPaymasterAndData as aT, type PhantomBidSponsorship as aU, type PhantomOrderEvent as aV, type PhantomOrderLeg as aW, type PhantomOrderPriceSnapshot as aX, type PhantomOrderPriceSnapshotsResponse as aY, type PhantomTimings as aZ, type PollPhantomOrdersOptions 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 FetchLike as b$, type RequestBody as b0, type RequestCommitment as b1, RequestKind as b2, type RequestResponse as b3, RequestStatus as b4, type RequestStatusKey as b5, type SelectOptions as b6, type SigningAccount as b7, type StateMachineId as b8, type StateMachineResponse as b9, encodeAcceptedSourceChains as bA, encodeERC7821ExecuteBatch as bB, encodeFillOrder as bC, encodeISMPMessage as bD, encodePhantomBidDeclaration as bE, encodePhantomBidPaymasterAndData as bF, encodeUserOpScale as bG, getChainId as bH, getConfigByStateMachineId as bI, getFillOptionsVersion as bJ, getViemChain as bK, hyperbridgeAddress as bL, pharosAtlantic as bM, pharosMainnet as bN, polkadotAssetHubPaseo as bO, polkadotHubMainnet as bP, poolSlug as bQ, readProtocolFeeHaircutBps as bR, resetFillOptionsVersionCache as bS, sortPoolSymbols as bT, tronChainIds as bU, tronNile as bV, type AggregationLogger as bW, type BidNonceKeyFn as bX, type BidSignature as bY, ENTRY_POINT_V08_ADDRESS as bZ, FILL_ORDER_ABI as b_, type StorageFacade as ba, TimeoutStatus as bb, type TimeoutStatusKey as bc, type TokenGatewayAssetTeleportedResponse as bd, type TokenInfo as be, type TokenPrice as bf, type TokenPricesResponse as bg, UNISWAP_QUOTE_HAIRCUT_BPS as bh, type UniswapV4PoolConfigData as bi, applyProtocolFeeHaircut as bj, applyUniswapQuoteHaircut as bk, chainConfigs as bl, convertCodecToIGetRequest as bm, convertCodecToIProof as bn, convertIGetRequestToCodec as bo, convertIProofToCodec as bp, convertStateIdToStateMachineId as bq, convertStateMachineEnumToString as br, convertStateMachineIdToEnum as bs, decodeAcceptedSourceChains as bt, decodeERC7821ExecuteBatch as bu, decodeFillOrder as bv, decodePhantomBidDeclaration as bw, decodePhantomBidPaymasterAndData as bx, decodeUserOpScale as by, deriveHttpUrl as bz, type StateMachineHeight as c, type FillData as c0, type HexString as c1, _default as c2, type LpBalance as c3, type OrderCommitmentFn as c4, type PhantomAggregation as c5, type PhantomLegAggregation as c6, type PhantomLegBidder as c7, type PoolAndPositionInfo as c8, type RecoverBidSigner as c9, type RpcBidInfo as ca, type SolverBalanceReader as cb, type SolverV4Position as cc, type UniswapV4Contracts as cd, type V4PositionState as ce, type YieldVaultMap as cf, aggregatePhantomBids as cg, extractFillData as ch, fetchBidsForOrder as ci, getTotalSolverBalance as cj, memoizedSolverBalance as ck, orderCommitmentFromDecoded as cl, positionAmountOfToken as cm, readV4Position as cn, recoverBidSignerViem as co, setAggregationFetch as cp, splitBidSignature as cq, weightedMedian as cr, zipFillLegs as cs, 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 };

package/dist/node/{intents-helpers-BRegx4yZ.d.ts → intents-helpers-fntBuoYM.d.ts}

@@ -2812,13 +2812,6 @@ interface FillerConfig {
      * Example: { 1: true, 56: false } - watch-only on Ethereum, normal execution on BSC
      */
     watchOnly?: Record<number, boolean>;
-    /**
-     * Source chains (state machine ids, e.g. "EVM-8453") this filler accepts payment from when
-     * filling cross-chain orders, declared inside its phantom bids' paymasterAndData. Omit to
-     * declare nothing, which downstream consumers read as "accepts all CCTP/USDT0-covered
-     * chains"; an empty array declares that no source chain is accepted.
-     */
-    acceptedSourceChains?: string[];
     /**
      * Uniswap V4 position tokenIds this filler holds, per chain (state machine id -> tokenIds as
      * decimal strings), declared inside its phantom bids' paymasterAndData for the bid's own chain.
@@ -5426,6 +5419,24 @@ declare const FILL_ORDER_ABI: readonly [{
     readonly name: "WrongChain";
     readonly inputs: readonly [];
 }];
+/** A complete Permit2-sponsored paymasterAndData, before any declaration is appended. */
+declare const PERMIT2_SPONSORSHIP_BYTES: number;
+/**
+ * The Permit2 sponsorship a bid's paymasterAndData carries when it was built on the real-bid path:
+ * which paymaster it names and the fee-token permit it signed for that paymaster. Read for the
+ * record only — the bid's authenticity comes from the solver signature over the userOpHash, which
+ * covers these bytes, so nothing here is verified further and the permit signature is not kept.
+ */
+interface PhantomBidSponsorship {
+    paymaster: HexString;
+    /** The fee token the permit draws on. */
+    token: HexString;
+    permitAmount: bigint;
+    /** Permit2 unordered nonce — random per op, which is what lets a solver's bids run in parallel. */
+    nonce: bigint;
+    /** Unix seconds after which the permit is unusable. */
+    deadline: bigint;
+}
 /** What a phantom bid's paymasterAndData declares about the solver behind it. */
 interface PhantomBidDeclaration {
     /**
@@ -5449,12 +5460,53 @@ declare function encodePhantomBidDeclaration(declaration: {
     acceptedSourceChains?: string[];
     uniswapV4Positions?: bigint[];
 }): HexString;
+/** Everything a phantom bid's paymasterAndData was found to carry. */
+interface PhantomBidPaymasterAndData {
+    /**
+     * Which shape the field was read as: a bare declaration, a Permit2-sponsored bid (with or
+     * without a declaration appended), or neither — empty, or bytes matching no known layout.
+     */
+    mode: "declaration" | "permit2" | "none";
+    /** Never null: an unreadable or missing declaration is the absent one (null sources, no positions). */
+    declaration: PhantomBidDeclaration;
+    /** The paymaster fields of a sponsored bid; null for the other two modes. */
+    sponsorship: PhantomBidSponsorship | null;
+}
 /**
- * Decodes a phantom bid's paymasterAndData. Understands both layout versions, so bids placed
+ * Decodes a phantom bid's paymasterAndData in whichever shape it takes.
+ *
+ * A bare declaration is tried first, so every bid placed before sponsored phantom bids existed
+ * decodes to the byte exactly as it did. Failing that, a blob opening with a complete
+ * Permit2-sponsored payload is read as a sponsored bid, and whatever follows the permit is parsed
+ * as its declaration. Both parsers demand exact consumption — a bare declaration must end where
+ * the bytes end, and a sponsored bid's tail must be a whole declaration or nothing — so neither
+ * shape can be half-read as the other.
+ *
+ * A malformed tail on a sponsored bid yields the absent declaration but still reports the
+ * sponsorship: the bid is still a bid, it just declared nothing readable.
+ */
+declare function decodePhantomBidPaymasterAndData(paymasterAndData: string | undefined | null): PhantomBidPaymasterAndData;
+/**
+ * Decodes the declaration out of a phantom bid's paymasterAndData, whichever shape it takes (see
+ * {@link decodePhantomBidPaymasterAndData}). Understands both declaration versions, so bids placed
  * before positions existed keep decoding unchanged. Anything absent, unversioned or malformed
  * yields a null `acceptedSources` with no positions — never a partial read.
  */
 declare function decodePhantomBidDeclaration(paymasterAndData: string | undefined | null): PhantomBidDeclaration;
+/**
+ * Builds a phantom bid's paymasterAndData: the declaration alone, or appended to a Permit2
+ * sponsorship when the bid was built on the real-bid path and carries one.
+ *
+ * `sponsorship` is the packed EntryPoint v0.8 paymasterAndData the paymaster builder produced. It
+ * must be exactly the Permit2-mode layout — the only one the decoder recognises — so a caller
+ * cannot sign bytes the aggregation would read as "no declaration"; anything else throws. Empty
+ * or omitted, the result is the bare declaration, byte-identical to what unsponsored bids carry.
+ */
+declare function encodePhantomBidPaymasterAndData(bid: {
+    sponsorship?: HexString | null;
+    acceptedSourceChains?: string[];
+    uniswapV4Positions?: bigint[];
+}): HexString;
 /** Back-compat wrapper: the source-chain half of {@link encodePhantomBidDeclaration}. */
 declare function encodeAcceptedSourceChains(chains: string[]): HexString;
 /** Back-compat wrapper: the source-chain half of {@link decodePhantomBidDeclaration}. */
@@ -5586,19 +5638,24 @@ interface AggregationLogger {
  * paid its cost of goods.
  */
 declare const UNISWAP_QUOTE_HAIRCUT_BPS = 10n;
+/** Applies {@link UNISWAP_QUOTE_HAIRCUT_BPS} to a quoted output amount, rounding down. */
+declare function applyUniswapQuoteHaircut(amount: bigint): bigint;
 /**
- * Haircut applied to every phantom quote that is NOT priced off a Uniswap V4 pool, in basis points.
+ * The protocol fee haircut: the fee the IntentGateway at `gatewayAddress` charges on order inputs,
+ * in basis points, read live from its `params()`.
  *
- * 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.
+ * A wallet-funded quote is shaded by exactly this, so the published rate is the one a taker
+ * actually realizes after the gateway takes its cut, and it moves with governance rather than
+ * with a constant someone has to remember to keep in step. Read on the phantom order's own chain,
+ * which is the chain whose gateway will collect the fee on the fills this rate is published for.
+ *
+ * Fails loudly rather than defaulting: a gateway that returns no code, or a fee at or above 100%,
+ * is a misconfiguration, and pricing a window unhaircut on the back of it would publish a rate
+ * nobody can trade at. The `PhantomRpcError` lets the run's retry loop have another go first.
  */
-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 readProtocolFeeHaircutBps(evmRpcUrl: string, gatewayAddress: string): Promise<bigint>;
+/** Applies the protocol fee haircut (see {@link readProtocolFeeHaircutBps}) to a quoted output amount, rounding down. */
+declare function applyProtocolFeeHaircut(amount: bigint, protocolFeeBps: bigint): bigint;
 declare function weightedMedian(entries: {
     price: bigint;
     weight: bigint;
@@ -8845,4 +8902,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$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 };
+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 PostRequestStatus 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, PERMIT2_SPONSORSHIP_BYTES as aN, type PaymentInfo as aO, type PhantomBid as aP, type PhantomBidBatchResult as aQ, type PhantomBidDeclaration as aR, type PhantomBidOutcome as aS, type PhantomBidPaymasterAndData as aT, type PhantomBidSponsorship as aU, type PhantomOrderEvent as aV, type PhantomOrderLeg as aW, type PhantomOrderPriceSnapshot as aX, type PhantomOrderPriceSnapshotsResponse as aY, type PhantomTimings as aZ, type PollPhantomOrdersOptions 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 FetchLike as b$, type RequestBody as b0, type RequestCommitment as b1, RequestKind as b2, type RequestResponse as b3, RequestStatus as b4, type RequestStatusKey as b5, type SelectOptions as b6, type SigningAccount as b7, type StateMachineId as b8, type StateMachineResponse as b9, encodeAcceptedSourceChains as bA, encodeERC7821ExecuteBatch as bB, encodeFillOrder as bC, encodeISMPMessage as bD, encodePhantomBidDeclaration as bE, encodePhantomBidPaymasterAndData as bF, encodeUserOpScale as bG, getChainId as bH, getConfigByStateMachineId as bI, getFillOptionsVersion as bJ, getViemChain as bK, hyperbridgeAddress as bL, pharosAtlantic as bM, pharosMainnet as bN, polkadotAssetHubPaseo as bO, polkadotHubMainnet as bP, poolSlug as bQ, readProtocolFeeHaircutBps as bR, resetFillOptionsVersionCache as bS, sortPoolSymbols as bT, tronChainIds as bU, tronNile as bV, type AggregationLogger as bW, type BidNonceKeyFn as bX, type BidSignature as bY, ENTRY_POINT_V08_ADDRESS as bZ, FILL_ORDER_ABI as b_, type StorageFacade as ba, TimeoutStatus as bb, type TimeoutStatusKey as bc, type TokenGatewayAssetTeleportedResponse as bd, type TokenInfo as be, type TokenPrice as bf, type TokenPricesResponse as bg, UNISWAP_QUOTE_HAIRCUT_BPS as bh, type UniswapV4PoolConfigData as bi, applyProtocolFeeHaircut as bj, applyUniswapQuoteHaircut as bk, chainConfigs as bl, convertCodecToIGetRequest as bm, convertCodecToIProof as bn, convertIGetRequestToCodec as bo, convertIProofToCodec as bp, convertStateIdToStateMachineId as bq, convertStateMachineEnumToString as br, convertStateMachineIdToEnum as bs, decodeAcceptedSourceChains as bt, decodeERC7821ExecuteBatch as bu, decodeFillOrder as bv, decodePhantomBidDeclaration as bw, decodePhantomBidPaymasterAndData as bx, decodeUserOpScale as by, deriveHttpUrl as bz, type StateMachineHeight as c, type FillData as c0, type HexString as c1, _default as c2, type LpBalance as c3, type OrderCommitmentFn as c4, type PhantomAggregation as c5, type PhantomLegAggregation as c6, type PhantomLegBidder as c7, type PoolAndPositionInfo as c8, type RecoverBidSigner as c9, type RpcBidInfo as ca, type SolverBalanceReader as cb, type SolverV4Position as cc, type UniswapV4Contracts as cd, type V4PositionState as ce, type YieldVaultMap as cf, aggregatePhantomBids as cg, extractFillData as ch, fetchBidsForOrder as ci, getTotalSolverBalance as cj, memoizedSolverBalance as ck, orderCommitmentFromDecoded as cl, positionAmountOfToken as cm, readV4Position as cn, recoverBidSignerViem as co, setAggregationFetch as cp, splitBidSignature as cq, weightedMedian as cr, zipFillLegs as cs, 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 };

package/dist/node/intents-helpers.cjs

@@ -2731,8 +2731,67 @@ async function rpcCall(url, payload) {
 var FILL_ORDER_ABI = IntentGatewayV2_default.ABI;
 var DECLARATION_V1 = 1;
 var DECLARATION_V2 = 2;
+var PAYMASTER_ADDRESS_BYTES = 20;
+var PAYMASTER_GAS_LIMIT_BYTES = 16;
+var PAYMASTER_DATA_OFFSET = PAYMASTER_ADDRESS_BYTES + 2 * PAYMASTER_GAS_LIMIT_BYTES;
+var SIMPLEX_MODE_PERMIT2 = 2;
+var PERMIT2_DATA_BYTES = 1 + 20 + 32 + 32 + 32 + 1 + 32 + 32;
+var PERMIT2_SPONSORSHIP_BYTES = PAYMASTER_DATA_OFFSET + PERMIT2_DATA_BYTES;
 var MAX_DECLARED_ENTRIES = 255;
 var MAX_TOKEN_ID_BYTES = 32;
+function utf8Encode(text) {
+  const bytes = [];
+  for (const char of text) {
+    const codePoint = char.codePointAt(0);
+    if (codePoint < 128) bytes.push(codePoint);
+    else if (codePoint < 2048) bytes.push(192 | codePoint >> 6, 128 | codePoint & 63);
+    else if (codePoint < 65536) {
+      bytes.push(224 | codePoint >> 12, 128 | codePoint >> 6 & 63, 128 | codePoint & 63);
+    } else {
+      bytes.push(
+        240 | codePoint >> 18,
+        128 | codePoint >> 12 & 63,
+        128 | codePoint >> 6 & 63,
+        128 | codePoint & 63
+      );
+    }
+  }
+  return bytes;
+}
+function utf8Decode(bytes) {
+  let text = "";
+  for (let offset = 0; offset < bytes.length; ) {
+    const lead = bytes[offset];
+    let codePoint;
+    let continuations;
+    if (lead < 128) {
+      codePoint = lead;
+      continuations = 0;
+    } else if ((lead & 224) === 192) {
+      codePoint = lead & 31;
+      continuations = 1;
+    } else if ((lead & 240) === 224) {
+      codePoint = lead & 15;
+      continuations = 2;
+    } else if ((lead & 248) === 240) {
+      codePoint = lead & 7;
+      continuations = 3;
+    } else {
+      return null;
+    }
+    if (offset + continuations >= bytes.length) return null;
+    for (let index = 1; index <= continuations; index++) {
+      const byte = bytes[offset + index];
+      if ((byte & 192) !== 128) return null;
+      codePoint = codePoint << 6 | byte & 63;
+    }
+    const overlong = continuations === 1 && codePoint < 128 || continuations === 2 && codePoint < 2048 || continuations === 3 && codePoint < 65536;
+    if (overlong || codePoint > 1114111 || codePoint >= 55296 && codePoint <= 57343) return null;
+    text += String.fromCodePoint(codePoint);
+    offset += continuations + 1;
+  }
+  return text;
+}
 function tokenIdToBytes(tokenId) {
   if (tokenId < 0n) throw new Error(`Uniswap V4 tokenId cannot be negative: ${tokenId}`);
   const bytes = [];
@@ -2755,7 +2814,7 @@ function encodePhantomBidDeclaration(declaration) {
   const version = positions.length > 0 ? DECLARATION_V2 : DECLARATION_V1;
   const bytes = [version, chains.length];
   for (const chain of chains) {
-    const encoded = util.stringToU8a(chain);
+    const encoded = utf8Encode(chain);
     if (encoded.length === 0 || encoded.length > 255) {
       throw new Error(`Invalid state machine id in source chain declaration: ${chain}`);
     }
@@ -2773,42 +2832,94 @@ function encodePhantomBidDeclaration(declaration) {
   }
   return util.u8aToHex(new Uint8Array(bytes));
 }
-function decodePhantomBidDeclaration(paymasterAndData) {
-  const absent = { acceptedSources: null, uniswapV4Positions: [] };
-  if (!paymasterAndData || !util.isHex(paymasterAndData)) return absent;
-  const bytes = util.hexToU8a(paymasterAndData);
-  if (bytes.length < 2) return absent;
-  const version = bytes[0];
-  if (version !== DECLARATION_V1 && version !== DECLARATION_V2) return absent;
+function parseDeclaration(bytes, start) {
+  if (bytes.length - start < 2) return null;
+  const version = bytes[start];
+  if (version !== DECLARATION_V1 && version !== DECLARATION_V2) return null;
   const chains = [];
-  let offset = 2;
-  for (let entry = 0; entry < bytes[1]; entry++) {
-    if (offset >= bytes.length) return absent;
+  let offset = start + 2;
+  for (let entry = 0; entry < bytes[start + 1]; entry++) {
+    if (offset >= bytes.length) return null;
     const length = bytes[offset];
     offset += 1;
-    if (length === 0 || offset + length > bytes.length) return absent;
-    chains.push(util.u8aToString(bytes.subarray(offset, offset + length)));
+    if (length === 0 || offset + length > bytes.length) return null;
+    const chain = utf8Decode(bytes.subarray(offset, offset + length));
+    if (chain === null) return null;
+    chains.push(chain);
     offset += length;
   }
   const positions = [];
   if (version === DECLARATION_V2) {
-    if (offset >= bytes.length) return absent;
+    if (offset >= bytes.length) return null;
     const count = bytes[offset];
     offset += 1;
     for (let entry = 0; entry < count; entry++) {
-      if (offset >= bytes.length) return absent;
+      if (offset >= bytes.length) return null;
       const length = bytes[offset];
       offset += 1;
-      if (length === 0 || length > MAX_TOKEN_ID_BYTES || offset + length > bytes.length) return absent;
-      let tokenId = 0n;
-      for (const byte of bytes.subarray(offset, offset + length)) tokenId = tokenId << 8n | BigInt(byte);
-      positions.push(tokenId);
+      if (length === 0 || length > MAX_TOKEN_ID_BYTES || offset + length > bytes.length) return null;
+      positions.push(bytesToBigInt2(bytes.subarray(offset, offset + length)));
       offset += length;
     }
   }
-  if (offset !== bytes.length) return absent;
+  if (offset !== bytes.length) return null;
   return { acceptedSources: chains, uniswapV4Positions: positions };
 }
+function bytesToBigInt2(bytes) {
+  let value = 0n;
+  for (const byte of bytes) value = value << 8n | BigInt(byte);
+  return value;
+}
+function bytesToAddress(bytes) {
+  return util.u8aToHex(bytes);
+}
+function hasPermit2Sponsorship(bytes) {
+  return bytes.length >= PERMIT2_SPONSORSHIP_BYTES && bytes[PAYMASTER_DATA_OFFSET] === SIMPLEX_MODE_PERMIT2;
+}
+function parseSponsorship(bytes) {
+  let offset = 0;
+  const take = (length) => {
+    const slice = bytes.subarray(offset, offset + length);
+    offset += length;
+    return slice;
+  };
+  const paymaster = bytesToAddress(take(PAYMASTER_ADDRESS_BYTES));
+  take(2 * PAYMASTER_GAS_LIMIT_BYTES);
+  take(1);
+  const token = bytesToAddress(take(20));
+  const permitAmount = bytesToBigInt2(take(32));
+  const nonce = bytesToBigInt2(take(32));
+  const deadline = bytesToBigInt2(take(32));
+  return { paymaster, token, permitAmount, nonce, deadline };
+}
+var absentDeclaration = () => ({ acceptedSources: null, uniswapV4Positions: [] });
+function decodePhantomBidPaymasterAndData(paymasterAndData) {
+  const none = { mode: "none", declaration: absentDeclaration(), sponsorship: null };
+  if (!paymasterAndData || !util.isHex(paymasterAndData)) return none;
+  const bytes = util.hexToU8a(paymasterAndData);
+  const bare = parseDeclaration(bytes, 0);
+  if (bare) return { mode: "declaration", declaration: bare, sponsorship: null };
+  if (!hasPermit2Sponsorship(bytes)) return none;
+  const sponsorship = parseSponsorship(bytes);
+  const tail = bytes.length > PERMIT2_SPONSORSHIP_BYTES ? parseDeclaration(bytes, PERMIT2_SPONSORSHIP_BYTES) : null;
+  return { mode: "permit2", declaration: tail ?? absentDeclaration(), sponsorship };
+}
+function decodePhantomBidDeclaration(paymasterAndData) {
+  return decodePhantomBidPaymasterAndData(paymasterAndData).declaration;
+}
+function encodePhantomBidPaymasterAndData(bid) {
+  const declaration = encodePhantomBidDeclaration(bid);
+  const sponsorship = bid.sponsorship;
+  if (!sponsorship || sponsorship === "0x") return declaration;
+  if (!util.isHex(sponsorship)) throw new Error("Phantom bid sponsorship is not hex");
+  const bytes = util.hexToU8a(sponsorship);
+  if (bytes.length !== PERMIT2_SPONSORSHIP_BYTES || !hasPermit2Sponsorship(bytes)) {
+    throw new Error(
+      `Phantom bid sponsorship must be a ${PERMIT2_SPONSORSHIP_BYTES}-byte Permit2-mode paymasterAndData, got ${bytes.length} bytes`
+    );
+  }
+  return `${sponsorship}${declaration.slice(2)}`;
+}
 function encodeAcceptedSourceChains(chains) {
   return encodePhantomBidDeclaration({ acceptedSourceChains: chains });
 }
@@ -2825,15 +2936,35 @@ function zipFillLegs(assets, outputs) {
   });
 }
 var UNISWAP_QUOTE_HAIRCUT_BPS = 10n;
-var PHANTOM_QUOTE_HAIRCUT_BPS = 5n;
 function haircut(amount, bps) {
   return amount * (10000n - bps) / 10000n;
 }
 function applyUniswapQuoteHaircut(amount) {
   return haircut(amount, UNISWAP_QUOTE_HAIRCUT_BPS);
 }
-function applyPhantomQuoteHaircut(amount) {
-  return haircut(amount, PHANTOM_QUOTE_HAIRCUT_BPS);
+var SELECTOR_GATEWAY_PARAMS = "0xcff0ab96";
+var GATEWAY_PARAMS_WORDS = 6;
+var GATEWAY_PARAMS_FEE_WORD = 4;
+async function readProtocolFeeHaircutBps(evmRpcUrl, gatewayAddress) {
+  const result = await rpcCall(evmRpcUrl, {
+    id: 1,
+    jsonrpc: "2.0",
+    method: "eth_call",
+    params: [{ to: gatewayAddress, data: SELECTOR_GATEWAY_PARAMS }, "latest"]
+  });
+  const hex = result.result;
+  if (typeof hex !== "string" || hex.length < 2 + 64 * GATEWAY_PARAMS_WORDS) {
+    throw new PhantomRpcError(`IntentGateway.params() returned no usable result from ${gatewayAddress} on ${evmRpcUrl}`);
+  }
+  const start = 2 + 64 * GATEWAY_PARAMS_FEE_WORD;
+  const protocolFeeBps = BigInt(`0x${hex.slice(start, start + 64)}`);
+  if (protocolFeeBps >= 10000n) {
+    throw new PhantomRpcError(`IntentGateway ${gatewayAddress} reports an implausible protocol fee: ${protocolFeeBps} bps`);
+  }
+  return protocolFeeBps;
+}
+function applyProtocolFeeHaircut(amount, protocolFeeBps) {
+  return haircut(amount, protocolFeeBps);
 }
 function weightedMedian(entries) {
   const sorted = [...entries].sort((a, b) => a.price < b.price ? -1 : a.price > b.price ? 1 : 0);
@@ -3155,6 +3286,7 @@ async function runAggregation(params, isDelegated) {
   }
   const bids = await fetchBidsForOrder(nodeUrl, commitment);
   if (bids.length === 0) return null;
+  const protocolFeeHaircutBps = await readProtocolFeeHaircutBps(destUrl, gatewayAddress);
   const v4Contracts = params.uniswapV4?.[chain];
   const readPosition = memoizedV4Position(params.keccak ?? viem.keccak256, logger);
   const getBalance = params.getBalance ?? memoizedSolverBalance(yieldVaults);
@@ -3198,10 +3330,10 @@ async function runAggregation(params, isDelegated) {
         continue;
       }
       countedSolvers.add(normalizedSolver);
-      const declaration = decodePhantomBidDeclaration(decoded.paymasterAndData);
+      const { declaration } = decodePhantomBidPaymasterAndData(decoded.paymasterAndData);
       const acceptedSources = declaration.acceptedSources;
       const poolPriced = declaration.uniswapV4Positions.length > 0;
-      const applyHaircut = poolPriced ? applyUniswapQuoteHaircut : applyPhantomQuoteHaircut;
+      const applyHaircut = (amount) => poolPriced ? applyUniswapQuoteHaircut(amount) : applyProtocolFeeHaircut(amount, protocolFeeHaircutBps);
       const quotedLegs = [...fillData.legs.entries()].map(([legIndex, leg]) => [
         legIndex,
         { ...leg, solverAmount: applyHaircut(leg.solverAmount) }
@@ -3293,18 +3425,20 @@ exports.ENTRY_POINT_V08_ADDRESS = ENTRY_POINT_V08_ADDRESS;
 exports.FILL_ORDER_ABI = FILL_ORDER_ABI;
 exports.FILL_ORDER_V1_ABI = FILL_ORDER_V1_ABI;
 exports.IntentGatewayV2 = IntentGatewayV2_default;
-exports.PHANTOM_QUOTE_HAIRCUT_BPS = PHANTOM_QUOTE_HAIRCUT_BPS;
+exports.PERMIT2_SPONSORSHIP_BYTES = PERMIT2_SPONSORSHIP_BYTES;
 exports.UNISWAP_QUOTE_HAIRCUT_BPS = UNISWAP_QUOTE_HAIRCUT_BPS;
 exports.aggregatePhantomBids = aggregatePhantomBids;
-exports.applyPhantomQuoteHaircut = applyPhantomQuoteHaircut;
+exports.applyProtocolFeeHaircut = applyProtocolFeeHaircut;
 exports.applyUniswapQuoteHaircut = applyUniswapQuoteHaircut;
 exports.decodeAcceptedSourceChains = decodeAcceptedSourceChains;
 exports.decodeERC7821ExecuteBatch = decodeERC7821ExecuteBatch;
 exports.decodePhantomBidDeclaration = decodePhantomBidDeclaration;
+exports.decodePhantomBidPaymasterAndData = decodePhantomBidPaymasterAndData;
 exports.decodeUserOpScale = decodeUserOpScale;
 exports.encodeAcceptedSourceChains = encodeAcceptedSourceChains;
 exports.encodeERC7821ExecuteBatch = encodeERC7821ExecuteBatch;
 exports.encodePhantomBidDeclaration = encodePhantomBidDeclaration;
+exports.encodePhantomBidPaymasterAndData = encodePhantomBidPaymasterAndData;
 exports.encodeUserOpScale = encodeUserOpScale;
 exports.extractFillData = extractFillData;
 exports.fetchBidsForOrder = fetchBidsForOrder;
@@ -3313,6 +3447,7 @@ exports.memoizedSolverBalance = memoizedSolverBalance;
 exports.orderCommitmentFromDecoded = orderCommitmentFromDecoded;
 exports.poolSlug = poolSlug;
 exports.positionAmountOfToken = positionAmountOfToken;
+exports.readProtocolFeeHaircutBps = readProtocolFeeHaircutBps;
 exports.readV4Position = readV4Position;
 exports.recoverBidSignerViem = recoverBidSignerViem;
 exports.setAggregationFetch = setAggregationFetch;