@hyperbridge/sdk 2.4.2 → 2.5.0

package/dist/node/intents-helpers.d.cts

@@ -1,4 +1,5 @@
-export { bj as IntentGatewayV2, b4 as decodeERC7821ExecuteBatch, b5 as decodeUserOpScale, b6 as encodeERC7821ExecuteBatch, b8 as encodeUserOpScale } from './IntentGatewayV2-PzbhFn_7.cjs';
+import { z as PackedUserOperation } from './IntentGatewayV2-tYGohDdW.cjs';
+export { bm as IntentGatewayV2, b7 as decodeERC7821ExecuteBatch, b8 as decodeUserOpScale, b9 as encodeERC7821ExecuteBatch, bb as encodeUserOpScale } from './IntentGatewayV2-tYGohDdW.cjs';
 import '@polkadot/api';
 import '@polkadot/keyring/types';
 import 'consola';
@@ -8,6 +9,12 @@ import 'viem';
 import 'viem/chains';
 
 type HexString = `0x${string}`;
+/**
+ * ERC-4337 v0.8 EntryPoint, the contract whose userOpHash a bid's solver signature is taken over.
+ * Canonical across every EVM chain we support, which is why it is a constant here rather than
+ * something callers pass in (chain.ts carries the same address per chain as `EntryPointV08`).
+ */
+declare const ENTRY_POINT_V08_ADDRESS: "0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108";
 /** Minimal fetch shape used by the JSON-RPC POSTs below. */
 type FetchLike = (url: string, init: any) => Promise<{
     json(): Promise<any>;
@@ -1439,20 +1446,50 @@ declare function weightedMedian(entries: {
     weight: bigint;
 }[]): bigint;
 declare function extractFillData(callData: HexString, gatewayAddress: string): FillData | null;
+/** Derives the 192-bit bid nonce key binding a bid to an (order, sessionKey) pair. */
+type BidNonceKeyFn = (commitment: HexString, sessionKey: HexString) => bigint;
+/** Recomputes an order's commitment from the contract-shaped order decoded out of a bid's calldata. */
+type OrderCommitmentFn = (order: Record<string, unknown>) => HexString | null;
+/**
+ * Default (viem) {@link OrderCommitmentFn}. The order comes straight out of `fillOrder`'s ABI
+ * decode, so it is already contract-shaped and re-encoding it reproduces `keccak256(abi.encode(order))`
+ * — the same commitment IntentGatewayV2 computes on-chain. Returns null when it cannot be computed,
+ * which callers treat as unverifiable (fail closed).
+ */
+declare function orderCommitmentFromDecoded(order: Record<string, unknown>): HexString | null;
+interface BidSignature {
+    /** The order commitment the solver signature is bound to. */
+    commitment: HexString;
+    /** The solver's 65-byte ECDSA signature over the userOpHash. */
+    solverSignature: HexString;
+}
+/** Splits a bid userOp's signature into its commitment and solver signature; null if malformed. */
+declare function splitBidSignature(signature: HexString): BidSignature | null;
+/** Recovers the address that produced a bid's solver signature, or null if it cannot be recovered. */
+type RecoverBidSigner = (userOp: PackedUserOperation, entryPoint: HexString, chainId: bigint, solverSignature: HexString) => Promise<HexString | null>;
+/**
+ * Default {@link RecoverBidSigner}: recovers over the EntryPoint v0.8 userOpHash, the digest
+ * SolverAccount itself validates against. viem-based, so Node consumers get it for free while the
+ * indexer injects an ethers equivalent (see the note at the top of this file).
+ */
+declare const recoverBidSignerViem: RecoverBidSigner;
 declare function fetchBidsForOrder(nodeUrl: string, commitment: string): Promise<RpcBidInfo[]>;
 /**
  * Aggregates every bid for a phantom order into a single price/liquidity snapshot.
  *
  * Fetches the live bids via `intents_getBidsForOrder` and reads each filler's quoted output amount.
- * The liquidity-weighted median weights every quote by the solver's balance of the output token on
- * the destination chain, so a solver that can't actually deliver size carries little or no weight —
- * which is why no fill simulation is needed to filter unfillable quotes. For each bidding solver it
- * also records a full liquidity sweep — every configured yield-vault token on every supported chain
- * (raw ERC-20 + vault positions). Returns `null` when there are no decodable bids.
+ * Only bids that {@link isVerifiedSolverBid} accepts are counted — a bid from anyone who is not one
+ * of our delegated solvers, or whose signature was not produced for this order, is dropped rather
+ * than allowed to move the price. The liquidity-weighted median then weights every surviving quote by
+ * the solver's balance of the output token on the destination chain, so a solver that can't actually
+ * deliver size carries little or no weight — which is why no fill simulation is needed to filter
+ * unfillable quotes. For each bidding solver it also records a full liquidity sweep — every
+ * configured yield-vault token on every supported chain (raw ERC-20 + vault positions). Returns
+ * `null` when no bid survives verification.
  *
- * `extractFill` decodes a bid's ERC-7821 calldata into the fill's order/output; it defaults to the
- * viem-based {@link extractFillData}, but the indexer injects a VM2-safe variant (viem's
- * decodeFunctionData keccak throws in the SubQuery sandbox).
+ * `extractFill` decodes a bid's ERC-7821 calldata into the fill's order/output and `recoverSigner`
+ * recovers its solver signature; both default to the viem implementations, but the indexer injects
+ * VM2-safe variants (viem's keccak throws in the SubQuery sandbox).
  */
 declare function aggregatePhantomBids(params: {
     nodeUrl: string;
@@ -1462,8 +1499,13 @@ declare function aggregatePhantomBids(params: {
     gatewayAddress: string;
     commitment: string;
     yieldVaults: YieldVaultMap;
+    /** SolverAccount on `chain` that our solvers delegate to; bids from anyone else are dropped. */
+    solverAccount: string;
     extractFill?: (callData: HexString, gatewayAddress: string) => FillData | null;
+    recoverSigner?: RecoverBidSigner;
+    bidNonceKey?: BidNonceKeyFn;
+    orderCommitment?: OrderCommitmentFn;
     logger?: AggregationLogger;
 }): Promise<PhantomAggregation | null>;
 
-export { type AggregationLogger, FILL_ORDER_ABI, type FetchLike, type FillData, type HexString, type LpBalance, type PhantomAggregation, type RpcBidInfo, type YieldVaultMap, aggregatePhantomBids, extractFillData, fetchBidsForOrder, setAggregationFetch, weightedMedian };
+export { type AggregationLogger, type BidNonceKeyFn, type BidSignature, ENTRY_POINT_V08_ADDRESS, FILL_ORDER_ABI, type FetchLike, type FillData, type HexString, type LpBalance, type OrderCommitmentFn, type PhantomAggregation, type RecoverBidSigner, type RpcBidInfo, type YieldVaultMap, aggregatePhantomBids, extractFillData, fetchBidsForOrder, orderCommitmentFromDecoded, recoverBidSignerViem, setAggregationFetch, splitBidSignature, weightedMedian };

package/dist/node/intents-helpers.d.ts

@@ -1,4 +1,5 @@
-export { bj as IntentGatewayV2, b4 as decodeERC7821ExecuteBatch, b5 as decodeUserOpScale, b6 as encodeERC7821ExecuteBatch, b8 as encodeUserOpScale } from './IntentGatewayV2-PzbhFn_7.js';
+import { z as PackedUserOperation } from './IntentGatewayV2-tYGohDdW.js';
+export { bm as IntentGatewayV2, b7 as decodeERC7821ExecuteBatch, b8 as decodeUserOpScale, b9 as encodeERC7821ExecuteBatch, bb as encodeUserOpScale } from './IntentGatewayV2-tYGohDdW.js';
 import '@polkadot/api';
 import '@polkadot/keyring/types';
 import 'consola';
@@ -8,6 +9,12 @@ import 'viem';
 import 'viem/chains';
 
 type HexString = `0x${string}`;
+/**
+ * ERC-4337 v0.8 EntryPoint, the contract whose userOpHash a bid's solver signature is taken over.
+ * Canonical across every EVM chain we support, which is why it is a constant here rather than
+ * something callers pass in (chain.ts carries the same address per chain as `EntryPointV08`).
+ */
+declare const ENTRY_POINT_V08_ADDRESS: "0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108";
 /** Minimal fetch shape used by the JSON-RPC POSTs below. */
 type FetchLike = (url: string, init: any) => Promise<{
     json(): Promise<any>;
@@ -1439,20 +1446,50 @@ declare function weightedMedian(entries: {
     weight: bigint;
 }[]): bigint;
 declare function extractFillData(callData: HexString, gatewayAddress: string): FillData | null;
+/** Derives the 192-bit bid nonce key binding a bid to an (order, sessionKey) pair. */
+type BidNonceKeyFn = (commitment: HexString, sessionKey: HexString) => bigint;
+/** Recomputes an order's commitment from the contract-shaped order decoded out of a bid's calldata. */
+type OrderCommitmentFn = (order: Record<string, unknown>) => HexString | null;
+/**
+ * Default (viem) {@link OrderCommitmentFn}. The order comes straight out of `fillOrder`'s ABI
+ * decode, so it is already contract-shaped and re-encoding it reproduces `keccak256(abi.encode(order))`
+ * — the same commitment IntentGatewayV2 computes on-chain. Returns null when it cannot be computed,
+ * which callers treat as unverifiable (fail closed).
+ */
+declare function orderCommitmentFromDecoded(order: Record<string, unknown>): HexString | null;
+interface BidSignature {
+    /** The order commitment the solver signature is bound to. */
+    commitment: HexString;
+    /** The solver's 65-byte ECDSA signature over the userOpHash. */
+    solverSignature: HexString;
+}
+/** Splits a bid userOp's signature into its commitment and solver signature; null if malformed. */
+declare function splitBidSignature(signature: HexString): BidSignature | null;
+/** Recovers the address that produced a bid's solver signature, or null if it cannot be recovered. */
+type RecoverBidSigner = (userOp: PackedUserOperation, entryPoint: HexString, chainId: bigint, solverSignature: HexString) => Promise<HexString | null>;
+/**
+ * Default {@link RecoverBidSigner}: recovers over the EntryPoint v0.8 userOpHash, the digest
+ * SolverAccount itself validates against. viem-based, so Node consumers get it for free while the
+ * indexer injects an ethers equivalent (see the note at the top of this file).
+ */
+declare const recoverBidSignerViem: RecoverBidSigner;
 declare function fetchBidsForOrder(nodeUrl: string, commitment: string): Promise<RpcBidInfo[]>;
 /**
  * Aggregates every bid for a phantom order into a single price/liquidity snapshot.
  *
  * Fetches the live bids via `intents_getBidsForOrder` and reads each filler's quoted output amount.
- * The liquidity-weighted median weights every quote by the solver's balance of the output token on
- * the destination chain, so a solver that can't actually deliver size carries little or no weight —
- * which is why no fill simulation is needed to filter unfillable quotes. For each bidding solver it
- * also records a full liquidity sweep — every configured yield-vault token on every supported chain
- * (raw ERC-20 + vault positions). Returns `null` when there are no decodable bids.
+ * Only bids that {@link isVerifiedSolverBid} accepts are counted — a bid from anyone who is not one
+ * of our delegated solvers, or whose signature was not produced for this order, is dropped rather
+ * than allowed to move the price. The liquidity-weighted median then weights every surviving quote by
+ * the solver's balance of the output token on the destination chain, so a solver that can't actually
+ * deliver size carries little or no weight — which is why no fill simulation is needed to filter
+ * unfillable quotes. For each bidding solver it also records a full liquidity sweep — every
+ * configured yield-vault token on every supported chain (raw ERC-20 + vault positions). Returns
+ * `null` when no bid survives verification.
  *
- * `extractFill` decodes a bid's ERC-7821 calldata into the fill's order/output; it defaults to the
- * viem-based {@link extractFillData}, but the indexer injects a VM2-safe variant (viem's
- * decodeFunctionData keccak throws in the SubQuery sandbox).
+ * `extractFill` decodes a bid's ERC-7821 calldata into the fill's order/output and `recoverSigner`
+ * recovers its solver signature; both default to the viem implementations, but the indexer injects
+ * VM2-safe variants (viem's keccak throws in the SubQuery sandbox).
  */
 declare function aggregatePhantomBids(params: {
     nodeUrl: string;
@@ -1462,8 +1499,13 @@ declare function aggregatePhantomBids(params: {
     gatewayAddress: string;
     commitment: string;
     yieldVaults: YieldVaultMap;
+    /** SolverAccount on `chain` that our solvers delegate to; bids from anyone else are dropped. */
+    solverAccount: string;
     extractFill?: (callData: HexString, gatewayAddress: string) => FillData | null;
+    recoverSigner?: RecoverBidSigner;
+    bidNonceKey?: BidNonceKeyFn;
+    orderCommitment?: OrderCommitmentFn;
     logger?: AggregationLogger;
 }): Promise<PhantomAggregation | null>;
 
-export { type AggregationLogger, FILL_ORDER_ABI, type FetchLike, type FillData, type HexString, type LpBalance, type PhantomAggregation, type RpcBidInfo, type YieldVaultMap, aggregatePhantomBids, extractFillData, fetchBidsForOrder, setAggregationFetch, weightedMedian };
+export { type AggregationLogger, type BidNonceKeyFn, type BidSignature, ENTRY_POINT_V08_ADDRESS, FILL_ORDER_ABI, type FetchLike, type FillData, type HexString, type LpBalance, type OrderCommitmentFn, type PhantomAggregation, type RecoverBidSigner, type RpcBidInfo, type YieldVaultMap, aggregatePhantomBids, extractFillData, fetchBidsForOrder, orderCommitmentFromDecoded, recoverBidSignerViem, setAggregationFetch, splitBidSignature, weightedMedian };