@pafi-dev/issuer 0.5.11 → 0.5.12

package/dist/index.d.cts

@@ -1354,6 +1354,48 @@ interface SubgraphNativeUsdtQuoterConfig {
  */
 declare function createSubgraphNativeUsdtQuoter(config?: SubgraphNativeUsdtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
 
+interface NativePtQuoterConfig {
+    /** Viem PublicClient — used to call Chainlink on-chain. */
+    provider: PublicClient;
+    /** Address of the PointToken being traded. */
+    pointTokenAddress: Address;
+    /** Chainlink ETH/USD feed address. Defaults to Base mainnet feed. */
+    chainlinkFeedAddress?: Address;
+    /** PAFI subgraph GraphQL endpoint. */
+    subgraphUrl?: string;
+    /** Cache TTL in ms. Default: 30_000. */
+    cacheTtlMs?: number;
+    /** Fallback ETH price (USD) when Chainlink is unreachable. Default: 3000. */
+    fallbackEthPriceUsd?: number;
+    /** Fallback PT price (USDT per 1 PT) when subgraph is unreachable. Default: 0.1. */
+    fallbackPtPriceUsdt?: number;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+}
+/**
+ * Create a native→PT quoter for use as `FeeManager.quoteNativeToFee`.
+ *
+ * Converts ETH gas cost → USDT (via Chainlink ETH/USD) → PT (via subgraph
+ * pool price), returning the fee amount in PT raw units (18 decimals).
+ *
+ * Formula:
+ *   feeInPT = amountNative × ethPrice_8dec × ptPerUsdt_18dec / 10^26
+ *
+ * Both prices are cached in-process (default 30s TTL).
+ *
+ * @example
+ * ```ts
+ * fee: {
+ *   quoteNativeToFee: createNativePtQuoter({
+ *     provider,
+ *     pointTokenAddress: "0x...",
+ *     chainlinkFeedAddress: getContractAddresses(chainId).chainlinkEthUsd,
+ *   }),
+ * }
+ * ```
+ */
+declare function createNativePtQuoter(config: NativePtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
+
 /**
  * Combined off-chain + on-chain balance for a single user / token pair.
  *
@@ -1742,4 +1784,4 @@ declare class IssuerStateValidator {
 /** SDK package version — bumped on every release */
 declare const PAFI_ISSUER_SDK_VERSION = "0.4.0";
 
-export { type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedeemRequest, type ApiRedeemResponse, type ApiTopUpRequest, type ApiTopUpResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, BalanceAggregator, type BalanceAggregatorConfig, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type CombinedBalance, DefaultPolicyEngine, type DefaultPolicyEngineOptions, FeeManager, type FeeManagerConfig, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintingStatus, NonceManager, PAFI_ISSUER_SDK_VERSION, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, type PendingUserOpEntry, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PreValidateMintResult, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, type RelayUserOpRequest, type RelayUserOpResponse, type RetryConfig, type Session, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, TopUpRedemptionError, TopUpRedemptionHandler, type TopUpRedemptionHandlerConfig, type TopUpRedemptionRequest, type TopUpRedemptionResponse, authenticateRequest, createIssuerService, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, serializeEntryToJsonRpc };
+export { type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedeemRequest, type ApiRedeemResponse, type ApiTopUpRequest, type ApiTopUpResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, BalanceAggregator, type BalanceAggregatorConfig, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type CombinedBalance, DefaultPolicyEngine, type DefaultPolicyEngineOptions, FeeManager, type FeeManagerConfig, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintingStatus, type NativePtQuoterConfig, NonceManager, PAFI_ISSUER_SDK_VERSION, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, type PendingUserOpEntry, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PreValidateMintResult, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, type RelayUserOpRequest, type RelayUserOpResponse, type RetryConfig, type Session, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, TopUpRedemptionError, TopUpRedemptionHandler, type TopUpRedemptionHandlerConfig, type TopUpRedemptionRequest, type TopUpRedemptionResponse, authenticateRequest, createIssuerService, createNativePtQuoter, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, serializeEntryToJsonRpc };

package/dist/index.d.ts

@@ -1354,6 +1354,48 @@ interface SubgraphNativeUsdtQuoterConfig {
  */
 declare function createSubgraphNativeUsdtQuoter(config?: SubgraphNativeUsdtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
 
+interface NativePtQuoterConfig {
+    /** Viem PublicClient — used to call Chainlink on-chain. */
+    provider: PublicClient;
+    /** Address of the PointToken being traded. */
+    pointTokenAddress: Address;
+    /** Chainlink ETH/USD feed address. Defaults to Base mainnet feed. */
+    chainlinkFeedAddress?: Address;
+    /** PAFI subgraph GraphQL endpoint. */
+    subgraphUrl?: string;
+    /** Cache TTL in ms. Default: 30_000. */
+    cacheTtlMs?: number;
+    /** Fallback ETH price (USD) when Chainlink is unreachable. Default: 3000. */
+    fallbackEthPriceUsd?: number;
+    /** Fallback PT price (USDT per 1 PT) when subgraph is unreachable. Default: 0.1. */
+    fallbackPtPriceUsdt?: number;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+}
+/**
+ * Create a native→PT quoter for use as `FeeManager.quoteNativeToFee`.
+ *
+ * Converts ETH gas cost → USDT (via Chainlink ETH/USD) → PT (via subgraph
+ * pool price), returning the fee amount in PT raw units (18 decimals).
+ *
+ * Formula:
+ *   feeInPT = amountNative × ethPrice_8dec × ptPerUsdt_18dec / 10^26
+ *
+ * Both prices are cached in-process (default 30s TTL).
+ *
+ * @example
+ * ```ts
+ * fee: {
+ *   quoteNativeToFee: createNativePtQuoter({
+ *     provider,
+ *     pointTokenAddress: "0x...",
+ *     chainlinkFeedAddress: getContractAddresses(chainId).chainlinkEthUsd,
+ *   }),
+ * }
+ * ```
+ */
+declare function createNativePtQuoter(config: NativePtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
+
 /**
  * Combined off-chain + on-chain balance for a single user / token pair.
  *
@@ -1742,4 +1784,4 @@ declare class IssuerStateValidator {
 /** SDK package version — bumped on every release */
 declare const PAFI_ISSUER_SDK_VERSION = "0.4.0";
 
-export { type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedeemRequest, type ApiRedeemResponse, type ApiTopUpRequest, type ApiTopUpResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, BalanceAggregator, type BalanceAggregatorConfig, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type CombinedBalance, DefaultPolicyEngine, type DefaultPolicyEngineOptions, FeeManager, type FeeManagerConfig, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintingStatus, NonceManager, PAFI_ISSUER_SDK_VERSION, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, type PendingUserOpEntry, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PreValidateMintResult, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, type RelayUserOpRequest, type RelayUserOpResponse, type RetryConfig, type Session, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, TopUpRedemptionError, TopUpRedemptionHandler, type TopUpRedemptionHandlerConfig, type TopUpRedemptionRequest, type TopUpRedemptionResponse, authenticateRequest, createIssuerService, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, serializeEntryToJsonRpc };
+export { type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedeemRequest, type ApiRedeemResponse, type ApiTopUpRequest, type ApiTopUpResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, BalanceAggregator, type BalanceAggregatorConfig, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type CombinedBalance, DefaultPolicyEngine, type DefaultPolicyEngineOptions, FeeManager, type FeeManagerConfig, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintingStatus, type NativePtQuoterConfig, NonceManager, PAFI_ISSUER_SDK_VERSION, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, type PendingUserOpEntry, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PreValidateMintResult, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, type RelayUserOpRequest, type RelayUserOpResponse, type RetryConfig, type Session, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, TopUpRedemptionError, TopUpRedemptionHandler, type TopUpRedemptionHandlerConfig, type TopUpRedemptionRequest, type TopUpRedemptionResponse, authenticateRequest, createIssuerService, createNativePtQuoter, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, serializeEntryToJsonRpc };

package/dist/index.js

@@ -1736,6 +1736,107 @@ function toUsdtPerNative(priceFloat, usdtDecimals) {
   return BigInt(whole + padded);
 }
 
+// src/pools/nativePtQuoter.ts
+import { parseAbi } from "viem";
+var CHAINLINK_ABI = parseAbi([
+  "function latestRoundData() external view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)"
+]);
+var CHAINLINK_MAX_AGE_S = 3600n;
+var POOL_PRICE_QUERY = `
+  query GetPoolPrice($id: ID!) {
+    pafiToken(id: $id) {
+      pool {
+        token0 { id }
+        token1 { id }
+        token0Price
+        token1Price
+      }
+    }
+  }
+`;
+function createNativePtQuoter(config) {
+  const {
+    provider,
+    pointTokenAddress,
+    chainlinkFeedAddress = "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70",
+    subgraphUrl = PAFI_SUBGRAPH_URL,
+    cacheTtlMs = 3e4,
+    fallbackEthPriceUsd = 3e3,
+    fallbackPtPriceUsdt = 0.1,
+    fetchImpl = globalThis.fetch,
+    now = () => Date.now()
+  } = config;
+  let ethPriceCache;
+  let ptPriceCache;
+  async function getEthPrice8dec() {
+    const ts = now();
+    if (ethPriceCache && ethPriceCache.expiresAt > ts) return ethPriceCache.value;
+    try {
+      const result = await provider.readContract({
+        address: chainlinkFeedAddress,
+        abi: CHAINLINK_ABI,
+        functionName: "latestRoundData"
+      });
+      const answer = result[1];
+      const updatedAt = result[3];
+      if (answer <= 0n) throw new Error("Chainlink: non-positive price");
+      const ageS = BigInt(Math.floor(ts / 1e3)) - updatedAt;
+      if (ageS > CHAINLINK_MAX_AGE_S) {
+        throw new Error(`Chainlink: price stale by ${ageS}s`);
+      }
+      ethPriceCache = { value: answer, expiresAt: ts + cacheTtlMs };
+      return answer;
+    } catch (err) {
+      console.warn("[nativePtQuoter] Chainlink unavailable, using fallback:", err.message);
+      return BigInt(Math.round(fallbackEthPriceUsd * 1e8));
+    }
+  }
+  async function getPtPerUsdt18dec() {
+    const ts = now();
+    if (ptPriceCache && ptPriceCache.expiresAt > ts) return ptPriceCache.value;
+    try {
+      const response = await fetchImpl(subgraphUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          query: POOL_PRICE_QUERY,
+          variables: { id: pointTokenAddress.toLowerCase() }
+        })
+      });
+      if (!response.ok) throw new Error(`subgraph HTTP ${response.status}`);
+      const json = await response.json();
+      if (json.errors?.length) throw new Error(json.errors.map((e) => e.message).join("; "));
+      const pool = json.data?.pafiToken?.pool;
+      if (!pool) throw new Error("pafiToken or pool not found in subgraph");
+      const isPtToken0 = pool.token0.id.toLowerCase() === pointTokenAddress.toLowerCase();
+      const ptPerUsdtStr = isPtToken0 ? pool.token0Price : pool.token1Price;
+      if (!ptPerUsdtStr || Number(ptPerUsdtStr) <= 0) {
+        throw new Error(`invalid PT/USDT price from subgraph: ${ptPerUsdtStr}`);
+      }
+      const value = parseBigDecimalTo18(ptPerUsdtStr);
+      ptPriceCache = { value, expiresAt: ts + cacheTtlMs };
+      return value;
+    } catch (err) {
+      console.warn("[nativePtQuoter] subgraph unavailable, using fallback:", err.message);
+      return parseBigDecimalTo18(fallbackPtPriceUsdt.toString());
+    }
+  }
+  return async (amountNative) => {
+    if (amountNative === 0n) return 0n;
+    const [ethPrice8dec, ptPerUsdt18dec] = await Promise.all([
+      getEthPrice8dec(),
+      getPtPerUsdt18dec()
+    ]);
+    return amountNative * ethPrice8dec * ptPerUsdt18dec / 10n ** 26n;
+  };
+}
+function parseBigDecimalTo18(s) {
+  const SCALE = 18;
+  const [whole = "0", frac = ""] = s.split(".");
+  const padded = (frac + "0".repeat(SCALE)).slice(0, SCALE);
+  return BigInt(whole + padded);
+}
+
 // src/balance/balanceAggregator.ts
 import { getPointTokenBalance as getPointTokenBalance4 } from "@pafi-dev/core";
 var BalanceAggregator = class {
@@ -2222,7 +2323,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
   }
   async fetchIssuerState(tokenAddr) {
     const issuerAddr = await this.getIssuerAddressForPointToken(tokenAddr);
-    const [tuple, totalSupply] = await Promise.all([
+    const [issuerStruct, totalSupply] = await Promise.all([
       this.provider.readContract({
         address: this.registryAddress,
         abi: issuerRegistryAbi,
@@ -2235,17 +2336,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
         functionName: "totalSupply"
       })
     ]);
-    const issuer = {
-      issuerAddress: tuple[0],
-      signerAddress: tuple[1],
-      name: tuple[2],
-      symbol: tuple[3],
-      declaredTotalSupply: tuple[4],
-      capBasisPoints: tuple[5],
-      active: tuple[6],
-      pointToken: tuple[7],
-      mintingOracle: tuple[8]
-    };
+    const issuer = issuerStruct;
     const hardCap = issuer.declaredTotalSupply * BigInt(issuer.capBasisPoints) / 10000n;
     const remaining = hardCap > totalSupply ? hardCap - totalSupply : 0n;
     return { issuer, totalSupply, hardCap, remaining };
@@ -2280,6 +2371,7 @@ export {
   TopUpRedemptionHandler,
   authenticateRequest,
   createIssuerService,
+  createNativePtQuoter,
   createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider,
   serializeEntryToJsonRpc