@hyperbridge/sdk 2.8.11 → 2.8.13

package/dist/browser/index.d.ts

@@ -3570,13 +3570,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.
@@ -6499,6 +6492,24 @@ declare function decodeFillOrder(data: HexString$1): {
 } | null;
 
 type HexString = `0x${string}`;
+/** 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 {
     /**
@@ -6522,12 +6533,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 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 a phantom bid's paymasterAndData. Understands both layout versions, so bids placed
+ * 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}. */
@@ -6542,19 +6594,24 @@ declare function decodeAcceptedSourceChains(paymasterAndData: string | undefined
  * 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 const ABI$1: readonly [{
     readonly type: "constructor";
@@ -11582,4 +11639,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, CHAINS_WITHOUT_VALID_UNTIL, 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 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_V1_ABI, type FillOptions, type FillOptionsVersion, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString$1 as HexString, type HostParams, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, 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 IndexedRateIntentQuoteMetadata, type IndexedRateQuoteIntentResult, type IndexedRateSide, IndexedRateUnavailableError, type IndexerQueryClient, IntentGateway, ABI$1 as IntentGatewayABI, type IntentGatewayContext, type IntentGatewayParams, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidIndexedRateError, InvalidLiquidityIndexerResponseError, InvalidPhantomSnapshotError, IsmpClient, type IsmpRequest, LEGACY_FILL_OPTIONS_IMPLEMENTATIONS, type LiquiditySlice, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, type Order, type OrderFeesQuote, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type OrderWithStatus, PACKED_USEROP_TYPEHASH, PHANTOM_QUOTE_HAIRCUT_BPS, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PhantomBid, type PhantomBidBatchResult, type PhantomBidDeclaration, type PhantomBidOutcome, type PhantomOrderEvent, type PhantomOrderLeg, type PhantomOrderPriceSnapshot, type PhantomOrderPriceSnapshotsResponse, type PhantomSnapshotIntentQuoteMetadata, type PhantomSnapshotQuoteIntentResult, PhantomSnapshotUnavailableError, type PhantomTimings, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, type PollPhantomOrdersOptions, 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 RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type ResumeIntentOrderOptions, type RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, 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, UNISWAP_QUOTE_HAIRCUT_BPS, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolConfigData, type UniswapV4PoolKey, type UniswapV4QuoteIntentResult, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, applyPhantomQuoteHaircut, applyUniswapQuoteHaircut, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeAcceptedSourceChains, decodeERC7821ExecuteBatch, decodeFillOrder, decodePhantomBidDeclaration, decodeUserOpScale, deriveHttpUrl, encodeAcceptedSourceChains, encodeERC7821ExecuteBatch, encodeFillOrder, encodeISMPMessage, encodePhantomBidDeclaration, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getFillOptionsVersion, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, resetFillOptionsVersionCache, responseCommitmentKey, retryPromise, sortPoolSymbols, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
+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, CHAINS_WITHOUT_VALID_UNTIL, 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 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_V1_ABI, type FillOptions, type FillOptionsVersion, type FillOrderEstimate, type FillerBid, type FillerConfig, type GetRequestResponse, type GetRequestWithStatus, type GetResponseByRequestIdResponse, type GetResponseStorageValues, type HexString$1 as HexString, type HostParams, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, 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 IndexedRateIntentQuoteMetadata, type IndexedRateQuoteIntentResult, type IndexedRateSide, IndexedRateUnavailableError, type IndexerQueryClient, IntentGateway, ABI$1 as IntentGatewayABI, type IntentGatewayContext, type IntentGatewayParams, IntentOrderStatus, type IntentOrderStatusKey, type IntentOrderStatusUpdate, type IntentQuoteStrategy, type IntentQuoteTradeType, IntentsCoprocessor, InvalidIndexedRateError, InvalidLiquidityIndexerResponseError, InvalidPhantomSnapshotError, IsmpClient, type IsmpRequest, LEGACY_FILL_OPTIONS_IMPLEMENTATIONS, type LiquiditySlice, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, type Order, type OrderFeesQuote, type OrderResponse, OrderStatus, OrderStatusChecker, type OrderStatusMetadata, type OrderWithStatus, PACKED_USEROP_TYPEHASH, PERMIT2_SPONSORSHIP_BYTES, PLACE_ORDER_SELECTOR, type PackedUserOperation, type Params, type PaymentInfo, type PhantomBid, type PhantomBidBatchResult, type PhantomBidDeclaration, type PhantomBidOutcome, type PhantomBidPaymasterAndData, type PhantomBidSponsorship, type PhantomOrderEvent, type PhantomOrderLeg, type PhantomOrderPriceSnapshot, type PhantomOrderPriceSnapshotsResponse, type PhantomSnapshotIntentQuoteMetadata, type PhantomSnapshotQuoteIntentResult, PhantomSnapshotUnavailableError, type PhantomTimings, PharosChain, type PharosChainParams, PolkadotHubChain, type PolkadotHubChainParams, type PollPhantomOrdersOptions, 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 RequestBody, type RequestCommitment, RequestKind, type RequestResponse, RequestStatus, type RequestStatusKey, type RequestStatusWithMetadata, type ResponseCommitmentWithValues, type ResumeIntentOrderOptions, type RetryConfig, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, 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, UNISWAP_QUOTE_HAIRCUT_BPS, USE_ETHERSCAN_CHAINS, type UniswapProtocol, type UniswapQuote, type UniswapQuoteToken, type UniswapTradeType, type UniswapV4IntentQuoteMetadata, type UniswapV4IntentQuoteOptions, type UniswapV4PoolConfigData, type UniswapV4PoolKey, type UniswapV4QuoteIntentResult, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, type XcmGatewayParams, __test, adjustDecimals, applyProtocolFeeHaircut, applyUniswapQuoteHaircut, 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, getFillOptionsVersion, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readProtocolFeeHaircutBps, requestCommitmentKey, resetFillOptionsVersionCache, responseCommitmentKey, retryPromise, sortPoolSymbols, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };

package/dist/browser/index.js

@@ -7,7 +7,7 @@ import { match } from 'ts-pattern';
 import { WsProvider, ApiPromise, Keyring, HttpProvider } from '@polkadot/api';
 import { Struct, Vector, u8, Bytes, Enum, Tuple, _void, u64, u32, Option, bool, u128 } from 'scale-ts';
 import { xxhashAsU8a, keccakAsU8a, decodeAddress, keccakAsHex, blake2AsU8a } from '@polkadot/util-crypto';
-import { u8aToHex, u8aConcat, hexToU8a, stringToU8a, isHex as isHex$1, u8aToString } from '@polkadot/util';
+import { u8aToHex, u8aConcat, hexToU8a, isHex as isHex$1 } from '@polkadot/util';
 import PQueue from 'p-queue';
 import { hasWindow, isNode, env } from 'std-env';
 import mergeRace from '@async-generator/merge-race';
@@ -20606,13 +20606,116 @@ var IntentGateway = class _IntentGateway {
     }
   }
 };
-
-// src/protocols/intents/phantom-aggregation.ts
+function rpcFetch() {
+  const f = globalThis.fetch;
+  if (typeof f !== "function") {
+    throw new Error("No fetch available; call setAggregationFetch() before using the aggregation helpers");
+  }
+  return f;
+}
+var PhantomRpcError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "PhantomRpcError";
+  }
+  cause;
+};
+async function rpcCall(url, payload) {
+  let lastErr;
+  for (let attempt = 0; attempt < 4; attempt++) {
+    if (attempt > 0) await new Promise((resolve) => setTimeout(resolve, 150 * attempt));
+    let timer;
+    try {
+      const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`rpc timeout: ${url}`)), 12e3);
+      });
+      const response = await Promise.race([
+        rpcFetch()(url, {
+          method: "POST",
+          headers: { accept: "application/json", "content-type": "application/json" },
+          body: JSON.stringify(payload)
+        }),
+        timeout
+      ]);
+      const body = await response.json();
+      if (body?.error) {
+        lastErr = new Error(`rpc error: ${JSON.stringify(body.error).slice(0, 200)}`);
+        continue;
+      }
+      return body;
+    } catch (err) {
+      lastErr = err;
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+  }
+  throw new PhantomRpcError(`RPC call failed after 4 attempts: ${url}`, lastErr);
+}
 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 = [];
@@ -20635,7 +20738,7 @@ function encodePhantomBidDeclaration(declaration) {
   const version = positions.length > 0 ? DECLARATION_V2 : DECLARATION_V1;
   const bytes = [version, chains2.length];
   for (const chain of chains2) {
-    const encoded = 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}`);
     }
@@ -20653,42 +20756,94 @@ function encodePhantomBidDeclaration(declaration) {
   }
   return u8aToHex(new Uint8Array(bytes));
 }
-function decodePhantomBidDeclaration(paymasterAndData) {
-  const absent = { acceptedSources: null, uniswapV4Positions: [] };
-  if (!paymasterAndData || !isHex$1(paymasterAndData)) return absent;
-  const bytes = 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 chains2 = [];
-  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;
-    chains2.push(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;
+    chains2.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(bytesToBigInt3(bytes.subarray(offset, offset + length)));
       offset += length;
     }
   }
-  if (offset !== bytes.length) return absent;
+  if (offset !== bytes.length) return null;
   return { acceptedSources: chains2, uniswapV4Positions: positions };
 }
+function bytesToBigInt3(bytes) {
+  let value = 0n;
+  for (const byte of bytes) value = value << 8n | BigInt(byte);
+  return value;
+}
+function bytesToAddress(bytes) {
+  return 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 = bytesToBigInt3(take(32));
+  const nonce = bytesToBigInt3(take(32));
+  const deadline = bytesToBigInt3(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 || !isHex$1(paymasterAndData)) return none;
+  const bytes = 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 (!isHex$1(sponsorship)) throw new Error("Phantom bid sponsorship is not hex");
+  const bytes = 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(chains2) {
   return encodePhantomBidDeclaration({ acceptedSourceChains: chains2 });
 }
@@ -20696,15 +20851,35 @@ function decodeAcceptedSourceChains(paymasterAndData) {
   return decodePhantomBidDeclaration(paymasterAndData).acceptedSources;
 }
 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);
 }
 FILL_ORDER_ABI.find(
   (item) => item?.type === "function" && item?.name === "fillOrder"
@@ -25179,6 +25354,6 @@ async function teleportDot(param_) {
   return stream;
 }
 
-export { ADDRESS_ZERO2 as ADDRESS_ZERO, BundlerMethod, CHAINS_WITHOUT_VALID_UNTIL, ChainConfigService, Chains, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, ERC20Method, ERC7821_BATCH_MODE, EvmChain, ABI as EvmHostABI, EvmLanguage, FILL_ORDER_V1_ABI, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, INCLUSION_TIMEOUT_MS, IndexedRateUnavailableError, IntentGateway, ABI3 as IntentGatewayABI, IntentOrderStatus, IntentsCoprocessor, InvalidIndexedRateError, InvalidLiquidityIndexerResponseError, InvalidPhantomSnapshotError, IsmpClient, LEGACY_FILL_OPTIONS_IMPLEMENTATIONS, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, OrderStatus, OrderStatusChecker, PACKED_USEROP_TYPEHASH, PHANTOM_QUOTE_HAIRCUT_BPS, PLACE_ORDER_SELECTOR, PhantomSnapshotUnavailableError, PharosChain, PolkadotHubChain, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestKind, RequestStatus, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SubstrateChain, Swap, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, TokenGateway, TronChain, UNISWAP_QUOTE_HAIRCUT_BPS, USE_ETHERSCAN_CHAINS, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, __test, adjustDecimals, applyPhantomQuoteHaircut, applyUniswapQuoteHaircut, bytes20ToBytes32, bytes32ToBytes20, calculateAllowanceMappingLocation, calculateBalanceMappingLocation, chainConfigs, constructRedeemEscrowRequestBody, constructRefundEscrowRequestBody, convertCodecToIGetRequest, convertCodecToIProof, convertIGetRequestToCodec, convertIProofToCodec, convertStateIdToStateMachineId, convertStateMachineEnumToString, convertStateMachineIdToEnum, createEvmChain, createQueryClient, decodeAcceptedSourceChains, decodeERC7821ExecuteBatch, decodeFillOrder, decodePhantomBidDeclaration, decodeUserOpScale, deriveHttpUrl, encodeAcceptedSourceChains, encodeERC7821ExecuteBatch, encodeFillOrder, encodeISMPMessage, encodePhantomBidDeclaration, encodeStateMachineId, encodeUserOpScale, encodeWithdrawalRequest, estimateGasForPost, fetchPrice, fetchSourceProof, generateRootWithProof, getChainId, getConfigByStateMachineId, getContractCallInput, getContractCallInputs, getFillOptionsVersion, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, requestCommitmentKey, resetFillOptionsVersionCache, responseCommitmentKey, retryPromise, sortPoolSymbols, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
+export { ADDRESS_ZERO2 as ADDRESS_ZERO, BundlerMethod, CHAINS_WITHOUT_VALID_UNTIL, ChainConfigService, Chains, CryptoUtils, DEFAULT_ADDRESS, DEFAULT_GRAFFITI, DOMAIN_TYPEHASH, DUMMY_PRIVATE_KEY, ERC20Method, ERC7821_BATCH_MODE, EvmChain, ABI as EvmHostABI, EvmLanguage, FILL_ORDER_V1_ABI, HyperClientStatus, HyperFungibleToken, HyperFungibleTokenABI, INCLUSION_TIMEOUT_MS, IndexedRateUnavailableError, IntentGateway, ABI3 as IntentGatewayABI, IntentOrderStatus, IntentsCoprocessor, InvalidIndexedRateError, InvalidLiquidityIndexerResponseError, InvalidPhantomSnapshotError, IsmpClient, LEGACY_FILL_OPTIONS_IMPLEMENTATIONS, MOCK_ADDRESS, ORDER_V2_PARAM_TYPE, OrderStatus, OrderStatusChecker, PACKED_USEROP_TYPEHASH, PERMIT2_SPONSORSHIP_BYTES, PLACE_ORDER_SELECTOR, PhantomSnapshotUnavailableError, PharosChain, PolkadotHubChain, REQUEST_COMMITMENTS_SLOT, REQUEST_RECEIPTS_SLOT, RESPONSE_COMMITMENTS_SLOT, RESPONSE_RECEIPTS_SLOT, RequestKind, RequestStatus, SELECT_SOLVER_TYPEHASH, STATE_COMMITMENTS_SLOT, SubstrateChain, Swap, TESTNET_CHAINS, TeleportStatus, TimeoutStatus, TokenGateway, TronChain, UNISWAP_QUOTE_HAIRCUT_BPS, USE_ETHERSCAN_CHAINS, UnsupportedIntentQuotePairError, UnsupportedIntentQuoteStrategyError, UnsupportedLiquidityAssetError, UnsupportedLiquidityChainError, WrappedHyperFungibleTokenABI, __test, adjustDecimals, applyProtocolFeeHaircut, applyUniswapQuoteHaircut, 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, getFillOptionsVersion, getGasPriceFromEtherscan, getOrFetchStorageSlot, getOrderPlacedFromTx, getPostRequestEventFromTx, getPostResponseEventFromTx, getRequestCommitment, getStateCommitmentFieldSlot, getStateCommitmentSlot, getStorageSlot, getViemChain, hexToString, hyperbridgeAddress, maxBigInt, normalizeAddressForEvmBytes32, normalizeAddressForStateMachine, normalizeEvmAddress, normalizeEvmChainId, normalizeStateMachineId, orderCommitment, parseStateMachineId, pharosAtlantic, pharosMainnet, polkadotAssetHubPaseo, polkadotHubMainnet, poolSlug, postRequestCommitment, queryAssetTeleported, queryGetRequest, queryPostRequest, quoteUniswap, readProtocolFeeHaircutBps, requestCommitmentKey, resetFillOptionsVersionCache, responseCommitmentKey, retryPromise, sortPoolSymbols, teleport, teleportDot, transformOrderForContract, tronChainIds, tronNile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map