@pafi-dev/core 0.5.22 → 0.6.1

package/dist/index-DKtVEoRC.d.ts

@@ -1,227 +0,0 @@
-import { Address, Hex, PublicClient } from 'viem';
-import { Q as QuoteResult, d as PathKey } from './types-JyuXUM8C.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>;
-
-/**
- * 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 up to four
- * inner calls into a single `BatchExecutor.execute(calls[])`:
- *
- *   1. `PT.approve(Permit2, amountIn)` — grant Permit2 ERC-20 allowance
- *   2. `Permit2.approve(PT, router, amountIn, deadline)` — authorize
- *      the UniversalRouter to pull PT via Permit2
- *   3. `UniversalRouter.execute(commands, inputs, deadline)` — V4 swap
- *      PT → USDT; user receives ≥ `minAmountOut` USDT
- *   4. `PT.transfer(feeRecipient, gasFeePt)` — pay the operator back
- *      for sponsoring the gas, in PT (omitted when `gasFeePt` is 0)
- *
- * The user's wallet must hold `amountIn + gasFeePt` PT before the
- * UserOp runs. All inner calls execute atomically via EIP-7702
- * delegation (`msg.sender = user`), so a reverting swap unwinds
- * the approvals and fee transfer too.
- *
- * ## Fee model
- *
- * The gas fee is a separate `transfer` after the swap — it does NOT
- * come out of the USDT output, because that output goes straight to
- * the user's wallet with no intermediate hook.
- *
- * If the FE wants "user receives exactly X USDT after gas":
- *   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
- *
- * Fee transfer is last so a reverting swap also refunds the fee
- * (atomic batch revert 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;
-    /** Override ERC-4337 gas estimates. Defaults are conservative; tune down for cheaper UserOps. */
-    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, 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/quoting/index.cjs

@@ -1,19 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-var _chunkL5UHQQVCcjs = require('../chunk-L5UHQQVC.cjs');
-require('../chunk-CL3QSI4O.cjs');
-require('../chunk-X2JZFK4C.cjs');
-
-
-
-
-
-
-
-exports.buildAllPaths = _chunkL5UHQQVCcjs.buildAllPaths; exports.combineRoutes = _chunkL5UHQQVCcjs.combineRoutes; exports.findBestQuote = _chunkL5UHQQVCcjs.findBestQuote; exports.quoteBestRoute = _chunkL5UHQQVCcjs.quoteBestRoute; exports.quoteExactInput = _chunkL5UHQQVCcjs.quoteExactInput; exports.quoteExactInputSingle = _chunkL5UHQQVCcjs.quoteExactInputSingle;
-//# sourceMappingURL=index.cjs.map

package/dist/quoting/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/phitran/Pacific-Finance/pafi-backend/pafi-sdk/packages/core/dist/quoting/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACF,2WAAC","file":"/Users/phitran/Pacific-Finance/pafi-backend/pafi-sdk/packages/core/dist/quoting/index.cjs"}

package/dist/quoting/index.d.cts

@@ -1,59 +0,0 @@
-import { Address, PublicClient } from 'viem';
-import { P as PoolKey, d as PathKey, B as BestQuote, Q as QuoteResult } from '../types-JyuXUM8C.cjs';
-
-/**
- * Combine point-token-specific pools and common pools for a given chain.
- * Point token pools are listed first so callers can prioritise them.
- */
-declare function combineRoutes(chainId: number, pointTokenAddress: Address): PoolKey[];
-/**
- * Build all possible swap paths from `tokenIn` to `tokenOut` using the given
- * pools. Returns an array of PathKey[] routes (each up to `maxHops` hops).
- *
- * Supports both direct single-hop routes and multi-hop routes through
- * intermediate tokens. Each pool is used at most once per path.
- *
- * @param pools    - Available pools to route through
- * @param tokenIn  - Input token address
- * @param tokenOut - Desired output token address
- * @param maxHops  - Maximum number of hops (default 3)
- */
-declare function buildAllPaths(pools: PoolKey[], tokenIn: Address, tokenOut: Address, maxHops?: number): PathKey[][];
-
-/**
- * Quote exact-input for a multi-hop path.
- */
-declare function quoteExactInput(client: PublicClient, quoterAddress: Address, exactCurrency: Address, path: PathKey[], exactAmount: bigint): Promise<QuoteResult>;
-/**
- * Quote exact-input for a single-hop swap, given an explicit PoolKey and direction.
- */
-declare function quoteExactInputSingle(client: PublicClient, quoterAddress: Address, poolKey: PoolKey, zeroForOne: boolean, exactAmount: bigint, hookData: `0x${string}`): Promise<{
-    amountOut: bigint;
-    gasEstimate: bigint;
-}>;
-/**
- * Try multiple PathKey[] routes and return the best quote plus all results.
- * Routes that fail (e.g. pool does not exist) are silently skipped.
- *
- * Uses viem multicall to batch all quotes into a single RPC call for speed.
- */
-declare function quoteBestRoute(client: PublicClient, quoterAddress: Address, exactCurrency: Address, routes: PathKey[][], exactAmount: bigint): Promise<BestQuote>;
-/**
- * Find and quote the best swap route from `tokenIn` to `tokenOut`.
- *
- * Combines the caller's `pools` with `COMMON_POOLS[chainId]`, builds all
- * possible paths (up to `maxHops`), then quotes them all via a single
- * multicall and returns the best result.
- *
- * @param client         - viem PublicClient
- * @param chainId        - Chain ID (used to look up COMMON_POOLS and V4_QUOTER_ADDRESSES)
- * @param tokenIn        - Input token address
- * @param tokenOut       - Desired output token address
- * @param exactAmount    - Exact input amount
- * @param pools          - Additional pools to consider (e.g. point-token-specific)
- * @param quoterAddress  - Override the default V4 Quoter address for this chain
- * @param maxHops        - Maximum number of hops per path (default 3)
- */
-declare function findBestQuote(client: PublicClient, chainId: number, tokenIn: Address, tokenOut: Address, exactAmount: bigint, pools?: PoolKey[], quoterAddress?: Address, maxHops?: number): Promise<BestQuote>;
-
-export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle };

package/dist/quoting/index.d.ts

@@ -1,59 +0,0 @@
-import { Address, PublicClient } from 'viem';
-import { P as PoolKey, d as PathKey, B as BestQuote, Q as QuoteResult } from '../types-JyuXUM8C.js';
-
-/**
- * Combine point-token-specific pools and common pools for a given chain.
- * Point token pools are listed first so callers can prioritise them.
- */
-declare function combineRoutes(chainId: number, pointTokenAddress: Address): PoolKey[];
-/**
- * Build all possible swap paths from `tokenIn` to `tokenOut` using the given
- * pools. Returns an array of PathKey[] routes (each up to `maxHops` hops).
- *
- * Supports both direct single-hop routes and multi-hop routes through
- * intermediate tokens. Each pool is used at most once per path.
- *
- * @param pools    - Available pools to route through
- * @param tokenIn  - Input token address
- * @param tokenOut - Desired output token address
- * @param maxHops  - Maximum number of hops (default 3)
- */
-declare function buildAllPaths(pools: PoolKey[], tokenIn: Address, tokenOut: Address, maxHops?: number): PathKey[][];
-
-/**
- * Quote exact-input for a multi-hop path.
- */
-declare function quoteExactInput(client: PublicClient, quoterAddress: Address, exactCurrency: Address, path: PathKey[], exactAmount: bigint): Promise<QuoteResult>;
-/**
- * Quote exact-input for a single-hop swap, given an explicit PoolKey and direction.
- */
-declare function quoteExactInputSingle(client: PublicClient, quoterAddress: Address, poolKey: PoolKey, zeroForOne: boolean, exactAmount: bigint, hookData: `0x${string}`): Promise<{
-    amountOut: bigint;
-    gasEstimate: bigint;
-}>;
-/**
- * Try multiple PathKey[] routes and return the best quote plus all results.
- * Routes that fail (e.g. pool does not exist) are silently skipped.
- *
- * Uses viem multicall to batch all quotes into a single RPC call for speed.
- */
-declare function quoteBestRoute(client: PublicClient, quoterAddress: Address, exactCurrency: Address, routes: PathKey[][], exactAmount: bigint): Promise<BestQuote>;
-/**
- * Find and quote the best swap route from `tokenIn` to `tokenOut`.
- *
- * Combines the caller's `pools` with `COMMON_POOLS[chainId]`, builds all
- * possible paths (up to `maxHops`), then quotes them all via a single
- * multicall and returns the best result.
- *
- * @param client         - viem PublicClient
- * @param chainId        - Chain ID (used to look up COMMON_POOLS and V4_QUOTER_ADDRESSES)
- * @param tokenIn        - Input token address
- * @param tokenOut       - Desired output token address
- * @param exactAmount    - Exact input amount
- * @param pools          - Additional pools to consider (e.g. point-token-specific)
- * @param quoterAddress  - Override the default V4 Quoter address for this chain
- * @param maxHops        - Maximum number of hops per path (default 3)
- */
-declare function findBestQuote(client: PublicClient, chainId: number, tokenIn: Address, tokenOut: Address, exactAmount: bigint, pools?: PoolKey[], quoterAddress?: Address, maxHops?: number): Promise<BestQuote>;
-
-export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle };

package/dist/quoting/index.js

@@ -1,19 +0,0 @@
-import {
-  buildAllPaths,
-  combineRoutes,
-  findBestQuote,
-  quoteBestRoute,
-  quoteExactInput,
-  quoteExactInputSingle
-} from "../chunk-WAFUL62X.js";
-import "../chunk-KFWZRL7I.js";
-import "../chunk-Y3HMGOYW.js";
-export {
-  buildAllPaths,
-  combineRoutes,
-  findBestQuote,
-  quoteBestRoute,
-  quoteExactInput,
-  quoteExactInputSingle
-};
-//# sourceMappingURL=index.js.map

package/dist/quoting/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/swap/index.cjs

@@ -1,31 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-
-
-
-
-
-var _chunkJJ2LGENOcjs = require('../chunk-JJ2LGENO.cjs');
-require('../chunk-IPXARZ6F.cjs');
-require('../chunk-X2JZFK4C.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.SETTLE_ALL = _chunkJJ2LGENOcjs.SETTLE_ALL; exports.SWAP_EXACT_IN = _chunkJJ2LGENOcjs.SWAP_EXACT_IN; exports.TAKE_ALL = _chunkJJ2LGENOcjs.TAKE_ALL; exports.V4_SWAP = _chunkJJ2LGENOcjs.V4_SWAP; exports.buildErc20ApprovalCalldata = _chunkJJ2LGENOcjs.buildErc20ApprovalCalldata; exports.buildPermit2ApprovalCalldata = _chunkJJ2LGENOcjs.buildPermit2ApprovalCalldata; exports.buildSwapFromQuote = _chunkJJ2LGENOcjs.buildSwapFromQuote; exports.buildSwapWithGasDeduction = _chunkJJ2LGENOcjs.buildSwapWithGasDeduction; exports.buildUniversalRouterExecuteArgs = _chunkJJ2LGENOcjs.buildUniversalRouterExecuteArgs; exports.buildV4SwapInput = _chunkJJ2LGENOcjs.buildV4SwapInput; exports.checkAllowance = _chunkJJ2LGENOcjs.checkAllowance; exports.simulateSwap = _chunkJJ2LGENOcjs.simulateSwap;
-//# sourceMappingURL=index.cjs.map

package/dist/swap/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/phitran/Pacific-Finance/pafi-backend/pafi-sdk/packages/core/dist/swap/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,mxBAAC","file":"/Users/phitran/Pacific-Finance/pafi-backend/pafi-sdk/packages/core/dist/swap/index.cjs"}

package/dist/swap/index.d.cts

@@ -1,3 +0,0 @@
-export { B as BuildSwapWithGasDeductionParams, b as SETTLE_ALL, c as SWAP_EXACT_IN, S as SwapSimulationResult, T as TAKE_ALL, V as V4_SWAP, 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-3C_HdEIm.cjs';
-import 'viem';
-import '../types-JyuXUM8C.cjs';

package/dist/swap/index.d.ts

@@ -1,3 +0,0 @@
-export { B as BuildSwapWithGasDeductionParams, b as SETTLE_ALL, c as SWAP_EXACT_IN, S as SwapSimulationResult, T as TAKE_ALL, V as V4_SWAP, 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-DKtVEoRC.js';
-import 'viem';
-import '../types-JyuXUM8C.js';

package/dist/swap/index.js

@@ -1,31 +0,0 @@
-import {
-  SETTLE_ALL,
-  SWAP_EXACT_IN,
-  TAKE_ALL,
-  V4_SWAP,
-  buildErc20ApprovalCalldata,
-  buildPermit2ApprovalCalldata,
-  buildSwapFromQuote,
-  buildSwapWithGasDeduction,
-  buildUniversalRouterExecuteArgs,
-  buildV4SwapInput,
-  checkAllowance,
-  simulateSwap
-} from "../chunk-VG23GIWQ.js";
-import "../chunk-2PIXFXA2.js";
-import "../chunk-Y3HMGOYW.js";
-export {
-  SETTLE_ALL,
-  SWAP_EXACT_IN,
-  TAKE_ALL,
-  V4_SWAP,
-  buildErc20ApprovalCalldata,
-  buildPermit2ApprovalCalldata,
-  buildSwapFromQuote,
-  buildSwapWithGasDeduction,
-  buildUniversalRouterExecuteArgs,
-  buildV4SwapInput,
-  checkAllowance,
-  simulateSwap
-};
-//# sourceMappingURL=index.js.map

package/dist/swap/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}