@pafi-dev/core 0.19.0 → 0.22.0

package/dist/index.d.cts

@@ -1,15 +1,26 @@
 import { Address, Hex, TypedDataDomain, PublicClient, WalletClient, TransactionReceipt, HttpTransport } from 'viem';
-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.cjs';
-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.cjs';
-export { pointTokenAbi as POINT_TOKEN_ABI, erc20Abi, issuerRegistryAbi, mintFeeWrapperAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v3QuoterV2Abi } from './abi/index.cjs';
+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-Hn1zUPTt.cjs';
+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, o as Source } from './types-Hn1zUPTt.cjs';
+export { erc20Abi, issuerRegistryAbi, mintFeeWrapperAbi, mintingOracleAbi, permit2Abi, pointModuleCoreAbi, pointTokenAbi, pointTokenFactoryAbi, settlementVaultAbi, tokenRegistryAbi, universalRouterAbi, v3QuoterV2Abi, vaultFactoryAbi, vaultRegistryAbi } from './abi/index.cjs';
 export { Eip712DomainMismatchError, assertDomainMatchesContract, buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, signBurnRequest, signMintRequest, verifyBurnRequest, verifyMintRequest } from './eip712/index.cjs';
-export { getBurnRequestNonce, getIssuer, getMintFeeBps, getMintFeeRecipients, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getTokenCap, getTokenName, isActiveIssuer, isMinter, issuerRegistryGetIssuerFlatAbi, verifyMintCap } from './contract/index.cjs';
+export { computeEquityCap, getBurnRequestNonce, getIssuer, getMintFeeBps, getMintFeeRecipients, getMintRequestNonce, getOracleRegistries, getPointTokenBalance, getPointTokenIssuerAddress, getTokenName, isActiveIssuer, isMinter, issuerRegistryGetIssuerFlatAbi, verifyEquityMint, verifyIssuerOperative, verifyMint } from './contract/index.cjs';
 import { LoginMessageParams } from './auth/index.cjs';
 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.cjs';
 
 /**
  * EIP-712 typed data for the sig-gated mint path.
  *
+ * V2 dual-bucket — adds `source` (uint8) so the on-chain digest matches
+ * `MintForRequest(address user,address receiver,uint256 amount,uint8 source,uint256 nonce,uint256 deadline)`.
+ * Source values per `IPointToken.Source`:
+ *   0 = EQUITY (mint backed by issuer's declared capital)
+ *   1 = VAULT  (mint backed by LP collateral in SettlementVault)
+ *
+ * SDK helpers `signMintRequest` / `prepareMint` hardcode `source = 0`
+ * (EQUITY). VAULT minting is contract-ready but no SDK writer ships it
+ * until the LP/admin dashboard lands; sponsor-relayer fails closed on
+ * `source != EQUITY` for the same reason.
+ *
  * Contract enforces:
  *   - msg.sender == receiver (the on-chain caller of `mint`)
  *   - nonce == mintRequestNonces[user] (per-user nonce stream)
@@ -29,6 +40,9 @@ declare const mintRequestTypes: {
     }, {
         readonly name: "amount";
         readonly type: "uint256";
+    }, {
+        readonly name: "source";
+        readonly type: "uint8";
     }, {
         readonly name: "nonce";
         readonly type: "uint256";
@@ -37,6 +51,13 @@ declare const mintRequestTypes: {
         readonly type: "uint256";
     }];
 };
+/**
+ * EIP-712 typed data for the sig-gated burn path. V2 adds `source`
+ * (uint8) to match the contract's 6-field digest:
+ *   `BurnRequest(address from,uint256 amount,uint8 source,uint256 nonce,uint256 deadline)`
+ *
+ * Same EQUITY-only policy as `mintRequestTypes`.
+ */
 declare const burnRequestTypes: {
     readonly BurnRequest: readonly [{
         readonly name: "from";
@@ -44,6 +65,9 @@ declare const burnRequestTypes: {
     }, {
         readonly name: "amount";
         readonly type: "uint256";
+    }, {
+        readonly name: "source";
+        readonly type: "uint8";
     }, {
         readonly name: "nonce";
         readonly type: "uint256";
@@ -1475,6 +1499,87 @@ interface DelegateDirectResult {
  */
 declare function delegateDirect(params: DelegateDirectParams): Promise<DelegateDirectResult>;
 
+interface AttachDelegationIfNeededParams {
+    /**
+     * Public client connected to the chain on which the delegation lives.
+     * The helper uses it to (1) read on-chain code via `eth_getCode` and
+     * (2) read the EOA's tx nonce — both reads must hit the SAME chain
+     * that `chainId` declares, otherwise Pimlico's bundler will reject the
+     * authorization with a chain-mismatch error.
+     */
+    rpc: PublicClient;
+    /**
+     * The user's EOA — the wallet that will become a temporary smart account
+     * via EIP-7702 SetCode. MUST match the `sender` of the UserOp the caller
+     * is about to submit; otherwise the bundler's recovered-signer check
+     * fails ("recovered signer does not match userOperation sender").
+     */
+    account: Address;
+    /**
+     * The implementation address the EOA should delegate to — typically the
+     * Pimlico Simple7702Account / BatchExecutor on the target chain (Base
+     * mainnet: `0xe6Cae83BdE06E4c305530e199D7217f42808555B`).
+     *
+     * The helper compares the on-chain code at `account` against this address.
+     * Mismatch → sign a new authorization to switch the delegate. Match →
+     * return `undefined` (caller passes nothing — extra auth would be wasted
+     * gas + the bundler may reject redundant authorizations).
+     */
+    expectedDelegate: Address;
+    /**
+     * Chain id baked into the EIP-7702 authorization tuple. Must equal the
+     * chain `rpc` connects to.
+     */
+    chainId: number;
+    /**
+     * Privy-shaped authorization signer. Pass `useSign7702Authorization().signAuthorization`
+     * directly on web, or the Expo SDK's equivalent on mobile.
+     *
+     * The helper feeds it `(contractAddress, chainId, nonce)` — the signer
+     * MUST sign with the same private key that controls `account`, otherwise
+     * the recovered signer mismatch above triggers.
+     */
+    signAuthorization: SignAuthorizationFn;
+}
+/**
+ * Sign an EIP-7702 authorization for `account` ONLY when the EOA does not
+ * already delegate to `expectedDelegate`. Returns the authorization in the
+ * shape that permissionless / viem expect on
+ * `smartClient.sendTransaction({ authorization, ... })`. Pimlico bundles
+ * the SetCode + UserOp execution into a SINGLE bundler tx — "atomic
+ * activation" — so the user never sees a separate "delegate" step on their
+ * first action.
+ *
+ * Returns `undefined` when the EOA already points at `expectedDelegate`.
+ * Caller spreads the return value into the tx params:
+ *
+ * ```ts
+ * const authPart = await attachDelegationIfNeeded({ ... });
+ * await smartClient.sendTransaction({
+ *   to: pointToken,
+ *   data: encodeMintCalldata(amount),
+ *   ...(authPart ?? {}),  // attaches { authorization: ... } only when needed
+ * });
+ * ```
+ *
+ * Cost: 1 `eth_getCode` read every time + 1 `eth_getTransactionCount` +
+ * 1 signature (only the first time per EOA). Subsequent calls collapse to
+ * a single RPC read and return `undefined` — cheap to call before every
+ * UserOp.
+ *
+ * Implementation notes:
+ *   - Comparison is case-insensitive (`isDelegatedTo` lowercases both
+ *     sides) so passing checksum-cased addresses is safe.
+ *   - Nonce is fetched freshly per call to avoid replaying an old nonce
+ *     when the FE held the helper params across multiple actions.
+ *   - The signed tuple is passed through `buildEip7702Authorization` to
+ *     normalise `r` / `s` / `yParity` into the wire shape Pimlico accepts
+ *     (handles Privy's bigint `v` and string-hex `yParity` variants).
+ */
+declare function attachDelegationIfNeeded(params: AttachDelegationIfNeededParams): Promise<{
+    authorization: Eip7702AuthorizationJsonRpc;
+} | undefined>;
+
 /**
  * Parameters for `createPafiProxyTransport`.
  */
@@ -1781,6 +1886,441 @@ interface QuoteOperatorFeeForTransferConfig extends Omit<QuoteOperatorFeeUsdtCon
 }
 declare function quoteOperatorFeeForTransfer(config: QuoteOperatorFeeForTransferConfig): Promise<bigint>;
 
+/**
+ * Real `PointToken` ABI — matches the V2 dual-bucket PointToken on
+ * Base. Each issuer's clone is per-deploy, created via
+ * `PointTokenFactory.createToken()`. ABI sourced from the Solidity
+ * contract shipped by the SC team (Pacific-Finance-Lab/PAFI-Point-module-sc).
+ *
+ * ## V2 Source enum
+ *
+ * Every mint and burn now requires a `Source` argument:
+ *   0 = EQUITY — issuer's declared capital
+ *   1 = VAULT  — LP collateral in SettlementVault
+ *
+ * SDK helpers + sponsor-relayer hardcode / enforce `source = EQUITY`
+ * until the VAULT writer surface lands.
+ *
+ * ## Mint — two paths
+ *
+ *   Path 1 — Direct (whitelisted minter):
+ *     mint(address to, uint256 amount, uint8 source)
+ *     - msg.sender must be in minters[]
+ *     - Used by off-chain services that hold a minter key
+ *
+ *   Path 2 — Sig-gated (sponsored flow):
+ *     mint(address user, uint256 amount, uint8 source, uint256 deadline, bytes minterSig)
+ *     - msg.sender MUST equal `user` (the receiver)
+ *     - minterSig is an EIP-712 MintForRequest signature from a whitelisted minter
+ *     - Consumes `mintRequestNonces[user]`
+ *     - Canonical PAFI path: issuer backend signs, user submits via
+ *       EIP-7702 + PAFI sponsor-relayer
+ *
+ * ## Burn — mirror structure
+ *
+ *   Path 1: burn(address from, uint256 amount, uint8 source) — whitelisted burner
+ *   Path 2: burn(address from, uint256 amount, uint8 source, 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. Bucket-specific underflow
+ * surfaces as `BucketUnderflow(source, amount, available)`.
+ *
+ * ## EIP-712 type hashes (V2 — from contract source)
+ *
+ *   MintForRequest(address user,address receiver,uint256 amount,uint8 source,uint256 nonce,uint256 deadline)
+ *   BurnRequest(address from,uint256 amount,uint8 source,uint256 nonce,uint256 deadline)
+ *
+ * `user` drives the `mintRequestNonces[user]` stream; `receiver ==
+ * msg.sender` of `mint()` (= user for direct, = MintFeeWrapper for
+ * wrapper-mediated mints).
+ *
+ *   Domain: EIP-712 standard — name = ERC-20 token name, version = "1",
+ *   chainId, verifyingContract = this PointToken address.
+ */
+/**
+ * Single-signature ABI for the sig-gated mint (the canonical PAFI
+ * sponsored path). Split out from `POINT_TOKEN_ABI` because viem's
+ * type-level overload resolution on `encodeFunctionData({abi, functionName:"mint", args:[...]})`
+ * cannot unambiguously pick between the 3-arg direct path and the
+ * 5-arg sig-gated path when both share the `mint` name. Callers that
+ * need to ENCODE the sig-gated mint should use this ABI; ABI reads
+ * (e.g. balance views) keep `POINT_TOKEN_ABI`.
+ */
+declare const POINT_TOKEN_MINT_SIG_ABI: readonly [{
+    readonly name: "mint";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }, {
+        readonly type: "uint8";
+        readonly name: "source";
+    }, {
+        readonly type: "uint256";
+        readonly name: "deadline";
+    }, {
+        readonly type: "bytes";
+        readonly name: "minterSig";
+    }];
+    readonly outputs: readonly [];
+}];
+/** Sig-gated burn ABI — see `POINT_TOKEN_MINT_SIG_ABI` rationale. */
+declare const POINT_TOKEN_BURN_SIG_ABI: 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: "uint8";
+        readonly name: "source";
+    }, {
+        readonly type: "uint256";
+        readonly name: "deadline";
+    }, {
+        readonly type: "bytes";
+        readonly name: "burnerSig";
+    }];
+    readonly outputs: readonly [];
+}];
+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 type: "uint8";
+        readonly name: "source";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "mint";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }, {
+        readonly type: "uint8";
+        readonly name: "source";
+    }, {
+        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 type: "uint8";
+        readonly name: "source";
+    }];
+    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: "uint8";
+        readonly name: "source";
+    }, {
+        readonly type: "uint256";
+        readonly name: "deadline";
+    }, {
+        readonly type: "bytes";
+        readonly name: "burnerSig";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "equitySupply";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "vaultSupply";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    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}`;
 
@@ -1836,6 +2376,12 @@ interface ContractAddresses {
     mintFeeWrapper: Address;
     /** Chainlink ETH/USD price feed — used by FeeManager to convert gas cost to USDT. */
     chainlinkEthUsd: Address;
+    /**
+     * Chainlink USDC/USD price feed — paired with the canonical USDC.
+     * Optional because not every chain ships a USDC oracle; FeeManager
+     * falls back to 1:1 (USDC pegged) when undefined.
+     */
+    chainlinkUsdcUsd?: Address;
     /**
      * Orderly perp-deposit Relay — holds an ETH reserve to cover the
      * LayerZero msg.value, charges a USDC token-fee reimbursement.
@@ -1851,7 +2397,7 @@ interface ContractAddresses {
      * shouldn't be able to redirect this fee to themselves.
      */
     pafiFeeRecipient: Address;
-    /** Uniswap V4 UniversalRouter — swap entry point for the swap handler. */
+    /** UniversalRouter — swap entry point for the swap handler. */
     universalRouter: Address;
     /**
      * PAFI fork of Uniswap's Permit2. Acts as the unified token-approval
@@ -1862,6 +2408,22 @@ interface ContractAddresses {
      * sync with `PERMIT2_ADDRESS` top-level export.
      */
     permit2: Address;
+    /** V2: TokenRegistry — per-PointToken metadata + active flag. */
+    tokenRegistry: Address;
+    /**
+     * V2: VaultRegistry — per-PointToken SettlementVault registration.
+     * Read-only from the SDK's perspective today (issuer-equity-only
+     * launch); becomes write-side relevant when the LP vault flow lands.
+     */
+    vaultRegistry: Address;
+    /** V2: VaultFactory — deploys SettlementVault UUPS-beacon clones. */
+    vaultFactory: Address;
+    /**
+     * V2: PointModuleCore — top-level coordinator. Holds references to
+     * the IssuerRegistry, TokenRegistry, VaultRegistry, MintingOracle so
+     * consumers can resolve the full registry set from one address.
+     */
+    pointModuleCore: Address;
 }
 declare const CONTRACT_ADDRESSES: Record<number, ContractAddresses>;
 /**
@@ -1871,11 +2433,26 @@ declare const CONTRACT_ADDRESSES: Record<number, ContractAddresses>;
  */
 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.
+ * PointToken implementation address — the clone target used by
+ * PointTokenFactory. V2 switched from EIP-1167 minimal proxy to a
+ * UUPS-beacon pattern (see `POINT_TOKEN_BEACON_ADDRESSES`); each clone
+ * delegates through the beacon to this impl. Exposed for observability
+ * / proxy verification; consumers should never call this directly.
  */
 declare const POINT_TOKEN_IMPL_ADDRESSES: Record<number, Address>;
+/**
+ * V2: PointToken UUPS beacon — clones point at this beacon; the beacon
+ * delegates to the impl. Upgrading the impl is done by re-pointing the
+ * beacon. Exposed for upgrade audits and observability; runtime SDK
+ * paths never reference it directly.
+ */
+declare const POINT_TOKEN_BEACON_ADDRESSES: Record<number, Address>;
+/**
+ * V2: SettlementVault UUPS beacon — same pattern as the PointToken
+ * beacon, for the per-PointToken ERC-4626 LP vault deployed by
+ * VaultFactory. Exposed for upgrade audits.
+ */
+declare const VAULT_BEACON_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`.
@@ -2154,7 +2731,21 @@ declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Prom
  * MintFeeWrapper. Schema entities: `MintFeeWrapper`, `MintFeeConfig`,
  * `FeeRecipient`, `MintWithFeeEvent`, `FeeDistribution`.
  */
-declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v4";
+/**
+ * Default subgraph endpoint. Points at `pafi-subgraph-v1` — the deployment
+ * that indexes the V2 contract bucket (IssuerRegistry 0x3e8264…,
+ * PointTokenFactory 0x34f9F8…, TokenRegistry 0x7092b3…, MintingOracle
+ * 0x19F5Ea…, MintFeeWrapper 0x72B8FB…). Despite the "v1" name in the URL
+ * this is the freshest subgraph — naming is a deploy-order artifact, not
+ * a contract-version indicator.
+ *
+ * Previous deployments (`pafi-subgraph-v4`, `v5`) tracked the v1.6
+ * contract bucket and have been retired alongside the v2 cutover.
+ *
+ * Override per-call via `subgraphUrl` parameter when you need to point at
+ * a fork or a private graph node for staging.
+ */
+declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v1";
 /**
  * Fetch the Uniswap V3 pool(s) for a PAFI PointToken from the subgraph.
  *
@@ -2213,6 +2804,9 @@ declare class PafiSDK {
             }, {
                 readonly name: "amount";
                 readonly type: "uint256";
+            }, {
+                readonly name: "source";
+                readonly type: "uint8";
             }, {
                 readonly name: "nonce";
                 readonly type: "uint256";
@@ -2232,4 +2826,4 @@ declare class PafiSDK {
     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 BuildErc20TransferParams, 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, type FallbackInfo, type FeeScenario, 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 QuoteOperatorFeeForTransferConfig, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SCENARIO_GAS_UNITS, 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, buildErc20TransferUserOp, 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, quoteOperatorFeeForTransfer, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };
+export { ApiError, type AttachDelegationIfNeededParams, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildErc20TransferParams, 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, type FallbackInfo, type FeeScenario, 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_ABI, POINT_TOKEN_BEACON_ADDRESSES, POINT_TOKEN_BURN_SIG_ABI, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_MINT_SIG_ABI, 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 QuoteOperatorFeeForTransferConfig, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SCENARIO_GAS_UNITS, 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, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, buildDelegationUserOp, buildEip7702Authorization, buildErc20TransferUserOp, 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, quoteOperatorFeeForTransfer, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };