@pafi-dev/core 0.10.0 → 0.13.1

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import { Address, Hex, TypedDataDomain, PublicClient, WalletClient, TransactionReceipt, HttpTransport } from 'viem';
-import { P as PoolKey, C as ChainConfig, a as PafiSDKConfig, b as PointTokenDomainConfig, M as MintRequest, E as EIP712Signature, S as SignatureVerification } from './types-B3UivyQ1.js';
-export { B as BestQuote, c as BlackoutWindow, d as BurnRequest, e as ExactOutputBestQuote, f as ExactOutputQuoteResult, I as Issuer, g as PathKey, Q as QuoteResult, R as Recipient, h as RedemptionDecision, i as RedemptionDenial, j as RedemptionDenialCode, k as RedemptionPolicy, l as RedemptionPolicySource, m as RedemptionPreview, T as TokenCap } from './types-B3UivyQ1.js';
-export { pointTokenAbi as POINT_TOKEN_V2_ABI, erc20Abi, issuerRegistryAbi, mintFeeWrapperAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v4QuoterAbi } from './abi/index.js';
+import { P as PoolKey, C as ChainConfig, V as V3Path, a as PafiSDKConfig, b as PointTokenDomainConfig, M as MintRequest, E as EIP712Signature, S as SignatureVerifyOptions, c as SignatureVerification } from './types-C17pznGz.js';
+export { B as BestQuote, d as BlackoutWindow, e as BurnRequest, f as ExactOutputBestQuote, g as ExactOutputQuoteResult, I as Issuer, Q as QuoteResult, R as Recipient, h as RedemptionDecision, i as RedemptionDenial, j as RedemptionDenialCode, k as RedemptionPolicy, l as RedemptionPolicySource, m as RedemptionPreview, n as SignatureVerificationFailReason, T as TokenCap } from './types-C17pznGz.js';
+export { pointTokenAbi as POINT_TOKEN_ABI, pointTokenAbi as POINT_TOKEN_V2_ABI, erc20Abi, issuerRegistryAbi, mintFeeWrapperAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v3QuoterV2Abi } from './abi/index.js';
 export { Eip712DomainMismatchError, assertDomainMatchesContract, buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, signBurnRequest, signMintRequest, verifyBurnRequest, verifyMintRequest } from './eip712/index.js';
 export { getBurnRequestNonce, getIssuer, getMintFeeBps, getMintFeeRecipients, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getTokenCap, getTokenName, isActiveIssuer, isMinter, issuerRegistryGetIssuerFlatAbi, verifyMintCap } from './contract/index.js';
 import { LoginMessageParams } from './auth/index.js';
 export { BuildSponsorAuthParams, BuiltSponsorAuth, SPONSOR_AUTH_DOMAIN_ANCHOR_BASE_MAINNET, SPONSOR_AUTH_DOMAIN_NAME, SPONSOR_AUTH_TYPES, SponsorAuthPayload, SponsorAuthVerifyResult, VerifyLoginResult, buildAndSignSponsorAuth, buildSponsorAuthDomain, buildSponsorAuthTypedData, computeCallDataHash, createLoginMessage, generateSponsorAuthNonce, getSponsorAuthDomainAnchor, parseLoginMessage, signSponsorAuth, verifyLoginMessage, verifySponsorAuth } from './auth/index.js';
 
 /**
- * EIP-712 typed data for the v1.6 sig-gated mint path.
+ * EIP-712 typed data for the sig-gated mint path.
  *
  * Contract enforces:
  *   - msg.sender == receiver (the on-chain caller of `mint`)
@@ -53,8 +53,35 @@ declare const burnRequestTypes: {
     }];
 };
 declare const SUPPORTED_CHAINS: Record<number, ChainConfig>;
-declare const V4_QUOTER_ADDRESSES: Record<number, Address>;
+/**
+ * Uniswap V3 QuoterV2 — used by `findBestQuote` / `quoteExactInput` etc.
+ * QuoterV2 (vs V1) reverts cleanly inside multicall and returns a 4-tuple
+ * `(amountOut, sqrtPriceX96AfterList, initializedTicksCrossedList, gasEstimate)`.
+ */
+declare const QUOTER_V2_ADDRESSES: Record<number, Address>;
+/**
+ * Uniswap UniversalRouter — used for AA/batched swaps via PT delegated
+ * accounts. Speaks V3 commands (`V3_SWAP_EXACT_IN = 0x00`,
+ * `V3_SWAP_EXACT_OUT = 0x01`).
+ */
 declare const UNIVERSAL_ROUTER_ADDRESSES: Record<number, Address>;
+/**
+ * Uniswap V3 SwapRouter — used by `swapDirect`-style flows that bypass
+ * the UniversalRouter. Takes `exactInput` / `exactOutput` with packed-bytes
+ * paths directly.
+ */
+declare const V3_SWAP_ROUTER_ADDRESSES: Record<number, Address>;
+/**
+ * PAFI's Uniswap V3 factory — used together with `V3_POOL_INIT_CODE_HASH`
+ * to derive pool addresses deterministically (`computeV3PoolAddress`).
+ */
+declare const V3_FACTORY_ADDRESSES: Record<number, Address>;
+/**
+ * Pool-init code hash for PAFI's V3 deployment. Combined with the factory
+ * address + sorted tokens + fee, deterministically yields a pool's
+ * address via the standard Uniswap V3 CREATE2 derivation.
+ */
+declare const V3_POOL_INIT_CODE_HASH: Hex;
 declare const COMMON_TOKENS: Record<number, Record<string, Address>>;
 declare const COMMON_POOLS: Record<number, PoolKey[]>;
 declare const POINT_TOKEN_POOLS: Record<number, Record<Address, PoolKey[]>>;
@@ -126,29 +153,67 @@ declare abstract class PafiSdkError extends Error {
     constructor(message: string);
 }
 /**
- * @deprecated Use `PafiSdkError` (capital S, lowercase dk).
- * The two classes existed in parallel ("PafiSDKError" in core,
- * "PafiSdkError" in issuer) due to historical drift; consolidating
- * here. Kept as alias for back-compat through v0.7.x; will be removed
- * in v0.8.
+ * SDK-level misconfiguration — required input missing on the
+ * `PafiSDK` class or a helper that needs a provider/signer/chainId.
+ * The SDK can't service the request until the deployment is fixed,
+ * so this routes to **503** in `createSdkErrorMapper`.
+ *
+ * Note: `@pafi-dev/issuer` has a separate `ConfigurationError` with
+ * the same name but a different shape (carries a caller-supplied
+ * `code`). Both extend `PafiSdkError`; pick based on which package
+ * raised the error.
  */
-declare class PafiSDKError extends Error {
-    constructor(message: string);
-}
-declare class ConfigurationError extends PafiSDKError {
+declare class ConfigurationError extends PafiSdkError {
+    readonly httpStatus: "service_unavailable";
+    readonly code: "CONFIGURATION_ERROR";
+    readonly type: "server_error";
     constructor(message: string);
 }
-declare class SigningError extends PafiSDKError {
+/**
+ * EIP-712 / EIP-7702 signing failed inside the SDK — typically the
+ * signer wallet rejected, the KMS was unreachable, or a signature
+ * post-condition (recover-to-expected-address) didn't hold.
+ *
+ * Routes to **503** because the most common cause is transient signer
+ * infrastructure (KMS hiccup); retry is often safe. Set
+ * `safeToRetry = true` from the call site if you can prove it.
+ */
+declare class SigningError extends PafiSdkError {
+    readonly httpStatus: "service_unavailable";
+    readonly code: "SIGNING_FAILED";
+    readonly type: "server_error";
     constructor(message: string);
 }
-declare class SimulationError extends PafiSDKError {
-    operation: string;
-    reason: string;
+/**
+ * `eth_call` dry-run reverted. The on-chain tx would also revert —
+ * caller's params are bad (slippage, insufficient balance, expired
+ * deadline). Routes to **422** as a business-logic failure.
+ *
+ * `operation` is a short tag (`"swap"`, `"perp-deposit"`, etc.) for
+ * log-grouping; `reason` carries the raw revert string surfaced by
+ * the simulator.
+ */
+declare class SimulationError extends PafiSdkError {
+    readonly httpStatus: "unprocessable";
+    readonly code: "SIMULATION_FAILED";
+    readonly type: "business_logic_error";
+    readonly operation: string;
+    readonly reason: string;
     constructor(operation: string, reason: string);
 }
-declare class ApiError extends PafiSDKError {
-    status?: number | undefined;
-    constructor(message: string, status?: number | undefined);
+/**
+ * External HTTP call (Pimlico bundler, PAFI sponsor-relayer, PAFI
+ * issuer-api) failed. Routes to **503**. `upstreamStatus` carries the
+ * remote HTTP status when known (e.g. 502 from Pimlico for a bundler
+ * outage) — useful for log-grouping but distinct from `httpStatus`
+ * which is the status PAFI returns to its OWN caller.
+ */
+declare class ApiError extends PafiSdkError {
+    readonly httpStatus: "service_unavailable";
+    readonly code: "API_ERROR";
+    readonly type: "service_unavailable_error";
+    readonly upstreamStatus?: number;
+    constructor(message: string, upstreamStatus?: number);
 }
 /**
  * Thrown by `quoteOperatorFee*` when an upstream price source
@@ -413,8 +478,8 @@ interface UserOpReceipt {
 declare const ZERO_VALUE = 0n;
 
 /**
- * v1.5 — Scenario 3: deposit USDC from the user's wallet into the
- * Orderly perp Vault on Base mainnet.
+ * Deposit USDC from the user's wallet into the Orderly perp Vault on
+ * Base mainnet.
  *
  * Builds a `PartialUserOperation` packaging the 2 inner calls:
  *
@@ -598,10 +663,8 @@ interface BuildPerpDepositViaRelayParams {
      * flows (PAFI gas reimbursement). Pass `0n` / `undefined` for the
      * fallback path where the user pays ERC-4337 gas in ETH directly.
      *
-     * v0.7 — input-token fee position rule: user holds USDC BEFORE
-     * deposit (token-availability), so charge there. Replaces the old
-     * `gasFeePt` / `gasFeePtRecipient` / `pointTokenAddress` triple from
-     * v0.6.
+     * Input-token fee position rule: user holds USDC BEFORE deposit
+     * (token-availability), so charge there.
      */
     gasFeeUsdc?: bigint;
     gasFeeUsdcRecipient?: Address;
@@ -660,12 +723,10 @@ declare function rawCallOp(target: Address, data: `0x${string}`, value?: bigint)
  *
  * Function name is `executeBatch` (selector `0x34fcd5be`) to match
  * Pimlico's `Simple7702Account` — the EIP-7702 delegate impl PAFI
- * pins on Base mainnet as of v1.4 (replaced an earlier Coinbase Smart
- * Wallet v2 trial). The shorter `execute(Call[])` (selector
- * `0x3f707e6b`) only exists on legacy/standalone batch executor
- * contracts; calling it on a 7702 delegated EOA falls through to the
- * fallback function and reverts with "account: not from EntryPoint"
- * (AA23).
+ * pins on Base mainnet. The shorter `execute(Call[])` (selector
+ * `0x3f707e6b`) only exists on standalone batch executor contracts;
+ * calling it on a 7702 delegated EOA falls through to the fallback
+ * function and reverts with "account: not from EntryPoint" (AA23).
  */
 declare const BATCH_EXECUTOR_ABI: readonly [{
     readonly name: "executeBatch";
@@ -869,25 +930,23 @@ declare function computeUserOpHash(userOp: Parameters<typeof buildUserOpTypedDat
  * `pm_sponsorUserOperation` simulation accepts.
  *
  * Current primary impl is `simple7702` (Pimlico's `Simple7702Account`).
- * `batchExecutor` is retained for transition / back-compat with EOAs
- * that delegated to the earlier Coinbase Smart Wallet v2 BatchExecutor
- * (trialled before v1.4 — Pimlico became the canonical impl on
- * 2026-04-27 due to a Coinbase SignatureWrapper incompatibility that
- * caused AA23 0x3c10b94e during validateUserOp).
+ * `batchExecutor` is retained for back-compat with EOAs that delegated
+ * to an earlier Coinbase Smart Wallet v2 BatchExecutor — Pimlico is
+ * the canonical impl now (the Coinbase SignatureWrapper format caused
+ * AA23 0x3c10b94e during validateUserOp).
  */
 type DelegateImpl = "simple7702" | "batchExecutor" | "unknown";
 /**
  * Pimlico's `Simple7702Account` implementation address on Base mainnet —
- * the canonical PAFI delegation target as of v1.4 (2026-04-27).
- * Used by `permissionless.to7702SimpleSmartAccount`.
+ * the canonical PAFI delegation target. Used by
+ * `permissionless.to7702SimpleSmartAccount`.
  */
 declare const SIMPLE_7702_IMPL_BASE_MAINNET: Address;
 /**
- * Legacy Coinbase Smart Wallet v2 BatchExecutor — PAFI's pre-v1.4
- * delegation target. Same on Base mainnet + Base Sepolia. Detected
- * here so EOAs that delegated to this address before the v1.4 cutover
- * still pass the impl check; new delegations should target
- * {@link SIMPLE_7702_IMPL_BASE_MAINNET} instead.
+ * Legacy Coinbase Smart Wallet v2 BatchExecutor — an earlier PAFI
+ * delegation target. Same on Base mainnet + Base Sepolia. Detected here
+ * so EOAs that delegated to this address still pass the impl check;
+ * new delegations should target {@link SIMPLE_7702_IMPL_BASE_MAINNET}.
  */
 declare const BATCH_EXECUTOR_7702_IMPL: Address;
 /**
@@ -923,11 +982,11 @@ declare function getDummySignatureFor7702(impl: DelegateImpl): Hex;
 
 /**
  * Module-level paymaster config shared by all batch builders and the
- * `@pafi/issuer` RelayService. Holds the fee recipient address and the
+ * `@pafi-dev/issuer` RelayService. Holds the fee recipient address and the
  * PAFI-assigned issuer identity.
  *
- * v1.4 update: the paymaster endpoint is **PAFI Backend**, which proxies
- * to PAFI sponsor-relayer. See [SPONSORED_PATH_FLOW.md].
+ * The paymaster endpoint is **PAFI Backend**, which proxies to PAFI
+ * sponsor-relayer. See [SPONSORED_PATH_FLOW.md].
  */
 interface PaymasterConfig {
     /**
@@ -957,23 +1016,6 @@ interface PaymasterConfig {
  */
 type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate";
 
-/**
- * @deprecated v0.7.1 — see file comment.
- *
- * Set the application-wide paymaster config. Safe to call multiple
- * times (later calls override earlier). Throws if required fields
- * are missing.
- */
-declare function setPaymasterConfig(config: PaymasterConfig): void;
-/**
- * @deprecated v0.7.1 — see file comment.
- */
-declare function getPaymasterConfig(): PaymasterConfig;
-/** Test helper — clear the singleton. */
-declare function _resetPaymasterConfigForTests(): void;
-/** Check whether paymaster config has been initialized. */
-declare function isPaymasterConfigured(): boolean;
-
 /**
  * Submission path chosen by `checkEthAndBranch`.
  * - `normal`: initiator has enough ETH; submit via `walletClient.writeContract`
@@ -1009,6 +1051,42 @@ interface CheckEthAndBranchParams {
  */
 declare function checkEthAndBranch(params: CheckEthAndBranchParams): Promise<SubmissionPath>;
 
+/**
+ * Encode a V3 swap path as packed bytes, oriented input→output:
+ *   `tokens[0] ‖ fees[0] ‖ tokens[1] ‖ fees[1] ‖ … ‖ tokens[N]`
+ *
+ * Each address is 20 bytes; each fee is uint24 (3 bytes). For an N-hop
+ * swap the result is `(N + 1) * 20 + N * 3` bytes.
+ *
+ * For exact-output quoting the Quoter walks the path output→input —
+ * reverse the underlying `tokens` and `fees` arrays before calling this
+ * encoder (or use `encodeV3PathReversed`).
+ *
+ * @throws if `tokens.length !== fees.length + 1` or any input is malformed.
+ */
+declare function encodeV3Path(path: V3Path): Hex;
+/**
+ * Encode the same path reversed (output→input). Convenience used by
+ * exact-output quoting and exact-output swap-builder paths.
+ */
+declare function encodeV3PathReversed(path: V3Path): Hex;
+/**
+ * Compute a V3 pool address deterministically from factory + initCodeHash.
+ *
+ * Uses the standard Uniswap V3 derivation:
+ *   `keccak256(0xff ‖ factory ‖ keccak256(abi.encode(token0, token1, fee)) ‖ initCodeHash)`
+ *
+ * Tokens are sorted ascending — the helper accepts them in any order.
+ * Returns a checksummed address.
+ */
+declare function computeV3PoolAddress(params: {
+    factory: Address;
+    tokenA: Address;
+    tokenB: Address;
+    fee: number;
+    initCodeHash: Hex;
+}): Address;
+
 /**
  * Parse the implementation address out of an EIP-7702 delegation designator.
  *
@@ -1609,57 +1687,44 @@ declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: `0x${string}`;
 declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: `0x${string}`;
 
 /**
- * Per-chain deployed contract addresses — v1.6 flow.
- *
- * ## Status (2026-05-07)
+ * Per-chain deployed contract addresses.
  *
- * Base mainnet (8453): v1.6 redeploy. PAFIHook removed entirely — fee on
- * mint now happens via `MintFeeWrapper` (single global instance, multi-PT).
- * `pafiHook` field kept as placeholder for back-compat with consumers that
- * still reference it; set to a deterministic dead address to make misuse
- * obvious.
+ * Base mainnet (8453): live deployment. Fee on mint happens via
+ * `MintFeeWrapper` (single global instance, multi-PT).
  *
  * Base Sepolia (84532): entire row is placeholder — not in active use.
  *
  * ## What lives where
  *
- *   pointToken       — DEAD legacy field (per-issuer, not chain-level).
- *                      Each issuer's clone is configured via env or
- *                      resolved from PointTokenFactory at runtime. Set
- *                      to a deterministic dead address so misuse fails
- *                      loudly. Will be removed when downstream consumers
- *                      stop referencing it.
  *   batchExecutor    — EIP-7702 delegation target (Pimlico Simple7702Account)
- *   usdt             — MockERC20 used by Uniswap pools
+ *   usdt             — Stablecoin used by Uniswap pools
  *   issuerRegistry   — registry of all issuers on this chain
- *   mintingOracle    — per-token mint cap enforcer (v1.6: per-token, not per-issuer)
- *   mintFeeWrapper   — v1.6 mint-time fee splitter (single global instance)
- *   pafiHook         — DEAD; v1.5 V4 swap fee removed in v1.6. Kept for ABI compat.
+ *   mintingOracle    — per-token mint cap enforcer
+ *   mintFeeWrapper   — mint-time fee splitter (single global instance)
+ *   chainlinkEthUsd  — ETH/USD price feed used by FeeManager
+ *   orderlyRelay     — Orderly perp-deposit Relay
+ *   pafiFeeRecipient — PAFI-controlled fee recipient (sponsored gas reimbursement)
+ *   universalRouter  — Uniswap V4 swap entry point
+ *
+ * PointToken addresses are per-issuer and resolved from the issuer's
+ * config (env / DB / PointTokenFactory readout). PointTokenFactory and
+ * the PointToken implementation live in separate exports below.
  *
- * PointTokenFactory + PointToken implementation addresses live in
- * separate exports below — they're only needed at provisioning /
- * observability time, not in the hot mint/burn path, so excluded from
- * the per-chain bundle.
+ * Fee logic lives in `MintFeeWrapper` on the mint path; swaps are
+ * hook-free (`hooks = address(0)`).
  */
 interface ContractAddresses {
-    pointToken: Address;
     batchExecutor: Address;
     usdt: Address;
     issuerRegistry: Address;
     mintingOracle: Address;
     /**
-     * v1.6 — single-instance MintFeeWrapper that skims a fee on every
-     * sig-gated mint and distributes across the registered recipient
-     * list for the target PointToken. Issuers route mints through this
-     * by passing `mintFeeWrapperAddress` to `prepareMint`.
+     * Single-instance MintFeeWrapper that skims a fee on every sig-gated
+     * mint and distributes across the registered recipient list for the
+     * target PointToken. Issuers route mints through this by passing
+     * `mintFeeWrapperAddress` to `prepareMint`.
      */
     mintFeeWrapper: Address;
-    /**
-     * @deprecated v1.5 PAFIHook (10% PT→USDT swap fee) was removed in
-     * v1.6. Field kept as a dead placeholder so older consumers don't
-     * crash on missing-property errors; do not use for new code.
-     */
-    pafiHook: Address;
     /** Chainlink ETH/USD price feed — used by FeeManager to convert gas cost to USDT. */
     chainlinkEthUsd: Address;
     /**
@@ -1743,17 +1808,20 @@ declare function getPafiServiceUrls(chainId: number): PafiServiceUrls;
  * `./eip712/` and are re-exported from the package root — not duplicated
  * here.
  *
- * ## v1.4 flow — no Relayer, sig-gated mint/burn
+ * ## Sig-gated mint / burn (no Relayer contract)
  *
- * Relayer contract dropped. Users call `PointToken.mint(to, amount,
- * deadline, minterSig)` directly via an EIP-7702 delegated UserOp —
- * `msg.sender == user == to`. `minterSig` is an EIP-712 `MintRequest`
- * signed off-chain by the issuer's minter signer (HSM/KMS). Mirror
- * structure on the burn side with `BurnRequest` + `burn(from, amount,
- * deadline, burnerSig)`.
+ * Users call `PointToken.mint(to, amount, deadline, minterSig)`
+ * directly via an EIP-7702 delegated UserOp — `msg.sender == user
+ * == to`. `minterSig` is an EIP-712 `MintRequest` signed off-chain
+ * by the issuer's minter signer (HSM/KMS). Mirror structure on the
+ * burn side with `BurnRequest` + `burn(from, amount, deadline,
+ * burnerSig)`.
  *
  * Exports:
- *   - `POINT_TOKEN_V2_ABI`      — full mint + burn + admin surface
+ *   - `POINT_TOKEN_ABI`         — full mint + burn + admin surface
+ *                                 (canonical name; not version-suffixed
+ *                                 so future Uniswap fork bumps don't
+ *                                 collide with PointToken internals)
  *   - `BATCH_EXECUTOR_*`        — EIP-7702 delegation target (ABI real,
  *                                 address still placeholder on all
  *                                 chains until SC delivers)
@@ -1768,8 +1836,8 @@ declare function getPafiServiceUrls(chainId: number): PafiServiceUrls;
 
 /**
  * Signature struct — kept for consumers that want the tuple form.
- * Most v1.4 paths pass `bytes` (serialized signature) directly to the
- * contract; this struct is only needed if you're manually splitting
+ * The canonical paths pass `bytes` (serialized signature) directly to
+ * the contract; this struct is only needed if you're manually splitting
  * for other on-chain verifiers.
  */
 interface SignatureStruct {
@@ -1961,23 +2029,25 @@ declare function getPafiWebModalAdapter(): PafiWebModalAdapter | null;
 declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Promise<PafiWebModalHandle>;
 
 /**
- * PAFI-hosted subgraph endpoint — single source of truth across all SDK packages.
+ * PAFI-hosted subgraph endpoint — single source of truth across all
+ * SDK packages.
  *
- * v3 (deployed 2026-05-08) indexes the v1.6 contract redeploy starting at
- * block 45683465 — IssuerRegistry/PointTokenFactory/MintingOracle/MintFeeWrapper
- * (single global wrapper instance, replaces v1.5 PAFIHook). Schema additions:
- * `MintFeeWrapper`, `MintFeeConfig`, `FeeRecipient`, `MintWithFeeEvent`,
- * `FeeDistribution`. v2 endpoint is kept live as rollback for ~1 week before
- * removal.
+ * Indexes IssuerRegistry, PointTokenFactory, MintingOracle, and
+ * MintFeeWrapper. Schema entities: `MintFeeWrapper`, `MintFeeConfig`,
+ * `FeeRecipient`, `MintWithFeeEvent`, `FeeDistribution`.
  */
-declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v3";
+declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v4";
 /**
- * Fetch the Uniswap V4 pool(s) for a PAFI PointToken from the subgraph.
+ * Fetch the Uniswap V3 pool(s) for a PAFI PointToken from the subgraph.
  *
  * Browser and Node compatible — uses globalThis.fetch. Returns an empty
  * array (never throws) when the token has no pool yet or the subgraph is
  * unreachable, so callers can show "quote unavailable" without crashing.
  *
+ * Tolerates subgraph responses still carrying the V4-era `tickSpacing`
+ * and `hooks` fields — those are silently ignored. Subgraph migration
+ * can land independently of the SDK migration.
+ *
  * @param chainId            - Chain ID (reserved for multi-subgraph routing; currently unused)
  * @param pointTokenAddress  - The PointToken contract address
  * @param subgraphUrl        - Override the default PAFI subgraph URL
@@ -2037,11 +2107,11 @@ declare class PafiSDK {
         message: MintRequest;
     }>;
     signMintRequest(message: MintRequest): Promise<EIP712Signature>;
-    verifyMintRequest(message: MintRequest, signature: Hex, expectedMinter: Address): Promise<SignatureVerification>;
+    verifyMintRequest(message: MintRequest, signature: Hex, expectedMinter: Address, options?: SignatureVerifyOptions): Promise<SignatureVerification>;
     getMintRequestNonce(receiver: Address): Promise<bigint>;
     createLoginMessage(params: Omit<LoginMessageParams, "address" | "chainId">): Promise<string>;
     /** Sign a login message string with the current signer (personal_sign) */
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateDirectParams, type DelegateDirectResult, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, type Eip7702AuthorizationJsonRpc, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, type Operation, OracleStaleError, type OrderlyRelayDepositRequest, PAFI_SERVICE_URLS, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiErrorType, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, PafiSdkError, type PafiServiceUrls, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SDK_ERROR_HTTP_STATUS_CODE, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V4_QUOTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, splitAuthorizationSig, webPopupAdapter };
+export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateDirectParams, type DelegateDirectResult, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, type Eip7702AuthorizationJsonRpc, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, type Operation, OracleStaleError, type OrderlyRelayDepositRequest, PAFI_SERVICE_URLS, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiErrorType, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSdkError, type PafiServiceUrls, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QUOTER_V2_ADDRESSES, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SDK_ERROR_HTTP_STATUS_CODE, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, SignatureVerifyOptions, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeBatchExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeBatchExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, isDelegatedTo, isDelegatedToTarget, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };