@pafi-dev/core 0.3.0-beta.0 → 0.3.0-beta.10

package/dist/eip712/index.d.cts

@@ -1,4 +1,4 @@
-import { a as PointTokenDomainConfig, M as MintRequest, E as EIP712Signature, S as SignatureVerification, R as ReceiverConsent } from '../types-BDOnH5Le.cjs';
+import { b as PointTokenDomainConfig, M as MintRequest, E as EIP712Signature, S as SignatureVerification, c as BurnRequest, R as ReceiverConsent } from '../types-b5_Tokjl.cjs';
 import { WalletClient, Hex, Address } from 'viem';
 
 declare function buildDomain(config: PointTokenDomainConfig): {
@@ -41,6 +41,48 @@ declare function buildMintRequestTypedData(domain: PointTokenDomainConfig, messa
 declare function signMintRequest(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MintRequest): Promise<EIP712Signature>;
 declare function verifyMintRequest(domain: PointTokenDomainConfig, message: MintRequest, signature: Hex, expectedMinter: Address): Promise<SignatureVerification>;
 
+/**
+ * EIP-712 helpers for `BurnRequest` — consumed by the sig-gated burn
+ * path on `PointToken`:
+ *
+ *   burn(address from, uint256 amount, uint256 deadline, bytes burnerSig)
+ *
+ * Solidity type hash:
+ *   BurnRequest(address from,uint256 amount,uint256 nonce,uint256 deadline)
+ *
+ * Issuer backend signs with its burner signer (HSM/KMS). On-chain
+ * `msg.sender` must equal `from`, and the recovered signer must be in
+ * `burners[]`. Nonce comes from `burnRequestNonces[from]` and is
+ * auto-incremented on success.
+ */
+declare function buildBurnRequestTypedData(domain: PointTokenDomainConfig, message: BurnRequest): {
+    domain: {
+        name: string;
+        version: "1";
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+    types: {
+        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";
+        }];
+    };
+    primaryType: "BurnRequest";
+    message: BurnRequest;
+};
+declare function signBurnRequest(walletClient: WalletClient, domain: PointTokenDomainConfig, message: BurnRequest): Promise<EIP712Signature>;
+declare function verifyBurnRequest(domain: PointTokenDomainConfig, message: BurnRequest, signature: Hex, expectedBurner: Address): Promise<SignatureVerification>;
+
 /**
  * Build the EIP-712 typed data object for a ReceiverConsent.
  * Returns the standard `{ domain, types, primaryType, message }` structure
@@ -80,4 +122,4 @@ declare function buildReceiverConsentTypedData(domain: PointTokenDomainConfig, m
 declare function signReceiverConsent(walletClient: WalletClient, domain: PointTokenDomainConfig, message: ReceiverConsent): Promise<EIP712Signature>;
 declare function verifyReceiverConsent(domain: PointTokenDomainConfig, message: ReceiverConsent, signature: Hex, expectedReceiver: Address): Promise<SignatureVerification>;
 
-export { buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signMintRequest, signReceiverConsent, verifyMintRequest, verifyReceiverConsent };
+export { buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signBurnRequest, signMintRequest, signReceiverConsent, verifyBurnRequest, verifyMintRequest, verifyReceiverConsent };

package/dist/eip712/index.d.ts

@@ -1,4 +1,4 @@
-import { a as PointTokenDomainConfig, M as MintRequest, E as EIP712Signature, S as SignatureVerification, R as ReceiverConsent } from '../types-BDOnH5Le.js';
+import { b as PointTokenDomainConfig, M as MintRequest, E as EIP712Signature, S as SignatureVerification, c as BurnRequest, R as ReceiverConsent } from '../types-b5_Tokjl.js';
 import { WalletClient, Hex, Address } from 'viem';
 
 declare function buildDomain(config: PointTokenDomainConfig): {
@@ -41,6 +41,48 @@ declare function buildMintRequestTypedData(domain: PointTokenDomainConfig, messa
 declare function signMintRequest(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MintRequest): Promise<EIP712Signature>;
 declare function verifyMintRequest(domain: PointTokenDomainConfig, message: MintRequest, signature: Hex, expectedMinter: Address): Promise<SignatureVerification>;
 
+/**
+ * EIP-712 helpers for `BurnRequest` — consumed by the sig-gated burn
+ * path on `PointToken`:
+ *
+ *   burn(address from, uint256 amount, uint256 deadline, bytes burnerSig)
+ *
+ * Solidity type hash:
+ *   BurnRequest(address from,uint256 amount,uint256 nonce,uint256 deadline)
+ *
+ * Issuer backend signs with its burner signer (HSM/KMS). On-chain
+ * `msg.sender` must equal `from`, and the recovered signer must be in
+ * `burners[]`. Nonce comes from `burnRequestNonces[from]` and is
+ * auto-incremented on success.
+ */
+declare function buildBurnRequestTypedData(domain: PointTokenDomainConfig, message: BurnRequest): {
+    domain: {
+        name: string;
+        version: "1";
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+    types: {
+        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";
+        }];
+    };
+    primaryType: "BurnRequest";
+    message: BurnRequest;
+};
+declare function signBurnRequest(walletClient: WalletClient, domain: PointTokenDomainConfig, message: BurnRequest): Promise<EIP712Signature>;
+declare function verifyBurnRequest(domain: PointTokenDomainConfig, message: BurnRequest, signature: Hex, expectedBurner: Address): Promise<SignatureVerification>;
+
 /**
  * Build the EIP-712 typed data object for a ReceiverConsent.
  * Returns the standard `{ domain, types, primaryType, message }` structure
@@ -80,4 +122,4 @@ declare function buildReceiverConsentTypedData(domain: PointTokenDomainConfig, m
 declare function signReceiverConsent(walletClient: WalletClient, domain: PointTokenDomainConfig, message: ReceiverConsent): Promise<EIP712Signature>;
 declare function verifyReceiverConsent(domain: PointTokenDomainConfig, message: ReceiverConsent, signature: Hex, expectedReceiver: Address): Promise<SignatureVerification>;
 
-export { buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signMintRequest, signReceiverConsent, verifyMintRequest, verifyReceiverConsent };
+export { buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signBurnRequest, signMintRequest, signReceiverConsent, verifyBurnRequest, verifyMintRequest, verifyReceiverConsent };

package/dist/eip712/index.js

@@ -1,19 +1,25 @@
 import {
+  buildBurnRequestTypedData,
   buildDomain,
   buildMintRequestTypedData,
   buildReceiverConsentTypedData,
+  signBurnRequest,
   signMintRequest,
   signReceiverConsent,
+  verifyBurnRequest,
   verifyMintRequest,
   verifyReceiverConsent
-} from "../chunk-C4ZDYG4D.js";
-import "../chunk-R4L66ZR5.js";
+} from "../chunk-DUY7Z2AI.js";
+import "../chunk-73CQTNLB.js";
 export {
+  buildBurnRequestTypedData,
   buildDomain,
   buildMintRequestTypedData,
   buildReceiverConsentTypedData,
+  signBurnRequest,
   signMintRequest,
   signReceiverConsent,
+  verifyBurnRequest,
   verifyMintRequest,
   verifyReceiverConsent
 };

package/dist/index-B06IJlHe.d.ts

@@ -0,0 +1,244 @@
+import { Address, Hex, PublicClient } from 'viem';
+import { Q as QuoteResult, d as PathKey } from './types-b5_Tokjl.js';
+
+declare function checkAllowance(client: PublicClient, token: Address, owner: Address, spender: Address): Promise<bigint>;
+/**
+ * Encode an ERC-20 approve(spender, amount) call.
+ */
+declare function buildErc20ApprovalCalldata(spender: Address, amount: bigint): Hex;
+/**
+ * Encode a Permit2 approve(token, spender, amount, expiration) call.
+ */
+declare function buildPermit2ApprovalCalldata(token: Address, spender: Address, amount: bigint, expiration: number): Hex;
+
+/** UniversalRouter command byte for V4 swap */
+declare const V4_SWAP: 16;
+declare const SWAP_EXACT_IN: 7;
+declare const SETTLE_ALL: 12;
+declare const TAKE_ALL: 15;
+/**
+ * Build the calldata inputs[0] (the V4_SWAP command payload) for
+ * UniversalRouter.execute.
+ *
+ * Actions encoded: SWAP_EXACT_IN → SETTLE_ALL → TAKE_ALL
+ *
+ * Encoding matches the Uniswap V4 SDK's V4Planner — each action's params
+ * are individually ABI-encoded, then wrapped together with the action bytes.
+ */
+declare function buildV4SwapInput(currencyIn: Address, path: PathKey[], amountIn: bigint, minAmountOut: bigint, outputCurrency: Address): Hex;
+/**
+ * Build the full commands + inputs args for UniversalRouter.execute.
+ */
+declare function buildUniversalRouterExecuteArgs(currencyIn: Address, path: PathKey[], amountIn: bigint, minAmountOut: bigint, outputCurrency: Address): {
+    commands: Hex;
+    inputs: Hex[];
+};
+/**
+ * Build UniversalRouter execute args from a quote result.
+ *
+ * Takes the output of `findBestQuote` / `quoteBestRoute` and produces
+ * ready-to-use `{ commands, inputs }` for `UniversalRouter.execute`.
+ *
+ * @param quote        - Quote result containing the path
+ * @param currencyIn   - Input token address
+ * @param currencyOut  - Output token address
+ * @param amountIn     - Exact input amount (same value passed to the quoter)
+ * @param minAmountOut - Minimum acceptable output (caller applies slippage)
+ *
+ * @deprecated Since v1.4 — the Issuer App no longer handles swaps.
+ * For the new PT→USDT batch call on PAFI Web (Scenario 4 with
+ * EIP-7702 gas deduction), use `buildSwapWithGasDeduction()` (v1.5).
+ * This helper is kept for legacy v0.2.x consumers; will be removed in v2.0.
+ */
+declare function buildSwapFromQuote(params: {
+    quote: QuoteResult;
+    currencyIn: Address;
+    currencyOut: Address;
+    amountIn: bigint;
+    minAmountOut: bigint;
+}): {
+    commands: Hex;
+    inputs: Hex[];
+};
+
+interface SwapSimulationResult {
+    success: boolean;
+    gasEstimate: bigint;
+}
+/**
+ * Simulate a UniversalRouter.execute swap call via eth_call (no gas spent).
+ *
+ * Runs the full V4 swap flow — token transfer via Permit2, swap via
+ * PoolManager, output settlement — without submitting a transaction.
+ * If the simulation reverts, throws a `SimulationError` with the reason.
+ *
+ * @param client        - viem PublicClient
+ * @param routerAddress - UniversalRouter contract address
+ * @param commands      - Packed command bytes (from buildSwapFromQuote)
+ * @param inputs        - Encoded inputs per command (from buildSwapFromQuote)
+ * @param deadline      - Unix timestamp after which the tx expires
+ * @param from          - Address that will execute the swap
+ */
+declare function simulateSwap(client: PublicClient, routerAddress: Address, commands: Hex, inputs: Hex[], deadline: bigint, from: Address): Promise<SwapSimulationResult>;
+
+/**
+ * ERC-4337 v0.7 EntryPoint standard address (deployed deterministically
+ * at the same address across chains).
+ * https://eips.ethereum.org/EIPS/eip-4337
+ */
+declare const ENTRY_POINT_V07: Address;
+/**
+ * A single call inside a batch. `BatchExecutor.execute(Call[])` iterates
+ * and invokes each one. When the batch runs via EIP-7702 delegation,
+ * `msg.sender` for each call is the user's EOA.
+ */
+interface Operation {
+    target: Address;
+    value: bigint;
+    data: Hex;
+}
+/**
+ * Paymaster fields attached to a UserOperation. Populated by the
+ * Coinbase Paymaster (via PAFI Backend proxy) before the user signs.
+ */
+interface PaymasterFields {
+    paymaster: Address;
+    paymasterData: Hex;
+    paymasterVerificationGasLimit: bigint;
+    paymasterPostOpGasLimit: bigint;
+}
+/**
+ * Partial UserOp used during preparation — before paymaster fields are
+ * attached or the user signs.
+ */
+interface PartialUserOperation {
+    sender: Address;
+    nonce: bigint;
+    callData: Hex;
+    callGasLimit: bigint;
+    verificationGasLimit: bigint;
+    preVerificationGas: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}
+/**
+ * Full ERC-4337 v0.7 UserOperation, ready for bundler submission.
+ */
+interface UserOperation extends PartialUserOperation {
+    paymaster: Address;
+    paymasterData: Hex;
+    paymasterVerificationGasLimit: bigint;
+    paymasterPostOpGasLimit: bigint;
+    signature: Hex;
+}
+/**
+ * Receipt returned by a bundler after a UserOp lands on-chain.
+ */
+interface UserOpReceipt {
+    userOpHash: Hex;
+    success: boolean;
+    txHash: Hex;
+    blockNumber: bigint;
+    gasUsed: bigint;
+    /** Effective gas cost paid (wei). */
+    actualGasCost: bigint;
+}
+/**
+ * Sentinel operation value used in tests + docs when `Operation.value`
+ * is irrelevant (ERC-20 transfers, for example).
+ */
+declare const ZERO_VALUE = 0n;
+
+/**
+ * v1.5 — Scenario 4: Swap PT → USDT on PAFI Web with **gas fee
+ * deducted in PT** from the user's balance.
+ *
+ * Builds an unsigned `PartialUserOperation` that packages three inner
+ * calls into a single `BatchExecutor.execute(calls[])`:
+ *
+ *   1. `PT.approve(UniversalRouter, amountIn)` — let the router pull
+ *      `amountIn` PT for the swap
+ *   2. `UniversalRouter.execute(commands, inputs, deadline)` — V4 swap
+ *      PT → USDT, user receives `minAmountOut` USDT
+ *   3. `PT.transfer(feeRecipient, gasFeePt)` — pay the operator back
+ *      for sponsoring the gas, in PT (application-level recovery —
+ *      no custom paymaster contract needed)
+ *
+ * The user's wallet must hold `amountIn + gasFeePt` PT **before** the
+ * UserOp runs. The three inner calls execute atomically via
+ * EIP-7702 delegation (`msg.sender = user`), so a reverting swap
+ * unwinds the approve + fee transfer too.
+ *
+ * ## Fee model
+ *
+ * Exact-out on the **USDT side** is not attempted here. The user
+ * specifies `amountIn` PT for the swap; the minimum USDT out comes
+ * from a separate quote (not this function). The gas fee is a
+ * separate `transfer` call — it does NOT come out of the swap's USDT
+ * output, because that output goes straight to the user's wallet with
+ * no intermediate hook to skim from.
+ *
+ * If the FE wants "user receives exactly X USDT after gas", it should:
+ *   1. Quote PT→USDT for candidate `amountIn` values
+ *   2. Pick an `amountIn` where `minAmountOut ≈ X`
+ *   3. Separately compute `gasFeePt` from the operator's rate
+ *   4. Ensure user's PT balance ≥ `amountIn + gasFeePt`
+ *
+ * ## Order of operations
+ *
+ * Approve → swap → fee transfer. The fee transfer comes **last** so
+ * if the swap reverts, the user is also refunded the fee (atomic
+ * batch revert). Doing fee transfer first would still unwind on
+ * revert, but ordering it last matches the intuitive "only charge
+ * gas on success" semantics.
+ */
+interface BuildSwapWithGasDeductionParams {
+    /** User's EOA (with EIP-7702 delegation to BatchExecutor). */
+    userAddress: Address;
+    /** ERC-4337 account nonce — fetched from EntryPoint by the caller. */
+    aaNonce: bigint;
+    /** PT token address being swapped. */
+    pointTokenAddress: Address;
+    /** Destination currency (typically USDT). */
+    outputTokenAddress: Address;
+    /** UniversalRouter contract address (chain-specific). */
+    universalRouterAddress: Address;
+    /** PT units to swap. User's balance must be ≥ `amountIn + gasFeePt`. */
+    amountIn: bigint;
+    /**
+     * Minimum USDT to accept out of the swap. Caller applies slippage
+     * (typically ~0.5-1%) against a fresh quote. Sub-minimum swap reverts.
+     */
+    minAmountOut: bigint;
+    /** V4 pool path for the swap. Single-hop = 1 PathKey. */
+    swapPath: PathKey[];
+    /** Unix seconds. After this, the router rejects the swap. */
+    deadline: bigint;
+    /** PT amount transferred to `feeRecipient` as gas fee recovery. */
+    gasFeePt: bigint;
+    /** Where the gas fee lands — typically the operator or fee collector. */
+    feeRecipient: Address;
+    /**
+     * Optional — pre-signed Permit2 / EIP-2612 approval. If omitted, a
+     * standard `approve()` call is appended as the first batch op.
+     * Future work: support Permit2 so the approve is part of the swap
+     * input rather than a separate call.
+     */
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+/**
+ * Build an unsigned UserOp for Scenario 4. Returns a
+ * `PartialUserOperation` — caller attaches paymaster sponsorship (via
+ * `POST /api/paymaster/sponsor`), adds the user's UserOp-hash
+ * signature, and submits to the Bundler.
+ *
+ * @throws when `amountIn` or `gasFeePt` is not positive, or when
+ *   `swapPath` is empty (at least one PathKey required).
+ */
+declare function buildSwapWithGasDeduction(params: BuildSwapWithGasDeductionParams): PartialUserOperation;
+
+export { type BuildSwapWithGasDeductionParams as B, ENTRY_POINT_V07 as E, type Operation as O, type PartialUserOperation as P, type SwapSimulationResult as S, TAKE_ALL as T, type UserOperation as U, V4_SWAP as V, ZERO_VALUE as Z, type PaymasterFields as a, SETTLE_ALL as b, SWAP_EXACT_IN as c, type UserOpReceipt as d, buildErc20ApprovalCalldata as e, buildPermit2ApprovalCalldata as f, buildSwapFromQuote as g, buildSwapWithGasDeduction as h, buildUniversalRouterExecuteArgs as i, buildV4SwapInput as j, checkAllowance as k, simulateSwap as s };

package/dist/index-B7pGBych.d.cts

@@ -0,0 +1,244 @@
+import { Address, Hex, PublicClient } from 'viem';
+import { Q as QuoteResult, d as PathKey } from './types-b5_Tokjl.cjs';
+
+declare function checkAllowance(client: PublicClient, token: Address, owner: Address, spender: Address): Promise<bigint>;
+/**
+ * Encode an ERC-20 approve(spender, amount) call.
+ */
+declare function buildErc20ApprovalCalldata(spender: Address, amount: bigint): Hex;
+/**
+ * Encode a Permit2 approve(token, spender, amount, expiration) call.
+ */
+declare function buildPermit2ApprovalCalldata(token: Address, spender: Address, amount: bigint, expiration: number): Hex;
+
+/** UniversalRouter command byte for V4 swap */
+declare const V4_SWAP: 16;
+declare const SWAP_EXACT_IN: 7;
+declare const SETTLE_ALL: 12;
+declare const TAKE_ALL: 15;
+/**
+ * Build the calldata inputs[0] (the V4_SWAP command payload) for
+ * UniversalRouter.execute.
+ *
+ * Actions encoded: SWAP_EXACT_IN → SETTLE_ALL → TAKE_ALL
+ *
+ * Encoding matches the Uniswap V4 SDK's V4Planner — each action's params
+ * are individually ABI-encoded, then wrapped together with the action bytes.
+ */
+declare function buildV4SwapInput(currencyIn: Address, path: PathKey[], amountIn: bigint, minAmountOut: bigint, outputCurrency: Address): Hex;
+/**
+ * Build the full commands + inputs args for UniversalRouter.execute.
+ */
+declare function buildUniversalRouterExecuteArgs(currencyIn: Address, path: PathKey[], amountIn: bigint, minAmountOut: bigint, outputCurrency: Address): {
+    commands: Hex;
+    inputs: Hex[];
+};
+/**
+ * Build UniversalRouter execute args from a quote result.
+ *
+ * Takes the output of `findBestQuote` / `quoteBestRoute` and produces
+ * ready-to-use `{ commands, inputs }` for `UniversalRouter.execute`.
+ *
+ * @param quote        - Quote result containing the path
+ * @param currencyIn   - Input token address
+ * @param currencyOut  - Output token address
+ * @param amountIn     - Exact input amount (same value passed to the quoter)
+ * @param minAmountOut - Minimum acceptable output (caller applies slippage)
+ *
+ * @deprecated Since v1.4 — the Issuer App no longer handles swaps.
+ * For the new PT→USDT batch call on PAFI Web (Scenario 4 with
+ * EIP-7702 gas deduction), use `buildSwapWithGasDeduction()` (v1.5).
+ * This helper is kept for legacy v0.2.x consumers; will be removed in v2.0.
+ */
+declare function buildSwapFromQuote(params: {
+    quote: QuoteResult;
+    currencyIn: Address;
+    currencyOut: Address;
+    amountIn: bigint;
+    minAmountOut: bigint;
+}): {
+    commands: Hex;
+    inputs: Hex[];
+};
+
+interface SwapSimulationResult {
+    success: boolean;
+    gasEstimate: bigint;
+}
+/**
+ * Simulate a UniversalRouter.execute swap call via eth_call (no gas spent).
+ *
+ * Runs the full V4 swap flow — token transfer via Permit2, swap via
+ * PoolManager, output settlement — without submitting a transaction.
+ * If the simulation reverts, throws a `SimulationError` with the reason.
+ *
+ * @param client        - viem PublicClient
+ * @param routerAddress - UniversalRouter contract address
+ * @param commands      - Packed command bytes (from buildSwapFromQuote)
+ * @param inputs        - Encoded inputs per command (from buildSwapFromQuote)
+ * @param deadline      - Unix timestamp after which the tx expires
+ * @param from          - Address that will execute the swap
+ */
+declare function simulateSwap(client: PublicClient, routerAddress: Address, commands: Hex, inputs: Hex[], deadline: bigint, from: Address): Promise<SwapSimulationResult>;
+
+/**
+ * ERC-4337 v0.7 EntryPoint standard address (deployed deterministically
+ * at the same address across chains).
+ * https://eips.ethereum.org/EIPS/eip-4337
+ */
+declare const ENTRY_POINT_V07: Address;
+/**
+ * A single call inside a batch. `BatchExecutor.execute(Call[])` iterates
+ * and invokes each one. When the batch runs via EIP-7702 delegation,
+ * `msg.sender` for each call is the user's EOA.
+ */
+interface Operation {
+    target: Address;
+    value: bigint;
+    data: Hex;
+}
+/**
+ * Paymaster fields attached to a UserOperation. Populated by the
+ * Coinbase Paymaster (via PAFI Backend proxy) before the user signs.
+ */
+interface PaymasterFields {
+    paymaster: Address;
+    paymasterData: Hex;
+    paymasterVerificationGasLimit: bigint;
+    paymasterPostOpGasLimit: bigint;
+}
+/**
+ * Partial UserOp used during preparation — before paymaster fields are
+ * attached or the user signs.
+ */
+interface PartialUserOperation {
+    sender: Address;
+    nonce: bigint;
+    callData: Hex;
+    callGasLimit: bigint;
+    verificationGasLimit: bigint;
+    preVerificationGas: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}
+/**
+ * Full ERC-4337 v0.7 UserOperation, ready for bundler submission.
+ */
+interface UserOperation extends PartialUserOperation {
+    paymaster: Address;
+    paymasterData: Hex;
+    paymasterVerificationGasLimit: bigint;
+    paymasterPostOpGasLimit: bigint;
+    signature: Hex;
+}
+/**
+ * Receipt returned by a bundler after a UserOp lands on-chain.
+ */
+interface UserOpReceipt {
+    userOpHash: Hex;
+    success: boolean;
+    txHash: Hex;
+    blockNumber: bigint;
+    gasUsed: bigint;
+    /** Effective gas cost paid (wei). */
+    actualGasCost: bigint;
+}
+/**
+ * Sentinel operation value used in tests + docs when `Operation.value`
+ * is irrelevant (ERC-20 transfers, for example).
+ */
+declare const ZERO_VALUE = 0n;
+
+/**
+ * v1.5 — Scenario 4: Swap PT → USDT on PAFI Web with **gas fee
+ * deducted in PT** from the user's balance.
+ *
+ * Builds an unsigned `PartialUserOperation` that packages three inner
+ * calls into a single `BatchExecutor.execute(calls[])`:
+ *
+ *   1. `PT.approve(UniversalRouter, amountIn)` — let the router pull
+ *      `amountIn` PT for the swap
+ *   2. `UniversalRouter.execute(commands, inputs, deadline)` — V4 swap
+ *      PT → USDT, user receives `minAmountOut` USDT
+ *   3. `PT.transfer(feeRecipient, gasFeePt)` — pay the operator back
+ *      for sponsoring the gas, in PT (application-level recovery —
+ *      no custom paymaster contract needed)
+ *
+ * The user's wallet must hold `amountIn + gasFeePt` PT **before** the
+ * UserOp runs. The three inner calls execute atomically via
+ * EIP-7702 delegation (`msg.sender = user`), so a reverting swap
+ * unwinds the approve + fee transfer too.
+ *
+ * ## Fee model
+ *
+ * Exact-out on the **USDT side** is not attempted here. The user
+ * specifies `amountIn` PT for the swap; the minimum USDT out comes
+ * from a separate quote (not this function). The gas fee is a
+ * separate `transfer` call — it does NOT come out of the swap's USDT
+ * output, because that output goes straight to the user's wallet with
+ * no intermediate hook to skim from.
+ *
+ * If the FE wants "user receives exactly X USDT after gas", it should:
+ *   1. Quote PT→USDT for candidate `amountIn` values
+ *   2. Pick an `amountIn` where `minAmountOut ≈ X`
+ *   3. Separately compute `gasFeePt` from the operator's rate
+ *   4. Ensure user's PT balance ≥ `amountIn + gasFeePt`
+ *
+ * ## Order of operations
+ *
+ * Approve → swap → fee transfer. The fee transfer comes **last** so
+ * if the swap reverts, the user is also refunded the fee (atomic
+ * batch revert). Doing fee transfer first would still unwind on
+ * revert, but ordering it last matches the intuitive "only charge
+ * gas on success" semantics.
+ */
+interface BuildSwapWithGasDeductionParams {
+    /** User's EOA (with EIP-7702 delegation to BatchExecutor). */
+    userAddress: Address;
+    /** ERC-4337 account nonce — fetched from EntryPoint by the caller. */
+    aaNonce: bigint;
+    /** PT token address being swapped. */
+    pointTokenAddress: Address;
+    /** Destination currency (typically USDT). */
+    outputTokenAddress: Address;
+    /** UniversalRouter contract address (chain-specific). */
+    universalRouterAddress: Address;
+    /** PT units to swap. User's balance must be ≥ `amountIn + gasFeePt`. */
+    amountIn: bigint;
+    /**
+     * Minimum USDT to accept out of the swap. Caller applies slippage
+     * (typically ~0.5-1%) against a fresh quote. Sub-minimum swap reverts.
+     */
+    minAmountOut: bigint;
+    /** V4 pool path for the swap. Single-hop = 1 PathKey. */
+    swapPath: PathKey[];
+    /** Unix seconds. After this, the router rejects the swap. */
+    deadline: bigint;
+    /** PT amount transferred to `feeRecipient` as gas fee recovery. */
+    gasFeePt: bigint;
+    /** Where the gas fee lands — typically the operator or fee collector. */
+    feeRecipient: Address;
+    /**
+     * Optional — pre-signed Permit2 / EIP-2612 approval. If omitted, a
+     * standard `approve()` call is appended as the first batch op.
+     * Future work: support Permit2 so the approve is part of the swap
+     * input rather than a separate call.
+     */
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+/**
+ * Build an unsigned UserOp for Scenario 4. Returns a
+ * `PartialUserOperation` — caller attaches paymaster sponsorship (via
+ * `POST /api/paymaster/sponsor`), adds the user's UserOp-hash
+ * signature, and submits to the Bundler.
+ *
+ * @throws when `amountIn` or `gasFeePt` is not positive, or when
+ *   `swapPath` is empty (at least one PathKey required).
+ */
+declare function buildSwapWithGasDeduction(params: BuildSwapWithGasDeductionParams): PartialUserOperation;
+
+export { type BuildSwapWithGasDeductionParams as B, ENTRY_POINT_V07 as E, type Operation as O, type PartialUserOperation as P, type SwapSimulationResult as S, TAKE_ALL as T, type UserOperation as U, V4_SWAP as V, ZERO_VALUE as Z, type PaymasterFields as a, SETTLE_ALL as b, SWAP_EXACT_IN as c, type UserOpReceipt as d, buildErc20ApprovalCalldata as e, buildPermit2ApprovalCalldata as f, buildSwapFromQuote as g, buildSwapWithGasDeduction as h, buildUniversalRouterExecuteArgs as i, buildV4SwapInput as j, checkAllowance as k, simulateSwap as s };