@pafi-dev/issuer 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -1080,7 +1080,23 @@ interface ApiConfigResponse {
          * a swap; the pool is only discoverable when the hook matches.
          */
         pafiHook?: Address;
+        /**
+         * v1.6 — single global MintFeeWrapper that skims a fee on every
+         * sig-gated mint and distributes across the configured recipients.
+         */
+        mintFeeWrapper?: Address;
     };
+    /**
+     * v1.6 — per-PointToken mint fee (in basis points, 0–10000) read from
+     * `MintFeeWrapper.totalFeeBps(pointToken)`. Frontend uses this to show
+     * "you'll receive X PT (Y% mint fee)" before user signs.
+     *
+     * Map keyed by lower-cased PointToken address (JSON-friendly) so the
+     * FE can look up the fee without iterating. Omitted (or with zero
+     * values) when the chain has no wrapper deployed or recipients are
+     * not configured.
+     */
+    mintFeeBpsByToken?: Record<string, number>;
     /**
      * Absolute URL that the Issuer App opens after a successful claim to
      * let the user swap PT → USDT or deposit into the perp DEX on PAFI
@@ -1331,6 +1347,13 @@ interface IssuerApiHandlersConfig {
      * See [MOBILE_SDK_INTEGRATION.md] "PAFI Web Handoff".
      */
     pafiWebUrl?: string;
+    /**
+     * v1.6 — MintFeeWrapper address used to read per-PointToken fee
+     * basis points for `/config`. When omitted, the response will not
+     * include `mintFeeBpsByToken` and FE must assume zero fee. Wrapper
+     * is shared across PointTokens; per-token recipients live inside it.
+     */
+    mintFeeWrapperAddress?: Address;
     /** Required by `handleGasFee`; omit to disable the endpoint. */
     feeManager?: FeeManager;
     /** Required by `handlePools`; omit to disable the endpoint. */
@@ -1376,6 +1399,14 @@ declare class IssuerApiHandlers {
     private readonly poolsProvider?;
     private readonly redemption?;
     private readonly rateLimiter;
+    private readonly mintFeeWrapperAddress?;
+    /**
+     * Per-token feeBps cache. Refreshed on /config when stale. feeBps
+     * changes only when ops calls `wrapper.setRecipients`, so 5-min TTL
+     * is more than safe for FE display purposes.
+     */
+    private readonly feeBpsCache;
+    private static readonly FEE_BPS_TTL_MS;
     constructor(config: IssuerApiHandlersConfig);
     /**
      * `GET /auth/nonce`
@@ -1402,6 +1433,13 @@ declare class IssuerApiHandlers {
      * needs to build EIP-712 messages and interact with on-chain.
      */
     handleConfig(chainId: number): Promise<ApiConfigResponse>;
+    /**
+     * Read `totalFeeBps(pointToken)` for every supported PointToken from
+     * the wrapper. Cached per-token for 5 minutes. Returns `undefined`
+     * (caller drops the field) if every read fails — FE must treat
+     * "field missing" as "fee unknown, do not display".
+     */
+    private resolveFeeBpsByToken;
     /** `GET /gas-fee` — quoted in USDT (6-decimal base units). */
     handleGasFee(): Promise<ApiGasFeeResponse>;
     /** `POST /auth/logout` */

package/dist/index.d.ts

@@ -1080,7 +1080,23 @@ interface ApiConfigResponse {
          * a swap; the pool is only discoverable when the hook matches.
          */
         pafiHook?: Address;
+        /**
+         * v1.6 — single global MintFeeWrapper that skims a fee on every
+         * sig-gated mint and distributes across the configured recipients.
+         */
+        mintFeeWrapper?: Address;
     };
+    /**
+     * v1.6 — per-PointToken mint fee (in basis points, 0–10000) read from
+     * `MintFeeWrapper.totalFeeBps(pointToken)`. Frontend uses this to show
+     * "you'll receive X PT (Y% mint fee)" before user signs.
+     *
+     * Map keyed by lower-cased PointToken address (JSON-friendly) so the
+     * FE can look up the fee without iterating. Omitted (or with zero
+     * values) when the chain has no wrapper deployed or recipients are
+     * not configured.
+     */
+    mintFeeBpsByToken?: Record<string, number>;
     /**
      * Absolute URL that the Issuer App opens after a successful claim to
      * let the user swap PT → USDT or deposit into the perp DEX on PAFI
@@ -1331,6 +1347,13 @@ interface IssuerApiHandlersConfig {
      * See [MOBILE_SDK_INTEGRATION.md] "PAFI Web Handoff".
      */
     pafiWebUrl?: string;
+    /**
+     * v1.6 — MintFeeWrapper address used to read per-PointToken fee
+     * basis points for `/config`. When omitted, the response will not
+     * include `mintFeeBpsByToken` and FE must assume zero fee. Wrapper
+     * is shared across PointTokens; per-token recipients live inside it.
+     */
+    mintFeeWrapperAddress?: Address;
     /** Required by `handleGasFee`; omit to disable the endpoint. */
     feeManager?: FeeManager;
     /** Required by `handlePools`; omit to disable the endpoint. */
@@ -1376,6 +1399,14 @@ declare class IssuerApiHandlers {
     private readonly poolsProvider?;
     private readonly redemption?;
     private readonly rateLimiter;
+    private readonly mintFeeWrapperAddress?;
+    /**
+     * Per-token feeBps cache. Refreshed on /config when stale. feeBps
+     * changes only when ops calls `wrapper.setRecipients`, so 5-min TTL
+     * is more than safe for FE display purposes.
+     */
+    private readonly feeBpsCache;
+    private static readonly FEE_BPS_TTL_MS;
     constructor(config: IssuerApiHandlersConfig);
     /**
      * `GET /auth/nonce`
@@ -1402,6 +1433,13 @@ declare class IssuerApiHandlers {
      * needs to build EIP-712 messages and interact with on-chain.
      */
     handleConfig(chainId: number): Promise<ApiConfigResponse>;
+    /**
+     * Read `totalFeeBps(pointToken)` for every supported PointToken from
+     * the wrapper. Cached per-token for 5 minutes. Returns `undefined`
+     * (caller drops the field) if every read fails — FE must treat
+     * "field missing" as "fee unknown, do not display".
+     */
+    private resolveFeeBpsByToken;
     /** `GET /gas-fee` — quoted in USDT (6-decimal base units). */
     handleGasFee(): Promise<ApiGasFeeResponse>;
     /** `POST /auth/logout` */

package/dist/index.js

@@ -1340,12 +1340,13 @@ var BurnIndexer = class {
 // src/api/handlers.ts
 import { getAddress as getAddress5 } from "viem";
 import {
+  getMintFeeBps,
   getMintRequestNonce,
   getPointTokenBalance,
   getReceiverConsentNonce,
   isMinter
 } from "@pafi-dev/core";
-var IssuerApiHandlers = class {
+var IssuerApiHandlers = class _IssuerApiHandlers {
   authService;
   ledger;
   provider;
@@ -1361,6 +1362,14 @@ var IssuerApiHandlers = class {
   poolsProvider;
   redemption;
   rateLimiter;
+  mintFeeWrapperAddress;
+  /**
+   * Per-token feeBps cache. Refreshed on /config when stale. feeBps
+   * changes only when ops calls `wrapper.setRecipients`, so 5-min TTL
+   * is more than safe for FE display purposes.
+   */
+  feeBpsCache = /* @__PURE__ */ new Map();
+  static FEE_BPS_TTL_MS = 5 * 60 * 1e3;
   constructor(config) {
     this.authService = config.authService;
     this.ledger = config.ledger;
@@ -1380,6 +1389,9 @@ var IssuerApiHandlers = class {
     if (config.feeManager) this.feeManager = config.feeManager;
     if (config.poolsProvider) this.poolsProvider = config.poolsProvider;
     if (config.redemption) this.redemption = config.redemption;
+    if (config.mintFeeWrapperAddress) {
+      this.mintFeeWrapperAddress = getAddress5(config.mintFeeWrapperAddress);
+    }
   }
   // =========================================================================
   // Public handlers (no auth required)
@@ -1479,13 +1491,58 @@ var IssuerApiHandlers = class {
       ...this.contracts,
       pointTokens: Array.from(this.supportedTokens)
     };
+    if (this.mintFeeWrapperAddress) {
+      contracts.mintFeeWrapper = this.mintFeeWrapperAddress;
+    }
     const response = {
       chainId: this.chainId,
       contracts
     };
+    if (this.mintFeeWrapperAddress) {
+      const byToken = await this.resolveFeeBpsByToken(
+        this.mintFeeWrapperAddress
+      );
+      if (byToken) response.mintFeeBpsByToken = byToken;
+    }
     if (this.pafiWebUrl) response.pafiWebUrl = this.pafiWebUrl;
     return response;
   }
+  /**
+   * Read `totalFeeBps(pointToken)` for every supported PointToken from
+   * the wrapper. Cached per-token for 5 minutes. Returns `undefined`
+   * (caller drops the field) if every read fails — FE must treat
+   * "field missing" as "fee unknown, do not display".
+   */
+  async resolveFeeBpsByToken(wrapper) {
+    const now = Date.now();
+    const out = {};
+    let anyFresh = false;
+    await Promise.all(
+      Array.from(this.supportedTokens).map(async (token) => {
+        const cached = this.feeBpsCache.get(token);
+        if (cached && cached.expiresAt > now) {
+          out[token.toLowerCase()] = cached.value;
+          anyFresh = true;
+          return;
+        }
+        try {
+          const bps = await getMintFeeBps(this.provider, wrapper, token);
+          this.feeBpsCache.set(token, {
+            value: bps,
+            expiresAt: now + _IssuerApiHandlers.FEE_BPS_TTL_MS
+          });
+          out[token.toLowerCase()] = bps;
+          anyFresh = true;
+        } catch {
+          if (cached) {
+            out[token.toLowerCase()] = cached.value;
+            anyFresh = true;
+          }
+        }
+      })
+    );
+    return anyFresh ? out : void 0;
+  }
   /** `GET /gas-fee` — quoted in USDT (6-decimal base units). */
   async handleGasFee() {
     if (!this.feeManager) {
@@ -4231,6 +4288,9 @@ function createIssuerService(config) {
     pafiHook: chainAddresses.pafiHook,
     ...config.contracts
   };
+  if (resolvedWrapperAddress !== void 0) {
+    resolvedContracts.mintFeeWrapper = resolvedWrapperAddress;
+  }
   let redemption;
   if (config.redemption) {
     const policyConfig = {
@@ -4261,6 +4321,9 @@ function createIssuerService(config) {
   if (feeManager) handlersConfig.feeManager = feeManager;
   if (config.poolsProvider) handlersConfig.poolsProvider = config.poolsProvider;
   if (redemption) handlersConfig.redemption = redemption;
+  if (resolvedWrapperAddress !== void 0) {
+    handlersConfig.mintFeeWrapperAddress = resolvedWrapperAddress;
+  }
   const handlers = new IssuerApiHandlers(handlersConfig);
   if (config.indexer?.autoStart) {
     for (const idx of indexers.values()) {
@@ -4478,7 +4541,7 @@ var MemoryRedemptionHistoryStore = class {
 };
 
 // src/index.ts
-var PAFI_ISSUER_SDK_VERSION = true ? "0.11.0" : "dev";
+var PAFI_ISSUER_SDK_VERSION = true ? "0.12.0" : "dev";
 export {
   AdapterMisconfiguredError,
   AuthError,