@pafi-dev/issuer 0.5.36 → 0.5.38

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { Address, Hex, PublicClient, WalletClient } from 'viem';
-import { PointTokenDomainConfig, PartialUserOperation, BurnRequest, PoolKey, UserOpTypedData, decodeBatchExecuteCalls, BROKER_HASHES, ENTRY_POINT_V08 } from '@pafi-dev/core';
+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';
 
 /**
@@ -2069,6 +2069,155 @@ declare class PerpDepositHandler {
     handle(request: PerpDepositRequest): Promise<PerpDepositResponse>;
 }
 
+/**
+ * Pure mechanics for the EIP-7702 delegation submit flow. Builds the
+ * empty-batch UserOp, attaches paymaster sponsorship, splits the user's
+ * authorization signature into the JSON-RPC tuple, and relays via the
+ * PAFI sponsor-relayer.
+ *
+ * The UserOp itself is a no-op — `BatchExecutor.execute([])` does
+ * nothing. The work is in the `eip7702Auth` object: the bundler picks
+ * it up, runs the EIP-7702 path, and installs the delegation on the
+ * user's EOA atomically with the (empty) UserOp.
+ *
+ * Throws the same `BundlerNotConfiguredError` / `BundlerRejectedError`
+ * as other relay paths so issuer controllers can use one error mapper.
+ */
+interface HandleDelegateSubmitParams {
+    userAddress: Address;
+    chainId: number;
+    /** Account nonce read at `delegate/prepare` time and signed by the user. */
+    delegationNonce: bigint;
+    /** ERC-4337 account nonce. Caller fetches via EntryPoint.getNonce. */
+    aaNonce: bigint;
+    /** 65-byte secp256k1 signature over the EIP-7702 authorization hash. */
+    authSig: Hex | string;
+    /** EIP-1559 fees from `provider.estimateFeesPerGas()` (or RPC equivalent). */
+    fees: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+    pafiBackendClient?: PafiBackendClient | null;
+    onWarning?: (msg: string) => void;
+    /** Override gas limits for the empty-batch UserOp. */
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+interface HandleDelegateSubmitResult {
+    userOpHash: Hex;
+    /** True when paymaster sponsorship was applied (gas is free). */
+    isSponsored: boolean;
+    /** The authorization tuple actually sent to the bundler. */
+    authorization: Eip7702AuthorizationJsonRpc;
+}
+declare function handleDelegateSubmit(params: HandleDelegateSubmitParams): Promise<HandleDelegateSubmitResult>;
+
+/**
+ * Quote PT → USDT for the cashout preview screen.
+ *
+ * Three branches the FE needs distinct handling for:
+ *   - `pointAmount = 0`           → all zeros, no RPC call.
+ *   - no pool / no path           → `quoteError: 'QUOTE_UNAVAILABLE'`.
+ *   - amountOut < gas reimbursement → `quoteError: 'AMOUNT_TOO_SMALL_FOR_GAS'`.
+ *
+ * Returns derived `netUsdtOut`, `exchangeRate`, and a `suggestedDeadline`
+ * so callers don't need to compute those locally.
+ *
+ * Replaces ~50 LoC of inline quote-handling in issuer controllers.
+ */
+interface QuotePointTokenToUsdtParams {
+    provider: PublicClient;
+    chainId: number;
+    pointTokenAddress: Address;
+    pointAmount: bigint;
+    pools: PoolKey[];
+    /** Operator gas-reimbursement quoted in USDT (subtracted from output). */
+    gasFeeUsdt: bigint;
+    /** Override deadline window; default 300 seconds. */
+    deadlineSeconds?: number;
+    now?: () => number;
+}
+interface QuotePointTokenToUsdtResult {
+    /** Raw V4 quote on the full point amount, before gas deduction. */
+    estimatedUsdtOut: bigint;
+    /** `estimatedUsdtOut - gasFeeUsdt`, clamped to 0. */
+    netUsdtOut: bigint;
+    /** USDT per 1.0 PT (1e18 raw units), formatted to 8 decimal places. */
+    exchangeRate: string;
+    /** V4 Quoter's gas estimate for the swap — informational. */
+    gasEstimate: bigint;
+    /** Unix seconds — `now + deadlineSeconds`. */
+    suggestedDeadline: number;
+    /** When set, the FE should hide the CTA / show "increase amount". */
+    quoteError?: "QUOTE_UNAVAILABLE" | "AMOUNT_TOO_SMALL_FOR_GAS";
+}
+declare function quotePointTokenToUsdt(params: QuotePointTokenToUsdtParams): Promise<QuotePointTokenToUsdtResult>;
+
+/**
+ * Normalized HTTP status the issuer controller should surface for a
+ * given SDK error. Kept to the three statuses every issuer needs —
+ * `400/500/etc.` are not used because every SDK error already maps
+ * cleanly into one of these three buckets.
+ */
+type SdkErrorStatus = "not_found" | "unprocessable" | "service_unavailable";
+/**
+ * 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 throw or return an Error — `createSdkErrorMapper`
+ * uses `throw factory(body)` so either form is fine.
+ */
+interface SdkErrorMapperFactories {
+    notFound: (body: SdkErrorBody) => Error;
+    unprocessable: (body: SdkErrorBody) => Error;
+    serviceUnavailable: (body: SdkErrorBody) => Error;
+}
+/**
+ * Build a single error-mapping function that converts any typed SDK
+ * error into the issuer's framework-specific HTTP exception.
+ *
+ *   - `PendingUserOpNotFoundError`   → 404 (lock expired / already submitted)
+ *   - `BundlerNotConfiguredError`    → 503 (PAFI backend client missing)
+ *   - `IssuerStateError`             → 422 (cap exceeded / inactive)
+ *   - `PerpDepositError`             → 422 (Orderly relay quote / broker)
+ *   - `PTClaimError`, `PTRedeemError`, `SwapError`, `BundlerRejectedError` → 422
+ *   - any other error                → re-thrown as-is
+ *
+ * `safeToRetry` is `true` only for transient cases:
+ *   - `MINT_CAP_EXCEEDED` (cap may free up between requests)
+ *   - `RELAY_FEE_EXCEEDS_AMOUNT` (Orderly fee may drop)
+ *
+ * Usage (NestJS):
+ *
+ * ```ts
+ * const mapSdkError = createSdkErrorMapper({
+ *   notFound: (body) => new NotFoundException(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`.
  */
@@ -2593,4 +2742,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 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, 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, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, mergePaymasterFields, prepareMobileUserOp, 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, 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 SdkErrorBody, 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 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex, PublicClient, WalletClient } from 'viem';
-import { PointTokenDomainConfig, PartialUserOperation, BurnRequest, PoolKey, UserOpTypedData, decodeBatchExecuteCalls, BROKER_HASHES, ENTRY_POINT_V08 } from '@pafi-dev/core';
+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';
 
 /**
@@ -2069,6 +2069,155 @@ declare class PerpDepositHandler {
     handle(request: PerpDepositRequest): Promise<PerpDepositResponse>;
 }
 
+/**
+ * Pure mechanics for the EIP-7702 delegation submit flow. Builds the
+ * empty-batch UserOp, attaches paymaster sponsorship, splits the user's
+ * authorization signature into the JSON-RPC tuple, and relays via the
+ * PAFI sponsor-relayer.
+ *
+ * The UserOp itself is a no-op — `BatchExecutor.execute([])` does
+ * nothing. The work is in the `eip7702Auth` object: the bundler picks
+ * it up, runs the EIP-7702 path, and installs the delegation on the
+ * user's EOA atomically with the (empty) UserOp.
+ *
+ * Throws the same `BundlerNotConfiguredError` / `BundlerRejectedError`
+ * as other relay paths so issuer controllers can use one error mapper.
+ */
+interface HandleDelegateSubmitParams {
+    userAddress: Address;
+    chainId: number;
+    /** Account nonce read at `delegate/prepare` time and signed by the user. */
+    delegationNonce: bigint;
+    /** ERC-4337 account nonce. Caller fetches via EntryPoint.getNonce. */
+    aaNonce: bigint;
+    /** 65-byte secp256k1 signature over the EIP-7702 authorization hash. */
+    authSig: Hex | string;
+    /** EIP-1559 fees from `provider.estimateFeesPerGas()` (or RPC equivalent). */
+    fees: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+    pafiBackendClient?: PafiBackendClient | null;
+    onWarning?: (msg: string) => void;
+    /** Override gas limits for the empty-batch UserOp. */
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+interface HandleDelegateSubmitResult {
+    userOpHash: Hex;
+    /** True when paymaster sponsorship was applied (gas is free). */
+    isSponsored: boolean;
+    /** The authorization tuple actually sent to the bundler. */
+    authorization: Eip7702AuthorizationJsonRpc;
+}
+declare function handleDelegateSubmit(params: HandleDelegateSubmitParams): Promise<HandleDelegateSubmitResult>;
+
+/**
+ * Quote PT → USDT for the cashout preview screen.
+ *
+ * Three branches the FE needs distinct handling for:
+ *   - `pointAmount = 0`           → all zeros, no RPC call.
+ *   - no pool / no path           → `quoteError: 'QUOTE_UNAVAILABLE'`.
+ *   - amountOut < gas reimbursement → `quoteError: 'AMOUNT_TOO_SMALL_FOR_GAS'`.
+ *
+ * Returns derived `netUsdtOut`, `exchangeRate`, and a `suggestedDeadline`
+ * so callers don't need to compute those locally.
+ *
+ * Replaces ~50 LoC of inline quote-handling in issuer controllers.
+ */
+interface QuotePointTokenToUsdtParams {
+    provider: PublicClient;
+    chainId: number;
+    pointTokenAddress: Address;
+    pointAmount: bigint;
+    pools: PoolKey[];
+    /** Operator gas-reimbursement quoted in USDT (subtracted from output). */
+    gasFeeUsdt: bigint;
+    /** Override deadline window; default 300 seconds. */
+    deadlineSeconds?: number;
+    now?: () => number;
+}
+interface QuotePointTokenToUsdtResult {
+    /** Raw V4 quote on the full point amount, before gas deduction. */
+    estimatedUsdtOut: bigint;
+    /** `estimatedUsdtOut - gasFeeUsdt`, clamped to 0. */
+    netUsdtOut: bigint;
+    /** USDT per 1.0 PT (1e18 raw units), formatted to 8 decimal places. */
+    exchangeRate: string;
+    /** V4 Quoter's gas estimate for the swap — informational. */
+    gasEstimate: bigint;
+    /** Unix seconds — `now + deadlineSeconds`. */
+    suggestedDeadline: number;
+    /** When set, the FE should hide the CTA / show "increase amount". */
+    quoteError?: "QUOTE_UNAVAILABLE" | "AMOUNT_TOO_SMALL_FOR_GAS";
+}
+declare function quotePointTokenToUsdt(params: QuotePointTokenToUsdtParams): Promise<QuotePointTokenToUsdtResult>;
+
+/**
+ * Normalized HTTP status the issuer controller should surface for a
+ * given SDK error. Kept to the three statuses every issuer needs —
+ * `400/500/etc.` are not used because every SDK error already maps
+ * cleanly into one of these three buckets.
+ */
+type SdkErrorStatus = "not_found" | "unprocessable" | "service_unavailable";
+/**
+ * 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 throw or return an Error — `createSdkErrorMapper`
+ * uses `throw factory(body)` so either form is fine.
+ */
+interface SdkErrorMapperFactories {
+    notFound: (body: SdkErrorBody) => Error;
+    unprocessable: (body: SdkErrorBody) => Error;
+    serviceUnavailable: (body: SdkErrorBody) => Error;
+}
+/**
+ * Build a single error-mapping function that converts any typed SDK
+ * error into the issuer's framework-specific HTTP exception.
+ *
+ *   - `PendingUserOpNotFoundError`   → 404 (lock expired / already submitted)
+ *   - `BundlerNotConfiguredError`    → 503 (PAFI backend client missing)
+ *   - `IssuerStateError`             → 422 (cap exceeded / inactive)
+ *   - `PerpDepositError`             → 422 (Orderly relay quote / broker)
+ *   - `PTClaimError`, `PTRedeemError`, `SwapError`, `BundlerRejectedError` → 422
+ *   - any other error                → re-thrown as-is
+ *
+ * `safeToRetry` is `true` only for transient cases:
+ *   - `MINT_CAP_EXCEEDED` (cap may free up between requests)
+ *   - `RELAY_FEE_EXCEEDS_AMOUNT` (Orderly fee may drop)
+ *
+ * Usage (NestJS):
+ *
+ * ```ts
+ * const mapSdkError = createSdkErrorMapper({
+ *   notFound: (body) => new NotFoundException(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`.
  */
@@ -2593,4 +2742,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 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, 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, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, mergePaymasterFields, prepareMobileUserOp, 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, 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 SdkErrorBody, 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 };

package/dist/index.js

@@ -2375,6 +2375,194 @@ var PerpDepositHandler = class {
   }
 };
 
+// src/api/delegateHandler.ts
+import {
+  ENTRY_POINT_V08 as ENTRY_POINT_V082,
+  buildEip7702Authorization,
+  encodeBatchExecute,
+  getContractAddresses as getContractAddresses5,
+  serializeUserOpToJsonRpc as serializeUserOpToJsonRpc2
+} from "@pafi-dev/core";
+var DEFAULT_DELEGATE_GAS = {
+  callGasLimit: 100000n,
+  verificationGasLimit: 150000n,
+  preVerificationGas: 50000n
+};
+async function handleDelegateSubmit(params) {
+  const { batchExecutor } = getContractAddresses5(params.chainId);
+  const callData = encodeBatchExecute([]);
+  const userOp = {
+    sender: params.userAddress,
+    nonce: params.aaNonce,
+    callData,
+    callGasLimit: params.gasLimits?.callGasLimit ?? DEFAULT_DELEGATE_GAS.callGasLimit,
+    verificationGasLimit: params.gasLimits?.verificationGasLimit ?? DEFAULT_DELEGATE_GAS.verificationGasLimit,
+    preVerificationGas: params.gasLimits?.preVerificationGas ?? DEFAULT_DELEGATE_GAS.preVerificationGas,
+    maxFeePerGas: params.fees.maxFeePerGas ?? 0n,
+    maxPriorityFeePerGas: params.fees.maxPriorityFeePerGas ?? 0n
+  };
+  const paymasterFields = await requestPaymaster({
+    client: params.pafiBackendClient,
+    chainId: params.chainId,
+    scenario: "delegate",
+    userOp,
+    pointTokenAddress: batchExecutor,
+    onWarning: params.onWarning
+  });
+  const merged = {
+    ...userOp,
+    ...paymasterFields ?? {}
+  };
+  const userOpJson = serializeUserOpToJsonRpc2(
+    {
+      sender: merged.sender,
+      nonce: merged.nonce,
+      callData: merged.callData,
+      callGasLimit: merged.callGasLimit,
+      verificationGasLimit: merged.verificationGasLimit,
+      preVerificationGas: merged.preVerificationGas,
+      maxFeePerGas: merged.maxFeePerGas,
+      maxPriorityFeePerGas: merged.maxPriorityFeePerGas,
+      paymaster: paymasterFields?.paymaster,
+      paymasterVerificationGasLimit: paymasterFields?.paymasterVerificationGasLimit,
+      paymasterPostOpGasLimit: paymasterFields?.paymasterPostOpGasLimit,
+      paymasterData: paymasterFields?.paymasterData
+    },
+    // Delegation UserOp is submitted unsigned — the EIP-7702 authorization
+    // is the user's "consent"; no separate AA signature is needed.
+    "0x"
+  );
+  const authorization = buildEip7702Authorization({
+    chainId: params.chainId,
+    address: batchExecutor,
+    nonce: params.delegationNonce,
+    authSig: params.authSig
+  });
+  const result = await relayUserOp({
+    client: params.pafiBackendClient,
+    userOp: userOpJson,
+    entryPoint: ENTRY_POINT_V082,
+    eip7702Auth: authorization
+  });
+  return {
+    userOpHash: result.userOpHash,
+    isSponsored: !!paymasterFields,
+    authorization
+  };
+}
+
+// src/api/quoteHelper.ts
+import {
+  findBestQuote as findBestQuote2,
+  getContractAddresses as getContractAddresses6
+} from "@pafi-dev/core";
+var DEFAULT_DEADLINE_SECONDS = 300;
+async function quotePointTokenToUsdt(params) {
+  const now = params.now ?? (() => Date.now());
+  const suggestedDeadline = Math.floor(now() / 1e3) + (params.deadlineSeconds ?? DEFAULT_DEADLINE_SECONDS);
+  if (params.pointAmount === 0n) {
+    return {
+      estimatedUsdtOut: 0n,
+      netUsdtOut: 0n,
+      exchangeRate: "0.00000000",
+      gasEstimate: 0n,
+      suggestedDeadline
+    };
+  }
+  if (params.pools.length === 0) {
+    return {
+      estimatedUsdtOut: 0n,
+      netUsdtOut: 0n,
+      exchangeRate: "0.00000000",
+      gasEstimate: 0n,
+      suggestedDeadline,
+      quoteError: "QUOTE_UNAVAILABLE"
+    };
+  }
+  const { usdt: usdtAddress } = getContractAddresses6(params.chainId);
+  let estimatedUsdtOut = 0n;
+  let gasEstimate = 0n;
+  try {
+    const best = await findBestQuote2(
+      params.provider,
+      params.chainId,
+      params.pointTokenAddress,
+      usdtAddress,
+      params.pointAmount,
+      params.pools
+    );
+    estimatedUsdtOut = best.bestRoute.amountOut;
+    gasEstimate = best.bestRoute.gasEstimate;
+  } catch {
+    return {
+      estimatedUsdtOut: 0n,
+      netUsdtOut: 0n,
+      exchangeRate: "0.00000000",
+      gasEstimate: 0n,
+      suggestedDeadline,
+      quoteError: "QUOTE_UNAVAILABLE"
+    };
+  }
+  const netUsdtOut = estimatedUsdtOut > params.gasFeeUsdt ? estimatedUsdtOut - params.gasFeeUsdt : 0n;
+  const quoteError = estimatedUsdtOut > 0n && netUsdtOut === 0n ? "AMOUNT_TOO_SMALL_FOR_GAS" : void 0;
+  const rateNum = estimatedUsdtOut > 0n ? Number(
+    estimatedUsdtOut * 1000000n * 10n ** 18n / params.pointAmount
+  ) / 1e6 : 0;
+  const exchangeRate = rateNum.toFixed(8);
+  return {
+    estimatedUsdtOut,
+    netUsdtOut,
+    exchangeRate,
+    gasEstimate,
+    suggestedDeadline,
+    ...quoteError ? { quoteError } : {}
+  };
+}
+
+// src/api/errorMapper.ts
+function createSdkErrorMapper(factories) {
+  return (err) => {
+    if (err instanceof PendingUserOpNotFoundError) {
+      throw factories.notFound({
+        code: err.code,
+        message: err.message,
+        safeToRetry: false
+      });
+    }
+    if (err instanceof BundlerNotConfiguredError) {
+      throw factories.serviceUnavailable({
+        code: err.code,
+        message: err.message,
+        safeToRetry: false
+      });
+    }
+    if (err instanceof IssuerStateError) {
+      throw factories.unprocessable({
+        code: err.code,
+        message: err.message,
+        details: err.details,
+        safeToRetry: err.code === "MINT_CAP_EXCEEDED"
+      });
+    }
+    if (err instanceof PerpDepositError) {
+      throw factories.unprocessable({
+        code: err.code,
+        message: err.message,
+        safeToRetry: err.code === "RELAY_FEE_EXCEEDS_AMOUNT"
+      });
+    }
+    if (err instanceof PTClaimError || err instanceof PTRedeemError || err instanceof SwapError || err instanceof BundlerRejectedError) {
+      throw factories.unprocessable({
+        code: err.code,
+        message: err.message,
+        details: "details" in err ? err.details : void 0,
+        safeToRetry: false
+      });
+    }
+    throw err;
+  };
+}
+
 // src/pools/subgraphPoolsProvider.ts
 import { isAddress } from "viem";
 import { PAFI_SUBGRAPH_URL } from "@pafi-dev/core";
@@ -2994,7 +3182,7 @@ var PafiBackendClient = class {
 
 // src/config.ts
 import { getAddress as getAddress9 } from "viem";
-import { getContractAddresses as getContractAddresses5 } from "@pafi-dev/core";
+import { getContractAddresses as getContractAddresses7 } from "@pafi-dev/core";
 function createIssuerService(config) {
   if (!config.provider) {
     throw new Error("createIssuerService: provider is required");
@@ -3064,7 +3252,7 @@ function createIssuerService(config) {
     indexers.set(tokenAddress, new PointIndexer(indexerConfig));
   }
   const firstIndexer = indexers.get(tokenAddresses[0]);
-  const chainAddresses = getContractAddresses5(config.chainId);
+  const chainAddresses = getContractAddresses7(config.chainId);
   const resolvedContracts = {
     batchExecutor: chainAddresses.batchExecutor,
     usdt: chainAddresses.usdt,
@@ -3116,7 +3304,7 @@ import { getAddress as getAddress10 } from "viem";
 import {
   POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI3,
   issuerRegistryGetIssuerFlatAbi,
-  getContractAddresses as getContractAddresses6
+  getContractAddresses as getContractAddresses8
 } from "@pafi-dev/core";
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
@@ -3134,7 +3322,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    * `CONTRACT_ADDRESSES` map for the given chain.
    */
   static forChain(provider, chainId) {
-    const { issuerRegistry } = getContractAddresses6(chainId);
+    const { issuerRegistry } = getContractAddresses8(chainId);
     return new _IssuerStateValidator(provider, issuerRegistry);
   }
   /**
@@ -3310,14 +3498,17 @@ export {
   authenticateRequest,
   createIssuerService,
   createNativePtQuoter,
+  createSdkErrorMapper,
   createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider,
   handleClaimStatus,
+  handleDelegateSubmit,
   handleMobilePrepare,
   handleMobileSubmit,
   handleRedeemStatus,
   mergePaymasterFields,
   prepareMobileUserOp,
+  quotePointTokenToUsdt,
   relayUserOp,
   requestPaymaster,
   serializeEntryToJsonRpc,