@pafi-dev/core 0.1.0

package/dist/index.js

@@ -0,0 +1,412 @@
+import {
+  pointTokenFactoryAbi
+} from "./chunk-5YH4D7QF.js";
+import {
+  createLoginMessage,
+  parseLoginMessage,
+  verifyLoginMessage
+} from "./chunk-O4SMTUOY.js";
+import {
+  getIssuer,
+  getIssuer2,
+  getMintRequestNonce,
+  getPointTokenIssuer,
+  getReceiverConsentNonce,
+  getTokenName,
+  getUsdt,
+  isActiveIssuer,
+  isMinter,
+  verifyMintCap
+} from "./chunk-KW6M5FXY.js";
+import {
+  issuerRegistryAbi,
+  mintingOracleAbi,
+  pointTokenAbi
+} from "./chunk-FXNG4G22.js";
+import {
+  buildDomain,
+  buildMintRequestTypedData,
+  buildReceiverConsentTypedData,
+  signMintRequest,
+  signReceiverConsent,
+  verifyMintRequest,
+  verifyReceiverConsent
+} from "./chunk-C4ZDYG4D.js";
+import {
+  buildAllPaths,
+  combineRoutes,
+  findBestQuote,
+  quoteBestRoute,
+  quoteExactInput,
+  quoteExactInputSingle
+} from "./chunk-FIKTQR7H.js";
+import {
+  v4QuoterAbi
+} from "./chunk-KFWZRL7I.js";
+import {
+  COMMON_POOLS,
+  COMMON_TOKENS,
+  POINT_TOKEN_POOLS,
+  SUPPORTED_CHAINS,
+  UNIVERSAL_ROUTER_ADDRESSES,
+  V4_QUOTER_ADDRESSES,
+  mintRequestTypes,
+  receiverConsentTypes
+} from "./chunk-R4L66ZR5.js";
+import {
+  SETTLE_ALL,
+  SWAP_EXACT_IN,
+  TAKE_ALL,
+  V4_SWAP,
+  buildErc20ApprovalCalldata,
+  buildPermit2ApprovalCalldata,
+  buildSwapFromQuote,
+  buildUniversalRouterExecuteArgs,
+  buildV4SwapInput,
+  checkAllowance,
+  simulateSwap
+} from "./chunk-37BBGXTS.js";
+import {
+  erc20Abi,
+  permit2Abi,
+  universalRouterAbi
+} from "./chunk-2PIXFXA2.js";
+import {
+  buildRelaySwapParams,
+  decodeExtData,
+  decodeMintAndSwap,
+  encodeExtData,
+  encodeMintAndSwap,
+  simulateMintAndSwap
+} from "./chunk-DSCUHT3F.js";
+import {
+  relayAbi
+} from "./chunk-4RYBJLF3.js";
+import {
+  ApiError,
+  ConfigurationError,
+  PafiSDKError,
+  SigningError,
+  SimulationError
+} from "./chunk-P56TUGTS.js";
+
+// src/index.ts
+import { createPublicClient, http } from "viem";
+var PafiSDK = class {
+  _pointTokenAddress;
+  _relayContractAddress;
+  _signer;
+  _provider;
+  _chainId;
+  constructor(config) {
+    this._pointTokenAddress = config.pointTokenAddress;
+    this._relayContractAddress = config.relayContractAddress;
+    this._signer = config.signer;
+    this._chainId = config.chainId;
+    if (config.provider) {
+      this._provider = config.provider;
+    } else if (config.rpcUrl) {
+      this._provider = createPublicClient({
+        transport: http(config.rpcUrl)
+      });
+    }
+  }
+  // -------------------------------------------------------------------------
+  // Setters
+  // -------------------------------------------------------------------------
+  setPointTokenAddress(address) {
+    this._pointTokenAddress = address;
+  }
+  setRelayContractAddress(address) {
+    this._relayContractAddress = address;
+  }
+  setSigner(signer) {
+    this._signer = signer;
+  }
+  setProvider(provider) {
+    this._provider = provider;
+  }
+  // -------------------------------------------------------------------------
+  // Private guards
+  // -------------------------------------------------------------------------
+  requirePointToken() {
+    if (!this._pointTokenAddress) {
+      throw new ConfigurationError("pointTokenAddress not set");
+    }
+    return this._pointTokenAddress;
+  }
+  requireProvider() {
+    if (!this._provider) {
+      throw new ConfigurationError("provider not set");
+    }
+    return this._provider;
+  }
+  requireSigner() {
+    if (!this._signer) {
+      throw new ConfigurationError("signer not set");
+    }
+    return this._signer;
+  }
+  requireChainId() {
+    if (this._chainId === void 0) {
+      throw new ConfigurationError("chainId not set");
+    }
+    return this._chainId;
+  }
+  // -------------------------------------------------------------------------
+  // Domain
+  // -------------------------------------------------------------------------
+  async getDomain() {
+    const provider = this.requireProvider();
+    const pointToken = this.requirePointToken();
+    const chainId = this.requireChainId();
+    const name = await getTokenName(provider, pointToken);
+    return { name, verifyingContract: pointToken, chainId };
+  }
+  // -------------------------------------------------------------------------
+  // EIP-712 — delegates to pure functions
+  // -------------------------------------------------------------------------
+  /**
+   * Build the EIP-712 typed data for a MintRequest.
+   * Pass the result to any external signer (Privy, WalletConnect, etc.).
+   */
+  async buildMintRequestTypedData(message) {
+    const domain = await this.getDomain();
+    return buildMintRequestTypedData(domain, message);
+  }
+  /**
+   * Build the EIP-712 typed data for a ReceiverConsent.
+   * Pass the result to any external signer (Privy, WalletConnect, etc.).
+   */
+  async buildReceiverConsentTypedData(message) {
+    const domain = await this.getDomain();
+    return buildReceiverConsentTypedData(domain, message);
+  }
+  async signMintRequest(message) {
+    const domain = await this.getDomain();
+    return signMintRequest(this.requireSigner(), domain, message);
+  }
+  async verifyMintRequest(message, signature, expectedMinter) {
+    const domain = await this.getDomain();
+    return verifyMintRequest(domain, message, signature, expectedMinter);
+  }
+  async signReceiverConsent(message) {
+    const domain = await this.getDomain();
+    return signReceiverConsent(this.requireSigner(), domain, message);
+  }
+  async verifyReceiverConsent(message, signature, expectedReceiver) {
+    const domain = await this.getDomain();
+    return verifyReceiverConsent(domain, message, signature, expectedReceiver);
+  }
+  // -------------------------------------------------------------------------
+  // Contract reads
+  // -------------------------------------------------------------------------
+  async getMintRequestNonce(receiver) {
+    return getMintRequestNonce(
+      this.requireProvider(),
+      this.requirePointToken(),
+      receiver
+    );
+  }
+  async getReceiverConsentNonce(receiver) {
+    return getReceiverConsentNonce(
+      this.requireProvider(),
+      this.requirePointToken(),
+      receiver
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Relay calldata — delegates to pure functions
+  // -------------------------------------------------------------------------
+  encodeMintAndSwap(mint, swap) {
+    return encodeMintAndSwap(mint, swap);
+  }
+  decodeMintAndSwap(calldata) {
+    return decodeMintAndSwap(calldata);
+  }
+  // -------------------------------------------------------------------------
+  // Quoting — delegates to pure functions
+  // -------------------------------------------------------------------------
+  /**
+   * Find the best swap route from `tokenIn` to `tokenOut`.
+   * Merges `pools` with COMMON_POOLS for the configured chain, builds all
+   * paths, and quotes via a single multicall RPC call.
+   */
+  async findBestQuote(tokenIn, tokenOut, exactAmount, pools = [], quoterAddress, maxHops) {
+    return findBestQuote(
+      this.requireProvider(),
+      this.requireChainId(),
+      tokenIn,
+      tokenOut,
+      exactAmount,
+      pools,
+      quoterAddress,
+      maxHops
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Swap building — delegates to pure functions
+  // -------------------------------------------------------------------------
+  /**
+   * Build UniversalRouter execute args from a quote result.
+   * The caller provides `minAmountOut` after applying their own slippage.
+   */
+  buildSwapFromQuote(params) {
+    return buildSwapFromQuote(params);
+  }
+  /**
+   * Build Relay SwapParams + extData from a quote result.
+   * Returns ready-to-use args for `Relay.mintAndSwap`.
+   */
+  buildRelaySwapParams(params) {
+    return buildRelaySwapParams(params);
+  }
+  /**
+   * Encode extData for ReceiverConsent and MintParams.
+   * extData = abi.encode(minAmountOut, feeInUsdt)
+   */
+  encodeExtData(minAmountOut, feeInUsdt) {
+    return encodeExtData(minAmountOut, feeInUsdt);
+  }
+  // -------------------------------------------------------------------------
+  // Simulation — dry-run via eth_call (no gas spent)
+  // -------------------------------------------------------------------------
+  /**
+   * 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
+   */
+  async simulateMintAndSwap(relayAddress, mint, swap, from) {
+    return simulateMintAndSwap(
+      this.requireProvider(),
+      relayAddress,
+      mint,
+      swap,
+      from
+    );
+  }
+  /**
+   * Simulate a UniversalRouter.execute swap call. Catches reverts (bad
+   * approvals, insufficient balance, pool errors) before submitting.
+   *
+   * @param routerAddress - UniversalRouter contract address
+   * @param commands      - Packed command bytes (from buildSwapFromQuote)
+   * @param inputs        - Encoded inputs (from buildSwapFromQuote)
+   * @param deadline      - Unix timestamp
+   * @param from          - Address that will execute the swap
+   */
+  async simulateSwap(routerAddress, commands, inputs, deadline, from) {
+    return simulateSwap(
+      this.requireProvider(),
+      routerAddress,
+      commands,
+      inputs,
+      deadline,
+      from
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Auth — EIP-4361 login helpers (offline, stateless)
+  //
+  // These are convenience wrappers around the pure functions in
+  // `./auth/loginMessage.ts`. They do NOT hit the network — the caller is
+  // responsible for fetching the nonce, POSTing the signed message, and
+  // storing the JWT returned by the issuer backend.
+  // -------------------------------------------------------------------------
+  /**
+   * 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.
+   */
+  async createLoginMessage(params) {
+    const signer = this.requireSigner();
+    const chainId = this.requireChainId();
+    const account = signer.account;
+    if (!account) {
+      throw new ConfigurationError("signer has no account attached");
+    }
+    return createLoginMessage({ ...params, address: account.address, chainId });
+  }
+  /** Sign a login message string with the current signer (personal_sign) */
+  async signLoginMessage(message) {
+    const signer = this.requireSigner();
+    const account = signer.account;
+    if (!account) {
+      throw new ConfigurationError("signer has no account attached");
+    }
+    return signer.signMessage({ account, message });
+  }
+};
+export {
+  ApiError,
+  COMMON_POOLS,
+  COMMON_TOKENS,
+  ConfigurationError,
+  POINT_TOKEN_POOLS,
+  PafiSDK,
+  PafiSDKError,
+  SETTLE_ALL,
+  SUPPORTED_CHAINS,
+  SWAP_EXACT_IN,
+  SigningError,
+  SimulationError,
+  TAKE_ALL,
+  UNIVERSAL_ROUTER_ADDRESSES,
+  V4_QUOTER_ADDRESSES,
+  V4_SWAP,
+  buildAllPaths,
+  buildDomain,
+  buildErc20ApprovalCalldata,
+  buildMintRequestTypedData,
+  buildPermit2ApprovalCalldata,
+  buildReceiverConsentTypedData,
+  buildRelaySwapParams,
+  buildSwapFromQuote,
+  buildUniversalRouterExecuteArgs,
+  buildV4SwapInput,
+  checkAllowance,
+  combineRoutes,
+  createLoginMessage,
+  decodeExtData,
+  decodeMintAndSwap,
+  encodeExtData,
+  encodeMintAndSwap,
+  erc20Abi,
+  findBestQuote,
+  getIssuer2 as getIssuer,
+  getMintRequestNonce,
+  getPointTokenIssuer,
+  getIssuer as getPointTokenIssuerAddress,
+  getReceiverConsentNonce,
+  getTokenName,
+  getUsdt,
+  isActiveIssuer,
+  isMinter,
+  issuerRegistryAbi,
+  mintRequestTypes,
+  mintingOracleAbi,
+  parseLoginMessage,
+  permit2Abi,
+  pointTokenAbi,
+  pointTokenFactoryAbi,
+  quoteBestRoute,
+  quoteExactInput,
+  quoteExactInputSingle,
+  receiverConsentTypes,
+  relayAbi,
+  signMintRequest,
+  signReceiverConsent,
+  simulateMintAndSwap,
+  simulateSwap,
+  universalRouterAbi,
+  v4QuoterAbi,
+  verifyLoginMessage,
+  verifyMintCap,
+  verifyMintRequest,
+  verifyReceiverConsent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { createPublicClient, http } from \"viem\";\nimport type { Address, Hex, PublicClient, WalletClient } from \"viem\";\n\n// -------------------------------------------------------------------------\n// Re-export all sub-modules\n// -------------------------------------------------------------------------\nexport * from \"./types\";\nexport * from \"./constants\";\nexport * from \"./errors\";\nexport * from \"./abi/index\";\nexport * from \"./eip712/index\";\nexport * from \"./relay/index\";\nexport * from \"./contract/index\";\nexport * from \"./quoting/index\";\nexport * from \"./swap/index\";\nexport * from \"./auth/index\";\n\n// -------------------------------------------------------------------------\n// Internal imports for PafiSDK class\n// -------------------------------------------------------------------------\nimport { buildMintRequestTypedData, signMintRequest, verifyMintRequest } from \"./eip712/mintRequest\";\nimport {\n  buildReceiverConsentTypedData,\n  signReceiverConsent,\n  verifyReceiverConsent,\n} from \"./eip712/receiverConsent\";\nimport {\n  getMintRequestNonce,\n  getReceiverConsentNonce,\n  getTokenName,\n} from \"./contract/pointToken\";\nimport {\n  encodeMintAndSwap,\n  decodeMintAndSwap,\n  encodeExtData,\n  buildRelaySwapParams,\n} from \"./relay/calldata\";\nimport { findBestQuote } from \"./quoting/quote\";\nimport {\n  buildSwapFromQuote,\n  buildUniversalRouterExecuteArgs,\n} from \"./swap/universalRouter\";\nimport { simulateMintAndSwap } from \"./relay/simulate\";\nimport { simulateSwap } from \"./swap/simulate\";\nimport type { SimulationResult } from \"./relay/simulate\";\nimport type { SwapSimulationResult } from \"./swap/simulate\";\nimport { createLoginMessage } from \"./auth/loginMessage\";\nimport type { LoginMessageParams } from \"./auth/types\";\nimport { ConfigurationError } from \"./errors\";\nimport type {\n  BestQuote,\n  EIP712Signature,\n  MintParams,\n  MintRequest,\n  PafiSDKConfig,\n  PathKey,\n  PointTokenDomainConfig,\n  PoolKey,\n  QuoteResult,\n  ReceiverConsent,\n  SignatureVerification,\n  SwapParams,\n} from \"./types\";\n\n// -------------------------------------------------------------------------\n// PafiSDK — convenience class wrapping all contract + crypto primitives.\n//\n// This class is HTTP-client-free on purpose. It covers signing, verifying,\n// contract reads, and calldata encoding — the things that need a signer\n// or a provider but no HTTP layer. The issuer backend defines its own HTTP\n// contract via `@pafi/issuer`; frontends build `fetch()` calls against\n// those types directly.\n// -------------------------------------------------------------------------\n\nexport class PafiSDK {\n  private _pointTokenAddress?: Address;\n  private _relayContractAddress?: Address;\n  private _signer?: WalletClient;\n  private _provider?: PublicClient;\n  private _chainId?: number;\n\n  constructor(config: PafiSDKConfig) {\n    this._pointTokenAddress = config.pointTokenAddress;\n    this._relayContractAddress = config.relayContractAddress;\n    this._signer = config.signer;\n    this._chainId = config.chainId;\n\n    if (config.provider) {\n      this._provider = config.provider;\n    } else if (config.rpcUrl) {\n      this._provider = createPublicClient({\n        transport: http(config.rpcUrl),\n      });\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Setters\n  // -------------------------------------------------------------------------\n\n  setPointTokenAddress(address: Address): void {\n    this._pointTokenAddress = address;\n  }\n\n  setRelayContractAddress(address: Address): void {\n    this._relayContractAddress = address;\n  }\n\n  setSigner(signer: WalletClient): void {\n    this._signer = signer;\n  }\n\n  setProvider(provider: PublicClient): void {\n    this._provider = provider;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private guards\n  // -------------------------------------------------------------------------\n\n  private requirePointToken(): Address {\n    if (!this._pointTokenAddress) {\n      throw new ConfigurationError(\"pointTokenAddress not set\");\n    }\n    return this._pointTokenAddress;\n  }\n\n  private requireProvider(): PublicClient {\n    if (!this._provider) {\n      throw new ConfigurationError(\"provider not set\");\n    }\n    return this._provider;\n  }\n\n  private requireSigner(): WalletClient {\n    if (!this._signer) {\n      throw new ConfigurationError(\"signer not set\");\n    }\n    return this._signer;\n  }\n\n  private requireChainId(): number {\n    if (this._chainId === undefined) {\n      throw new ConfigurationError(\"chainId not set\");\n    }\n    return this._chainId;\n  }\n\n  // -------------------------------------------------------------------------\n  // Domain\n  // -------------------------------------------------------------------------\n\n  async getDomain(): Promise<PointTokenDomainConfig> {\n    const provider = this.requireProvider();\n    const pointToken = this.requirePointToken();\n    const chainId = this.requireChainId();\n    const name = await getTokenName(provider, pointToken);\n    return { name, verifyingContract: pointToken, chainId };\n  }\n\n  // -------------------------------------------------------------------------\n  // EIP-712 — delegates to pure functions\n  // -------------------------------------------------------------------------\n\n  /**\n   * Build the EIP-712 typed data for a MintRequest.\n   * Pass the result to any external signer (Privy, WalletConnect, etc.).\n   */\n  async buildMintRequestTypedData(message: MintRequest) {\n    const domain = await this.getDomain();\n    return buildMintRequestTypedData(domain, message);\n  }\n\n  /**\n   * Build the EIP-712 typed data for a ReceiverConsent.\n   * Pass the result to any external signer (Privy, WalletConnect, etc.).\n   */\n  async buildReceiverConsentTypedData(message: ReceiverConsent) {\n    const domain = await this.getDomain();\n    return buildReceiverConsentTypedData(domain, message);\n  }\n\n  async signMintRequest(message: MintRequest): Promise<EIP712Signature> {\n    const domain = await this.getDomain();\n    return signMintRequest(this.requireSigner(), domain, message);\n  }\n\n  async verifyMintRequest(\n    message: MintRequest,\n    signature: Hex,\n    expectedMinter: Address,\n  ): Promise<SignatureVerification> {\n    const domain = await this.getDomain();\n    return verifyMintRequest(domain, message, signature, expectedMinter);\n  }\n\n  async signReceiverConsent(\n    message: ReceiverConsent,\n  ): Promise<EIP712Signature> {\n    const domain = await this.getDomain();\n    return signReceiverConsent(this.requireSigner(), domain, message);\n  }\n\n  async verifyReceiverConsent(\n    message: ReceiverConsent,\n    signature: Hex,\n    expectedReceiver: Address,\n  ): Promise<SignatureVerification> {\n    const domain = await this.getDomain();\n    return verifyReceiverConsent(domain, message, signature, expectedReceiver);\n  }\n\n  // -------------------------------------------------------------------------\n  // Contract reads\n  // -------------------------------------------------------------------------\n\n  async getMintRequestNonce(receiver: Address): Promise<bigint> {\n    return getMintRequestNonce(\n      this.requireProvider(),\n      this.requirePointToken(),\n      receiver,\n    );\n  }\n\n  async getReceiverConsentNonce(receiver: Address): Promise<bigint> {\n    return getReceiverConsentNonce(\n      this.requireProvider(),\n      this.requirePointToken(),\n      receiver,\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Relay calldata — delegates to pure functions\n  // -------------------------------------------------------------------------\n\n  encodeMintAndSwap(mint: MintParams, swap: SwapParams): Hex {\n    return encodeMintAndSwap(mint, swap);\n  }\n\n  decodeMintAndSwap(calldata: Hex): { mint: MintParams; swap: SwapParams } {\n    return decodeMintAndSwap(calldata);\n  }\n\n  // -------------------------------------------------------------------------\n  // Quoting — delegates to pure functions\n  // -------------------------------------------------------------------------\n\n  /**\n   * Find the best swap route from `tokenIn` to `tokenOut`.\n   * Merges `pools` with COMMON_POOLS for the configured chain, builds all\n   * paths, and quotes via a single multicall RPC call.\n   */\n  async findBestQuote(\n    tokenIn: Address,\n    tokenOut: Address,\n    exactAmount: bigint,\n    pools: PoolKey[] = [],\n    quoterAddress?: Address,\n    maxHops?: number,\n  ): Promise<BestQuote> {\n    return findBestQuote(\n      this.requireProvider(),\n      this.requireChainId(),\n      tokenIn,\n      tokenOut,\n      exactAmount,\n      pools,\n      quoterAddress,\n      maxHops,\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Swap building — delegates to pure functions\n  // -------------------------------------------------------------------------\n\n  /**\n   * Build UniversalRouter execute args from a quote result.\n   * The caller provides `minAmountOut` after applying their own slippage.\n   */\n  buildSwapFromQuote(params: {\n    quote: QuoteResult;\n    currencyIn: Address;\n    currencyOut: Address;\n    amountIn: bigint;\n    minAmountOut: bigint;\n  }): { commands: Hex; inputs: Hex[] } {\n    return buildSwapFromQuote(params);\n  }\n\n  /**\n   * Build Relay SwapParams + extData from a quote result.\n   * Returns ready-to-use args for `Relay.mintAndSwap`.\n   */\n  buildRelaySwapParams(params: {\n    quote: { path: PathKey[] };\n    minAmountOut: bigint;\n    feeInUsdt: bigint;\n    deadline: bigint;\n  }): { swapParams: SwapParams; extData: Hex } {\n    return buildRelaySwapParams(params);\n  }\n\n  /**\n   * Encode extData for ReceiverConsent and MintParams.\n   * extData = abi.encode(minAmountOut, feeInUsdt)\n   */\n  encodeExtData(minAmountOut: bigint, feeInUsdt: bigint): Hex {\n    return encodeExtData(minAmountOut, feeInUsdt);\n  }\n\n  // -------------------------------------------------------------------------\n  // Simulation — dry-run via eth_call (no gas spent)\n  // -------------------------------------------------------------------------\n\n  /**\n   * Simulate a Relay.mintAndSwap call. Catches reverts (bad signatures,\n   * expired deadlines, insufficient mint cap, pool errors) before submitting.\n   *\n   * @param relayAddress - Relay contract address\n   * @param mint         - MintParams with real signatures\n   * @param swap         - SwapParams (path + deadline)\n   * @param from         - Relayer address that will submit the tx\n   */\n  async simulateMintAndSwap(\n    relayAddress: Address,\n    mint: MintParams,\n    swap: SwapParams,\n    from: Address,\n  ): Promise<SimulationResult> {\n    return simulateMintAndSwap(\n      this.requireProvider(),\n      relayAddress,\n      mint,\n      swap,\n      from,\n    );\n  }\n\n  /**\n   * Simulate a UniversalRouter.execute swap call. Catches reverts (bad\n   * approvals, insufficient balance, pool errors) before submitting.\n   *\n   * @param routerAddress - UniversalRouter contract address\n   * @param commands      - Packed command bytes (from buildSwapFromQuote)\n   * @param inputs        - Encoded inputs (from buildSwapFromQuote)\n   * @param deadline      - Unix timestamp\n   * @param from          - Address that will execute the swap\n   */\n  async simulateSwap(\n    routerAddress: Address,\n    commands: Hex,\n    inputs: Hex[],\n    deadline: bigint,\n    from: Address,\n  ): Promise<SwapSimulationResult> {\n    return simulateSwap(\n      this.requireProvider(),\n      routerAddress,\n      commands,\n      inputs,\n      deadline,\n      from,\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Auth — EIP-4361 login helpers (offline, stateless)\n  //\n  // These are convenience wrappers around the pure functions in\n  // `./auth/loginMessage.ts`. They do NOT hit the network — the caller is\n  // responsible for fetching the nonce, POSTing the signed message, and\n  // storing the JWT returned by the issuer backend.\n  // -------------------------------------------------------------------------\n\n  /**\n   * Build an EIP-4361 login message for the current signer + chain. The\n   * caller supplies the issuer-specific fields (domain, nonce, uri); the SDK\n   * fills in the wallet address and chain id from its own config.\n   */\n  async createLoginMessage(\n    params: Omit<LoginMessageParams, \"address\" | \"chainId\">,\n  ): Promise<string> {\n    const signer = this.requireSigner();\n    const chainId = this.requireChainId();\n    const account = signer.account;\n    if (!account) {\n      throw new ConfigurationError(\"signer has no account attached\");\n    }\n    return createLoginMessage({ ...params, address: account.address, chainId });\n  }\n\n  /** Sign a login message string with the current signer (personal_sign) */\n  async signLoginMessage(message: string): Promise<Hex> {\n    const signer = this.requireSigner();\n    const account = signer.account;\n    if (!account) {\n      throw new ConfigurationError(\"signer has no account attached\");\n    }\n    return signer.signMessage({ account, message });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/quoting/index.cjs

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

package/dist/quoting/index.cjs.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,59 @@
+import { Address, PublicClient } from 'viem';
+import { P as PoolKey, e as PathKey, B as BestQuote, Q as QuoteResult } from '../types-CkRJzrZr.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

@@ -0,0 +1,59 @@
+import { Address, PublicClient } from 'viem';
+import { P as PoolKey, e as PathKey, B as BestQuote, Q as QuoteResult } from '../types-CkRJzrZr.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

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

package/dist/quoting/index.js.map

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

package/dist/relay/index.cjs

@@ -0,0 +1,19 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+var _chunk4QOWQQCHcjs = require('../chunk-4QOWQQCH.cjs');
+require('../chunk-27V32VNM.cjs');
+require('../chunk-5QJZT7VB.cjs');
+
+
+
+
+
+
+
+exports.buildRelaySwapParams = _chunk4QOWQQCHcjs.buildRelaySwapParams; exports.decodeExtData = _chunk4QOWQQCHcjs.decodeExtData; exports.decodeMintAndSwap = _chunk4QOWQQCHcjs.decodeMintAndSwap; exports.encodeExtData = _chunk4QOWQQCHcjs.encodeExtData; exports.encodeMintAndSwap = _chunk4QOWQQCHcjs.encodeMintAndSwap; exports.simulateMintAndSwap = _chunk4QOWQQCHcjs.simulateMintAndSwap;
+//# sourceMappingURL=index.cjs.map

package/dist/relay/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/phitran/Pacific-Finance/pafi-backend/pafi-sdk/packages/core/dist/relay/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,+XAAC","file":"/Users/phitran/Pacific-Finance/pafi-backend/pafi-sdk/packages/core/dist/relay/index.cjs"}