@pafi-dev/core 0.5.3 → 0.5.4

package/dist/index.d.cts

@@ -1,1607 +0,0 @@
-import { Address, Hex, PublicClient, HttpTransport, WalletClient } from 'viem';
-import { P as PoolKey, C as ChainConfig, a as PafiSDKConfig, b as PointTokenDomainConfig, M as MintRequest, R as ReceiverConsent, E as EIP712Signature, S as SignatureVerification, B as BestQuote, Q as QuoteResult } from './types-b5_Tokjl.cjs';
-export { c as BurnRequest, I as Issuer, d as PathKey } from './types-b5_Tokjl.cjs';
-export { erc20Abi, issuerRegistryAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v4QuoterAbi } from './abi/index.cjs';
-export { buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signBurnRequest, signMintRequest, signReceiverConsent, verifyBurnRequest, verifyMintRequest, verifyReceiverConsent } from './eip712/index.cjs';
-export { getIssuer, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getReceiverConsentNonce, getTokenName, isActiveIssuer, isMinter, verifyMintCap } from './contract/index.cjs';
-export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle } from './quoting/index.cjs';
-import { P as PartialUserOperation, O as Operation, U as UserOperation, S as SwapSimulationResult } from './index-BEx-Q1bW.cjs';
-export { B as BuildSwapWithGasDeductionParams, a as PaymasterFields, b as SETTLE_ALL, c as SWAP_EXACT_IN, T as TAKE_ALL, d as UserOpReceipt, V as V4_SWAP, Z as ZERO_VALUE, e as buildErc20ApprovalCalldata, f as buildPermit2ApprovalCalldata, g as buildSwapFromQuote, h as buildSwapWithGasDeduction, i as buildUniversalRouterExecuteArgs, j as buildV4SwapInput, k as checkAllowance, s as simulateSwap } from './index-BEx-Q1bW.cjs';
-import { LoginMessageParams } from './auth/index.cjs';
-export { SPONSOR_AUTH_DOMAIN_NAME, SPONSOR_AUTH_TYPES, SponsorAuthPayload, SponsorAuthVerifyResult, VerifyLoginResult, buildSponsorAuthDomain, buildSponsorAuthTypedData, computeCallDataHash, createLoginMessage, parseLoginMessage, signSponsorAuth, verifyLoginMessage, verifySponsorAuth } from './auth/index.cjs';
-
-declare const mintRequestTypes: {
-    readonly MintRequest: readonly [{
-        readonly name: "to";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
-        readonly name: "deadline";
-        readonly type: "uint256";
-    }];
-};
-declare const burnRequestTypes: {
-    readonly BurnRequest: readonly [{
-        readonly name: "from";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
-        readonly name: "deadline";
-        readonly type: "uint256";
-    }];
-};
-declare const receiverConsentTypes: {
-    readonly ReceiverConsent: readonly [{
-        readonly name: "onBehalfOf";
-        readonly type: "address";
-    }, {
-        readonly name: "originalReceiver";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
-        readonly name: "deadline";
-        readonly type: "uint256";
-    }, {
-        readonly name: "extData";
-        readonly type: "bytes";
-    }];
-};
-declare const SUPPORTED_CHAINS: Record<number, ChainConfig>;
-declare const V4_QUOTER_ADDRESSES: Record<number, Address>;
-declare const UNIVERSAL_ROUTER_ADDRESSES: Record<number, Address>;
-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[]>>;
-/** ERC-4337 v0.7 EntryPoint — deployed deterministically across all EVM chains. */
-declare const ENTRY_POINT_V07: Address;
-/** Permit2 — Uniswap's universal approval contract, same address on all EVM chains. */
-declare const PERMIT2_ADDRESS: Address;
-
-declare class PafiSDKError extends Error {
-    constructor(message: string);
-}
-declare class ConfigurationError extends PafiSDKError {
-    constructor(message: string);
-}
-declare class SigningError extends PafiSDKError {
-    constructor(message: string);
-}
-declare class SimulationError extends PafiSDKError {
-    operation: string;
-    reason: string;
-    constructor(operation: string, reason: string);
-}
-declare class ApiError extends PafiSDKError {
-    status?: number | undefined;
-    constructor(message: string, status?: number | undefined);
-}
-
-/**
- * Orderly Network Vault — entrypoint for **perp deposit** flow on
- * Base mainnet (Scenario 3).
- *
- * Source of truth for addresses + integration:
- *   https://orderly.network/docs/build-on-omnichain/addresses#base
- *
- * ## Architecture
- *
- *   User wallet (Base)
- *      │ 1. USDC.approve(vault, amount)
- *      │ 2. vault.deposit{value: layerZeroFee}({
- *      │      accountId, brokerHash, tokenHash, tokenAmount
- *      │    })
- *      ▼
- *   OrderlyVault (Base)
- *      │ — locks USDC, emits LayerZero message
- *      ▼
- *   Orderly chain (off-chain matching engine)
- *      │ — credits the user's perp account
- *      ▼
- *   User can now place perp orders via Orderly REST/WS API
- *
- * **Important:** `value` is required and is the LayerZero cross-chain
- * fee (paid in native ETH on Base). Quote it via
- * `vault.getDepositFee(user, data)` BEFORE calling deposit. Fees vary
- * with destination chain congestion.
- *
- * ## Sponsored vs direct
- *
- * ERC-4337 paymasters sponsor GAS, not `msg.value`. Even on the
- * sponsored path the user MUST hold enough native ETH on Base to cover
- * `getDepositFee()` (typically ~0.0002 ETH at quiet times).
- */
-/** Orderly Vault on Base mainnet (EIP-55 checksum). */
-declare const ORDERLY_VAULT_BASE_MAINNET: Address;
-/**
- * Per-chain registry of the Orderly Vault. Add chains here as Orderly
- * deploys them.
- */
-declare const ORDERLY_VAULT_ADDRESSES: Record<number, Address>;
-/**
- * Pre-computed broker hashes — `keccak256(abi.encodePacked(brokerId))`.
- * Add new brokers as they launch.
- *
- * Reference: https://orderly.network/docs/build-on-omnichain/user-flows/accountId
- */
-declare const BROKER_HASHES: {
-    /** Default partner broker on Base — most commonly whitelisted. */
-    readonly woofi_pro: `0x${string}`;
-    /** Orderly's own white-label broker. */
-    readonly orderly: `0x${string}`;
-    /** LogX. */
-    readonly logx: `0x${string}`;
-};
-/**
- * Pre-computed token hashes — `keccak256(abi.encodePacked(tokenSymbol))`.
- * The hash maps to the actual ERC-20 address on each chain via
- * `vault.getAllowedToken(tokenHash)`.
- *
- * Note: Orderly canonicalises by symbol (USDC, not "USD Coin").
- */
-declare const TOKEN_HASHES: {
-    readonly USDC: `0x${string}`;
-};
-/**
- * Compute Orderly's `accountId` — uniquely identifies a user+broker
- * tuple. Matches the off-chain formula used by the Orderly SDK so
- * deposits + future REST API calls reference the same account.
- *
- *   accountId = keccak256(abi.encode(user, brokerHash))
- *
- * Note `abi.encode` (not `encodePacked`) — uses 32-byte left-padding.
- */
-declare function computeAccountId(user: Address, brokerHash: Hex): Hex;
-/**
- * Minimal Orderly Vault ABI — just the functions PAFI needs for
- * Scenario 3 (perp deposit). Full ABI is on Orderly's docs site.
- */
-declare const ORDERLY_VAULT_ABI: readonly [{
-    readonly type: "function";
-    readonly name: "deposit";
-    readonly stateMutability: "payable";
-    readonly inputs: readonly [{
-        readonly name: "data";
-        readonly type: "tuple";
-        readonly components: readonly [{
-            readonly name: "accountId";
-            readonly type: "bytes32";
-        }, {
-            readonly name: "brokerHash";
-            readonly type: "bytes32";
-        }, {
-            readonly name: "tokenHash";
-            readonly type: "bytes32";
-        }, {
-            readonly name: "tokenAmount";
-            readonly type: "uint128";
-        }];
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly type: "function";
-    readonly name: "getDepositFee";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly name: "user";
-        readonly type: "address";
-    }, {
-        readonly name: "data";
-        readonly type: "tuple";
-        readonly components: readonly [{
-            readonly name: "accountId";
-            readonly type: "bytes32";
-        }, {
-            readonly name: "brokerHash";
-            readonly type: "bytes32";
-        }, {
-            readonly name: "tokenHash";
-            readonly type: "bytes32";
-        }, {
-            readonly name: "tokenAmount";
-            readonly type: "uint128";
-        }];
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "getAllowedBroker";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly name: "brokerHash";
-        readonly type: "bytes32";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "bool";
-    }];
-}, {
-    readonly type: "function";
-    readonly name: "getAllowedToken";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly name: "tokenHash";
-        readonly type: "bytes32";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "address";
-    }];
-}];
-/** Struct mirror of `IOrderlyVault.VaultDepositFE` for type-safe builders. */
-interface VaultDepositFE {
-    accountId: Hex;
-    brokerHash: Hex;
-    tokenHash: Hex;
-    /** uint128 — USDC has 6 decimals. */
-    tokenAmount: bigint;
-}
-
-/**
- * v1.5 — Scenario 3: deposit USDC from the user's wallet into the
- * Orderly perp Vault on Base mainnet.
- *
- * Builds a `PartialUserOperation` packaging the 2 inner calls:
- *
- *   1. `USDC.approve(orderlyVault, amount)` — let the Vault pull USDC
- *   2. `OrderlyVault.deposit{value: layerZeroFee}(VaultDepositFE)` —
- *      transfer USDC into the Vault + emit a LayerZero message that
- *      credits the user's perp account on the Orderly chain
- *
- * ## ⚠️ Native ETH constraint
- *
- * Coinbase Paymaster sponsors GAS, **not `msg.value`**. The LayerZero
- * cross-chain fee MUST come from the user's own native ETH balance on
- * Base — even when the rest of the UserOp is sponsored.
- *
- * Quote the fee BEFORE calling this builder via:
- *
- *   const fee = await client.readContract({
- *     address: orderlyVault,
- *     abi: ORDERLY_VAULT_ABI,
- *     functionName: 'getDepositFee',
- *     args: [user, depositData],
- *   });
- *
- * If `user.eth < fee`, surface this error to the FE so the user can
- * top up before retrying — the Vault `deposit{value: 0}` call will
- * revert otherwise.
- *
- * ## Why no PT/USDC fee deduction?
- *
- * Unlike Scenario 1/2/4 which deduct an operator fee in PT/USDC inside
- * the batch, perp deposit doesn't append a fee transfer because:
- *
- *   - User is paying Orderly's LayerZero fee directly via `msg.value`
- *   - There's no PAFI-specific operator cost on top — Orderly handles
- *     the off-chain accounting once the LayerZero message lands
- *
- * If we want to charge a PAFI service fee on top later, append a
- * `USDC.transfer(feeRecipient, fee)` op — same pattern as the swap
- * builder.
- */
-interface BuildPerpDepositWithGasDeductionParams {
-    /** User EOA (will be `msg.sender` via EIP-7702 delegation). */
-    userAddress: Address;
-    /** ERC-4337 account nonce — fetched from EntryPoint by the caller. */
-    aaNonce: bigint;
-    /** Chain ID for Orderly Vault address resolution. */
-    chainId: number;
-    /**
-     * Override Orderly Vault address (e.g. for fork tests). Defaults to
-     * `ORDERLY_VAULT_ADDRESSES[chainId]`.
-     */
-    vaultAddress?: Address;
-    /**
-     * USDC ERC-20 address — the actual token Orderly accepts. Caller
-     * resolves this via `vault.getAllowedToken(TOKEN_HASHES.USDC)` so we
-     * don't hardcode the wrong USDC variant (native vs bridged).
-     */
-    usdcAddress: Address;
-    /** USDC amount to deposit (uint128, 6 decimals). */
-    amount: bigint;
-    /**
-     * Pre-built `VaultDepositFE` struct — caller computes accountId via
-     * `computeAccountId(user, brokerHash)` and supplies tokenHash.
-     */
-    depositData: VaultDepositFE;
-    /**
-     * LayerZero fee in wei — from `vault.getDepositFee(user, data)`.
-     * Becomes the `msg.value` on the `deposit()` call. User MUST hold
-     * ≥ this much native ETH or the call reverts.
-     */
-    layerZeroFee: bigint;
-    gasLimits?: {
-        callGasLimit?: bigint;
-        verificationGasLimit?: bigint;
-        preVerificationGas?: bigint;
-    };
-}
-/**
- * Build an unsigned UserOp for Scenario 3. Returns a
- * `PartialUserOperation` — caller attaches paymaster sponsorship for
- * gas + the user's UserOp-hash signature, then submits to the Bundler.
- */
-declare function buildPerpDepositWithGasDeduction(params: BuildPerpDepositWithGasDeductionParams): PartialUserOperation;
-
-/**
- * Build an ERC-20 `transfer(to, amount)` operation. Used inside a batch
- * to move fee tokens from the user to the fee recipient atomically with
- * the main action.
- */
-declare function erc20TransferOp(token: Address, to: Address, amount: bigint): Operation;
-/**
- * Build an ERC-20 `approve(spender, amount)` operation. Used inside a
- * batch before a swap / deposit call so the AMM / protocol can pull
- * tokens from the user.
- */
-declare function erc20ApproveOp(token: Address, spender: Address, amount: bigint): Operation;
-/**
- * Build an ERC-20 `burn(amount)` operation (OpenZeppelin ERC20Burnable
- * extension). Burns from `msg.sender`, which — via EIP-7702 — is the
- * user's EOA.
- *
- * Requires the PointToken contract to expose a public `burn(uint256)`
- * without a role check. See
- * [SDK_V1.4_TASKS.md §11 — PointToken.burn callable via batch].
- */
-declare function erc20BurnOp(token: Address, amount: bigint): Operation;
-/**
- * Build a raw call operation with caller-supplied calldata. Useful for
- * non-ERC-20 contracts (PoolManager.swap, PerpDEX.deposit, Relayer.mint)
- * where the encoding is specific to that protocol.
- */
-declare function rawCallOp(target: Address, data: `0x${string}`, value?: bigint): Operation;
-
-/**
- * Standard BatchExecutor ABI — a contract that takes an array of calls
- * and invokes each one in sequence, reverting all if any fail.
- *
- * Compatible with OpenZeppelin `Account.execute(Call[])`, Biconomy
- * `executeBatch`, Safe `MultiSend`, and most EIP-7702 delegation
- * targets. The exact deployed address is supplied by the infra team
- * (see [V1.4_V1.5_READINESS.md B2]).
- */
-declare const BATCH_EXECUTOR_ABI: readonly [{
-    readonly name: "execute";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "tuple[]";
-        readonly components: readonly [{
-            readonly type: "address";
-            readonly name: "target";
-        }, {
-            readonly type: "uint256";
-            readonly name: "value";
-        }, {
-            readonly type: "bytes";
-            readonly name: "data";
-        }];
-        readonly name: "calls";
-    }];
-    readonly outputs: readonly [];
-}];
-/**
- * Encode a batch of operations into calldata for `BatchExecutor.execute()`.
- * The resulting calldata goes into `UserOperation.callData`.
- *
- * When the EOA has an EIP-7702 delegation to a BatchExecutor, calling
- * this calldata against the EOA runs all operations with
- * `msg.sender = EOA` for each inner call.
- *
- * @param operations batch of calls, in execution order
- * @returns calldata bytes for `execute((address,uint256,bytes)[])`
- */
-declare function encodeBatchExecute(operations: Operation[]): Hex;
-
-interface BuildPartialUserOpParams {
-    /** User's EOA (with EIP-7702 delegation). */
-    sender: Address;
-    /** Batch of operations — encoded into callData via `encodeBatchExecute`. */
-    operations: Operation[];
-    /** EntryPoint nonce for this sender. Caller fetches from the EntryPoint contract. */
-    nonce: bigint;
-    /** Optional gas overrides; bundler re-estimates before submission. */
-    gasLimits?: {
-        callGasLimit?: bigint;
-        verificationGasLimit?: bigint;
-        preVerificationGas?: bigint;
-    };
-    /** Optional fee overrides; bundler usually fills these. */
-    feeOverrides?: {
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
-}
-/**
- * Build a partial ERC-4337 UserOperation from a batch of operations.
- * Paymaster fields and signature are populated later:
- *   1. Call `PafiBackendClient.requestSponsorship()` → get paymaster fields
- *   2. Compute userOpHash and have the user sign it (via Privy)
- *   3. Attach `signature` → submit to bundler
- *
- * This function is a pure struct builder — no network calls.
- */
-declare function buildPartialUserOperation(params: BuildPartialUserOpParams): PartialUserOperation;
-/**
- * Assemble a full UserOperation once paymaster fields + signature are
- * known. Used after `PafiBackendClient.requestSponsorship()` and user
- * signing complete.
- */
-declare function assembleUserOperation(partial: PartialUserOperation, paymaster: {
-    paymaster: Address;
-    paymasterData: `0x${string}`;
-    paymasterVerificationGasLimit: bigint;
-    paymasterPostOpGasLimit: bigint;
-}, signature: `0x${string}`): UserOperation;
-
-/**
- * ERC-4337 v0.7 UserOp hash, matching EntryPoint._hashUserOp().
- *
- * The returned hash is what the user signs via personal_sign / eth_sign.
- * Paymaster fields are included when present — they must match exactly
- * what was sent to the bundler, or signature recovery fails on-chain.
- *
- * Use this on the **backend** (mobile prepare/submit pattern) to compute
- * the hash before returning it to the mobile client for signing.
- */
-declare function computeUserOpHash(userOp: {
-    sender: Address;
-    nonce: bigint;
-    callData: Hex;
-    callGasLimit: bigint;
-    verificationGasLimit: bigint;
-    preVerificationGas: bigint;
-    maxFeePerGas: bigint;
-    maxPriorityFeePerGas: bigint;
-    paymaster?: Address;
-    paymasterVerificationGasLimit?: bigint;
-    paymasterPostOpGasLimit?: bigint;
-    paymasterData?: Hex;
-}, chainId: number): Hex;
-
-/**
- * Module-level paymaster config shared by all batch builders and the
- * `@pafi/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 Coinbase Paymaster. See [SPONSORED_PATH_FLOW.md].
- */
-interface PaymasterConfig {
-    /**
-     * PAFI Backend API base URL. Example:
-     *   https://api.pacificfinance.org/paymaster
-     */
-    pafiBackendUrl: string;
-    /** PAFI-assigned issuer ID. Passed in X-Issuer-Id header. */
-    issuerId: string;
-    /** Per-issuer API key (or JWT) for Authorization header. */
-    apiKey: string;
-    /**
-     * Where the fee transfer lands inside the batch call. Fee recovery is
-     * application-level — Paymaster sponsors gas, fee is a separate
-     * ERC-20 transfer inside the batch that reimburses the issuer.
-     */
-    feeRecipient: Address;
-    /** EIP-4337 EntryPoint address. Default: v0.7 (same across chains). */
-    entryPoint?: Address;
-    /** Chain ID the paymaster sponsors on. Defaults to consumer config. */
-    chainId?: number;
-}
-/**
- * Which PAFI-defined scenario this UserOp represents. PAFI Backend
- * validates the request's target contracts + function selectors
- * match the expected pattern for the scenario.
- */
-type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit";
-
-/**
- * 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;
-/**
- * Get the current paymaster config. Throws if `setPaymasterConfig()`
- * has not been called yet — this surfaces boot-order bugs early
- * instead of failing with "paymaster.feeRecipient is undefined" at
- * the point of use.
- */
-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`
- *   or a plain `eth_sendRawTransaction`. No paymaster round-trip.
- * - `paymaster`: initiator doesn't have enough ETH; wrap the batch as a
- *   UserOperation and route through PAFI Backend → Coinbase Paymaster
- *   → Bundler.
- */
-type SubmissionPath = "normal" | "paymaster";
-interface CheckEthAndBranchParams {
-    /** viem PublicClient bound to the target chain. */
-    client: PublicClient;
-    /** The address whose ETH balance we check. */
-    initiator: Address;
-    /** Estimated gas cost in wei for the upcoming tx. */
-    estimatedGasWei: bigint;
-    /**
-     * Optional safety margin multiplier (basis points). Defaults to
-     * 11_000 (110%) — the initiator needs 10% above the estimate to
-     * qualify for the normal path. Prevents edge cases where gas price
-     * spikes between estimation and submission cause a "has enough"
-     * decision to fail at broadcast time.
-     */
-    marginBps?: number;
-}
-/**
- * Step 3 of the Generalized Flow ([SPONSORED_PATH_FLOW.md §2]):
- * choose between the normal path (initiator pays ETH directly) and the
- * paymaster path (bundler + Coinbase Paymaster).
- *
- * Intentionally synchronous in spirit — the only network call is
- * `getBalance`. Callers can parallelize it with other reads.
- */
-declare function checkEthAndBranch(params: CheckEthAndBranchParams): Promise<SubmissionPath>;
-
-/**
- * Parse the implementation address out of an EIP-7702 delegation designator.
- *
- * Returns `null` when:
- *   - `code` is undefined / empty / `"0x"` (plain EOA, no code)
- *   - `code` does not contain the EIP-7702 magic prefix (regular contract)
- *
- * @param code - bytecode returned by `eth_getCode` / `client.getCode()`
- * @returns the 20-byte implementation address (checksummed), or `null`
- *
- * @example
- * const code = await client.getCode({ address });
- * const impl = parseEip7702DelegatedAddress(code);
- * // null  → not delegated
- * // '0x7702cb554e6bFb442cb743A7dF23154544a7176C' → delegated to BatchExecutor
- */
-declare function parseEip7702DelegatedAddress(code: Hex | string | null | undefined): Address | null;
-/**
- * Read the EIP-7702 delegation status of an EOA from the chain.
- *
- * @param client  - viem PublicClient (any provider — only `eth_getCode` is called)
- * @param address - EOA address to inspect
- * @returns the implementation address the EOA is delegated to, or `null`
- *
- * @example
- * const impl = await checkDelegation(publicClient, userAddress);
- * if (impl === null) {
- *   // show "Setup Wallet" button
- * } else {
- *   // EOA already delegated; safe to send UserOps
- * }
- */
-declare function checkDelegation(client: PublicClient, address: Address): Promise<Address | null>;
-/**
- * Return `true` when the EOA at `address` is currently delegated to `target`.
- *
- * Useful for asserting that the delegation points specifically at the expected
- * BatchExecutor rather than some other implementation (e.g. old deployment).
- *
- * @example
- * import { BATCH_EXECUTOR_ADDRESS_BASE_MAINNET } from '@pafi-dev/core';
- * const ok = await isDelegatedTo(client, userAddress, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET);
- */
-declare function isDelegatedTo(client: PublicClient, address: Address, target: Address): Promise<boolean>;
-
-/**
- * Parameters for building a delegation-only UserOperation.
- *
- * This UserOp carries no calldata — its sole purpose is to anchor the
- * EIP-7702 authorization (signed externally via `signAuthorization`) into
- * a sponsored transaction so the user doesn't need native ETH to delegate.
- */
-interface BuildDelegationUserOpParams {
-    /** User EOA to delegate. */
-    userAddress: Address;
-    /** ERC-4337 account nonce — fetched from EntryPoint. Pass 0n on first ever op. */
-    aaNonce: bigint;
-    gasLimits?: {
-        callGasLimit?: bigint;
-        verificationGasLimit?: bigint;
-        preVerificationGas?: bigint;
-    };
-}
-/**
- * Build the minimal `PartialUserOperation` used to sponsor the one-time
- * EIP-7702 delegation.
- *
- * The caller must:
- *   1. Sign the EIP-7702 authorization via `signAuthorization()` (Privy hook).
- *   2. Pass the authorization as `authorization` alongside `calls` (or alone)
- *      to `smartClient.sendTransaction()`.
- *
- * The permissionless SDK + Pimlico bundler handle the rest: they detect the
- * `authorization` field and submit an EIP-7702 type-4 transaction that sets
- * the EOA's bytecode to `0xef0100<batchExecutorAddress>`.
- *
- * This builder is a convenience wrapper — in practice you can also pass
- * `{ to: userAddress, value: 0n, data: '0x', authorization }` directly to
- * `smartClient.sendTransaction()` without calling this function at all.
- * Use it when you need a `PartialUserOperation` struct for inspection or
- * custom paymaster flows.
- *
- * @example
- * // Typical flow — no need to call this builder directly:
- * const nonce = await publicClient.getTransactionCount({ address, blockTag: 'pending' });
- * const authorization = await signAuthorization({ contractAddress: BATCH_EXECUTOR, chainId: 8453, nonce });
- * const txHash = await smartClient.sendTransaction({
- *   to: address,
- *   value: 0n,
- *   data: '0x',
- *   authorization,
- *   paymasterContext: { sponsorshipPolicyId },
- * });
- */
-declare function buildDelegationUserOp(params: BuildDelegationUserOpParams): PartialUserOperation;
-/**
- * Fetch the AA nonce for a user EOA from the EntryPoint v0.7.
- *
- * Convenience helper so callers don't need to import the EntryPoint ABI
- * themselves when building the delegation UserOp.
- *
- * @param client     - viem PublicClient
- * @param userAddress - EOA to query
- * @returns bigint nonce (0n on first-ever UserOp)
- */
-declare function getAaNonce(client: PublicClient, userAddress: Address): Promise<bigint>;
-
-/**
- * EIP-7702 authorization tuple hash.
- *
- *   keccak256(0x05 || rlp([chain_id, address, nonce]))
- *
- * The user signs this hash with a **raw secp256k1 sign** (no EIP-191 prefix).
- * On mobile, pass the result to the wallet's raw signing primitive.
- *
- * The resulting 65-byte signature is sent to `POST /delegate/submit` as `authSig`.
- *
- * Reference: EIP-7702 §3 — Authorization tuple
- */
-declare function computeAuthorizationHash(chainId: number, address: Address, nonce: bigint): Hex;
-/**
- * Check whether an EOA code string carries an EIP-7702 delegation to `target`.
- *
- * Sync alternative to `isDelegatedTo()` for callers that already have the
- * code from a prior `eth_getCode` call and don't want another RPC round-trip.
- *
- * Delegation designator format: 0xef0100 (3 bytes) || address (20 bytes)
- */
-declare function isDelegatedToTarget(code: string | null | undefined, target: Address): boolean;
-
-/**
- * Parameters for `createPafiProxyTransport`.
- */
-interface PafiProxyTransportParams {
-    /**
-     * Full URL of the PAFI sponsor-relayer Pimlico proxy endpoint.
-     * @example "https://sponsor-relayer.pacificfinance.org/pimlico"
-     * @example "http://localhost:4000/pimlico"
-     */
-    proxyUrl: string;
-    /**
-     * Called on every request to get the current Privy identity token.
-     * Use a getter (or a ref's `.current`) so the transport always sends
-     * the latest token without needing to be rebuilt when it rotates.
-     *
-     * @example () => identityTokenRef.current
-     * @example () => privyHook.identityToken
-     */
-    getIdentityToken: () => string | null | undefined;
-    /**
-     * Issuer ID sent as `X-Issuer-Id` header.
-     * sponsor-relayer uses this to look up per-issuer rate limits and policy.
-     * Obtain from PAFI team during onboarding.
-     */
-    issuerId: string;
-}
-/**
- * Create a viem `HttpTransport` that proxies all Pimlico JSON-RPC calls
- * through the PAFI sponsor-relayer (`POST /pimlico`).
- *
- * The transport:
- *   - Sets `Authorization: Bearer <identityToken>` on every request
- *   - Sets `X-Issuer-Id: <issuerId>` on every request
- *   - Reads the identity token lazily via `getIdentityToken()` so it is
- *     always fresh without rebuilding the SmartAccountClient on each rotation
- *
- * Pass the returned transport to both `createPimlicoClient` and
- * `createSmartAccountClient` so ALL Pimlico RPC calls (paymaster + bundler)
- * go through the proxy with auth headers attached.
- *
- * @example
- * ```ts
- * import { createPafiProxyTransport, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET } from '@pafi-dev/core';
- * import { createSmartAccountClient } from 'permissionless';
- * import { createPimlicoClient } from 'permissionless/clients/pimlico';
- * import { useIdentityToken } from '@privy-io/react-auth';
- *
- * const { identityToken } = useIdentityToken();
- * const identityTokenRef = useRef<string | null>(null);
- * useEffect(() => { identityTokenRef.current = identityToken; }, [identityToken]);
- *
- * const proxyTransport = createPafiProxyTransport({
- *   proxyUrl: process.env.NEXT_PUBLIC_PIMLICO_PROXY_URL!,
- *   getIdentityToken: () => identityTokenRef.current,
- *   issuerId: process.env.NEXT_PUBLIC_ISSUER_ID!,
- * });
- *
- * const pimlicoClient = createPimlicoClient({ chain: base, transport: proxyTransport });
- * const smartClient  = createSmartAccountClient({
- *   client: publicClient,
- *   chain: base,
- *   account,
- *   paymaster: pimlicoClient,
- *   bundlerTransport: proxyTransport,
- * });
- * ```
- */
-declare function createPafiProxyTransport(params: PafiProxyTransportParams): HttpTransport;
-
-/**
- * Minimal interface for any smart-account client capable of submitting
- * transactions. Deliberately duck-typed so the SDK does not need a hard
- * dependency on permissionless — any client with this shape works.
- */
-interface SmartAccountSender {
-    sendTransaction(params: Record<string, unknown>): Promise<Hex>;
-}
-/**
- * Returns true when `err` originates from the **paymaster layer** rather
- * than the contract or bundler layer. Covers:
- *
- * - ERC-4337 AA3x validation errors (AA31–AA34)
- * - Pimlico sponsorship rejections (`pm_*` methods, "sponsorship" messages)
- * - PAFI proxy HTTP errors (401, 403, 429, 503)
- * - Generic "rate limit" / "unauthorized" strings
- *
- * Use this to decide whether retrying without a paymaster makes sense.
- * Contract reverts (AA23, AA24, AA25) and bundler errors are NOT matched.
- */
-declare function isPaymasterError(err: unknown): boolean;
-interface SendWithPaymasterFallbackParams {
-    /** Smart-account client with paymaster configured — tried first. */
-    primaryClient: SmartAccountSender;
-    /**
-     * Smart-account client without paymaster — used when `primaryClient`
-     * throws a paymaster error. User pays gas from their ETH balance.
-     * Pass `null` or `undefined` to disable fallback (error re-thrown as-is).
-     */
-    fallbackClient: SmartAccountSender | null | undefined;
-    /** Transaction params forwarded verbatim to `sendTransaction`. */
-    txParams: Record<string, unknown>;
-    /**
-     * Called just before the fallback attempt so the caller can log or
-     * update UI. Receives the error message from the failed primary attempt.
-     */
-    onFallback?: (errorMessage: string) => void;
-}
-/**
- * Submit a UserOp with paymaster sponsorship, falling back to user-paid gas
- * if the paymaster refuses.
- *
- * Flow:
- * 1. Call `primaryClient.sendTransaction(txParams)`.
- * 2. If it throws and `isPaymasterError` returns true, call `onFallback` then
- *    retry with `fallbackClient` (no paymaster — user pays gas).
- * 3. All other errors (contract revert, bundler rejection, network) are
- *    re-thrown immediately without a retry.
- *
- * @example
- * ```ts
- * import { sendWithPaymasterFallback } from '@pafi-dev/core';
- *
- * const txHash = await sendWithPaymasterFallback({
- *   primaryClient:  smartClientWithPaymaster,
- *   fallbackClient: smartClientNoPaymaster,
- *   txParams: { calls, paymasterContext: { sponsorshipPolicyId } },
- *   onFallback: (msg) => addLog(`Paymaster refused (${msg}) — you will pay gas.`),
- * });
- * ```
- */
-declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackParams): Promise<Hex>;
-
-/**
- * Real `PointToken` ABI — matches the contract deployed on Base mainnet
- * (POINT at `0x7d25E7156E51F865D522fd3ef257a6B5DD41b97e`). Sourced from
- * the Solidity contract shipped by the SC team 2026-04-21.
- *
- * ## Mint — two paths
- *
- *   Path 1 — Direct (whitelisted minter):
- *     mint(address to, uint256 amount)
- *     - msg.sender must be in minters[]
- *     - Used by off-chain services that hold a minter key
- *
- *   Path 2 — Sig-gated (gasless, v1.4 sponsored flow):
- *     mint(address to, uint256 amount, uint256 deadline, bytes minterSig)
- *     - msg.sender MUST equal `to` (the receiver)
- *     - minterSig is an EIP-712 MintRequest signature from a whitelisted minter
- *     - Consumes `mintRequestNonces[to]`
- *     - This is the path v1.4 uses: issuer backend signs, user submits
- *       via EIP-7702 + Coinbase Paymaster
- *
- * ## Burn — mirror structure
- *
- *   Path 1: burn(address from, uint256 amount) — whitelisted burner
- *   Path 2: burn(address from, uint256 amount, uint256 deadline, bytes burnerSig)
- *           — msg.sender must equal `from`, burnerSig from whitelisted burner,
- *           consumes `burnRequestNonces[from]`
- *
- * Either burn path emits `Transfer(from → 0x0)` so BurnIndexer semantics
- * don't depend on which path was taken.
- *
- * ## EIP-712 type hashes (from contract source)
- *
- *   MintRequest(address to,uint256 amount,uint256 nonce,uint256 deadline)
- *   BurnRequest(address from,uint256 amount,uint256 nonce,uint256 deadline)
- *
- *   Domain: EIP-712 standard — name = ERC-20 token name, version = "1",
- *   chainId, verifyingContract = this PointToken address.
- */
-declare const POINT_TOKEN_ABI: readonly [{
-    readonly name: "mint";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "to";
-    }, {
-        readonly type: "uint256";
-        readonly name: "amount";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "mint";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "to";
-    }, {
-        readonly type: "uint256";
-        readonly name: "amount";
-    }, {
-        readonly type: "uint256";
-        readonly name: "deadline";
-    }, {
-        readonly type: "bytes";
-        readonly name: "minterSig";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "burn";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "from";
-    }, {
-        readonly type: "uint256";
-        readonly name: "amount";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "burn";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "from";
-    }, {
-        readonly type: "uint256";
-        readonly name: "amount";
-    }, {
-        readonly type: "uint256";
-        readonly name: "deadline";
-    }, {
-        readonly type: "bytes";
-        readonly name: "burnerSig";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "minters";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "account";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "bool";
-    }];
-}, {
-    readonly name: "burners";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "account";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "bool";
-    }];
-}, {
-    readonly name: "addMinter";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "minter";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "removeMinter";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "minter";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "addBurner";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "burner";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "removeBurner";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "burner";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "mintRequestNonces";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "receiver";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly name: "burnRequestNonces";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "from";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly name: "mintingOracle";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "address";
-    }];
-}, {
-    readonly name: "setMintingOracle";
-    readonly type: "function";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "_mintingOracle";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "issuer";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "address";
-    }];
-}, {
-    readonly name: "balanceOf";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "account";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly name: "totalSupply";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly name: "name";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "string";
-    }];
-}, {
-    readonly name: "symbol";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "string";
-    }];
-}, {
-    readonly name: "decimals";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint8";
-    }];
-}, {
-    readonly name: "DOMAIN_SEPARATOR";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "bytes32";
-    }];
-}, {
-    readonly name: "eip712Domain";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "bytes1";
-        readonly name: "fields";
-    }, {
-        readonly type: "string";
-        readonly name: "name";
-    }, {
-        readonly type: "string";
-        readonly name: "version";
-    }, {
-        readonly type: "uint256";
-        readonly name: "chainId";
-    }, {
-        readonly type: "address";
-        readonly name: "verifyingContract";
-    }, {
-        readonly type: "bytes32";
-        readonly name: "salt";
-    }, {
-        readonly type: "uint256[]";
-        readonly name: "extensions";
-    }];
-}, {
-    readonly name: "Transfer";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "from";
-        readonly indexed: true;
-    }, {
-        readonly type: "address";
-        readonly name: "to";
-        readonly indexed: true;
-    }, {
-        readonly type: "uint256";
-        readonly name: "value";
-    }];
-}, {
-    readonly name: "MinterAdded";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "minter";
-        readonly indexed: true;
-    }];
-}, {
-    readonly name: "MinterRemoved";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "minter";
-        readonly indexed: true;
-    }];
-}, {
-    readonly name: "BurnerAdded";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "burner";
-        readonly indexed: true;
-    }];
-}, {
-    readonly name: "BurnerRemoved";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "burner";
-        readonly indexed: true;
-    }];
-}, {
-    readonly name: "MintingOracleUpdated";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "mintingOracle";
-        readonly indexed: true;
-    }];
-}];
-
-declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: `0x${string}`;
-declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: `0x${string}`;
-
-/**
- * Per-chain deployed contract addresses — v1.4 flow.
- *
- * ## Status (2026-04-22)
- *
- * Base mainnet (8453): **all real**. BatchExecutor now points at the
- * canonical Coinbase Smart Wallet v2 contract which PAFI reuses as the
- * EIP-7702 delegation target (no per-app deploy required — one
- * contract, every issuer).
- *
- * Base Sepolia (84532): entire row is placeholder — not in active use.
- *
- * ## What lives where
- *
- *   pointToken      — live POINT instance (clone of PointToken impl)
- *   batchExecutor   — EIP-7702 delegation target (Coinbase Smart Wallet v2)
- *   usdt            — MockERC20 used by Uniswap pools
- *   issuerRegistry  — registry of all issuers on this chain
- *   mintingOracle   — per-issuer mint cap enforcer
- *   pafiHook        — Uniswap V4 hook enforcing the 10% PT→USDT fee
- *
- * 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.
- */
-interface ContractAddresses {
-    pointToken: Address;
-    batchExecutor: Address;
-    usdt: Address;
-    issuerRegistry: Address;
-    mintingOracle: Address;
-    /**
-     * Uniswap V4 hook that enforces the 10% fee on PT→USDT swaps
-     * (USDT→PT is free). FE reads this to build `PoolKey.hooks` when
-     * constructing a swap; quoters + routers need it to resolve the
-     * correct pool.
-     */
-    pafiHook: Address;
-}
-declare const CONTRACT_ADDRESSES: Record<number, ContractAddresses>;
-/**
- * PointTokenFactory address — separate from `ContractAddresses` because
- * it's only used at provisioning time (issuer onboard + token creation),
- * not in the hot mint/burn path.
- */
-declare const POINT_TOKEN_FACTORY_ADDRESSES: Record<number, Address>;
-/**
- * PointToken implementation address — the EIP-1167 clone target used
- * by PointTokenFactory. Exposed for observability / proxy verification;
- * consumers should never call this directly.
- */
-declare const POINT_TOKEN_IMPL_ADDRESSES: Record<number, Address>;
-/**
- * Lookup helper — throws if the chain isn't in the map so callers fail
- * loudly on misconfiguration instead of silently using `undefined`.
- */
-declare function getContractAddresses(chainId: number): ContractAddresses;
-
-/**
- * Public contract surface for `@pafi-dev/core/contracts`.
- *
- * Consumers import ABIs + per-chain addresses from this module. EIP-712
- * helpers (`signMintRequest`, `signBurnRequest`, etc.) live under
- * `./eip712/` and are re-exported from the package root — not duplicated
- * here.
- *
- * ## v1.4 flow — no Relayer, sig-gated mint/burn
- *
- * 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)`.
- *
- * Exports:
- *   - `POINT_TOKEN_V2_ABI`      — full mint + burn + admin surface
- *   - `BATCH_EXECUTOR_*`        — EIP-7702 delegation target (ABI real,
- *                                 address still placeholder on all
- *                                 chains until SC delivers)
- *   - `CONTRACT_ADDRESSES`      — per-chain map (real on 8453 except
- *                                 `batchExecutor` — pending SC)
- *   - `POINT_TOKEN_FACTORY_ADDRESSES`, `POINT_TOKEN_IMPL_ADDRESSES`
- *                               — provisioning / observability helpers
- *
- * Status: all real except BatchExecutor address (single remaining
- * placeholder, flagged inline in `real/addresses.ts`).
- */
-
-/**
- * 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
- * for other on-chain verifiers.
- */
-interface SignatureStruct {
-    v: number;
-    r: `0x${string}`;
-    s: `0x${string}`;
-}
-
-/**
- * Options for opening a PAFI Web modal — passed through by all adapters.
- * Web-only fields (width/height/windowName) are ignored by mobile
- * adapters that can't resize a system in-app browser.
- */
-interface ModalOpenOptions {
-    /** Web popup pixel width. Default 900. Ignored on mobile. */
-    width?: number;
-    /** Web popup pixel height. Default 700. Ignored on mobile. */
-    height?: number;
-    /**
-     * `window.open()` target name. Same name across calls re-uses an
-     * already-open popup. Default: `"pafi-web"`. Web-only.
-     */
-    windowName?: string;
-    /**
-     * Called when the modal closes — either user-initiated (clicked
-     * close, swiped down on mobile) or programmatically via `handle.close()`.
-     */
-    onClose?: () => void;
-    /**
-     * Called when the opened window posts a message back to the parent
-     * via `window.opener.postMessage(data, origin)`. PAFI Web uses this
-     * to signal "swap complete" / "perp deposit complete" back to the
-     * issuer app without needing a redirect.
-     *
-     * `origin` is the posting window's origin — caller MUST verify it
-     * matches the expected PAFI Web host before trusting `data`.
-     */
-    onMessage?: (data: unknown, origin: string) => void;
-    /**
-     * Allowed origins for `onMessage` — messages from other origins are
-     * silently dropped. Pass the PAFI Web host(s), e.g.
-     * `["https://app.pacificfinance.org", "https://app-dev.pacificfinance.org"]`.
-     *
-     * Default: empty (all messages rejected). Set explicitly for security.
-     */
-    allowedOrigins?: string[];
-}
-/**
- * Handle to an open PAFI Web modal. Methods are no-ops when the modal
- * has already closed — safe to call without tracking state yourself.
- */
-interface PafiWebModalHandle {
-    /** True when the modal is still open. */
-    readonly isOpen: boolean;
-    /** Close the modal. Fires `onClose` if the callback was supplied. */
-    close(): void;
-    /** Bring the modal to focus (web popup only; mobile ignores). */
-    focus(): void;
-    /**
-     * Post a message INTO the modal — useful for ping/pong handshakes
-     * with PAFI Web. The modal page must be on the same origin or
-     * explicitly listen for the message.
-     */
-    postMessage(data: unknown): void;
-}
-/**
- * Adapter that knows how to open a URL in the right UX for the host
- * platform. Callers register one via `setPafiWebModalAdapter()`; if
- * none is registered, the core module falls back to `openWebPopup()`
- * (if `window` is present) or throws (in Node / React Native without
- * an adapter set).
- *
- * ## Mobile adapter example (React Native)
- *
- * ```ts
- * import { setPafiWebModalAdapter } from '@pafi-dev/core';
- * import InAppBrowser from 'react-native-inappbrowser-reborn';
- *
- * setPafiWebModalAdapter({
- *   async open(url, options) {
- *     const result = await InAppBrowser.open(url, {
- *       // iOS: SFSafariViewController
- *       dismissButtonStyle: 'close',
- *       preferredBarTintColor: '#1a1a1a',
- *       preferredControlTintColor: 'white',
- *       // Android: Chrome Custom Tab
- *       toolbarColor: '#1a1a1a',
- *       secondaryToolbarColor: 'black',
- *     });
- *     options?.onClose?.();
- *     return {
- *       isOpen: false,
- *       close: () => InAppBrowser.close(),
- *       focus: () => {},
- *       postMessage: () => {},
- *     };
- *   },
- * });
- * ```
- *
- * ## Expo adapter example
- *
- * ```ts
- * import * as WebBrowser from 'expo-web-browser';
- *
- * setPafiWebModalAdapter({
- *   async open(url, options) {
- *     await WebBrowser.openBrowserAsync(url);
- *     options?.onClose?.();
- *     return { isOpen: false, close: WebBrowser.dismissBrowser, focus: () => {}, postMessage: () => {} };
- *   },
- * });
- * ```
- */
-interface PafiWebModalAdapter {
-    open(url: string, options?: ModalOpenOptions): PafiWebModalHandle | Promise<PafiWebModalHandle>;
-}
-
-/**
- * Web browser popup adapter. Opens the given URL in a centered
- * `window.open()` popup, polls for close, and optionally forwards
- * `postMessage` events back to the caller.
- *
- * Runtime requirement: `window.open` must exist. Throws if called
- * under Node / SSR / React Native — use `setPafiWebModalAdapter()` to
- * provide a platform-specific adapter in those environments.
- *
- * ## Popup blocking
- *
- * Browsers block `window.open()` unless it happens inside a user
- * gesture (click handler). Callers MUST wire this into a direct click
- * handler — wrapping it in a `setTimeout` or async await before the
- * open call will trigger the blocker.
- */
-declare function openWebPopup(url: string, options?: ModalOpenOptions): PafiWebModalHandle;
-/**
- * The web popup packaged as a {@link PafiWebModalAdapter} so callers
- * can register it explicitly (e.g. in a test harness).
- */
-declare const webPopupAdapter: PafiWebModalAdapter;
-
-/**
- * Register the adapter used by `openPafiWebModal()`. Typically called
- * once during app initialization — mobile apps register a
- * SFSafariViewController / Chrome Custom Tabs adapter, desktop apps
- * can leave it unset (web popup is the default).
- *
- * Pass `null` to unregister and fall back to the default.
- */
-declare function setPafiWebModalAdapter(adapter: PafiWebModalAdapter | null): void;
-/**
- * Return the currently registered adapter, or `null` when none is set.
- * Useful for tests that want to snapshot-and-restore the adapter.
- */
-declare function getPafiWebModalAdapter(): PafiWebModalAdapter | null;
-/**
- * Open PAFI Web in the host platform's appropriate UX:
- *
- *   - Browser (window.open): centered popup, 900×700 by default
- *   - React Native (with adapter registered): SFSafariViewController
- *     / Chrome Custom Tabs via `react-native-inappbrowser-reborn` or
- *     `expo-web-browser`
- *   - Desktop (with adapter registered): custom BrowserWindow / new tab
- *
- * Resolution order:
- *   1. If an adapter was registered via `setPafiWebModalAdapter()`, use it.
- *   2. Else if `window.open` is available, use the built-in web popup.
- *   3. Else throw with a clear error pointing at the adapter registry.
- *
- * @example
- * ```ts
- * // User clicks "Trade on PAFI" button
- * button.addEventListener('click', async () => {
- *   const modal = await openPafiWebModal('https://app.pacificfinance.org', {
- *     allowedOrigins: ['https://app.pacificfinance.org'],
- *     onMessage: (data, origin) => {
- *       if (typeof data === 'object' && data && 'txHash' in data) {
- *         console.log('Swap confirmed:', data.txHash);
- *         modal.close();
- *       }
- *     },
- *     onClose: () => {
- *       console.log('User closed modal');
- *     },
- *   });
- * });
- * ```
- */
-declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Promise<PafiWebModalHandle>;
-
-/** PAFI-hosted subgraph endpoint — single source of truth across all SDK packages. */
-declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v2";
-/**
- * Fetch the Uniswap V4 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.
- *
- * @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
- */
-declare function fetchPafiPools(_chainId: number, pointTokenAddress: Address, subgraphUrl?: string): Promise<PoolKey[]>;
-
-declare class PafiSDK {
-    private _pointTokenAddress?;
-    private _signer?;
-    private _provider?;
-    private _chainId?;
-    readonly mint: {
-        buildTypedData: PafiSDK["buildMintRequestTypedData"];
-        sign: PafiSDK["signMintRequest"];
-        verify: PafiSDK["verifyMintRequest"];
-        getNonce: PafiSDK["getMintRequestNonce"];
-    };
-    readonly consent: {
-        buildTypedData: PafiSDK["buildReceiverConsentTypedData"];
-        sign: PafiSDK["signReceiverConsent"];
-        verify: PafiSDK["verifyReceiverConsent"];
-        getNonce: PafiSDK["getReceiverConsentNonce"];
-    };
-    readonly swap: {
-        buildFromQuote: PafiSDK["buildSwapFromQuote"];
-        simulate: PafiSDK["simulateSwap"];
-    };
-    readonly quote: {
-        findBest: PafiSDK["findBestQuote"];
-    };
-    readonly auth: {
-        createLoginMessage: PafiSDK["createLoginMessage"];
-        signMessage: PafiSDK["signLoginMessage"];
-    };
-    constructor(config: PafiSDKConfig);
-    setPointTokenAddress(address: Address): void;
-    setSigner(signer: WalletClient): void;
-    setProvider(provider: PublicClient): void;
-    private requirePointToken;
-    private requireProvider;
-    private requireSigner;
-    private requireChainId;
-    getDomain(): Promise<PointTokenDomainConfig>;
-    buildMintRequestTypedData(message: MintRequest): Promise<{
-        domain: {
-            name: string;
-            version: "1";
-            chainId: number;
-            verifyingContract: `0x${string}`;
-        };
-        types: {
-            readonly MintRequest: readonly [{
-                readonly name: "to";
-                readonly type: "address";
-            }, {
-                readonly name: "amount";
-                readonly type: "uint256";
-            }, {
-                readonly name: "nonce";
-                readonly type: "uint256";
-            }, {
-                readonly name: "deadline";
-                readonly type: "uint256";
-            }];
-        };
-        primaryType: "MintRequest";
-        message: MintRequest;
-    }>;
-    buildReceiverConsentTypedData(message: ReceiverConsent): Promise<{
-        domain: {
-            name: string;
-            version: "1";
-            chainId: number;
-            verifyingContract: `0x${string}`;
-        };
-        types: {
-            readonly ReceiverConsent: readonly [{
-                readonly name: "onBehalfOf";
-                readonly type: "address";
-            }, {
-                readonly name: "originalReceiver";
-                readonly type: "address";
-            }, {
-                readonly name: "amount";
-                readonly type: "uint256";
-            }, {
-                readonly name: "nonce";
-                readonly type: "uint256";
-            }, {
-                readonly name: "deadline";
-                readonly type: "uint256";
-            }, {
-                readonly name: "extData";
-                readonly type: "bytes";
-            }];
-        };
-        primaryType: "ReceiverConsent";
-        message: ReceiverConsent;
-    }>;
-    signMintRequest(message: MintRequest): Promise<EIP712Signature>;
-    verifyMintRequest(message: MintRequest, signature: Hex, expectedMinter: Address): Promise<SignatureVerification>;
-    signReceiverConsent(message: ReceiverConsent): Promise<EIP712Signature>;
-    verifyReceiverConsent(message: ReceiverConsent, signature: Hex, expectedReceiver: Address): Promise<SignatureVerification>;
-    getMintRequestNonce(receiver: Address): Promise<bigint>;
-    getReceiverConsentNonce(receiver: Address): Promise<bigint>;
-    /**
-     * Find the best swap route from `tokenIn` to `tokenOut`.
-     * Merges `pools` with COMMON_POOLS for the configured chain, builds all
-     * paths, and quotes via a single multicall RPC call.
-     */
-    findBestQuote(tokenIn: Address, tokenOut: Address, exactAmount: bigint, pools?: PoolKey[], quoterAddress?: Address, maxHops?: number): Promise<BestQuote>;
-    /**
-     * Build UniversalRouter execute args from a quote result.
-     * The caller provides `minAmountOut` after applying their own slippage.
-     */
-    buildSwapFromQuote(params: {
-        quote: QuoteResult;
-        currencyIn: Address;
-        currencyOut: Address;
-        amountIn: bigint;
-        minAmountOut: bigint;
-    }): {
-        commands: Hex;
-        inputs: Hex[];
-    };
-    /**
-     * Simulate a UniversalRouter.execute swap call. Catches reverts (bad
-     * approvals, insufficient balance, pool errors) before submitting.
-     *
-     * @param routerAddress - UniversalRouter contract address
-     * @param commands      - Packed command bytes (from buildSwapFromQuote)
-     * @param inputs        - Encoded inputs (from buildSwapFromQuote)
-     * @param deadline      - Unix timestamp
-     * @param from          - Address that will execute the swap
-     */
-    simulateSwap(routerAddress: Address, commands: Hex, inputs: Hex[], deadline: bigint, from: Address): Promise<SwapSimulationResult>;
-    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_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, BestQuote, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, ENTRY_POINT_V07, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, Operation, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, POINT_TOKEN_ABI as POINT_TOKEN_V2_ABI, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, ReceiverConsent, SUPPORTED_CHAINS, type SendWithPaymasterFallbackParams, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, SwapSimulationResult, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, type VaultDepositFE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildPartialUserOperation, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, setPafiWebModalAdapter, setPaymasterConfig, webPopupAdapter };