@pafi-dev/issuer 0.23.0 → 0.24.1

package/dist/index.d.cts

@@ -1029,6 +1029,23 @@ interface ISingletonLock {
     acquire(key: string): Promise<SingletonLockHandle | null>;
 }
 
+declare class PointIndexerFinalizeError extends Error {
+    readonly context: {
+        pointToken: Address;
+        to: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+    };
+    readonly cause: unknown;
+    constructor(message: string, context: {
+        pointToken: Address;
+        to: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+    }, cause: unknown);
+}
 interface PointIndexerConfig {
     provider: PublicClient;
     pointTokenAddress: Address;
@@ -1179,6 +1196,33 @@ declare class PointIndexer {
     private finalize;
 }
 
+/**
+ * Mirror of `PointIndexerFinalizeError` — raised when
+ * `ledger.resolveCreditByBurnTx` rejects. See audit M-12: pre-fix this
+ * was silently swallowed and the cursor advanced regardless,
+ * permanently dropping confirmed on-chain burns from the off-chain
+ * credit pipeline. Post-fix the error propagates, the chunk's cursor
+ * save is skipped, and the next tick retries.
+ */
+declare class BurnIndexerFinalizeError extends Error {
+    readonly context: {
+        pointToken: Address;
+        from: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+        lockId: string;
+    };
+    readonly cause: unknown;
+    constructor(message: string, context: {
+        pointToken: Address;
+        from: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+        lockId: string;
+    }, cause: unknown);
+}
 interface BurnIndexerConfig {
     provider: PublicClient;
     pointTokenAddress: Address;
@@ -3646,34 +3690,48 @@ declare function relayUserOp(params: RelayUserOpParams): Promise<{
     userOpHash: Hex;
 }>;
 
+/**
+ * Registry record returned by `IssuerRegistry.getIssuer()` in V2
+ * dual-bucket. Schema reshape from V1:
+ *
+ *   V1: { issuerAddress, signerAddress, name, symbol, active, pointToken, mintingOracle }
+ *   V2: { signerAddress, name, active, capitalBase, basisPoints }
+ *
+ * `issuerAddress` is the lookup key the caller passed; we don't
+ * re-emit it here because the caller already has it. `capitalBase` +
+ * `basisPoints` drive the EQUITY-bucket cap (`capitalBase *
+ * basisPoints / 10000`).
+ */
 interface IssuerRegistryRecord {
-    issuerAddress: Address;
     signerAddress: Address;
     name: string;
-    symbol: string;
     active: boolean;
-    pointToken: Address;
-    mintingOracle: Address;
+    capitalBase: bigint;
+    basisPoints: number;
 }
 /**
- * Per-token cap config read from `MintingOracle.tokenCaps()`. Caps
- * live per PointToken (not per issuer), so a single issuer can run
- * many PointTokens with different supply policies.
+ * Equity-bucket cap snapshot computed from the `IssuerRegistryRecord`.
+ *
+ * V1 had a separate `TokenCapRecord` sourced from
+ * `MintingOracle.tokenCaps`; in V2 the oracle is stateless and the
+ * EQUITY cap derives from the registry's `capitalBase` + `basisPoints`.
+ * Kept as a distinct shape (rather than inlining into
+ * `PreValidateMintResult`) so admin tooling can read it without
+ * re-deriving the multiplication.
  */
-interface TokenCapRecord {
-    declaredTotalSupply: bigint;
-    capBasisPoints: number;
+interface EquityCapRecord {
+    capitalBase: bigint;
+    basisPoints: number;
+    hardCap: bigint;
 }
 interface PreValidateMintResult {
     /** Registry record read at pre-validation time. */
     issuer: IssuerRegistryRecord;
-    /** Per-token cap config from MintingOracle. */
-    tokenCap: TokenCapRecord;
-    /** Current on-chain PointToken.totalSupply(). */
-    totalSupply: bigint;
-    /** declaredTotalSupply × capBasisPoints / 10000. */
-    hardCap: bigint;
-    /** hardCap − totalSupply (clamped to 0). */
+    /** Equity-bucket cap derived from issuer.capitalBase × basisPoints. */
+    equityCap: EquityCapRecord;
+    /** Current on-chain `PointToken.equitySupply()`. */
+    equitySupply: bigint;
+    /** equityCap.hardCap − equitySupply (clamped to 0). */
     remaining: bigint;
 }
 /**
@@ -3827,4 +3885,4 @@ declare class MemoryRedemptionHistoryStore implements IRedemptionHistoryStore {
 
 declare const PAFI_ISSUER_SDK_VERSION: string;
 
-export { AdapterMisconfiguredError, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedemptionEvaluateRequest, type ApiRedemptionEvaluateResponse, type ApiRedemptionPreviewRequest, type ApiRedemptionPreviewResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, type BundlerEstimatorClient, BundlerNotConfiguredError, BundlerRejectedError, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type BurnStatusParams, type BurnStatusResponse, type ClaimDto, type ConfigDto, ConfigurationError, DEFAULT_REDEMPTION_POLICY, type DecodedCallDto, DefaultPolicyEngine, type DefaultPolicyEngineOptions, type DelegatePrepareDto, type DelegateStatusDto, type EstimateGasFeeOptions, type EvaluateInput, FeeManager, type FeeManagerConfig, type FeeManagerMetrics, type FetchFailureReason, type FetchImpl, type FetchResult, type GasFeeDto, type GasFeeSource, type HandleDelegateSubmitParams, type HandleDelegateSubmitResult, type HandleMobilePrepareParams, type HandleMobilePrepareResult, type HandleMobileSubmitParams, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type IRateLimiter, type IRedemptionHistoryStore, type ISessionStore, type ISingletonLock, InMemoryCursorStore, IssuerApiAdapter, type IssuerApiAdapterConfig, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, LockNotFoundError, type LockedMintRequest, type LoginResult, MemoryPendingUserOpStore, MemoryRateLimiter, MemoryRedemptionHistoryStore, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintStatusParams, type MintStatusResponse, type MintingStatus, type MobilePrepareDto, type MobileSubmitDto, type NativePtQuoterConfig, NonceManager, NoopRateLimiter, 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 PafiEstimatorClientConfig, PafiEstimatorHttpError, type PaymasterGasEstimates, type PendingCredit, type PendingUserOpEntry, PendingUserOpForbiddenError, PendingUserOpNotFoundError, type PerpDepositDto, PerpDepositError, PerpDepositHandler, type PerpDepositHandlerConfig, type PerpDepositRequest, type PerpDepositResponse, PointIndexer, type PointIndexerConfig, PointTokenDomainResolver, type PointTokenDomainResolverConfig, type PolicyDecision, type PolicyEvalRequest, PolicyProvider, type PolicyProviderConfig, type PoolsDto, type PoolsProvider, type PostgresQueryRunner, type PreValidateMintResult, type PrepareBurnParams, type PrepareMintParams, type PrepareMobileUserOpParams, type PrepareMobileUserOpResult, type PreparedUserOp, type PreviewBurnParams, type PreviewMintParams, REDEMPTION_HISTORY_WINDOW_SEC, type RateLimitAction, type RateLimiterConfig, type RedeemDto, type RedeemPrepareDto, RedemptionService, type RedemptionServiceConfig, RelayError, type RelayErrorCode, RelayService, type RelayUserOpParams, type RelayUserOpRequest, type RelayUserOpResponse, type RequestPaymasterParams, type ResolvedPolicy, type RetryConfig, type SdkErrorBody, type SdkErrorMapperFactories, type SdkErrorStatus, type SerializedUserOpTypedData, type Session, SettlementClient, type SettlementClientConfig, type SingletonLockHandle, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, type UserDto, type UserHistory, applyPaymasterGasEstimates, authenticateRequest, buildSdkErrorBody, createIssuerService, createNativePtQuoter, createPafiEstimatorClient, createSdkErrorMapper, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, defaultPolicyFor, evaluateRedemption, handleClaimStatus, handleDelegateSubmit, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, makePostgresSingletonLock, mergePaymasterFields, prepareMobileUserOp, relayUserOp, requestPaymaster, serializeEntryToJsonRpc, serializeUserOpTypedData };
+export { AdapterMisconfiguredError, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedemptionEvaluateRequest, type ApiRedemptionEvaluateResponse, type ApiRedemptionPreviewRequest, type ApiRedemptionPreviewResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, type BundlerEstimatorClient, BundlerNotConfiguredError, BundlerRejectedError, type BurnEvent, BurnIndexer, type BurnIndexerConfig, BurnIndexerFinalizeError, type BurnStatusParams, type BurnStatusResponse, type ClaimDto, type ConfigDto, ConfigurationError, DEFAULT_REDEMPTION_POLICY, type DecodedCallDto, DefaultPolicyEngine, type DefaultPolicyEngineOptions, type DelegatePrepareDto, type DelegateStatusDto, type EstimateGasFeeOptions, type EvaluateInput, FeeManager, type FeeManagerConfig, type FeeManagerMetrics, type FetchFailureReason, type FetchImpl, type FetchResult, type GasFeeDto, type GasFeeSource, type HandleDelegateSubmitParams, type HandleDelegateSubmitResult, type HandleMobilePrepareParams, type HandleMobilePrepareResult, type HandleMobileSubmitParams, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type IRateLimiter, type IRedemptionHistoryStore, type ISessionStore, type ISingletonLock, InMemoryCursorStore, IssuerApiAdapter, type IssuerApiAdapterConfig, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, LockNotFoundError, type LockedMintRequest, type LoginResult, MemoryPendingUserOpStore, MemoryRateLimiter, MemoryRedemptionHistoryStore, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintStatusParams, type MintStatusResponse, type MintingStatus, type MobilePrepareDto, type MobileSubmitDto, type NativePtQuoterConfig, NonceManager, NoopRateLimiter, 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 PafiEstimatorClientConfig, PafiEstimatorHttpError, type PaymasterGasEstimates, type PendingCredit, type PendingUserOpEntry, PendingUserOpForbiddenError, PendingUserOpNotFoundError, type PerpDepositDto, PerpDepositError, PerpDepositHandler, type PerpDepositHandlerConfig, type PerpDepositRequest, type PerpDepositResponse, PointIndexer, type PointIndexerConfig, PointIndexerFinalizeError, PointTokenDomainResolver, type PointTokenDomainResolverConfig, type PolicyDecision, type PolicyEvalRequest, PolicyProvider, type PolicyProviderConfig, type PoolsDto, type PoolsProvider, type PostgresQueryRunner, type PreValidateMintResult, type PrepareBurnParams, type PrepareMintParams, type PrepareMobileUserOpParams, type PrepareMobileUserOpResult, type PreparedUserOp, type PreviewBurnParams, type PreviewMintParams, REDEMPTION_HISTORY_WINDOW_SEC, type RateLimitAction, type RateLimiterConfig, type RedeemDto, type RedeemPrepareDto, RedemptionService, type RedemptionServiceConfig, RelayError, type RelayErrorCode, RelayService, type RelayUserOpParams, type RelayUserOpRequest, type RelayUserOpResponse, type RequestPaymasterParams, type ResolvedPolicy, type RetryConfig, type SdkErrorBody, type SdkErrorMapperFactories, type SdkErrorStatus, type SerializedUserOpTypedData, type Session, SettlementClient, type SettlementClientConfig, type SingletonLockHandle, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, type UserDto, type UserHistory, applyPaymasterGasEstimates, authenticateRequest, buildSdkErrorBody, createIssuerService, createNativePtQuoter, createPafiEstimatorClient, createSdkErrorMapper, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, defaultPolicyFor, evaluateRedemption, handleClaimStatus, handleDelegateSubmit, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, makePostgresSingletonLock, mergePaymasterFields, prepareMobileUserOp, relayUserOp, requestPaymaster, serializeEntryToJsonRpc, serializeUserOpTypedData };

package/dist/index.d.ts

@@ -1029,6 +1029,23 @@ interface ISingletonLock {
     acquire(key: string): Promise<SingletonLockHandle | null>;
 }
 
+declare class PointIndexerFinalizeError extends Error {
+    readonly context: {
+        pointToken: Address;
+        to: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+    };
+    readonly cause: unknown;
+    constructor(message: string, context: {
+        pointToken: Address;
+        to: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+    }, cause: unknown);
+}
 interface PointIndexerConfig {
     provider: PublicClient;
     pointTokenAddress: Address;
@@ -1179,6 +1196,33 @@ declare class PointIndexer {
     private finalize;
 }
 
+/**
+ * Mirror of `PointIndexerFinalizeError` — raised when
+ * `ledger.resolveCreditByBurnTx` rejects. See audit M-12: pre-fix this
+ * was silently swallowed and the cursor advanced regardless,
+ * permanently dropping confirmed on-chain burns from the off-chain
+ * credit pipeline. Post-fix the error propagates, the chunk's cursor
+ * save is skipped, and the next tick retries.
+ */
+declare class BurnIndexerFinalizeError extends Error {
+    readonly context: {
+        pointToken: Address;
+        from: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+        lockId: string;
+    };
+    readonly cause: unknown;
+    constructor(message: string, context: {
+        pointToken: Address;
+        from: Address;
+        amount: bigint;
+        txHash: `0x${string}`;
+        blockNumber: bigint;
+        lockId: string;
+    }, cause: unknown);
+}
 interface BurnIndexerConfig {
     provider: PublicClient;
     pointTokenAddress: Address;
@@ -3646,34 +3690,48 @@ declare function relayUserOp(params: RelayUserOpParams): Promise<{
     userOpHash: Hex;
 }>;
 
+/**
+ * Registry record returned by `IssuerRegistry.getIssuer()` in V2
+ * dual-bucket. Schema reshape from V1:
+ *
+ *   V1: { issuerAddress, signerAddress, name, symbol, active, pointToken, mintingOracle }
+ *   V2: { signerAddress, name, active, capitalBase, basisPoints }
+ *
+ * `issuerAddress` is the lookup key the caller passed; we don't
+ * re-emit it here because the caller already has it. `capitalBase` +
+ * `basisPoints` drive the EQUITY-bucket cap (`capitalBase *
+ * basisPoints / 10000`).
+ */
 interface IssuerRegistryRecord {
-    issuerAddress: Address;
     signerAddress: Address;
     name: string;
-    symbol: string;
     active: boolean;
-    pointToken: Address;
-    mintingOracle: Address;
+    capitalBase: bigint;
+    basisPoints: number;
 }
 /**
- * Per-token cap config read from `MintingOracle.tokenCaps()`. Caps
- * live per PointToken (not per issuer), so a single issuer can run
- * many PointTokens with different supply policies.
+ * Equity-bucket cap snapshot computed from the `IssuerRegistryRecord`.
+ *
+ * V1 had a separate `TokenCapRecord` sourced from
+ * `MintingOracle.tokenCaps`; in V2 the oracle is stateless and the
+ * EQUITY cap derives from the registry's `capitalBase` + `basisPoints`.
+ * Kept as a distinct shape (rather than inlining into
+ * `PreValidateMintResult`) so admin tooling can read it without
+ * re-deriving the multiplication.
  */
-interface TokenCapRecord {
-    declaredTotalSupply: bigint;
-    capBasisPoints: number;
+interface EquityCapRecord {
+    capitalBase: bigint;
+    basisPoints: number;
+    hardCap: bigint;
 }
 interface PreValidateMintResult {
     /** Registry record read at pre-validation time. */
     issuer: IssuerRegistryRecord;
-    /** Per-token cap config from MintingOracle. */
-    tokenCap: TokenCapRecord;
-    /** Current on-chain PointToken.totalSupply(). */
-    totalSupply: bigint;
-    /** declaredTotalSupply × capBasisPoints / 10000. */
-    hardCap: bigint;
-    /** hardCap − totalSupply (clamped to 0). */
+    /** Equity-bucket cap derived from issuer.capitalBase × basisPoints. */
+    equityCap: EquityCapRecord;
+    /** Current on-chain `PointToken.equitySupply()`. */
+    equitySupply: bigint;
+    /** equityCap.hardCap − equitySupply (clamped to 0). */
     remaining: bigint;
 }
 /**
@@ -3827,4 +3885,4 @@ declare class MemoryRedemptionHistoryStore implements IRedemptionHistoryStore {
 
 declare const PAFI_ISSUER_SDK_VERSION: string;
 
-export { AdapterMisconfiguredError, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedemptionEvaluateRequest, type ApiRedemptionEvaluateResponse, type ApiRedemptionPreviewRequest, type ApiRedemptionPreviewResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, type BundlerEstimatorClient, BundlerNotConfiguredError, BundlerRejectedError, type BurnEvent, BurnIndexer, type BurnIndexerConfig, type BurnStatusParams, type BurnStatusResponse, type ClaimDto, type ConfigDto, ConfigurationError, DEFAULT_REDEMPTION_POLICY, type DecodedCallDto, DefaultPolicyEngine, type DefaultPolicyEngineOptions, type DelegatePrepareDto, type DelegateStatusDto, type EstimateGasFeeOptions, type EvaluateInput, FeeManager, type FeeManagerConfig, type FeeManagerMetrics, type FetchFailureReason, type FetchImpl, type FetchResult, type GasFeeDto, type GasFeeSource, type HandleDelegateSubmitParams, type HandleDelegateSubmitResult, type HandleMobilePrepareParams, type HandleMobilePrepareResult, type HandleMobileSubmitParams, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type IRateLimiter, type IRedemptionHistoryStore, type ISessionStore, type ISingletonLock, InMemoryCursorStore, IssuerApiAdapter, type IssuerApiAdapterConfig, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, LockNotFoundError, type LockedMintRequest, type LoginResult, MemoryPendingUserOpStore, MemoryRateLimiter, MemoryRedemptionHistoryStore, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintStatusParams, type MintStatusResponse, type MintingStatus, type MobilePrepareDto, type MobileSubmitDto, type NativePtQuoterConfig, NonceManager, NoopRateLimiter, 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 PafiEstimatorClientConfig, PafiEstimatorHttpError, type PaymasterGasEstimates, type PendingCredit, type PendingUserOpEntry, PendingUserOpForbiddenError, PendingUserOpNotFoundError, type PerpDepositDto, PerpDepositError, PerpDepositHandler, type PerpDepositHandlerConfig, type PerpDepositRequest, type PerpDepositResponse, PointIndexer, type PointIndexerConfig, PointTokenDomainResolver, type PointTokenDomainResolverConfig, type PolicyDecision, type PolicyEvalRequest, PolicyProvider, type PolicyProviderConfig, type PoolsDto, type PoolsProvider, type PostgresQueryRunner, type PreValidateMintResult, type PrepareBurnParams, type PrepareMintParams, type PrepareMobileUserOpParams, type PrepareMobileUserOpResult, type PreparedUserOp, type PreviewBurnParams, type PreviewMintParams, REDEMPTION_HISTORY_WINDOW_SEC, type RateLimitAction, type RateLimiterConfig, type RedeemDto, type RedeemPrepareDto, RedemptionService, type RedemptionServiceConfig, RelayError, type RelayErrorCode, RelayService, type RelayUserOpParams, type RelayUserOpRequest, type RelayUserOpResponse, type RequestPaymasterParams, type ResolvedPolicy, type RetryConfig, type SdkErrorBody, type SdkErrorMapperFactories, type SdkErrorStatus, type SerializedUserOpTypedData, type Session, SettlementClient, type SettlementClientConfig, type SingletonLockHandle, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, type UserDto, type UserHistory, applyPaymasterGasEstimates, authenticateRequest, buildSdkErrorBody, createIssuerService, createNativePtQuoter, createPafiEstimatorClient, createSdkErrorMapper, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, defaultPolicyFor, evaluateRedemption, handleClaimStatus, handleDelegateSubmit, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, makePostgresSingletonLock, mergePaymasterFields, prepareMobileUserOp, relayUserOp, requestPaymaster, serializeEntryToJsonRpc, serializeUserOpTypedData };
+export { AdapterMisconfiguredError, type ApiConfigResponse, type ApiGasFeeResponse, type ApiLoginRequest, type ApiLoginResponse, type ApiNonceResponse, type ApiPoolsRequest, type ApiPoolsResponse, type ApiRedemptionEvaluateRequest, type ApiRedemptionEvaluateResponse, type ApiRedemptionPreviewRequest, type ApiRedemptionPreviewResponse, type ApiUserRequest, type ApiUserResponse, type AuthContext, AuthError, type AuthErrorCode, AuthService, type AuthServiceConfig, type BundlerEstimatorClient, BundlerNotConfiguredError, BundlerRejectedError, type BurnEvent, BurnIndexer, type BurnIndexerConfig, BurnIndexerFinalizeError, type BurnStatusParams, type BurnStatusResponse, type ClaimDto, type ConfigDto, ConfigurationError, DEFAULT_REDEMPTION_POLICY, type DecodedCallDto, DefaultPolicyEngine, type DefaultPolicyEngineOptions, type DelegatePrepareDto, type DelegateStatusDto, type EstimateGasFeeOptions, type EvaluateInput, FeeManager, type FeeManagerConfig, type FeeManagerMetrics, type FetchFailureReason, type FetchImpl, type FetchResult, type GasFeeDto, type GasFeeSource, type HandleDelegateSubmitParams, type HandleDelegateSubmitResult, type HandleMobilePrepareParams, type HandleMobilePrepareResult, type HandleMobileSubmitParams, type IIndexerCursorStore, type IPendingUserOpStore, type IPointLedger, type IPolicyEngine, type IRateLimiter, type IRedemptionHistoryStore, type ISessionStore, type ISingletonLock, InMemoryCursorStore, IssuerApiAdapter, type IssuerApiAdapterConfig, IssuerApiHandlers, type IssuerApiHandlersConfig, type IssuerRegistryRecord, type IssuerService, type IssuerServiceConfig, IssuerStateError, IssuerStateValidator, LockNotFoundError, type LockedMintRequest, type LoginResult, MemoryPendingUserOpStore, MemoryRateLimiter, MemoryRedemptionHistoryStore, MemorySessionStore, type MemorySessionStoreOptions, type MintEvent, type MintStatusParams, type MintStatusResponse, type MintingStatus, type MobilePrepareDto, type MobileSubmitDto, type NativePtQuoterConfig, NonceManager, NoopRateLimiter, 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 PafiEstimatorClientConfig, PafiEstimatorHttpError, type PaymasterGasEstimates, type PendingCredit, type PendingUserOpEntry, PendingUserOpForbiddenError, PendingUserOpNotFoundError, type PerpDepositDto, PerpDepositError, PerpDepositHandler, type PerpDepositHandlerConfig, type PerpDepositRequest, type PerpDepositResponse, PointIndexer, type PointIndexerConfig, PointIndexerFinalizeError, PointTokenDomainResolver, type PointTokenDomainResolverConfig, type PolicyDecision, type PolicyEvalRequest, PolicyProvider, type PolicyProviderConfig, type PoolsDto, type PoolsProvider, type PostgresQueryRunner, type PreValidateMintResult, type PrepareBurnParams, type PrepareMintParams, type PrepareMobileUserOpParams, type PrepareMobileUserOpResult, type PreparedUserOp, type PreviewBurnParams, type PreviewMintParams, REDEMPTION_HISTORY_WINDOW_SEC, type RateLimitAction, type RateLimiterConfig, type RedeemDto, type RedeemPrepareDto, RedemptionService, type RedemptionServiceConfig, RelayError, type RelayErrorCode, RelayService, type RelayUserOpParams, type RelayUserOpRequest, type RelayUserOpResponse, type RequestPaymasterParams, type ResolvedPolicy, type RetryConfig, type SdkErrorBody, type SdkErrorMapperFactories, type SdkErrorStatus, type SerializedUserOpTypedData, type Session, SettlementClient, type SettlementClientConfig, type SingletonLockHandle, type SponsorshipRequest, type SponsorshipResponse, type SponsorshipTarget, type SponsorshipUserOp, type SubgraphNativeUsdtQuoterConfig, type SubgraphPoolsProviderConfig, type UserDto, type UserHistory, applyPaymasterGasEstimates, authenticateRequest, buildSdkErrorBody, createIssuerService, createNativePtQuoter, createPafiEstimatorClient, createSdkErrorMapper, createSubgraphNativeUsdtQuoter, createSubgraphPoolsProvider, defaultPolicyFor, evaluateRedemption, handleClaimStatus, handleDelegateSubmit, handleMobilePrepare, handleMobileSubmit, handleRedeemStatus, makePostgresSingletonLock, mergePaymasterFields, prepareMobileUserOp, relayUserOp, requestPaymaster, serializeEntryToJsonRpc, serializeUserOpTypedData };

package/dist/index.js

@@ -579,12 +579,14 @@ import {
   erc20Abi
 } from "viem";
 import {
-  POINT_TOKEN_ABI,
+  POINT_TOKEN_MINT_SIG_ABI,
+  POINT_TOKEN_BURN_SIG_ABI,
   mintFeeWrapperAbi,
   buildPartialUserOperation,
   signMintRequest,
   getContractAddresses,
-  quoteOperatorFeePt
+  quoteOperatorFeePt,
+  Source
 } from "@pafi-dev/core";
 var RelayService = class {
   provider;
@@ -673,6 +675,7 @@ var RelayService = class {
         "prepareMint: deadline exceeds maximum allowed window (1 hour)"
       );
     }
+    const MINT_SOURCE = Source.EQUITY;
     const useWrapper = params.mintFeeWrapperAddress !== void 0;
     const receiverForSig = useWrapper ? params.mintFeeWrapperAddress : params.userAddress;
     let minterSig;
@@ -684,6 +687,7 @@ var RelayService = class {
           user: params.userAddress,
           receiver: receiverForSig,
           amount: params.amount,
+          source: MINT_SOURCE,
           nonce: params.mintRequestNonce,
           deadline: params.deadline
         }
@@ -714,9 +718,15 @@ var RelayService = class {
         mintTarget = params.mintFeeWrapperAddress;
       } else {
         mintCallData = encodeFunctionData({
-          abi: POINT_TOKEN_ABI,
+          abi: POINT_TOKEN_MINT_SIG_ABI,
           functionName: "mint",
-          args: [params.userAddress, params.amount, params.deadline, minterSig]
+          args: [
+            params.userAddress,
+            params.amount,
+            MINT_SOURCE,
+            params.deadline,
+            minterSig
+          ]
         });
         mintTarget = params.pointTokenAddress;
       }
@@ -801,11 +811,12 @@ var RelayService = class {
     let burnCallData;
     try {
       burnCallData = encodeFunctionData({
-        abi: POINT_TOKEN_ABI,
+        abi: POINT_TOKEN_BURN_SIG_ABI,
         functionName: "burn",
         args: [
           params.burnRequest.from,
           params.burnRequest.amount,
+          params.burnRequest.source,
           params.burnRequest.deadline,
           params.burnerSignature
         ]
@@ -900,11 +911,12 @@ var RelayService = class {
       mintTarget = params.mintFeeWrapperAddress;
     } else {
       mintCallData = encodeFunctionData({
-        abi: POINT_TOKEN_ABI,
+        abi: POINT_TOKEN_MINT_SIG_ABI,
         functionName: "mint",
         args: [
           params.userAddress,
           params.amount,
+          Source.EQUITY,
           params.deadline,
           PLACEHOLDER_SIG_65
         ]
@@ -926,11 +938,12 @@ var RelayService = class {
   /** Burn-side mirror of `previewMintUserOp`. */
   previewBurnUserOp(params) {
     const burnCallData = encodeFunctionData({
-      abi: POINT_TOKEN_ABI,
+      abi: POINT_TOKEN_BURN_SIG_ABI,
       functionName: "burn",
       args: [
         params.userAddress,
         params.amount,
+        Source.EQUITY,
         params.deadline,
         PLACEHOLDER_SIG_65
       ]
@@ -1148,6 +1161,16 @@ var InMemoryCursorStore = class _InMemoryCursorStore {
 
 // src/indexer/pointIndexer.ts
 import { getAddress as getAddress3, parseAbiItem } from "viem";
+var PointIndexerFinalizeError = class extends Error {
+  constructor(message, context, cause) {
+    super(message);
+    this.context = context;
+    this.cause = cause;
+    this.name = "PointIndexerFinalizeError";
+  }
+  context;
+  cause;
+};
 var TRANSFER_EVENT = parseAbiItem(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
@@ -1373,8 +1396,18 @@ var PointIndexer = class {
         evt.txHash,
         this.pointTokenAddress
       );
-    } catch {
-      return;
+    } catch (err) {
+      throw new PointIndexerFinalizeError(
+        `PointIndexer.deductBalance failed for tx ${evt.txHash} (to=${evt.to}, amount=${evt.amount}, block=${evt.blockNumber}); cursor will NOT advance, next tick retries.`,
+        {
+          pointToken: this.pointTokenAddress,
+          to: evt.to,
+          amount: evt.amount,
+          txHash: evt.txHash,
+          blockNumber: evt.blockNumber
+        },
+        err
+      );
     }
     try {
       await this.ledger.updateMintStatus(match.lockId, "MINTED", evt.txHash);
@@ -1396,6 +1429,16 @@ function pickMatchingLock(locks, amount) {
 
 // src/indexer/burnIndexer.ts
 import { getAddress as getAddress4, parseAbiItem as parseAbiItem2 } from "viem";
+var BurnIndexerFinalizeError = class extends Error {
+  constructor(message, context, cause) {
+    super(message);
+    this.context = context;
+    this.cause = cause;
+    this.name = "BurnIndexerFinalizeError";
+  }
+  context;
+  cause;
+};
 var TRANSFER_EVENT2 = parseAbiItem2(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
@@ -1563,7 +1606,18 @@ var BurnIndexer = class {
     try {
       await this.ledger.resolveCreditByBurnTx(lockId, evt.txHash);
     } catch (err) {
-      console.error("[PAFI] BurnIndexer finalize error \u2014 credit may be lost:", err);
+      throw new BurnIndexerFinalizeError(
+        `BurnIndexer.resolveCreditByBurnTx failed for tx ${evt.txHash} (lockId=${lockId}, from=${evt.from}, amount=${evt.amount}, block=${evt.blockNumber}); cursor will NOT advance, next tick retries.`,
+        {
+          pointToken: this.pointTokenAddress,
+          from: evt.from,
+          amount: evt.amount,
+          txHash: evt.txHash,
+          blockNumber: evt.blockNumber,
+          lockId
+        },
+        err
+      );
     }
   }
 };
@@ -2027,9 +2081,10 @@ var PointTokenDomainResolver = class {
 import { getAddress as getAddress7 } from "viem";
 import {
   signBurnRequest,
-  POINT_TOKEN_ABI as POINT_TOKEN_ABI2,
+  POINT_TOKEN_ABI,
   getPointTokenBalance as getPointTokenBalance2,
-  getContractAddresses as getContractAddresses2
+  getContractAddresses as getContractAddresses2,
+  Source as Source2
 } from "@pafi-dev/core";
 var DEFAULT_REDEEM_LOCK_MS = 15 * 60 * 1e3;
 var DEFAULT_SIG_DEADLINE_SEC = 15 * 60;
@@ -2133,7 +2188,7 @@ var PTRedeemHandler = class {
     try {
       burnNonce = await this.provider.readContract({
         address: pointTokenAddress,
-        abi: POINT_TOKEN_ABI2,
+        abi: POINT_TOKEN_ABI,
         functionName: "burnRequestNonces",
         args: [request.userAddress]
       });
@@ -2215,10 +2270,12 @@ var PTRedeemHandler = class {
       chainId: this.chainId,
       verifyingContract: pointTokenAddress
     };
+    const BURN_SOURCE = Source2.EQUITY;
     const sponsoredBurnAmount = request.amount - fee;
     const sponsoredBurnRequest = {
       from: request.userAddress,
       amount: sponsoredBurnAmount,
+      source: BURN_SOURCE,
       nonce: burnNonce,
       deadline
     };
@@ -2254,6 +2311,7 @@ var PTRedeemHandler = class {
         const fallbackBurnRequest = {
           from: request.userAddress,
           amount: request.amount,
+          source: BURN_SOURCE,
           nonce: burnNonce,
           deadline
         };
@@ -4701,10 +4759,9 @@ async function createIssuerService(config) {
 // src/issuer-state/validator.ts
 import { getAddress as getAddress13 } from "viem";
 import {
-  POINT_TOKEN_ABI as POINT_TOKEN_ABI3,
+  POINT_TOKEN_ABI as POINT_TOKEN_ABI2,
   issuerRegistryAbi,
-  getContractAddresses as getContractAddresses8,
-  getTokenCap
+  getContractAddresses as getContractAddresses8
 } from "@pafi-dev/core";
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
@@ -4751,7 +4808,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
     if (cached) return cached;
     const issuer = await this.provider.readContract({
       address: key,
-      abi: POINT_TOKEN_ABI3,
+      abi: POINT_TOKEN_ABI2,
       functionName: "issuer"
     });
     this.pointTokenIssuerCache.set(key, getAddress13(issuer));
@@ -4805,22 +4862,22 @@ var IssuerStateValidator = class _IssuerStateValidator {
       }
       throw err;
     }
-    const { issuer, totalSupply, hardCap, remaining } = state;
+    const { issuer, equityCap, equitySupply, remaining } = state;
     if (!issuer.active) {
       throw new IssuerStateError(
         "ISSUER_INACTIVE",
-        `Issuer ${issuer.issuerAddress} is deactivated on IssuerRegistry`,
-        { issuer: issuer.issuerAddress, pointToken: issuer.pointToken }
+        `Issuer "${issuer.name}" is deactivated on IssuerRegistry`,
+        { pointToken }
       );
     }
-    if (totalSupply + amount > hardCap) {
+    if (equitySupply + amount > equityCap.hardCap) {
       throw new IssuerStateError(
         "MINT_CAP_EXCEEDED",
-        `Requested ${amount} PT would exceed mint cap. Cap=${hardCap}, minted=${totalSupply}, remaining=${remaining}`,
+        `Requested ${amount} PT would exceed EQUITY mint cap. Cap=${equityCap.hardCap}, equityMinted=${equitySupply}, remaining=${remaining}`,
         {
           requested: amount.toString(),
-          cap: hardCap.toString(),
-          minted: totalSupply.toString(),
+          cap: equityCap.hardCap.toString(),
+          equityMinted: equitySupply.toString(),
           remaining: remaining.toString()
         }
       );
@@ -4836,33 +4893,28 @@ var IssuerStateValidator = class _IssuerStateValidator {
       args: [issuerAddr]
     });
     const issuer = {
-      issuerAddress: issuerStruct.issuerAddress,
       signerAddress: issuerStruct.signerAddress,
       name: issuerStruct.name,
-      symbol: issuerStruct.symbol,
       active: issuerStruct.active,
-      pointToken: issuerStruct.pointToken,
-      mintingOracle: issuerStruct.mintingOracle
+      capitalBase: issuerStruct.capitalBase,
+      basisPoints: Number(issuerStruct.basisPoints)
     };
-    const [tokenCap, totalSupply] = await Promise.all([
-      getTokenCap(this.provider, issuer.mintingOracle, tokenAddr),
-      this.provider.readContract({
-        address: tokenAddr,
-        abi: POINT_TOKEN_ABI3,
-        functionName: "totalSupply"
-      })
-    ]);
-    const tokenCapRecord = {
-      declaredTotalSupply: tokenCap.declaredTotalSupply,
-      capBasisPoints: tokenCap.capBasisPoints
+    const equitySupply = await this.provider.readContract({
+      address: tokenAddr,
+      abi: POINT_TOKEN_ABI2,
+      functionName: "equitySupply"
+    });
+    const hardCap = issuer.capitalBase * BigInt(issuer.basisPoints) / 10000n;
+    const equityCap = {
+      capitalBase: issuer.capitalBase,
+      basisPoints: issuer.basisPoints,
+      hardCap
     };
-    const hardCap = tokenCapRecord.declaredTotalSupply * BigInt(tokenCapRecord.capBasisPoints) / 10000n;
-    const remaining = hardCap > totalSupply ? hardCap - totalSupply : 0n;
+    const remaining = hardCap > equitySupply ? hardCap - equitySupply : 0n;
     return {
       issuer,
-      tokenCap: tokenCapRecord,
-      totalSupply,
-      hardCap,
+      equityCap,
+      equitySupply,
       remaining
     };
   }
@@ -4905,7 +4957,7 @@ var MemoryRedemptionHistoryStore = class {
 };
 
 // src/index.ts
-var PAFI_ISSUER_SDK_VERSION = true ? "0.23.0" : "dev";
+var PAFI_ISSUER_SDK_VERSION = true ? "0.24.1" : "dev";
 export {
   AdapterMisconfiguredError,
   AuthError,
@@ -4913,6 +4965,7 @@ export {
   BundlerNotConfiguredError,
   BundlerRejectedError,
   BurnIndexer,
+  BurnIndexerFinalizeError,
   ConfigurationError,
   DEFAULT_REDEMPTION_POLICY,
   DefaultPolicyEngine,
@@ -4944,6 +4997,7 @@ export {
   PerpDepositError,
   PerpDepositHandler,
   PointIndexer,
+  PointIndexerFinalizeError,
   PointTokenDomainResolver,
   PolicyProvider,
   REDEMPTION_HISTORY_WINDOW_SEC,