@pafi-dev/core 0.3.0-beta.3 → 0.3.0-beta.5

package/dist/index.d.ts

@@ -1,14 +1,12 @@
 import { Address, Hex, PublicClient, WalletClient } from 'viem';
-import { P as PoolKey, C as ChainConfig, a as PointTokenDomainConfig, E as EIP712Signature, S as SignatureVerification, b as PafiSDKConfig, M as MintRequest, R as ReceiverConsent, c as MintParams, d as SwapParams, B as BestQuote, Q as QuoteResult, e as PathKey } from './types-BDOnH5Le.js';
-export { I as Issuer } from './types-BDOnH5Le.js';
-export { erc20Abi, issuerRegistryAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, relayAbi, universalRouterAbi, v4QuoterAbi } from './abi/index.js';
-export { buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signMintRequest, signReceiverConsent, verifyMintRequest, verifyReceiverConsent } from './eip712/index.js';
-import { SimulationResult } from './relay/index.js';
-export { buildRelaySwapParams, decodeExtData, decodeMintAndSwap, encodeExtData, encodeMintAndSwap, simulateMintAndSwap } from './relay/index.js';
-export { getIssuer, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getReceiverConsentNonce, getTokenName, getUsdt, isActiveIssuer, isMinter, verifyMintCap } from './contract/index.js';
+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.js';
+export { c as BurnRequest, I as Issuer, d as PathKey } from './types-b5_Tokjl.js';
+export { erc20Abi, issuerRegistryAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v4QuoterAbi } from './abi/index.js';
+export { buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signBurnRequest, signMintRequest, signReceiverConsent, verifyBurnRequest, verifyMintRequest, verifyReceiverConsent } from './eip712/index.js';
+export { getIssuer, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getReceiverConsentNonce, getTokenName, isActiveIssuer, isMinter, verifyMintCap } from './contract/index.js';
 export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle } from './quoting/index.js';
-import { O as Operation, P as PartialUserOperation, U as UserOperation, S as SwapSimulationResult } from './index-CNALKsH1.js';
-export { B as BuildSwapWithGasDeductionParams, E as ENTRY_POINT_V07, 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-CNALKsH1.js';
+import { O as Operation, P as PartialUserOperation, U as UserOperation, S as SwapSimulationResult } from './index-B06IJlHe.js';
+export { B as BuildSwapWithGasDeductionParams, E as ENTRY_POINT_V07, 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-B06IJlHe.js';
 import { LoginMessageParams } from './auth/index.js';
 export { VerifyLoginResult, createLoginMessage, parseLoginMessage, verifyLoginMessage } from './auth/index.js';
 
@@ -27,6 +25,21 @@ declare const mintRequestTypes: {
         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";
@@ -276,122 +289,286 @@ interface CheckEthAndBranchParams {
 declare function checkEthAndBranch(params: CheckEthAndBranchParams): Promise<SubmissionPath>;
 
 /**
- * ⚠️ MOCK — `PointToken` v1.4 surface (mint + burn).
+ * 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
  *
- * ## Mint (NEW direct flow — no Relayer)
+ *   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
  *
- * In v1.4 the user calls `PointToken.mint()` directly via an EIP-7702
- * delegated UserOp — `msg.sender == user`. The contract checks the
- * caller is on its authorized minter allowlist. **No Relayer contract,
- * no MintRequest EIP-712 signature.** Backend (gg56) only validates
- * off-chain (balance, policy, KYC) before returning the unsigned UserOp.
+ *   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
  *
- * The mock signature `mint(uint256 amount)` mints to `msg.sender`.
- * SC team confirmation pending — they may pick `mint(address to,
- * uint256 amount)` instead. Either is a 1-line ABI change here.
+ * ## Burn — mirror structure
  *
- * ## Burn — two variants mocked
+ *   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]`
  *
- *   Variant A (simpler, most likely):
- *     burn(uint256 amount)
- *     - burns from `msg.sender` (user via EIP-7702)
+ * Either burn path emits `Transfer(from → 0x0)` so BurnIndexer semantics
+ * don't depend on which path was taken.
  *
- *   Variant B (signature-based, if SC prefers explicit on-chain consent):
- *     burnWithSig(BurnConsent consent, Signature sig)
- *     - verifies EIP-712 signature before burning
+ * ## EIP-712 type hashes (from contract source)
  *
- * Either way the ERC-20 emits `Transfer(from, address(0), amount)` so
- * `BurnIndexer` semantics don't change.
+ *   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 MOCK_POINT_TOKEN_V2_ABI: 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 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: "user";
+        readonly name: "account";
     }];
     readonly outputs: readonly [{
         readonly type: "bool";
     }];
 }, {
-    readonly name: "burn";
+    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: "uint256";
-        readonly name: "amount";
+        readonly type: "address";
+        readonly name: "minter";
     }];
     readonly outputs: readonly [];
 }, {
-    readonly name: "burnWithSig";
+    readonly name: "removeMinter";
     readonly type: "function";
     readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly type: "tuple";
-        readonly components: readonly [{
-            readonly type: "address";
-            readonly name: "user";
-        }, {
-            readonly type: "address";
-            readonly name: "pointToken";
-        }, {
-            readonly type: "uint256";
-            readonly name: "amount";
-        }, {
-            readonly type: "uint256";
-            readonly name: "nonce";
-        }, {
-            readonly type: "uint256";
-            readonly name: "deadline";
-        }];
-        readonly name: "consent";
-    }, {
-        readonly type: "tuple";
-        readonly components: readonly [{
-            readonly type: "uint8";
-            readonly name: "v";
-        }, {
-            readonly type: "bytes32";
-            readonly name: "r";
-        }, {
-            readonly type: "bytes32";
-            readonly name: "s";
-        }];
-        readonly name: "sig";
+        readonly type: "address";
+        readonly name: "minter";
     }];
     readonly outputs: readonly [];
 }, {
-    readonly name: "balanceOf";
+    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: "user";
+        readonly name: "receiver";
     }];
     readonly outputs: readonly [{
         readonly type: "uint256";
     }];
 }, {
-    readonly name: "burnNonce";
+    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: "user";
+        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";
@@ -407,54 +584,99 @@ declare const MOCK_POINT_TOKEN_V2_ABI: readonly [{
         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;
+    }];
 }];
 
 /**
- * ⚠️ MOCK — placeholder BatchExecutor address.
+ * BatchExecutor delegation target addresses.
+ *
+ * ## Status
  *
- * Real deployment:
- *   - Coinbase may pre-deploy a canonical BatchExecutor that we target
- *     via EIP-7702 delegation (see blocker B2 in V1.4_V1.5_READINESS.md)
- *   - Otherwise PAFI deploys a minimal one and publishes the address
+ * Per-chain addresses are **still placeholder** (`0x...DE01` / `DE02`)
+ * pending the SC team's Phase B delivery. When Coinbase publishes a
+ * canonical BatchExecutor, or PAFI deploys its own and publishes the
+ * address, swap the constants below — callers already import from here
+ * so no wiring changes.
  *
- * The ABI itself (`execute(Call[])`) is stable and lives under
- * `../../userop/batchExecute.ts` — that's the real one, unchanged
- * by the mock swap. Only the **address** is mocked here.
+ * The ABI (`execute(Call[])`) itself is real and stable — it lives
+ * under `../../userop/batchExecute.ts` and is re-exported below so
+ * consumers can grab both ABI + address from one import path.
  *
- * Pattern: checksum address with hex "DEAD0001" suffix per chain so
- * it's obvious in logs which chain is using a mock.
+ * ## Why checksum with DEAD0001 / DEAD0002 suffix
+ *
+ * The placeholder pattern makes the fact-of-mockness obvious in logs
+ * and block explorers. A request targeting `0x...DE01` is impossible
+ * to confuse with a production contract.
  */
-declare const MOCK_BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: Address;
-declare const MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: Address;
+declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: Address;
+declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: Address;
 
 /**
- * ⚠️ MOCK — per-chain contract addresses for the v1.4 sponsored flow.
- *
- * Real addresses come from SC team once they deploy Relayer v2 and
- * pick a BatchExecutor. Until then we use placeholders so the SDK
- * code path compiles + tests execute end-to-end.
- *
- * **Intentionally not merge-safe to mainnet** — callers that resolve
- * a mainnet address here get a `0x...DEAD` placeholder which will
- * revert at contract-level. That's the point: prod refuses to run
- * on mocks.
- *
- * Chain id map:
- *   - 8453     Base mainnet
- *   - 84532    Base Sepolia
- *
- * Swap workflow when SC delivers:
- *   1. Rename this file → `addresses.ts` under `src/contracts/real/`
- *   2. Fill real addresses per chain
- *   3. Update `src/contracts/index.ts` re-export
- *   4. Delete MOCK_* named exports
- */
-/**
- * Per-chain contract addresses.
+ * Per-chain deployed contract addresses — v1.4 flow.
+ *
+ * ## Status (2026-04-21)
+ *
+ * Base mainnet (8453): all SC-delivered and real, EXCEPT `batchExecutor`
+ * which is still a `0x...DE02` placeholder pending the Phase B delivery.
+ * 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 (PLACEHOLDER)
+ *   usdt            — MockERC20 used by Uniswap pools
+ *   issuerRegistry  — registry of all issuers on this chain
+ *   mintingOracle   — per-issuer mint cap enforcer
+ *
+ * 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.
+ *
+ * ## Swap workflow when BatchExecutor lands
  *
- * v1.4 update: `relayerV2` field dropped — flow now calls
- * `PointToken.mint()` directly via EIP-7702 delegation. No Relayer
- * contract sits between user and PointToken.
+ *   1. Replace `batchExecutor` placeholder with real address
+ *   2. Structure / imports don't change — callers are stable
+ *   3. Bump core to next beta and update release notes
  */
 interface ContractAddresses {
     pointToken: Address;
@@ -463,121 +685,61 @@ interface ContractAddresses {
     issuerRegistry: Address;
     mintingOracle: Address;
 }
-declare const MOCK_ADDRESSES: Record<number, ContractAddresses>;
+declare const CONTRACT_ADDRESSES: Record<number, ContractAddresses>;
 /**
- * Lookup helper — throws if the chain isn't in the map so callers fail
- * loudly on misconfiguration instead of silently using `undefined`.
+ * 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 function getMockAddresses(chainId: number): ContractAddresses;
-
+declare const POINT_TOKEN_FACTORY_ADDRESSES: Record<number, Address>;
 /**
- * ⚠️ MOCK — `BurnConsent` EIP-712 type for the v1.4 reverse flow.
- *
- * New type entirely — v0.2.x had no burn-for-credit flow.
- *
- * User signs `BurnConsent` to authorize burning `amount` PT from their
- * wallet in exchange for an off-chain credit of (amount - gasFee).
- * Signature is consumed either by:
- *   - A relayer calling `PointToken.burnWithSig(...)` (Variant B)
- *   - The paymaster-proxy-sponsored UserOp calling `PointToken.burn(...)`
- *     with msg.sender = user via EIP-7702 (Variant A)
- *
- * Either way the tx emits `Transfer(user → 0x0)` which the issuer's
- * `BurnIndexer` watches for and uses to credit the off-chain ledger.
- *
- * Field list is a best-guess — SC team may add fields (e.g. `feeAmount`
- * explicit, `extData`). Update this mock when they freeze the spec.
+ * PointToken implementation address — the EIP-1167 clone target used
+ * by PointTokenFactory. Exposed for observability / proxy verification;
+ * consumers should never call this directly.
  */
-interface MockBurnConsent {
-    user: Address;
-    pointToken: Address;
-    amount: bigint;
-    nonce: bigint;
-    deadline: bigint;
-}
-declare const MOCK_BURN_CONSENT_TYPES: {
-    readonly BurnConsent: readonly [{
-        readonly name: "user";
-        readonly type: "address";
-    }, {
-        readonly name: "pointToken";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
-        readonly name: "deadline";
-        readonly type: "uint256";
-    }];
-};
-declare function buildMockBurnConsentTypedData(domain: PointTokenDomainConfig, message: MockBurnConsent): {
-    domain: {
-        name: string;
-        version: "1";
-        chainId: number;
-        verifyingContract: `0x${string}`;
-    };
-    types: {
-        readonly BurnConsent: readonly [{
-            readonly name: "user";
-            readonly type: "address";
-        }, {
-            readonly name: "pointToken";
-            readonly type: "address";
-        }, {
-            readonly name: "amount";
-            readonly type: "uint256";
-        }, {
-            readonly name: "nonce";
-            readonly type: "uint256";
-        }, {
-            readonly name: "deadline";
-            readonly type: "uint256";
-        }];
-    };
-    primaryType: "BurnConsent";
-    message: MockBurnConsent;
-};
-declare function signMockBurnConsent(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MockBurnConsent): Promise<EIP712Signature>;
-declare function verifyMockBurnConsent(domain: PointTokenDomainConfig, message: MockBurnConsent, signature: Hex, expectedUser: Address): Promise<SignatureVerification>;
+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 contract ABIs + addresses + EIP-712 builders from
- * this module. The re-exports below dispatch to either `./mocks/*`
- * (current) or `./real/*` (once SC team delivers real ABIs).
+ * 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 update — Relayer removed
+ * ## v1.4 flow — no Relayer, sig-gated mint/burn
  *
- * The flow no longer routes mint through a Relayer contract. Users
- * call `PointToken.mint()` directly via an EIP-7702 delegated UserOp
- * (`msg.sender == user`). PointToken checks `minters[user]` for
- * authorization. No on-chain MintRequest signature, no dual-sig
- * verification.
+ * 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 kept:
- *   - `POINT_TOKEN_V2_ABI` — mint + burn surface
- *   - `BATCH_EXECUTOR_*` — EIP-7702 delegation target
- *   - `CONTRACT_ADDRESSES` — per-chain map (pointToken, batchExecutor, etc.)
- *   - `BURN_CONSENT_*` — EIP-712 for Scenario 2 if `burnWithSig` variant
+ * 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
  *
- * Exports removed (vs beta.2):
- *   - `RELAYER_V2_ABI`, `RELAYER_V2_MINT_SELECTOR`, `MintRequestV2`,
- *     `SignatureStruct` — Relayer contract dropped from flow
- *   - `MINT_REQUEST_V2_TYPES`, `buildMintRequestV2TypedData`,
- *     `signMintRequestV2`, `verifyMintRequestV2` — no MintRequest sig
- *
- * Status: MOCKS active. See `./mocks/README.md` for deletion checklist.
+ * Status: all real except BatchExecutor address (single remaining
+ * placeholder, flagged inline in `real/addresses.ts`).
  */
 
 /**
- * Signature struct shared by `burnWithSig` (and any future EIP-712
- * verifier on-chain). Exported here so consumers don't need to
- * redefine it locally.
+ * 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;
@@ -769,13 +931,11 @@ declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Prom
 
 declare class PafiSDK {
     private _pointTokenAddress?;
-    private _relayContractAddress?;
     private _signer?;
     private _provider?;
     private _chainId?;
     constructor(config: PafiSDKConfig);
     setPointTokenAddress(address: Address): void;
-    setRelayContractAddress(address: Address): void;
     setSigner(signer: WalletClient): void;
     setProvider(provider: PublicClient): void;
     private requirePointToken;
@@ -783,10 +943,6 @@ declare class PafiSDK {
     private requireSigner;
     private requireChainId;
     getDomain(): Promise<PointTokenDomainConfig>;
-    /**
-     * Build the EIP-712 typed data for a MintRequest.
-     * Pass the result to any external signer (Privy, WalletConnect, etc.).
-     */
     buildMintRequestTypedData(message: MintRequest): Promise<{
         domain: {
             name: string;
@@ -812,10 +968,6 @@ declare class PafiSDK {
         primaryType: "MintRequest";
         message: MintRequest;
     }>;
-    /**
-     * Build the EIP-712 typed data for a ReceiverConsent.
-     * Pass the result to any external signer (Privy, WalletConnect, etc.).
-     */
     buildReceiverConsentTypedData(message: ReceiverConsent): Promise<{
         domain: {
             name: string;
@@ -853,11 +1005,6 @@ declare class PafiSDK {
     verifyReceiverConsent(message: ReceiverConsent, signature: Hex, expectedReceiver: Address): Promise<SignatureVerification>;
     getMintRequestNonce(receiver: Address): Promise<bigint>;
     getReceiverConsentNonce(receiver: Address): Promise<bigint>;
-    encodeMintAndSwap(mint: MintParams, swap: SwapParams): Hex;
-    decodeMintAndSwap(calldata: Hex): {
-        mint: MintParams;
-        swap: SwapParams;
-    };
     /**
      * Find the best swap route from `tokenIn` to `tokenOut`.
      * Merges `pools` with COMMON_POOLS for the configured chain, builds all
@@ -878,36 +1025,6 @@ declare class PafiSDK {
         commands: Hex;
         inputs: Hex[];
     };
-    /**
-     * Build Relay SwapParams + extData from a quote result.
-     * Returns ready-to-use args for `Relay.mintAndSwap`.
-     */
-    buildRelaySwapParams(params: {
-        quote: {
-            path: PathKey[];
-        };
-        minAmountOut: bigint;
-        feeInUsdt: bigint;
-        deadline: bigint;
-    }): {
-        swapParams: SwapParams;
-        extData: Hex;
-    };
-    /**
-     * Encode extData for ReceiverConsent and MintParams.
-     * extData = abi.encode(minAmountOut, feeInUsdt)
-     */
-    encodeExtData(minAmountOut: bigint, feeInUsdt: bigint): Hex;
-    /**
-     * Simulate a Relay.mintAndSwap call. Catches reverts (bad signatures,
-     * expired deadlines, insufficient mint cap, pool errors) before submitting.
-     *
-     * @param relayAddress - Relay contract address
-     * @param mint         - MintParams with real signatures
-     * @param swap         - SwapParams (path + deadline)
-     * @param from         - Relayer address that will submit the tx
-     */
-    simulateMintAndSwap(relayAddress: Address, mint: MintParams, swap: SwapParams, from: Address): Promise<SimulationResult>;
     /**
      * Simulate a UniversalRouter.execute swap call. Catches reverts (bad
      * approvals, insufficient balance, pool errors) before submitting.
@@ -919,14 +1036,9 @@ declare class PafiSDK {
      * @param from          - Address that will execute the swap
      */
     simulateSwap(routerAddress: Address, commands: Hex, inputs: Hex[], deadline: bigint, from: Address): Promise<SwapSimulationResult>;
-    /**
-     * Build an EIP-4361 login message for the current signer + chain. The
-     * caller supplies the issuer-specific fields (domain, nonce, uri); the SDK
-     * fills in the wallet address and chain id from its own config.
-     */
     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, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET as BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA as BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, MOCK_BURN_CONSENT_TYPES as BURN_CONSENT_TYPES, BestQuote, type BuildPartialUserOpParams, type MockBurnConsent as BurnConsent, COMMON_POOLS, COMMON_TOKENS, MOCK_ADDRESSES as CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, LoginMessageParams, MintParams, MintRequest, type ModalOpenOptions, Operation, POINT_TOKEN_POOLS, MOCK_POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, PathKey, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, ReceiverConsent, SUPPORTED_CHAINS, type SignatureStruct, SignatureVerification, SigningError, SimulationError, SimulationResult, type SponsorshipScenario, type SubmissionPath, SwapParams, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, _resetPaymasterConfigForTests, assembleUserOperation, buildMockBurnConsentTypedData as buildBurnConsentTypedData, buildPartialUserOperation, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getMockAddresses as getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, openPafiWebModal, openWebPopup, rawCallOp, receiverConsentTypes, setPafiWebModalAdapter, setPaymasterConfig, signMockBurnConsent as signBurnConsent, verifyMockBurnConsent as verifyBurnConsent, webPopupAdapter };
+export { ApiError, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BestQuote, type BuildPartialUserOpParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, LoginMessageParams, MintRequest, type ModalOpenOptions, Operation, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, POINT_TOKEN_ABI as POINT_TOKEN_V2_ABI, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, ReceiverConsent, SUPPORTED_CHAINS, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SponsorshipScenario, type SubmissionPath, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, _resetPaymasterConfigForTests, assembleUserOperation, buildPartialUserOperation, burnRequestTypes, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, openPafiWebModal, openWebPopup, rawCallOp, receiverConsentTypes, setPafiWebModalAdapter, setPaymasterConfig, webPopupAdapter };