@hyperbridge/sdk 2.3.3 → 2.4.2

package/dist/node/index.cjs

@@ -2490,30 +2490,30 @@ var handlerV2_default = { ABI: ABI2 };
 function tronAddress(base58) {
   return `0x${tronweb.TronWeb.address.toHex(base58).slice(2)}`;
 }
-var Chains = /* @__PURE__ */ ((Chains3) => {
-  Chains3["BSC_CHAPEL"] = "EVM-97";
-  Chains3["GNOSIS_CHIADO"] = "EVM-10200";
-  Chains3["HYPERBRIDGE_GARGANTUA"] = "KUSAMA-4009";
-  Chains3["SEPOLIA"] = "EVM-11155111";
-  Chains3["MAINNET"] = "EVM-1";
-  Chains3["BSC_MAINNET"] = "EVM-56";
-  Chains3["ARBITRUM_MAINNET"] = "EVM-42161";
-  Chains3["ARBITRUM_SEPOLIA"] = "EVM-421614";
-  Chains3["BASE_MAINNET"] = "EVM-8453";
-  Chains3["BASE_SEPOLIA"] = "EVM-84532";
-  Chains3["OPTIMISM_MAINNET"] = "EVM-10";
-  Chains3["OPTIMISM_SEPOLIA"] = "EVM-11155420";
-  Chains3["GNOSIS_MAINNET"] = "EVM-100";
-  Chains3["SONEIUM_MAINNET"] = "EVM-1868";
-  Chains3["POLYGON_MAINNET"] = "EVM-137";
-  Chains3["POLKADOT_HUB_MAINNET"] = "EVM-420420419";
-  Chains3["POLYGON_AMOY"] = "EVM-80002";
-  Chains3["POLKADOT_ASSET_HUB_PASEO"] = "EVM-420420417";
-  Chains3["TRON_MAINNET"] = "EVM-728126428";
-  Chains3["TRON_NILE"] = "EVM-3448148188";
-  Chains3["PHAROS_MAINNET"] = "EVM-688600";
-  Chains3["PHAROS_ATLANTIC"] = "EVM-688689";
-  return Chains3;
+var Chains = /* @__PURE__ */ ((Chains2) => {
+  Chains2["BSC_CHAPEL"] = "EVM-97";
+  Chains2["GNOSIS_CHIADO"] = "EVM-10200";
+  Chains2["HYPERBRIDGE_GARGANTUA"] = "KUSAMA-4009";
+  Chains2["SEPOLIA"] = "EVM-11155111";
+  Chains2["MAINNET"] = "EVM-1";
+  Chains2["BSC_MAINNET"] = "EVM-56";
+  Chains2["ARBITRUM_MAINNET"] = "EVM-42161";
+  Chains2["ARBITRUM_SEPOLIA"] = "EVM-421614";
+  Chains2["BASE_MAINNET"] = "EVM-8453";
+  Chains2["BASE_SEPOLIA"] = "EVM-84532";
+  Chains2["OPTIMISM_MAINNET"] = "EVM-10";
+  Chains2["OPTIMISM_SEPOLIA"] = "EVM-11155420";
+  Chains2["GNOSIS_MAINNET"] = "EVM-100";
+  Chains2["SONEIUM_MAINNET"] = "EVM-1868";
+  Chains2["POLYGON_MAINNET"] = "EVM-137";
+  Chains2["POLKADOT_HUB_MAINNET"] = "EVM-420420419";
+  Chains2["POLYGON_AMOY"] = "EVM-80002";
+  Chains2["POLKADOT_ASSET_HUB_PASEO"] = "EVM-420420417";
+  Chains2["TRON_MAINNET"] = "EVM-728126428";
+  Chains2["TRON_NILE"] = "EVM-3448148188";
+  Chains2["PHAROS_MAINNET"] = "EVM-688600";
+  Chains2["PHAROS_ATLANTIC"] = "EVM-688689";
+  return Chains2;
 })(Chains || {});
 var polkadotAssetHubPaseo = viem.defineChain({
   id: 420420417,
@@ -2596,7 +2596,7 @@ var chainConfigs = {
       UniswapV3Quoter: "0x0000000000000000000000000000000000000000",
       UniswapV4Quoter: "0x0000000000000000000000000000000000000000",
       EntryPointV08: "0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108",
-      SolverAccount: "0x07FeC66d967800998060194EaECDd7C66dA4a1B1"
+      SolverAccount: "0x110C7E1814c923127469Ca8939a12dAa70B96a17"
     },
     rpcEnvKey: "BSC_CHAPEL",
     defaultRpcUrl: "https://bnb-testnet.api.onfinality.io/public",
@@ -2704,7 +2704,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
@@ -2759,7 +2759,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0x10ED43C718714eb63d5aA57B78B54704E256024E",
@@ -2815,7 +2815,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24",
@@ -2872,7 +2872,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24",
@@ -2931,7 +2931,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0x8b536105b6Fae2aE9199f5146D3C57Dfe53b614E",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0xd2f9496824951D5237cC71245D659E48d0d5f9E8",
@@ -3018,7 +3018,7 @@ var chainConfigs = {
       Calldispatcher: "0x876F1891982E260026630c233A4897160A281Fb8",
       Permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
       EntryPointV08: "0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108",
-      SolverAccount: "0x07FeC66d967800998060194EaECDd7C66dA4a1B1"
+      SolverAccount: "0x110C7E1814c923127469Ca8939a12dAa70B96a17"
     },
     rpcEnvKey: "POLYGON_AMOY",
     defaultRpcUrl: "https://rpc-amoy.polygon.technology",
@@ -3042,7 +3042,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0x4A7b5Da61326A6379179b40d00F57E5bbDC962c2",
@@ -3077,7 +3077,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       TokenGateway: "0xFd413e3AFe560182C4471F4d143A96d3e259B6dE",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       UniswapRouter02: "0xB2e26652e4BAd1e56055A051f922E06760cA0BFE",
@@ -3232,7 +3232,7 @@ var chainConfigs = {
     },
     addresses: {
       IntentGateway: "0xAe041F7B0CB581876832830baeB6a2Aa2a3C9716",
-      SolverAccount: "0x975e80B476cB1d4Cd06c292ce36898f2bE4159ea",
+      SolverAccount: "0xfCd233b937D7622AAc63ced3C9A1A12F4a6B64E3",
       Host: "0x620128E2B19193d6Bd244a3AC8D3bBa0541B19c3",
       Calldispatcher: "0xE2C7e576E26E0bE7aC97c6fE925bcDAbD87c4bEd"
     },
@@ -5118,6 +5118,24 @@ var ChainConfigService = class {
   getAssetAddress(chain, symbol) {
     return this.getConfig(chain)?.assets?.[symbol];
   }
+  /**
+   * Resolves configured token metadata from an address on a specific chain.
+   * This is used by SDK helpers that accept token addresses rather than caller-
+   * supplied symbols or decimals.
+   */
+  getAssetMetadataByAddress(chain, address) {
+    const config = this.getConfig(chain);
+    if (!config?.assets) return;
+    const normalizedAddress = address.toLowerCase();
+    for (const [symbol, configuredAddress] of Object.entries(config.assets)) {
+      if (configuredAddress.toLowerCase() !== normalizedAddress) continue;
+      return {
+        symbol,
+        address: configuredAddress,
+        decimals: config.tokenDecimals?.[symbol]
+      };
+    }
+  }
   getUsdtAsset(chain) {
     return this.getConfig(chain)?.assets?.USDT ?? "0x";
   }
@@ -7791,7 +7809,7 @@ var IntentsCoprocessor = class _IntentsCoprocessor {
    */
   async sendExtrinsicWithRetries(extrinsic, maxRetries, timeoutMs) {
     const keyPair = this.getKeyPair();
-    let baseTip = 500000000000n;
+    const baseTip = 1000000000n;
     let attempt = 0;
     while (attempt < maxRetries) {
       const currentTip = baseTip * BigInt(2 ** attempt);
@@ -11461,6 +11479,33 @@ query OrderStatus($commitment: String!) {
     }
   }
 }`;
+var LATEST_PHANTOM_ORDER_PRICE_SNAPSHOT = `
+query LatestPhantomOrderPriceSnapshot($tokenA: String!, $tokenB: String!) {
+  phantomOrderPriceSnapshots(
+    filter: {
+      and: [
+        { tokenA: { equalTo: $tokenA } }
+        { tokenB: { equalTo: $tokenB } }
+        { medianPrice: { isNull: false } }
+      ]
+    }
+    orderBy: BLOCK_NUMBER_DESC
+    first: 1
+  ) {
+    nodes {
+      commitment
+      tokenA
+      tokenB
+      standardAmount
+      blockNumber
+      medianPrice
+      lowestPrice
+      highestPrice
+      bidCount
+      snapshotTime
+    }
+  }
+}`;
 var TOKEN_GATEWAY_ASSET_TELEPORTED_STATUS = `
 query TokenGatewayAssetTeleportedStatus($commitment: String!) {
   tokenGatewayAssetTeleportedV2s(
@@ -11522,6 +11567,29 @@ async function queryAssetTeleported(params) {
 function queryGetRequest(params) {
   return _queryGetRequestInternal(params);
 }
+async function _queryLatestPhantomOrderPriceSnapshot(params) {
+  const response = await params.queryClient.request(
+    LATEST_PHANTOM_ORDER_PRICE_SNAPSHOT,
+    {
+      tokenA: params.tokenA.toLowerCase(),
+      tokenB: params.tokenB.toLowerCase()
+    }
+  );
+  const snapshot = response.phantomOrderPriceSnapshots.nodes[0];
+  if (!snapshot?.medianPrice) return;
+  return {
+    commitment: snapshot.commitment,
+    tokenA: snapshot.tokenA,
+    tokenB: snapshot.tokenB,
+    standardAmount: BigInt(snapshot.standardAmount),
+    blockNumber: BigInt(snapshot.blockNumber),
+    medianPrice: BigInt(snapshot.medianPrice),
+    lowestPrice: snapshot.lowestPrice === null ? void 0 : BigInt(snapshot.lowestPrice),
+    highestPrice: snapshot.highestPrice === null ? void 0 : BigInt(snapshot.highestPrice),
+    bidCount: snapshot.bidCount,
+    snapshotTime: new Date(snapshot.snapshotTime)
+  };
+}
 async function _queryTokenGatewayAssetTeleportedInternal(params) {
   const { commitmentHash, queryClient: client, logger = DEFAULT_LOGGER } = params;
   const response = await retryPromise(
@@ -14774,6 +14842,67 @@ var CryptoUtils = class _CryptoUtils {
       viem.encodePacked(["bytes1", "bytes1", "bytes32", "bytes32"], ["0x19", "0x01", domainSeparator, structHash])
     );
   }
+  /**
+   * Derives the ERC-4337 nonce key that binds a bid UserOperation to its
+   * order and session key: the lower 192 bits of
+   * `keccak256(commitment ‖ sessionKey)`. `SolverAccount` rejects bid
+   * operations whose nonce key differs — this is what lets the solver sign
+   * the plain userOpHash while staying committed to the order and to the
+   * session key it bid against.
+   *
+   * @param commitment - The order commitment (`order.id`).
+   * @param sessionKey - The order's session key address (`order.session`).
+   * @returns The 192-bit nonce key as a bigint (pass to `EntryPoint.getNonce`).
+   */
+  static bidNonceKey(commitment, sessionKey) {
+    return BigInt(viem.keccak256(viem.encodePacked(["bytes32", "address"], [commitment, sessionKey]))) & (1n << 192n) - 1n;
+  }
+  /**
+   * Builds the EIP-712 typed-data payload whose digest is the EntryPoint v0.8
+   * `userOpHash` (i.e. `hashTypedData(packedUserOpTypedData(...)) ===
+   * computeUserOpHash(...)`). Signing this typed data is bit-identical to
+   * signing the raw userOpHash, but keeps the full operation visible to
+   * signing infrastructure (hardware wallets, MPC/TEE policy engines) instead
+   * of an opaque 32-byte digest.
+   *
+   * @param userOp - The packed UserOperation to sign (signature field ignored).
+   * @param entryPoint - Address of the EntryPoint v0.8 contract.
+   * @param chainId - Chain ID of the network on which the operation will execute.
+   * @returns A viem `TypedDataDefinition` for the operation.
+   */
+  static packedUserOpTypedData(userOp, entryPoint, chainId) {
+    return {
+      domain: {
+        name: "ERC4337",
+        version: "1",
+        chainId,
+        verifyingContract: entryPoint
+      },
+      types: {
+        PackedUserOperation: [
+          { name: "sender", type: "address" },
+          { name: "nonce", type: "uint256" },
+          { name: "initCode", type: "bytes" },
+          { name: "callData", type: "bytes" },
+          { name: "accountGasLimits", type: "bytes32" },
+          { name: "preVerificationGas", type: "uint256" },
+          { name: "gasFees", type: "bytes32" },
+          { name: "paymasterAndData", type: "bytes" }
+        ]
+      },
+      primaryType: "PackedUserOperation",
+      message: {
+        sender: userOp.sender,
+        nonce: userOp.nonce,
+        initCode: userOp.initCode,
+        callData: userOp.callData,
+        accountGasLimits: userOp.accountGasLimits,
+        preVerificationGas: userOp.preVerificationGas,
+        gasFees: userOp.gasFees,
+        paymasterAndData: userOp.paymasterAndData
+      }
+    };
+  }
   /**
    * Computes the EIP-712 struct hash of a `PackedUserOperation`.
    *
@@ -16282,9 +16411,12 @@ var BidManager = class {
    * Constructs a signed `PackedUserOperation` that a solver can submit to the
    * Hyperbridge coprocessor as a bid to fill an order.
    *
-   * The solver's signature covers a hash that binds the UserOperation to the
-   * order commitment and the session key address, so the IntentGatewayV2
-   * contract can verify the solver's intent on-chain.
+   * The solver signs the operation as EntryPoint v0.8 EIP-712 typed data,
+   * whose digest is the plain userOpHash. The binding to the order lives in
+   * the operation itself: the 4337 nonce key must be the lower 192 bits of
+   * the order commitment (`SolverAccount` enforces this during validation),
+   * and the callData carries the order. This keeps the signed payload fully
+   * transparent to signing infrastructure instead of an opaque digest.
    *
    * @param options - Parameters describing the solver account, gas limits, fee
    *   market values, and pre-built `callData` for the fill operation.
@@ -16322,10 +16454,17 @@ var BidManager = class {
       paymasterAndData,
       signature: "0x"
     };
-    const userOpHash = CryptoUtils.computeUserOpHash(userOp, entryPointAddress, chainId);
-    const sessionKey = order.session;
-    const messageHash = viem.keccak256(viem.concat([userOpHash, order.id, sessionKey]));
-    const solverSignature = await solverSigner.signMessage(messageHash, Number(chainId));
+    const nonceKey = BigInt(nonce) >> 64n;
+    const expectedKey = CryptoUtils.bidNonceKey(order.id, order.session);
+    if (nonceKey !== expectedKey) {
+      console.warn(
+        `[BidManager] bid nonce key does not bind the order commitment and session key; on-chain validation will fail (order=${order.id})`
+      );
+    }
+    const solverSignature = await solverSigner.signTypedData(
+      CryptoUtils.packedUserOpTypedData(userOp, entryPointAddress, chainId),
+      Number(chainId)
+    );
     const signature = viem.concat([order.id, solverSignature]);
     return { ...userOp, signature };
   }
@@ -17250,15 +17389,67 @@ var UnsupportedIntentQuoteStrategyError = class extends Error {
 var UnsupportedIntentQuotePairError = class extends Error {
   constructor(params) {
     super(
-      `No Uniswap v4 pool config found for ${params.tokenIn.symbol ?? params.tokenIn.address} -> ${params.tokenOut.symbol ?? params.tokenOut.address} on ${params.source} -> ${params.destination}`
+      `No ${params.quoteSource ?? "Uniswap v4 pool config"} found for ${params.tokenIn} -> ${params.tokenOut} on ${params.source} -> ${params.destination}`
     );
     this.name = "UnsupportedIntentQuotePairError";
   }
 };
+var PhantomSnapshotUnavailableError = class extends Error {
+  constructor(tokenA, tokenB) {
+    super(`No Phantom order price snapshot found for ${tokenA} -> ${tokenB}`);
+    this.name = "PhantomSnapshotUnavailableError";
+  }
+};
+var InvalidPhantomSnapshotError = class extends Error {
+  constructor(commitment, reason) {
+    super(`Invalid Phantom order price snapshot ${commitment}: ${reason}`);
+    this.name = "InvalidPhantomSnapshotError";
+  }
+};
+var BPS_DENOMINATOR = 10000n;
+function validateQuoteParams(params) {
+  const hasAmountIn = params.amountIn !== void 0;
+  const hasAmountOut = params.amountOut !== void 0;
+  if (hasAmountIn === hasAmountOut) throw new Error("Provide exactly one of amountIn or amountOut");
+  if (params.amountIn !== void 0 && params.amountIn <= 0n) throw new Error("amountIn must be greater than zero");
+  if (params.amountOut !== void 0 && params.amountOut <= 0n) throw new Error("amountOut must be greater than zero");
+  if (params.tokenIn.toLowerCase() === params.tokenOut.toLowerCase()) {
+    throw new Error("tokenIn and tokenOut cannot be the same");
+  }
+}
+async function readProtocolFeeBps(chainConfigService, source) {
+  const gatewayAddress = chainConfigService.getIntentGatewayAddress(source.stateMachineId);
+  if (!gatewayAddress || gatewayAddress === "0x" || gatewayAddress === viem.zeroAddress) {
+    throw new Error(`IntentGatewayV2 is not configured for chain ${source.stateMachineId}`);
+  }
+  const gatewayParams = await source.client.readContract({
+    address: gatewayAddress,
+    abi: IntentGatewayV2_default.ABI,
+    functionName: "params"
+  });
+  const protocolFeeBps = Array.isArray(gatewayParams) ? BigInt(gatewayParams[4]) : BigInt(gatewayParams.protocolFeeBps ?? 0);
+  if (protocolFeeBps < 0n || protocolFeeBps >= BPS_DENOMINATOR) {
+    throw new Error(`Invalid IntentGateway protocol fee: ${protocolFeeBps} bps`);
+  }
+  return protocolFeeBps;
+}
+function deductProtocolFee(amount, protocolFeeBps) {
+  if (protocolFeeBps <= 0n) return amount;
+  const fee = amount * protocolFeeBps / BPS_DENOMINATOR;
+  return amount - fee;
+}
+function grossUpForProtocolFee(netAmount, protocolFeeBps) {
+  if (protocolFeeBps <= 0n) return netAmount;
+  if (protocolFeeBps >= BPS_DENOMINATOR) throw new Error("protocolFeeBps must be less than 10,000");
+  return divCeil(netAmount * BPS_DENOMINATOR, BPS_DENOMINATOR - protocolFeeBps);
+}
+function divCeil(numerator, denominator) {
+  if (denominator <= 0n) throw new Error("denominator must be greater than zero");
+  return (numerator + denominator - 1n) / denominator;
+}
 
 // src/protocols/intents/quote/uniswapV4.ts
 var UNISWAP_INTENT_QUOTE_CHAIN = "EVM-8453" /* BASE_MAINNET */;
-var BPS_DENOMINATOR = 10000n;
 var UniswapV4IntentQuoteStrategy = class {
   constructor(chainConfigService) {
     this.chainConfigService = chainConfigService;
@@ -17266,10 +17457,10 @@ var UniswapV4IntentQuoteStrategy = class {
   chainConfigService;
   baseQuoteClient;
   async quote(params, source, destination) {
-    this.validateQuoteParams(params);
-    const protocolFeeBps = await this.readProtocolFeeBps(source.client, source.stateMachineId);
+    validateQuoteParams(params);
+    const protocolFeeBps = await readProtocolFeeBps(this.chainConfigService, source);
     const quoteClient = this.resolveQuoteClient(source, destination);
-    const poolConfig = this.resolvePoolConfig(params, source.stateMachineId, UNISWAP_INTENT_QUOTE_CHAIN);
+    const poolConfig = this.resolvePoolConfig(params, source.stateMachineId, destination.stateMachineId);
     return params.amountIn !== void 0 ? this.quoteExactInput({ params, client: quoteClient, protocolFeeBps, poolConfig }) : this.quoteExactOutput({ params, client: quoteClient, protocolFeeBps, poolConfig });
   }
   resolveQuoteClient(source, destination) {
@@ -17285,34 +17476,11 @@ var UniswapV4IntentQuoteStrategy = class {
     this.baseQuoteClient = baseQuoteClient;
     return baseQuoteClient;
   }
-  validateQuoteParams(params) {
-    const hasAmountIn = params.amountIn !== void 0;
-    const hasAmountOut = params.amountOut !== void 0;
-    if (hasAmountIn === hasAmountOut) throw new Error("Provide exactly one of amountIn or amountOut");
-    if (hasAmountIn && params.amountIn <= 0n) throw new Error("amountIn must be greater than zero");
-    if (hasAmountOut && params.amountOut <= 0n) throw new Error("amountOut must be greater than zero");
-    if (params.tokenIn.address.toLowerCase() === params.tokenOut.address.toLowerCase()) {
-      throw new Error("tokenIn and tokenOut cannot be the same");
-    }
-  }
-  async readProtocolFeeBps(client, chain) {
-    const gatewayAddress = this.chainConfigService.getIntentGatewayAddress(chain);
-    if (!gatewayAddress || gatewayAddress === "0x" || gatewayAddress === viem.zeroAddress) {
-      throw new Error(`IntentGatewayV2 is not configured for chain ${chain}`);
-    }
-    const gatewayParams = await client.readContract({
-      address: gatewayAddress,
-      abi: IntentGatewayV2_default.ABI,
-      functionName: "params"
-    });
-    if (isGatewayParamsTuple(gatewayParams)) return BigInt(gatewayParams[4]);
-    return BigInt(gatewayParams.protocolFeeBps ?? 0);
-  }
   resolvePoolConfig(params, source, destination) {
     const override = params.uniswapV4?.poolKey;
     if (override) {
       const poolKey = normalizePoolKey(override);
-      const tokenInForQuote = viem.getAddress(override.currencyIn ?? params.tokenIn.address);
+      const tokenInForQuote = viem.getAddress(override.currencyIn ?? params.tokenIn);
       if (tokenInForQuote !== poolKey.currency0 && tokenInForQuote !== poolKey.currency1) {
         throw new Error(
           `Input currency ${tokenInForQuote} is not part of the override pool (${poolKey.currency0}, ${poolKey.currency1}). For cross-chain quotes pass uniswapV4.poolKey.currencyIn with the Base-side input currency address.`
@@ -17320,11 +17488,11 @@ var UniswapV4IntentQuoteStrategy = class {
       }
       return {
         poolKey,
-        quoterAddress: this.resolveQuoterAddress(destination, override.quoterAddress),
+        quoterAddress: this.resolveQuoterAddress(UNISWAP_INTENT_QUOTE_CHAIN, override.quoterAddress),
         tokenInForQuote
       };
     }
-    const poolConfig = this.resolveConfiguredPool(params, destination);
+    const poolConfig = this.resolveConfiguredPool(params, source, destination, UNISWAP_INTENT_QUOTE_CHAIN);
     if (poolConfig) return poolConfig;
     throw new UnsupportedIntentQuotePairError({
       source,
@@ -17333,12 +17501,12 @@ var UniswapV4IntentQuoteStrategy = class {
       tokenOut: params.tokenOut
     });
   }
-  resolveConfiguredPool(params, chain) {
-    for (const pool of this.chainConfigService.getUniswapV4PoolConfigs(chain)) {
-      const resolvedPool = this.resolveConfiguredPoolTokens(chain, pool);
+  resolveConfiguredPool(params, sourceChain, destinationChain, quoteChain) {
+    for (const pool of this.chainConfigService.getUniswapV4PoolConfigs(quoteChain)) {
+      const resolvedPool = this.resolveConfiguredPoolTokens(quoteChain, pool);
       if (!resolvedPool) continue;
-      const tokenInForQuote = matchPoolToken(params.tokenIn, resolvedPool);
-      const tokenOutForQuote = matchPoolToken(params.tokenOut, resolvedPool);
+      const tokenInForQuote = this.matchPoolToken(params.tokenIn, sourceChain, resolvedPool);
+      const tokenOutForQuote = this.matchPoolToken(params.tokenOut, destinationChain, resolvedPool);
       if (!tokenInForQuote || !tokenOutForQuote || tokenInForQuote.symbol === tokenOutForQuote.symbol) continue;
       const { currency0, currency1 } = sortCurrencies(resolvedPool[0].address, resolvedPool[1].address);
       return {
@@ -17349,7 +17517,7 @@ var UniswapV4IntentQuoteStrategy = class {
           tickSpacing: pool.tickSpacing,
           hooks: viem.getAddress(pool.hooks ?? viem.zeroAddress)
         },
-        quoterAddress: this.resolveQuoterAddress(chain),
+        quoterAddress: this.resolveQuoterAddress(quoteChain),
         tokenInForQuote: tokenInForQuote.address
       };
     }
@@ -17372,8 +17540,18 @@ var UniswapV4IntentQuoteStrategy = class {
     if (!address || address === "0x") return null;
     return { symbol, address: viem.getAddress(address) };
   }
+  matchPoolToken(tokenAddress, orderChain, poolTokens) {
+    const addressMatch = poolTokens.find(
+      (poolToken) => poolToken.address.toLowerCase() === tokenAddress.toLowerCase()
+    );
+    if (addressMatch) return addressMatch;
+    const metadata = this.chainConfigService.getAssetMetadataByAddress(orderChain, tokenAddress);
+    if (!metadata) return null;
+    return poolTokens.find((poolToken) => poolToken.symbol === metadata.symbol) ?? null;
+  }
   async quoteExactInput(args) {
     const amountIn = args.params.amountIn;
+    if (amountIn === void 0) throw new Error("amountIn is required for an exact-input quote");
     const swapAmountIn = deductProtocolFee(amountIn, args.protocolFeeBps);
     const amountOut = await this.readV4QuoteExactInput(args.client, args.poolConfig, swapAmountIn);
     return {
@@ -17391,6 +17569,7 @@ var UniswapV4IntentQuoteStrategy = class {
   }
   async quoteExactOutput(args) {
     const amountOut = args.params.amountOut;
+    if (amountOut === void 0) throw new Error("amountOut is required for an exact-output quote");
     const swapAmountIn = await this.readV4QuoteExactOutput(args.client, args.poolConfig, amountOut);
     const amountIn = grossUpForProtocolFee(swapAmountIn, args.protocolFeeBps);
     return {
@@ -17469,34 +17648,125 @@ function sortCurrencies(tokenIn, tokenOut) {
   const output = viem.getAddress(tokenOut);
   return BigInt(input) < BigInt(output) ? { currency0: input, currency1: output } : { currency0: output, currency1: input };
 }
-function matchPoolToken(token, poolTokens) {
-  const tokenAddress = token.address.toLowerCase();
-  const addressMatch = poolTokens.find((poolToken) => poolToken.address.toLowerCase() === tokenAddress);
-  if (addressMatch) return addressMatch;
-  const tokenSymbol = token.symbol?.toUpperCase();
-  if (!tokenSymbol) return null;
-  return poolTokens.find((poolToken) => poolToken.symbol.toUpperCase() === tokenSymbol) ?? null;
-}
 function getZeroForOne(tokenIn, poolKey) {
   return viem.getAddress(tokenIn).toLowerCase() === viem.getAddress(poolKey.currency0).toLowerCase();
 }
-function isGatewayParamsTuple(value) {
-  return Array.isArray(value);
-}
-function deductProtocolFee(amount, protocolFeeBps) {
-  if (protocolFeeBps <= 0n) return amount;
-  const fee = amount * protocolFeeBps / BPS_DENOMINATOR;
-  return amount - fee;
-}
-function grossUpForProtocolFee(netAmount, protocolFeeBps) {
-  if (protocolFeeBps <= 0n) return netAmount;
-  return divCeil(netAmount * BPS_DENOMINATOR, BPS_DENOMINATOR - protocolFeeBps);
+
+// src/protocols/intents/quote/phantomSnapshot.ts
+var PHANTOM_INTENT_QUOTE_CHAIN = "EVM-8453" /* BASE_MAINNET */;
+var BASE_SNAPSHOT_ASSET_BY_ORDER_ASSET = {
+  USDC: "USDC",
+  USDT: "USDC",
+  cNGN: "cNGN"
+};
+var SUPPORTED_BASE_SNAPSHOT_PAIRS = /* @__PURE__ */ new Set(["USDC:cNGN", "cNGN:USDC"]);
+var PhantomSnapshotIntentQuoteStrategy = class {
+  constructor(chainConfigService, getQueryClient) {
+    this.chainConfigService = chainConfigService;
+    this.getQueryClient = getQueryClient;
+  }
+  chainConfigService;
+  getQueryClient;
+  async quote(params, source, destination) {
+    validateQuoteParams(params);
+    const pair = this.resolveBaseSnapshotPair(params, source.stateMachineId, destination.stateMachineId);
+    if (!pair) {
+      throw new UnsupportedIntentQuotePairError({
+        source: source.stateMachineId,
+        destination: destination.stateMachineId,
+        tokenIn: params.tokenIn,
+        tokenOut: params.tokenOut,
+        quoteSource: "Phantom snapshot pair"
+      });
+    }
+    const queryClient = this.getQueryClient();
+    const [protocolFeeBps, snapshot] = await Promise.all([
+      readProtocolFeeBps(this.chainConfigService, source),
+      _queryLatestPhantomOrderPriceSnapshot({
+        tokenA: pair.tokenA,
+        tokenB: pair.tokenB,
+        queryClient
+      })
+    ]);
+    if (!snapshot) throw new PhantomSnapshotUnavailableError(pair.tokenA, pair.tokenB);
+    this.validateSnapshot(snapshot);
+    return this.quoteSnapshot(params, protocolFeeBps, snapshot);
+  }
+  quoteSnapshot(params, protocolFeeBps, snapshot) {
+    if (params.amountIn !== void 0) {
+      const netAmountIn2 = deductProtocolFee(params.amountIn, protocolFeeBps);
+      const amountOut = netAmountIn2 * snapshot.medianPrice / snapshot.standardAmount;
+      if (amountOut <= 0n) {
+        throw new InvalidPhantomSnapshotError(snapshot.commitment, "quote rounds down to zero output");
+      }
+      return this.buildResult("EXACT_INPUT", params.amountIn, amountOut, protocolFeeBps, snapshot);
+    }
+    if (params.amountOut === void 0) throw new Error("Quote amount is missing after validation");
+    const netAmountIn = divCeil(params.amountOut * snapshot.standardAmount, snapshot.medianPrice);
+    const amountIn = grossUpForProtocolFee(netAmountIn, protocolFeeBps);
+    return this.buildResult("EXACT_OUTPUT", amountIn, params.amountOut, protocolFeeBps, snapshot);
+  }
+  buildResult(tradeType, amountIn, amountOut, protocolFeeBps, snapshot) {
+    return {
+      strategy: "phantom_snapshot",
+      tradeType,
+      amountIn,
+      amountOut,
+      quoteMetadata: {
+        quoteChain: PHANTOM_INTENT_QUOTE_CHAIN,
+        commitment: snapshot.commitment,
+        tokenA: snapshot.tokenA,
+        tokenB: snapshot.tokenB,
+        standardAmount: snapshot.standardAmount,
+        medianPrice: snapshot.medianPrice,
+        lowestPrice: snapshot.lowestPrice,
+        highestPrice: snapshot.highestPrice,
+        blockNumber: snapshot.blockNumber,
+        snapshotTime: snapshot.snapshotTime,
+        bidCount: snapshot.bidCount,
+        protocolFeeBps
+      }
+    };
+  }
+  validateSnapshot(snapshot) {
+    if (snapshot.standardAmount <= 0n) {
+      throw new InvalidPhantomSnapshotError(snapshot.commitment, "standardAmount must be greater than zero");
+    }
+    if (snapshot.medianPrice <= 0n) {
+      throw new InvalidPhantomSnapshotError(snapshot.commitment, "medianPrice must be greater than zero");
+    }
+    if (snapshot.bidCount <= 0) {
+      throw new InvalidPhantomSnapshotError(snapshot.commitment, "bidCount must be greater than zero");
+    }
+    if (Number.isNaN(snapshot.snapshotTime.getTime())) {
+      throw new InvalidPhantomSnapshotError(snapshot.commitment, "snapshotTime is invalid");
+    }
+  }
+  resolveBaseSnapshotPair(params, sourceStateMachineId, destinationStateMachineId) {
+    const tokenIn = this.resolveBaseSnapshotToken(sourceStateMachineId, params.tokenIn);
+    const tokenOut = this.resolveBaseSnapshotToken(destinationStateMachineId, params.tokenOut);
+    if (!tokenIn || !tokenOut || !isSupportedSnapshotPair(tokenIn.symbol, tokenOut.symbol)) return;
+    return { tokenA: tokenIn.address, tokenB: tokenOut.address };
+  }
+  resolveBaseSnapshotToken(chain, tokenAddress) {
+    const orderAsset = this.chainConfigService.getAssetMetadataByAddress(chain, tokenAddress)?.symbol;
+    if (!orderAsset) return;
+    const snapshotAsset = BASE_SNAPSHOT_ASSET_BY_ORDER_ASSET[orderAsset];
+    if (!snapshotAsset) return;
+    const address = this.chainConfigService.getAssetAddress(PHANTOM_INTENT_QUOTE_CHAIN, snapshotAsset);
+    if (!isConfiguredAddress(address)) return;
+    return { symbol: snapshotAsset, address };
+  }
+};
+function isSupportedSnapshotPair(tokenA, tokenB) {
+  return SUPPORTED_BASE_SNAPSHOT_PAIRS.has(`${tokenA}:${tokenB}`);
 }
-function divCeil(numerator, denominator) {
-  return (numerator + denominator - 1n) / denominator;
+function isConfiguredAddress(address) {
+  return Boolean(address && address !== "0x" && !/^0x0{40}$/i.test(address));
 }
 
 // src/protocols/intents/IntentGateway.ts
+var CROSS_CHAIN_ORDER_FEE_GAS_BUMP = 600000n;
 var IntentGateway = class _IntentGateway {
   /** EVM chain on which orders are placed and escrowed. */
   source;
@@ -17568,6 +17838,10 @@ var IntentGateway = class _IntentGateway {
     this.gasEstimator = gasEstimator;
     this._crypto = crypto;
     this.quoteStrategies = {
+      phantom_snapshot: new PhantomSnapshotIntentQuoteStrategy(
+        dest.configService,
+        () => this.requireIndexer().queryClient
+      ),
       uniswap_v4: new UniswapV4IntentQuoteStrategy(dest.configService)
     };
   }
@@ -17617,37 +17891,39 @@ var IntentGateway = class _IntentGateway {
   /**
    * Quotes an intent between this gateway's source and destination chains.
    *
-   * `strategy` defaults to `uniswap_v4`, currently the only supported
-   * strategy. Provide exactly one of `amountIn` or `amountOut`.
+   * Uses the latest directional Phantom order price snapshot from the attached
+   * indexer by default. Pass `strategy: "uniswap_v4"` only when explicitly
+   * requesting a Uniswap quote. Provide exactly one of `amountIn` or `amountOut`.
    *
-   * The Uniswap quote strategy always prices against the configured Base
-   * pool, regardless of this gateway's destination chain. Returned
+   * Both built-in strategies resolve their canonical market on Base,
+   * regardless of this gateway's destination chain. Returned
    * `amountIn`/`amountOut` already account for the gateway's protocol fee
    * (`quoteMetadata.protocolFeeBps`), which the gateway deducts from order
-   * inputs; apply only your own slippage tolerance before placing the order.
+   * inputs; use the returned amounts directly when placing the order.
    *
    * @param params - Token pair, amount, and optional strategy/pool overrides.
    * @returns The quoted amounts plus strategy-specific metadata.
    * @throws {UnsupportedIntentQuoteStrategyError} For unknown strategies.
-   * @throws {UnsupportedIntentQuotePairError} When no pool is configured for the pair.
+   * @throws {UnsupportedIntentQuotePairError} When the selected strategy does not support the pair.
+   * @throws {PhantomSnapshotUnavailableError} When an eligible cNGN pair has no snapshot.
    */
   async quoteIntent(params) {
-    const strategy = params.strategy ?? "uniswap_v4";
+    const source = { stateMachineId: this.source.config.stateMachineId, client: this.source.client };
+    const destination = { stateMachineId: this.dest.config.stateMachineId, client: this.dest.client };
+    const strategy = params.strategy ?? "phantom_snapshot";
     const handler = this.quoteStrategies[strategy];
     if (!handler) throw new UnsupportedIntentQuoteStrategyError(strategy);
-    return handler.quote(
-      { ...params, strategy },
-      { stateMachineId: this.source.config.stateMachineId, client: this.source.client },
-      { stateMachineId: this.dest.config.stateMachineId, client: this.dest.client }
-    );
+    return handler.quote({ ...params, strategy }, source, destination);
   }
   /**
    * Bidirectional async generator that orchestrates the full order lifecycle:
    * placement, fee estimation, bid collection, and execution.
    *
    * **Yield/receive protocol:**
-   * 1. If `order.fees` is unset or zero, estimates gas and sets `order.fees`
-   *    with a 1% buffer and the wei cost with a 2% buffer for the `value` field.
+   * 1. If `order.fees` is unset or zero, estimates gas and sets same-chain
+   *    `order.fees` to twice the estimate. Cross-chain orders retain a 1% buffer
+   *    and include an additional 600k-gas fee uplift, while the wei cost used for
+   *    the `value` field receives a 2% buffer.
    * 2. Yields `AWAITING_PLACE_ORDER` with `{ to, data, value, sessionPrivateKey }`.
    *    The caller must sign the transaction and pass it back via `gen.next(signedTx)`.
    * 3. Yields `ORDER_PLACED` with the finalised order and transaction hash once
@@ -17679,8 +17955,15 @@ var IntentGateway = class _IntentGateway {
       if (estimate.totalGasCostWei === 0n || estimate.totalGasInFeeToken === 0n) {
         throw new Error("Gas estimation failed");
       }
+      const isSameChain = this.source.config.stateMachineId === this.dest.config.stateMachineId;
       value = estimate.totalGasCostWei + estimate.totalGasCostWei * 2n / 100n;
-      order.fees = estimate.totalGasInFeeToken + estimate.totalGasInFeeToken * 1n / 100n;
+      const crossChainFeeBump = isSameChain ? 0n : await convertGasToFeeToken(
+        this.ctx,
+        CROSS_CHAIN_ORDER_FEE_GAS_BUMP,
+        "source",
+        this.source.config.stateMachineId
+      );
+      order.fees = isSameChain ? estimate.totalGasInFeeToken * 2n : estimate.totalGasInFeeToken + (crossChainFeeBump + estimate.totalGasInFeeToken * 1n / 100n);
     }
     const placeOrderGen = this.orderPlacer.placeOrder(order, graffiti);
     const placeOrderFirst = await placeOrderGen.next();
@@ -18061,7 +18344,9 @@ var IntentGateway = class _IntentGateway {
   }
   requireIndexer() {
     if (!this.indexer) {
-      throw new Error("IntentGateway: call withQueryClient(queryClient) before using indexer-backed methods");
+      throw new Error(
+        "IntentGateway: call withQueryClient(queryClient) before using indexer-backed methods or Phantom quotes"
+      );
     }
     return this.indexer;
   }
@@ -22596,6 +22881,7 @@ exports.IntentGateway = IntentGateway;
 exports.IntentGatewayABI = ABI3;
 exports.IntentOrderStatus = IntentOrderStatus;
 exports.IntentsCoprocessor = IntentsCoprocessor;
+exports.InvalidPhantomSnapshotError = InvalidPhantomSnapshotError;
 exports.IsmpClient = IsmpClient;
 exports.MOCK_ADDRESS = MOCK_ADDRESS;
 exports.ORDER_V2_PARAM_TYPE = ORDER_V2_PARAM_TYPE;
@@ -22603,6 +22889,7 @@ exports.OrderStatus = OrderStatus;
 exports.OrderStatusChecker = OrderStatusChecker;
 exports.PACKED_USEROP_TYPEHASH = PACKED_USEROP_TYPEHASH;
 exports.PLACE_ORDER_SELECTOR = PLACE_ORDER_SELECTOR;
+exports.PhantomSnapshotUnavailableError = PhantomSnapshotUnavailableError;
 exports.PharosChain = PharosChain;
 exports.PolkadotHubChain = PolkadotHubChain;
 exports.REQUEST_COMMITMENTS_SLOT = REQUEST_COMMITMENTS_SLOT;