@pafi-dev/issuer 0.5.1 → 0.5.3

package/dist/index.d.cts

@@ -1222,15 +1222,18 @@ declare class TopUpRedemptionHandler {
     handle(request: TopUpRedemptionRequest): Promise<TopUpRedemptionResponse>;
 }
 
+/** PAFI-hosted subgraph endpoint. Used as the default for all subgraph helpers. */
+declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v2";
 /**
  * Config for `createSubgraphPoolsProvider`.
  */
 interface SubgraphPoolsProviderConfig {
     /**
-     * Fully qualified subgraph GraphQL endpoint. Example:
-     * `https://graph.pacificfinance.org/subgraphs/name/pafi`
+     * Fully qualified subgraph GraphQL endpoint.
+     * Defaults to the PAFI-hosted subgraph (`PAFI_SUBGRAPH_URL`).
+     * Override only when pointing at a staging or custom deployment.
      */
-    subgraphUrl: string;
+    subgraphUrl?: string;
     /**
      * Cache TTL in milliseconds. Pool discovery is near-static — a 30s
      * cache removes subgraph load without meaningfully delaying UX.
@@ -1278,17 +1281,18 @@ interface SubgraphPoolsProviderConfig {
  * });
  * ```
  */
-declare function createSubgraphPoolsProvider(config: SubgraphPoolsProviderConfig): PoolsProvider;
+declare function createSubgraphPoolsProvider(config?: SubgraphPoolsProviderConfig): PoolsProvider;
 
 /**
  * Config for `createSubgraphNativeUsdtQuoter`.
  */
 interface SubgraphNativeUsdtQuoterConfig {
     /**
-     * Fully qualified subgraph GraphQL endpoint. Same URL used by
-     * `createSubgraphPoolsProvider`.
+     * Fully qualified subgraph GraphQL endpoint.
+     * Defaults to the PAFI-hosted subgraph (`PAFI_SUBGRAPH_URL`).
+     * Override only when pointing at a staging or custom deployment.
      */
-    subgraphUrl: string;
+    subgraphUrl?: string;
     /**
      * Decimals of the USDT token. Defaults to 6 (standard USDT/USDC on
      * Base, Ethereum, Polygon). Override for chains where USDT uses a
@@ -1349,7 +1353,7 @@ interface SubgraphNativeUsdtQuoterConfig {
  * });
  * ```
  */
-declare function createSubgraphNativeUsdtQuoter(config: SubgraphNativeUsdtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
+declare function createSubgraphNativeUsdtQuoter(config?: SubgraphNativeUsdtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
 
 /**
  * Combined off-chain + on-chain balance for a single user / token pair.
@@ -1478,10 +1482,12 @@ interface IssuerServiceConfig {
     /** All PointToken addresses this issuer supports. */
     pointTokenAddresses?: Address[];
     /**
-     * Full contract address bundle returned verbatim by `handleConfig` so
-     * the frontend SDK can pick them up.
+     * Issuer-specific contract addresses merged into the `/config` response.
+     * PAFI-owned addresses (batchExecutor, usdt, issuerRegistry, mintingOracle,
+     * pafiHook) are auto-resolved from `getContractAddresses(chainId)` and
+     * can be omitted. Only `pointToken` / `pointTokens` must be provided.
      */
-    contracts: ApiConfigResponse["contracts"];
+    contracts?: Pick<ApiConfigResponse["contracts"], "pointToken" | "pointTokens" | "relay">;
     /**
      * Shared `PublicClient` used for on-chain reads, simulation, indexer
      * polling, and gas-price lookups. Must be pointed at the target chain.
@@ -1526,7 +1532,8 @@ interface IssuerServiceConfig {
      */
     claim?: {
         issuerSignerWallet: WalletClient;
-        batchExecutorAddress: Address;
+        /** Defaults to the PAFI-deployed BatchExecutor for the target chain. */
+        batchExecutorAddress?: Address;
         lockDurationMs?: number;
     };
     indexer?: {
@@ -1580,4 +1587,4 @@ declare function createIssuerService(config: IssuerServiceConfig): IssuerService
 /** SDK package version — bumped on every release */
 declare const PAFI_ISSUER_SDK_VERSION = "0.4.0";
 
-export { type ApiBuildConsentTypedDataRequest, type ApiBuildConsentTypedDataResponse, type ApiClaimAndSwapRequest, type ApiClaimAndSwapResponse, type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, 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 IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerService, type IssuerServiceConfig, 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, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, 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 };
+export { type ApiBuildConsentTypedDataRequest, type ApiBuildConsentTypedDataResponse, type ApiClaimAndSwapRequest, type ApiClaimAndSwapResponse, type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, 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 IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerService, type IssuerServiceConfig, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintingStatus, NonceManager, PAFI_ISSUER_SDK_VERSION, PAFI_SUBGRAPH_URL, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, 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 };

package/dist/index.d.ts

@@ -1222,15 +1222,18 @@ declare class TopUpRedemptionHandler {
     handle(request: TopUpRedemptionRequest): Promise<TopUpRedemptionResponse>;
 }
 
+/** PAFI-hosted subgraph endpoint. Used as the default for all subgraph helpers. */
+declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v2";
 /**
  * Config for `createSubgraphPoolsProvider`.
  */
 interface SubgraphPoolsProviderConfig {
     /**
-     * Fully qualified subgraph GraphQL endpoint. Example:
-     * `https://graph.pacificfinance.org/subgraphs/name/pafi`
+     * Fully qualified subgraph GraphQL endpoint.
+     * Defaults to the PAFI-hosted subgraph (`PAFI_SUBGRAPH_URL`).
+     * Override only when pointing at a staging or custom deployment.
      */
-    subgraphUrl: string;
+    subgraphUrl?: string;
     /**
      * Cache TTL in milliseconds. Pool discovery is near-static — a 30s
      * cache removes subgraph load without meaningfully delaying UX.
@@ -1278,17 +1281,18 @@ interface SubgraphPoolsProviderConfig {
  * });
  * ```
  */
-declare function createSubgraphPoolsProvider(config: SubgraphPoolsProviderConfig): PoolsProvider;
+declare function createSubgraphPoolsProvider(config?: SubgraphPoolsProviderConfig): PoolsProvider;
 
 /**
  * Config for `createSubgraphNativeUsdtQuoter`.
  */
 interface SubgraphNativeUsdtQuoterConfig {
     /**
-     * Fully qualified subgraph GraphQL endpoint. Same URL used by
-     * `createSubgraphPoolsProvider`.
+     * Fully qualified subgraph GraphQL endpoint.
+     * Defaults to the PAFI-hosted subgraph (`PAFI_SUBGRAPH_URL`).
+     * Override only when pointing at a staging or custom deployment.
      */
-    subgraphUrl: string;
+    subgraphUrl?: string;
     /**
      * Decimals of the USDT token. Defaults to 6 (standard USDT/USDC on
      * Base, Ethereum, Polygon). Override for chains where USDT uses a
@@ -1349,7 +1353,7 @@ interface SubgraphNativeUsdtQuoterConfig {
  * });
  * ```
  */
-declare function createSubgraphNativeUsdtQuoter(config: SubgraphNativeUsdtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
+declare function createSubgraphNativeUsdtQuoter(config?: SubgraphNativeUsdtQuoterConfig): (amountNative: bigint) => Promise<bigint>;
 
 /**
  * Combined off-chain + on-chain balance for a single user / token pair.
@@ -1478,10 +1482,12 @@ interface IssuerServiceConfig {
     /** All PointToken addresses this issuer supports. */
     pointTokenAddresses?: Address[];
     /**
-     * Full contract address bundle returned verbatim by `handleConfig` so
-     * the frontend SDK can pick them up.
+     * Issuer-specific contract addresses merged into the `/config` response.
+     * PAFI-owned addresses (batchExecutor, usdt, issuerRegistry, mintingOracle,
+     * pafiHook) are auto-resolved from `getContractAddresses(chainId)` and
+     * can be omitted. Only `pointToken` / `pointTokens` must be provided.
      */
-    contracts: ApiConfigResponse["contracts"];
+    contracts?: Pick<ApiConfigResponse["contracts"], "pointToken" | "pointTokens" | "relay">;
     /**
      * Shared `PublicClient` used for on-chain reads, simulation, indexer
      * polling, and gas-price lookups. Must be pointed at the target chain.
@@ -1526,7 +1532,8 @@ interface IssuerServiceConfig {
      */
     claim?: {
         issuerSignerWallet: WalletClient;
-        batchExecutorAddress: Address;
+        /** Defaults to the PAFI-deployed BatchExecutor for the target chain. */
+        batchExecutorAddress?: Address;
         lockDurationMs?: number;
     };
     indexer?: {
@@ -1580,4 +1587,4 @@ declare function createIssuerService(config: IssuerServiceConfig): IssuerService
 /** SDK package version — bumped on every release */
 declare const PAFI_ISSUER_SDK_VERSION = "0.4.0";
 
-export { type ApiBuildConsentTypedDataRequest, type ApiBuildConsentTypedDataResponse, type ApiClaimAndSwapRequest, type ApiClaimAndSwapResponse, type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, 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 IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerService, type IssuerServiceConfig, 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, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, 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 };
+export { type ApiBuildConsentTypedDataRequest, type ApiBuildConsentTypedDataResponse, type ApiClaimAndSwapRequest, type ApiClaimAndSwapResponse, type ApiClaimRequest, type ApiClaimResponse, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, 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 IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerService, type IssuerServiceConfig, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintingStatus, NonceManager, PAFI_ISSUER_SDK_VERSION, PAFI_SUBGRAPH_URL, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, RelayError, type RelayErrorCode, RelayService, 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 };

package/dist/index.js

@@ -1499,6 +1499,7 @@ var TopUpRedemptionHandler = class {
 
 // src/pools/subgraphPoolsProvider.ts
 import { isAddress } from "viem";
+var PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v2";
 var DEFAULT_CACHE_TTL_MS = 3e4;
 var POOL_QUERY = `
   query GetPoolForPointToken($id: ID!) {
@@ -1515,21 +1516,17 @@ var POOL_QUERY = `
     }
   }
 `;
-function createSubgraphPoolsProvider(config) {
-  if (!config.subgraphUrl) {
-    throw new Error(
-      "createSubgraphPoolsProvider: subgraphUrl is required"
-    );
-  }
+function createSubgraphPoolsProvider(config = {}) {
+  const subgraphUrl = config.subgraphUrl ?? PAFI_SUBGRAPH_URL;
   try {
-    const parsed = new URL(config.subgraphUrl);
+    const parsed = new URL(subgraphUrl);
     if (process.env.NODE_ENV === "production" && parsed.protocol !== "https:") {
       throw new Error("subgraphUrl must use HTTPS in production");
     }
   } catch (err) {
     if (err instanceof TypeError) {
       throw new Error(
-        `subgraphPoolsProvider: invalid subgraphUrl: ${config.subgraphUrl}`
+        `subgraphPoolsProvider: invalid subgraphUrl: ${subgraphUrl}`
       );
     }
     throw err;
@@ -1553,7 +1550,7 @@ function createSubgraphPoolsProvider(config) {
     }
     const pools = await fetchPoolsFromSubgraph(
       fetchImpl,
-      config.subgraphUrl,
+      subgraphUrl,
       request.pointTokenAddress
     );
     if (cacheTtl > 0) {
@@ -1651,21 +1648,17 @@ var PRICE_QUERY = `
     }
   }
 `;
-function createSubgraphNativeUsdtQuoter(config) {
-  if (!config.subgraphUrl) {
-    throw new Error(
-      "createSubgraphNativeUsdtQuoter: subgraphUrl is required"
-    );
-  }
+function createSubgraphNativeUsdtQuoter(config = {}) {
+  const subgraphUrl = config.subgraphUrl ?? PAFI_SUBGRAPH_URL;
   try {
-    const parsed = new URL(config.subgraphUrl);
+    const parsed = new URL(subgraphUrl);
     if (process.env.NODE_ENV === "production" && parsed.protocol !== "https:") {
       throw new Error("subgraphUrl must use HTTPS in production");
     }
   } catch (err) {
     if (err instanceof TypeError) {
       throw new Error(
-        `subgraphPoolsProvider: invalid subgraphUrl: ${config.subgraphUrl}`
+        `createSubgraphNativeUsdtQuoter: invalid subgraphUrl: ${subgraphUrl}`
       );
     }
     throw err;
@@ -1688,7 +1681,7 @@ function createSubgraphNativeUsdtQuoter(config) {
     }
     const price = await fetchEthPriceFromSubgraph(
       fetchImpl,
-      config.subgraphUrl
+      subgraphUrl
     );
     const usdtPerNative = toUsdtPerNative(
       price ?? fallbackPrice,
@@ -1935,6 +1928,7 @@ var PafiBackendClient = class {
 
 // src/config.ts
 import { getAddress as getAddress8 } from "viem";
+import { getContractAddresses } from "@pafi-dev/core";
 function createIssuerService(config) {
   if (!config.provider) {
     throw new Error("createIssuerService: provider is required");
@@ -2001,13 +1995,22 @@ function createIssuerService(config) {
     indexers.set(tokenAddress, new PointIndexer(indexerConfig));
   }
   const firstIndexer = indexers.get(tokenAddresses[0]);
+  const chainAddresses = getContractAddresses(config.chainId);
+  const resolvedContracts = {
+    batchExecutor: chainAddresses.batchExecutor,
+    usdt: chainAddresses.usdt,
+    issuerRegistry: chainAddresses.issuerRegistry,
+    mintingOracle: chainAddresses.mintingOracle,
+    pafiHook: chainAddresses.pafiHook,
+    ...config.contracts
+  };
   const handlersConfig = {
     authService,
     ledger,
     provider: config.provider,
     pointTokenAddresses: tokenAddresses,
     chainId: config.chainId,
-    contracts: config.contracts
+    contracts: resolvedContracts
   };
   if (feeManager) handlersConfig.feeManager = feeManager;
   if (config.poolsProvider) handlersConfig.poolsProvider = config.poolsProvider;
@@ -2016,7 +2019,7 @@ function createIssuerService(config) {
       policy,
       relayService,
       issuerSignerWallet: config.claim.issuerSignerWallet,
-      batchExecutorAddress: config.claim.batchExecutorAddress,
+      batchExecutorAddress: config.claim.batchExecutorAddress ?? chainAddresses.batchExecutor,
       lockDurationMs: config.claim.lockDurationMs
     };
   }
@@ -2053,6 +2056,7 @@ export {
   MemorySessionStore,
   NonceManager,
   PAFI_ISSUER_SDK_VERSION,
+  PAFI_SUBGRAPH_URL,
   PTRedeemError,
   PTRedeemHandler,
   PafiBackendClient,