@pafi-dev/issuer 0.5.37 → 0.5.39

package/dist/index.d.cts

@@ -2,6 +2,40 @@ import { Address, Hex, PublicClient, WalletClient } from 'viem';
 import { PointTokenDomainConfig, PartialUserOperation, BurnRequest, PoolKey, UserOpTypedData, decodeBatchExecuteCalls, BROKER_HASHES, Eip7702AuthorizationJsonRpc, ENTRY_POINT_V08 } from '@pafi-dev/core';
 export { PAFI_SUBGRAPH_URL } from '@pafi-dev/core';
 
+/**
+ * Base class for every typed error the SDK throws across handlers,
+ * orchestrators, and helpers. The shape is intentionally minimal so
+ * issuer controllers can map all SDK errors through a single funnel
+ * (`createSdkErrorMapper`) without listing each subclass.
+ *
+ * Subclasses must declare `code` (machine-readable identifier the FE
+ * can branch on) and may override `safeToRetry` (transient failures
+ * the FE should auto-retry — e.g. cap freed up between requests).
+ *
+ * `details` is `unknown` so subclasses can attach structured context
+ * (offending value, on-chain state snapshot, etc.) without locking
+ * the base shape.
+ *
+ * `httpStatus` is the recommended HTTP status the issuer's HTTP layer
+ * should surface. Kept on the SDK side because the SDK already knows
+ * the right status (e.g. `IssuerStateError` is always 422); leaving it
+ * to issuer controllers means each one re-implements the same mapping.
+ */
+type SdkErrorHttpStatus = "not_found" | "forbidden" | "unprocessable" | "service_unavailable";
+declare abstract class PafiSdkError extends Error {
+    abstract readonly code: string;
+    /**
+     * `true` when the FE should consider a retry safe — typically because
+     * the failure is transient (`MINT_CAP_EXCEEDED` may free up,
+     * `RELAY_FEE_EXCEEDS_AMOUNT` may drop on next quote). Defaults to
+     * `false` — subclasses opt in per-code.
+     */
+    readonly safeToRetry: boolean;
+    readonly details?: unknown;
+    abstract readonly httpStatus: SdkErrorHttpStatus;
+    constructor(message: string);
+}
+
 /**
  * Lifecycle of a minting request as tracked by the issuer's point ledger.
  *
@@ -1182,6 +1216,13 @@ interface PTRedeemHandlerConfig {
      * provisioning time. Typically HSM/KMS-backed in prod.
      */
     burnerSignerWallet: WalletClient;
+    /**
+     * Optional — when wired, used to estimate the PT gas-reimbursement
+     * fee. The handler self-computes `feeAmount` + `feeRecipient` so the
+     * caller doesn't repeat the boilerplate at each endpoint. Pass
+     * `feeAmount` on `PTRedeemRequest` to override.
+     */
+    feeService?: FeeManager;
     /**
      * How long the pending credit stays reserved if the burn never lands.
      * Default: 15 min — long enough for a bundler submission + confirmation.
@@ -1204,11 +1245,19 @@ interface PTRedeemRequest {
     /** ERC-4337 account nonce for the user's EOA. */
     aaNonce: bigint;
     /**
-     * Optional PT fee transfer appended after the burn (sponsored path).
-     * User must hold `amount + feeAmount` PT. Both fields together or neither.
+     * Optional override — explicit PT fee transfer appended after the
+     * burn (sponsored path). When omitted, the handler auto-computes
+     * via `feeService.estimateGasFee()` (if configured) and resolves
+     * the recipient from `getContractAddresses(chainId).pafiFeeRecipient`.
      */
     feeAmount?: bigint;
     feeRecipient?: Address;
+    /**
+     * Optional — required only when the handler self-computes the
+     * recipient. When the caller passes an explicit `feeRecipient`, this
+     * is ignored.
+     */
+    chainId?: number;
 }
 interface PTRedeemResponse {
     /**
@@ -1220,6 +1269,12 @@ interface PTRedeemResponse {
     userOp: PartialUserOperation;
     /** = request.amount - feeAmount. What BurnIndexer credits off-chain on sponsored fire. */
     netCreditAmount: bigint;
+    /**
+     * Resolved fee — computed via `feeService.estimateGasFee()` when the
+     * caller didn't override on the request, else echoed back from the
+     * request override. Useful for the FE confirmation screen.
+     */
+    feeAmount: bigint;
     /**
      * Fallback path — UserOp with NO fee transfer. BurnRequest signed for
      * full `request.amount`. User pays gas in ETH directly. Present only
@@ -1240,14 +1295,17 @@ interface PTRedeemResponse {
     /** The BurnRequest deadline (unix seconds) — FE uses this to surface a countdown. */
     signatureDeadline: bigint;
 }
-declare class PTRedeemError extends Error {
-    code: "UNAUTHORIZED" | "INVALID_AMOUNT" | "NONCE_READ_FAILED" | "NONCE_IN_FLIGHT" | "LEDGER_NOT_SUPPORTED" | "SIGNING_FAILED";
-    constructor(code: "UNAUTHORIZED" | "INVALID_AMOUNT" | "NONCE_READ_FAILED" | "NONCE_IN_FLIGHT" | "LEDGER_NOT_SUPPORTED" | "SIGNING_FAILED", message: string);
+type PTRedeemErrorCode = "UNAUTHORIZED" | "INVALID_AMOUNT" | "NONCE_READ_FAILED" | "NONCE_IN_FLIGHT" | "LEDGER_NOT_SUPPORTED" | "SIGNING_FAILED";
+declare class PTRedeemError extends PafiSdkError {
+    readonly httpStatus: "unprocessable";
+    readonly code: PTRedeemErrorCode;
+    constructor(code: PTRedeemErrorCode, message: string);
 }
 declare class PTRedeemHandler {
     private readonly ledger;
     private readonly relayService;
     private readonly provider;
+    private readonly feeService?;
     private readonly pointTokenAddress;
     private readonly batchExecutorAddress;
     private readonly chainId;
@@ -1489,7 +1547,7 @@ interface MintStatusParams {
      * `PointIndexer`'s amount-based race (multiple PENDING locks with
      * the same amount can be matched to the wrong tx_hash).
      */
-    pafiBackendClient?: PafiBackendClient;
+    pafiBackendClient?: PafiBackendClient | null;
     /** Optional logger for "ledger update failed" warnings. */
     onWarning?: (msg: string) => void;
 }
@@ -1497,11 +1555,12 @@ interface BurnStatusParams {
     lockId: string;
     userAddress: Address;
     ledger: IPointLedger;
-    pafiBackendClient?: PafiBackendClient;
+    pafiBackendClient?: PafiBackendClient | null;
     onWarning?: (msg: string) => void;
 }
-declare class LockNotFoundError extends Error {
+declare class LockNotFoundError extends PafiSdkError {
     readonly code = "LOCK_NOT_FOUND";
+    readonly httpStatus: "not_found";
     constructor();
 }
 
@@ -1756,8 +1815,25 @@ declare function prepareMobileUserOp(params: PrepareMobileUserOpParams): Promise
  * Issuer controllers shrink to ~30 LoC each — wire the handler that
  * produces `partialUserOp[+ fallback]`, hand off to these.
  */
-declare class PendingUserOpNotFoundError extends Error {
+declare class PendingUserOpNotFoundError extends PafiSdkError {
     readonly code = "PENDING_USEROP_NOT_FOUND";
+    readonly httpStatus: "not_found";
+    constructor(lockId: string);
+}
+/**
+ * Thrown when the authenticated user attempts to submit a pending
+ * UserOp that belongs to a different sender. Map to 403.
+ *
+ * The pending-userop store is keyed by `lockId` (a UUID), but lockIds
+ * are predictable by anyone who logs them — without this check, user A
+ * could submit user B's UserOp once they leak/guess the lockId. The
+ * UserOp signature itself recovers to user B (so on-chain it would
+ * fail), but the issuer would still bind the bundler hash to user B's
+ * lock and consume relay quota, enabling DoS / state pollution.
+ */
+declare class PendingUserOpForbiddenError extends PafiSdkError {
+    readonly code = "PENDING_USEROP_FORBIDDEN";
+    readonly httpStatus: "forbidden";
     constructor(lockId: string);
 }
 interface HandleMobilePrepareParams {
@@ -1817,6 +1893,13 @@ interface HandleMobilePrepareResult extends PrepareMobileUserOpResult {
 declare function handleMobilePrepare(params: HandleMobilePrepareParams): Promise<HandleMobilePrepareResult>;
 interface HandleMobileSubmitParams {
     lockId: string;
+    /**
+     * Authenticated user EOA — extracted from the JWT / session by the
+     * caller. Enforces ownership: the helper rejects with
+     * `PendingUserOpForbiddenError` when `entry.sender !==
+     * authenticatedAddress`.
+     */
+    authenticatedAddress: Address;
     /** User signature over `userOpHash` (or `userOpHashFallback`). */
     signature: Hex;
     /** Which variant the user actually signed. Defaults to `'sponsored'`. */
@@ -1840,6 +1923,8 @@ interface HandleMobileSubmitParams {
  * Throws:
  *   - `PendingUserOpNotFoundError` — entry expired or already submitted.
  *     Map to 404.
+ *   - `PendingUserOpForbiddenError` — `entry.sender` doesn't match the
+ *     authenticated user. Map to 403.
  *   - `BundlerNotConfiguredError` — `pafiBackendClient` missing. Map to 503.
  *   - `BundlerRejectedError` — bundler rejected the UserOp. Map to 422.
  */
@@ -1870,10 +1955,12 @@ interface IssuerStateValidatorLike {
  * own composer — gg56 uses a timestamp-key 2D nonce). Caller layers
  * paymaster sponsorship + sponsorAuth on top of the returned UserOps.
  */
-declare class PTClaimError extends Error {
-    code: "INVALID_AMOUNT" | "VALIDATION_FAILED" | "BUILD_FAILED";
-    details?: Record<string, unknown> | undefined;
-    constructor(code: "INVALID_AMOUNT" | "VALIDATION_FAILED" | "BUILD_FAILED", message: string, details?: Record<string, unknown> | undefined);
+type PTClaimErrorCode = "INVALID_AMOUNT" | "VALIDATION_FAILED" | "BUILD_FAILED";
+declare class PTClaimError extends PafiSdkError {
+    readonly httpStatus: "unprocessable";
+    readonly code: PTClaimErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: PTClaimErrorCode, message: string, details?: Record<string, unknown>);
 }
 interface PTClaimHandlerConfig {
     ledger: IPointLedger;
@@ -1953,9 +2040,11 @@ type DecodedCall$1 = ReturnType<typeof decodeBatchExecuteCalls>[number];
  * userOp. No off-chain ledger state is touched — swap is purely
  * on-chain.
  */
-declare class SwapError extends Error {
-    code: "QUOTE_UNAVAILABLE" | "FEE_EXCEEDS_AMOUNT" | "INVALID_AMOUNT";
-    constructor(code: "QUOTE_UNAVAILABLE" | "FEE_EXCEEDS_AMOUNT" | "INVALID_AMOUNT", message: string);
+type SwapErrorCode = "QUOTE_UNAVAILABLE" | "FEE_EXCEEDS_AMOUNT" | "INVALID_AMOUNT";
+declare class SwapError extends PafiSdkError {
+    readonly httpStatus: "unprocessable";
+    readonly code: SwapErrorCode;
+    constructor(code: SwapErrorCode, message: string);
 }
 interface SwapHandlerConfig {
     provider: PublicClient;
@@ -2024,9 +2113,12 @@ type DecodedCall = ReturnType<typeof decodeBatchExecuteCalls>[number];
  * USD-pricing during the inclusion window. If the actual fee at
  * execution exceeds maxFee the Relay reverts (`FeeExceedsMax`).
  */
-declare class PerpDepositError extends Error {
-    code: "PERP_DEPOSIT_UNAVAILABLE" | "BROKER_NOT_WHITELISTED" | "RELAY_FEE_EXCEEDS_AMOUNT" | "FEE_EXCEEDS_AMOUNT" | "INVALID_AMOUNT";
-    constructor(code: "PERP_DEPOSIT_UNAVAILABLE" | "BROKER_NOT_WHITELISTED" | "RELAY_FEE_EXCEEDS_AMOUNT" | "FEE_EXCEEDS_AMOUNT" | "INVALID_AMOUNT", message: string);
+type PerpDepositErrorCode = "PERP_DEPOSIT_UNAVAILABLE" | "BROKER_NOT_WHITELISTED" | "RELAY_FEE_EXCEEDS_AMOUNT" | "FEE_EXCEEDS_AMOUNT" | "INVALID_AMOUNT";
+declare class PerpDepositError extends PafiSdkError {
+    readonly httpStatus: "unprocessable";
+    readonly code: PerpDepositErrorCode;
+    readonly safeToRetry: boolean;
+    constructor(code: PerpDepositErrorCode, message: string);
 }
 interface PerpDepositHandlerConfig {
     provider: PublicClient;
@@ -2156,6 +2248,62 @@ interface QuotePointTokenToUsdtResult {
 }
 declare function quotePointTokenToUsdt(params: QuotePointTokenToUsdtParams): Promise<QuotePointTokenToUsdtResult>;
 
+/**
+ * Normalized HTTP status the issuer controller should surface for a
+ * given SDK error. Mirrors `SdkErrorHttpStatus` on `PafiSdkError`.
+ */
+type SdkErrorStatus = SdkErrorHttpStatus;
+/**
+ * Structured body the issuer controller passes to its
+ * framework-specific exception class. Mirrors the shape every PAFI
+ * issuer surfaces over HTTP today.
+ */
+interface SdkErrorBody {
+    code: string;
+    message: string;
+    details?: unknown;
+    safeToRetry: boolean;
+}
+/**
+ * Per-status exception factories. The issuer's controller wires one
+ * factory per status to its preferred framework's exception class
+ * (NestJS `UnprocessableEntityException`, Fastify `httpErrors.badData`,
+ * etc). The factory must return an Error — `createSdkErrorMapper`
+ * uses `throw factory(body)`.
+ */
+interface SdkErrorMapperFactories {
+    notFound: (body: SdkErrorBody) => Error;
+    forbidden: (body: SdkErrorBody) => Error;
+    unprocessable: (body: SdkErrorBody) => Error;
+    serviceUnavailable: (body: SdkErrorBody) => Error;
+}
+/**
+ * Build a single error-mapping function that converts any `PafiSdkError`
+ * into the issuer's framework-specific HTTP exception. Status, code,
+ * `safeToRetry`, and `details` come straight off the error class —
+ * the mapper is a dumb funnel, no per-error business logic.
+ *
+ * Any non-`PafiSdkError` is re-thrown unchanged so unexpected runtime
+ * errors propagate to the framework's default 500 handler.
+ *
+ * Usage (NestJS):
+ *
+ * ```ts
+ * const mapSdkError = createSdkErrorMapper({
+ *   notFound: (body) => new NotFoundException(body),
+ *   forbidden: (body) => new ForbiddenException(body),
+ *   unprocessable: (body) => new UnprocessableEntityException(body),
+ *   serviceUnavailable: (body) => new ServiceUnavailableException(body),
+ * });
+ *
+ * try { ... } catch (err) { mapSdkError(err); }
+ * ```
+ *
+ * Returns `never` so call sites in `try/catch` propagate the throw
+ * without a redundant `throw` keyword.
+ */
+declare function createSdkErrorMapper(factories: SdkErrorMapperFactories): (err: unknown) => never;
+
 /**
  * Config for `createSubgraphPoolsProvider`.
  */
@@ -2379,12 +2527,14 @@ declare class BalanceAggregator {
  * here because the SDK is framework-agnostic; the consuming controller
  * wraps each one in its preferred exception class.
  */
-declare class BundlerNotConfiguredError extends Error {
+declare class BundlerNotConfiguredError extends PafiSdkError {
     readonly code = "BUNDLER_NOT_CONFIGURED";
+    readonly httpStatus: "service_unavailable";
     constructor();
 }
-declare class BundlerRejectedError extends Error {
+declare class BundlerRejectedError extends PafiSdkError {
     readonly code = "BUNDLER_REJECTED";
+    readonly httpStatus: "unprocessable";
     readonly cause: unknown;
     constructor(message: string, cause: unknown);
 }
@@ -2611,11 +2761,18 @@ interface PreValidateMintResult {
 /**
  * Thrown by `IssuerStateValidator.preValidateMint()`.
  * `code` maps 1:1 to the HTTP error the issuer API surfaces to clients.
+ *
+ * `MINT_CAP_EXCEEDED` is `safeToRetry: true` because the cap may free
+ * up between requests as other mints expire or settle. The other two
+ * codes are configuration-time states — the FE can't recover by retry.
  */
-declare class IssuerStateError extends Error {
-    readonly code: "ISSUER_NOT_REGISTERED" | "ISSUER_INACTIVE" | "MINT_CAP_EXCEEDED";
-    readonly details?: Record<string, unknown> | undefined;
-    constructor(code: "ISSUER_NOT_REGISTERED" | "ISSUER_INACTIVE" | "MINT_CAP_EXCEEDED", message: string, details?: Record<string, unknown> | undefined);
+type IssuerStateErrorCode = "ISSUER_NOT_REGISTERED" | "ISSUER_INACTIVE" | "MINT_CAP_EXCEEDED";
+declare class IssuerStateError extends PafiSdkError {
+    readonly httpStatus: "unprocessable";
+    readonly code: IssuerStateErrorCode;
+    readonly details?: Record<string, unknown>;
+    readonly safeToRetry: boolean;
+    constructor(code: IssuerStateErrorCode, message: string, details?: Record<string, unknown>);
 }
 
 /**
@@ -2680,4 +2837,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, BundlerNotConfiguredError, BundlerRejectedError, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type BurnStatusParams, type BurnStatusResponse, type CombinedBalance, DefaultPolicyEngine, type DefaultPolicyEngineOptions, FeeManager, type FeeManagerConfig, type HandleDelegateSubmitParams, type HandleDelegateSubmitResult, type HandleMobilePrepareParams, type HandleMobilePrepareResult, type HandleMobileSubmitParams, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, LockNotFoundError, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintStatusParams, type MintStatusResponse, type MintingStatus, type NativePtQuoterConfig, NonceManager, PAFI_ISSUER_SDK_VERSION, PTClaimError, PTClaimHandler, type PTClaimHandlerConfig, type PTClaimRequest, type PTClaimResponse, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, type PendingCredit, type PendingUserOpEntry, PendingUserOpNotFoundError, PerpDepositError, PerpDepositHandler, type PerpDepositHandlerConfig, type PerpDepositRequest, type PerpDepositResponse, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PreValidateMintResult, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, type PrepareMobileUserOpParams, type PrepareMobileUserOpResult, type PreparedUserOp, type QuotePointTokenToUsdtParams, type QuotePointTokenToUsdtResult, RelayError, type RelayErrorCode, RelayService, type RelayUserOpParams, type RelayUserOpRequest, type RelayUserOpResponse, type RequestPaymasterParams, type RetryConfig, type SerializedUserOpTypedData, type Session, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, SwapError, SwapHandler, type SwapHandlerConfig, type SwapRequest, type SwapResponse, TopUpRedemptionError, TopUpRedemptionHandler, type TopUpRedemptionHandlerConfig, type TopUpRedemptionRequest, type TopUpRedemptionResponse, authenticateRequest, createIssuerService, createNativePtQuoter, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, handleClaimStatus, handleDelegateSubmit, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, mergePaymasterFields, prepareMobileUserOp, quotePointTokenToUsdt, relayUserOp, requestPaymaster, serializeEntryToJsonRpc, serializeUserOpTypedData };
+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, BundlerNotConfiguredError, BundlerRejectedError, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type BurnStatusParams, type BurnStatusResponse, type CombinedBalance, DefaultPolicyEngine, type DefaultPolicyEngineOptions, FeeManager, type FeeManagerConfig, type HandleDelegateSubmitParams, type HandleDelegateSubmitResult, type HandleMobilePrepareParams, type HandleMobilePrepareResult, type HandleMobileSubmitParams, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type ISessionStore, InMemoryCursorStore, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, LockNotFoundError, type LockedMintRequest, type LoginResult, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintStatusParams, type MintStatusResponse, type MintingStatus, type NativePtQuoterConfig, NonceManager, PAFI_ISSUER_SDK_VERSION, PTClaimError, PTClaimHandler, type PTClaimHandlerConfig, type PTClaimRequest, type PTClaimResponse, PTRedeemError, PTRedeemHandler, type PTRedeemHandlerConfig, type PTRedeemRequest, type PTRedeemResponse, PafiBackendClient, type PafiBackendConfig, PafiBackendError, type PafiBackendErrorCode, PafiSdkError, type PendingCredit, type PendingUserOpEntry, PendingUserOpForbiddenError, PendingUserOpNotFoundError, PerpDepositError, PerpDepositHandler, type PerpDepositHandlerConfig, type PerpDepositRequest, type PerpDepositResponse, PointIndexer, type PointIndexerConfig, type PolicyDecision, type PolicyEvalRequest, type PoolsProvider, type PreValidateMintResult, type PrepareBurnDirectParams, type PrepareBurnParams, type PrepareBurnWithSigParams, type PrepareMintParams, type PrepareMobileUserOpParams, type PrepareMobileUserOpResult, type PreparedUserOp, type QuotePointTokenToUsdtParams, type QuotePointTokenToUsdtResult, RelayError, type RelayErrorCode, RelayService, type RelayUserOpParams, type RelayUserOpRequest, type RelayUserOpResponse, type RequestPaymasterParams, type RetryConfig, type SdkErrorBody, type SdkErrorHttpStatus, type SdkErrorMapperFactories, type SdkErrorStatus, type SerializedUserOpTypedData, type Session, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, SwapError, SwapHandler, type SwapHandlerConfig, type SwapRequest, type SwapResponse, TopUpRedemptionError, TopUpRedemptionHandler, type TopUpRedemptionHandlerConfig, type TopUpRedemptionRequest, type TopUpRedemptionResponse, authenticateRequest, createIssuerService, createNativePtQuoter, createSdkErrorMapper, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, handleClaimStatus, handleDelegateSubmit, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, mergePaymasterFields, prepareMobileUserOp, quotePointTokenToUsdt, relayUserOp, requestPaymaster, serializeEntryToJsonRpc, serializeUserOpTypedData };