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

package/dist/index.d.cts

@@ -276,90 +276,44 @@ interface CheckEthAndBranchParams {
 declare function checkEthAndBranch(params: CheckEthAndBranchParams): Promise<SubmissionPath>;
 
 /**
- * ⚠️ MOCK — Relayer v2 `mint()` ABI for the v1.4 sponsored flow.
+ * ⚠️ MOCK — `PointToken` v1.4 surface (mint + burn).
  *
- * Signature guess based on stakeholder memo (`REQUIREMENTS_V2.md §3`):
+ * ## Mint (NEW direct flow — no Relayer)
  *
- *   mint(
- *     MintRequest request,      // EIP-712 signed by user + issuer
- *     Signature userSig,        // v, r, s
- *     Signature issuerSig,      // v, r, s
- *     uint256 feeAmount,        // PT units to split off to feeRecipient
- *     address feeRecipient      // typically operator or fee collector
- *   )
+ * 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.
  *
- * Behaviour expected:
- *   - Verify user + issuer EIP-712 signatures against `request`
- *   - Mint `request.amount` PT to `request.to`
- *   - Atomic transfer `feeAmount` from `request.to` → `feeRecipient`
- *     (net mint = `amount - feeAmount`)
- *   - Increment the on-chain nonce to prevent replay
+ * 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.
  *
- * When SC team publishes the real ABI, drop it in under
- * `src/contracts/real/relayerV2.abi.ts` and flip the export in
- * `src/contracts/index.ts` — call sites unchanged.
+ * ## Burn — two variants mocked
  *
- * See [SC_MOCK_PLAN.md §2.1] for the rationale + swap checklist.
+ *   Variant A (simpler, most likely):
+ *     burn(uint256 amount)
+ *     - burns from `msg.sender` (user via EIP-7702)
+ *
+ *   Variant B (signature-based, if SC prefers explicit on-chain consent):
+ *     burnWithSig(BurnConsent consent, Signature sig)
+ *     - verifies EIP-712 signature before burning
+ *
+ * Either way the ERC-20 emits `Transfer(from, address(0), amount)` so
+ * `BurnIndexer` semantics don't change.
  */
-declare const MOCK_RELAYER_V2_ABI: readonly [{
+declare const MOCK_POINT_TOKEN_V2_ABI: readonly [{
     readonly name: "mint";
     readonly type: "function";
     readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly type: "tuple";
-        readonly components: readonly [{
-            readonly type: "address";
-            readonly name: "to";
-        }, {
-            readonly type: "uint256";
-            readonly name: "amount";
-        }, {
-            readonly type: "uint256";
-            readonly name: "feeAmount";
-        }, {
-            readonly type: "address";
-            readonly name: "feeRecipient";
-        }, {
-            readonly type: "uint256";
-            readonly name: "nonce";
-        }, {
-            readonly type: "uint256";
-            readonly name: "deadline";
-        }, {
-            readonly type: "bytes";
-            readonly name: "extData";
-        }];
-        readonly name: "request";
-    }, {
-        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: "userSig";
-    }, {
-        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: "issuerSig";
+        readonly type: "uint256";
+        readonly name: "amount";
     }];
     readonly outputs: readonly [];
 }, {
-    readonly name: "mintRequestNonce";
+    readonly name: "minters";
     readonly type: "function";
     readonly stateMutability: "view";
     readonly inputs: readonly [{
@@ -367,79 +321,9 @@ declare const MOCK_RELAYER_V2_ABI: readonly [{
         readonly name: "user";
     }];
     readonly outputs: readonly [{
-        readonly type: "uint256";
+        readonly type: "bool";
     }];
 }, {
-    readonly name: "Minted";
-    readonly type: "event";
-    readonly inputs: readonly [{
-        readonly type: "address";
-        readonly name: "user";
-        readonly indexed: true;
-    }, {
-        readonly type: "uint256";
-        readonly name: "amount";
-    }, {
-        readonly type: "uint256";
-        readonly name: "feeAmount";
-    }, {
-        readonly type: "address";
-        readonly name: "feeRecipient";
-        readonly indexed: true;
-    }, {
-        readonly type: "bytes32";
-        readonly name: "requestHash";
-    }];
-}];
-/**
- * Calldata function selector for `mint((...),(...),(...))` as encoded
- * by viem against {@link MOCK_RELAYER_V2_ABI}. Callers compare against
- * this to sanity-check decoded UserOp inner calls.
- *
- * Recompute when the real ABI lands — almost certainly differs.
- */
-declare const MOCK_RELAYER_V2_MINT_SELECTOR: "0xMOCKED__";
-/**
- * Struct shape that matches {@link MOCK_RELAYER_V2_ABI}. Exported so
- * builders can accept a typed input without `as const` gymnastics.
- */
-interface MockMintRequestV2 {
-    to: Address;
-    amount: bigint;
-    feeAmount: bigint;
-    feeRecipient: Address;
-    nonce: bigint;
-    deadline: bigint;
-    extData: `0x${string}`;
-}
-interface MockSignatureStruct {
-    v: number;
-    r: `0x${string}`;
-    s: `0x${string}`;
-}
-
-/**
- * ⚠️ MOCK — `PointToken` v1.4 burn surface.
- *
- * Two variants mocked — SC team will pick ONE before stable; the other
- * gets deleted during Phase B swap.
- *
- *   Variant A (simpler, most likely):
- *     burn(uint256 amount)
- *     - burns from `msg.sender`
- *     - caller handles authorization (the user is `msg.sender` via
- *       EIP-7702 delegation, so `msg.sender == user`)
- *
- *   Variant B (signature-based, if SC prefers explicit consent on-chain):
- *     burnWithSig(BurnConsent consent, Signature sig)
- *     - verifies EIP-712 signature before burning
- *     - used when the caller isn't the user (e.g. a relayer burns on
- *       behalf of the user)
- *
- * Either way the ERC-20 emits `Transfer(from, address(0), amount)` so
- * `BurnIndexer` semantics don't change.
- */
-declare const MOCK_POINT_TOKEN_V2_ABI: readonly [{
     readonly name: "burn";
     readonly type: "function";
     readonly stateMutability: "nonpayable";
@@ -565,8 +449,14 @@ declare const MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: Address;
  *   3. Update `src/contracts/index.ts` re-export
  *   4. Delete MOCK_* named exports
  */
+/**
+ * Per-chain contract addresses.
+ *
+ * v1.4 update: `relayerV2` field dropped — flow now calls
+ * `PointToken.mint()` directly via EIP-7702 delegation. No Relayer
+ * contract sits between user and PointToken.
+ */
 interface ContractAddresses {
-    relayerV2: Address;
     pointToken: Address;
     batchExecutor: Address;
     usdt: Address;
@@ -580,96 +470,6 @@ declare const MOCK_ADDRESSES: Record<number, ContractAddresses>;
  */
 declare function getMockAddresses(chainId: number): ContractAddresses;
 
-/**
- * ⚠️ MOCK — `MintRequest` v2 EIP-712 types.
- *
- * Extends v0.2.x `MintRequest` (4 fields) with three new fields needed
- * for the v1.4 sponsored flow:
- *
- *   + feeAmount      PT units taken from the mint for the operator
- *   + feeRecipient   where the fee goes (operator or treasury)
- *   + extData        arbitrary bytes for future extensions (swap path, etc.)
- *
- * When SC team confirms the real struct, drop this file's content into
- * the real builder and remove the MOCK_ prefix. The function signatures
- * below stay stable — only `MOCK_MINT_REQUEST_V2_TYPES` changes.
- */
-declare const MOCK_MINT_REQUEST_V2_TYPES: {
-    readonly MintRequest: readonly [{
-        readonly name: "to";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "feeAmount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "feeRecipient";
-        readonly type: "address";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
-        readonly name: "deadline";
-        readonly type: "uint256";
-    }, {
-        readonly name: "extData";
-        readonly type: "bytes";
-    }];
-};
-/**
- * Build the typed-data envelope that any EIP-712 signer (viem, ethers,
- * Privy) can consume. Callers typically pass the result to
- * `walletClient.signTypedData()` or `privy.signTypedData()`.
- */
-declare function buildMockMintRequestV2TypedData(domain: PointTokenDomainConfig, message: MockMintRequestV2): {
-    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: "feeAmount";
-            readonly type: "uint256";
-        }, {
-            readonly name: "feeRecipient";
-            readonly type: "address";
-        }, {
-            readonly name: "nonce";
-            readonly type: "uint256";
-        }, {
-            readonly name: "deadline";
-            readonly type: "uint256";
-        }, {
-            readonly name: "extData";
-            readonly type: "bytes";
-        }];
-    };
-    primaryType: "MintRequest";
-    message: MockMintRequestV2;
-};
-/**
- * Sign a `MintRequest` v2 with a viem WalletClient — server-side flow
- * where the issuer holds the private key directly (KMS-backed signer
- * is the production path; see `@pafi-dev/issuer` KMSSignerAdapter).
- */
-declare function signMockMintRequestV2(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MockMintRequestV2): Promise<EIP712Signature>;
-/**
- * Verify a `MintRequest` v2 signature and check it came from the
- * expected signer (either user or issuer depending on which side is
- * being verified).
- */
-declare function verifyMockMintRequestV2(domain: PointTokenDomainConfig, message: MockMintRequestV2, signature: Hex, expectedSigner: Address): Promise<SignatureVerification>;
-
 /**
  * ⚠️ MOCK — `BurnConsent` EIP-712 type for the v1.4 reverse flow.
  *
@@ -744,6 +544,47 @@ declare function buildMockBurnConsentTypedData(domain: PointTokenDomainConfig, m
 declare function signMockBurnConsent(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MockBurnConsent): Promise<EIP712Signature>;
 declare function verifyMockBurnConsent(domain: PointTokenDomainConfig, message: MockBurnConsent, signature: Hex, expectedUser: Address): Promise<SignatureVerification>;
 
+/**
+ * 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).
+ *
+ * ## v1.4 update — Relayer removed
+ *
+ * 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.
+ *
+ * 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 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.
+ */
+
+/**
+ * Signature struct shared by `burnWithSig` (and any future EIP-712
+ * verifier on-chain). Exported here so consumers don't need to
+ * redefine it locally.
+ */
+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
@@ -1088,4 +929,4 @@ declare class PafiSDK {
     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, MOCK_MINT_REQUEST_V2_TYPES as MINT_REQUEST_V2_TYPES, MintParams, MintRequest, type MockMintRequestV2 as MintRequestV2, 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, MOCK_RELAYER_V2_ABI as RELAYER_V2_ABI, MOCK_RELAYER_V2_MINT_SELECTOR as RELAYER_V2_MINT_SELECTOR, ReceiverConsent, SUPPORTED_CHAINS, type MockSignatureStruct as SignatureStruct, SignatureVerification, SigningError, SimulationError, SimulationResult, type SponsorshipScenario, type SubmissionPath, SwapParams, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, _resetPaymasterConfigForTests, assembleUserOperation, buildMockBurnConsentTypedData as buildBurnConsentTypedData, buildMockMintRequestV2TypedData as buildMintRequestV2TypedData, buildPartialUserOperation, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getMockAddresses as getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, openPafiWebModal, openWebPopup, rawCallOp, receiverConsentTypes, setPafiWebModalAdapter, setPaymasterConfig, signMockBurnConsent as signBurnConsent, signMockMintRequestV2 as signMintRequestV2, verifyMockBurnConsent as verifyBurnConsent, verifyMockMintRequestV2 as verifyMintRequestV2, webPopupAdapter };
+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 };