@pafi-dev/issuer 0.5.35 → 0.5.36

package/dist/index.d.cts

@@ -1847,98 +1847,17 @@ declare function handleMobileSubmit(params: HandleMobileSubmitParams): Promise<{
     userOpHash: Hex;
 }>;
 
-interface IssuerRegistryRecord {
-    issuerAddress: Address;
-    signerAddress: Address;
-    name: string;
-    symbol: string;
-    declaredTotalSupply: bigint;
-    capBasisPoints: number;
-    active: boolean;
-    pointToken: Address;
-    mintingOracle: Address;
-}
-interface PreValidateMintResult {
-    /** Registry record read at pre-validation time. */
-    issuer: IssuerRegistryRecord;
-    /** Current on-chain PointToken.totalSupply(). */
-    totalSupply: bigint;
-    /** declaredTotalSupply × capBasisPoints / 10000. */
-    hardCap: bigint;
-    /** hardCap − totalSupply (clamped to 0). */
-    remaining: bigint;
-}
-/**
- * Thrown by `IssuerStateValidator.preValidateMint()`.
- * `code` maps 1:1 to the HTTP error the issuer API surfaces to clients.
- */
-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 DecodedCall$2 = ReturnType<typeof decodeBatchExecuteCalls>[number];
 
 /**
- * Pure (framework-agnostic) validator for issuer state.
- *
- * Reads IssuerRegistry + PointToken on-chain state and pre-validates
- * mint requests before the user submits a UserOp. Catching these
- * off-chain lets issuers fail fast with a clear error rather than
- * wasting gas on a revert.
- *
- * Caching:
- *   - `PointToken.issuer()` — memoized for the process lifetime (immutable)
- *   - Full state (registry + totalSupply) — 30s TTL per PointToken
- *   - Burst calls while a fetch is in-flight share the same Promise
- *     (thundering-herd protection)
- *
- * Usage in NestJS: wrap this in an `@Injectable()` service; pass
- * `PublicClient` and `registryAddress` from your DI container.
+ * Structural shape — accepts both the raw `IssuerStateValidator` from
+ * `@pafi-dev/issuer/issuer-state` and any host-framework wrapper (e.g.
+ * a NestJS Injectable that delegates to it). Only `preValidateMint`
+ * is needed on this surface.
  */
-declare class IssuerStateValidator {
-    private readonly provider;
-    private readonly registryAddress;
-    private readonly pointTokenIssuerCache;
-    private readonly stateCache;
-    private readonly inflight;
-    constructor(provider: PublicClient, registryAddress: Address);
-    /**
-     * Convenience factory — reads `registryAddress` from the SDK
-     * `CONTRACT_ADDRESSES` map for the given chain.
-     */
-    static forChain(provider: PublicClient, chainId: number): IssuerStateValidator;
-    /**
-     * Invalidate cached state for one PointToken, or everything if omitted.
-     * Call after admin txs that change registry or cap settings.
-     */
-    invalidate(pointToken?: Address): void;
-    /**
-     * Resolve `PointToken.issuer()` once per token and memoize.
-     * The issuer field is set at `initialize()` and never changes.
-     */
-    getIssuerAddressForPointToken(pointToken: Address): Promise<Address>;
-    /**
-     * Read registry record + totalSupply, with 30s cache and in-flight
-     * deduplication. Does NOT throw on inactive/missing — returns raw state.
-     */
-    getIssuerState(pointToken: Address): Promise<PreValidateMintResult>;
-    /**
-     * Validate that `amount` PT can be minted on `pointToken` right now.
-     *
-     * Throws `IssuerStateError` with:
-     *   - `ISSUER_NOT_REGISTERED` — registry has no record for this issuer
-     *   - `ISSUER_INACTIVE`       — issuer.active is false
-     *   - `MINT_CAP_EXCEEDED`     — totalSupply + amount would exceed hardCap
-     *
-     * Returns the fetched state on success so callers can log without a
-     * second RPC round-trip.
-     */
-    preValidateMint(pointToken: Address, amount: bigint): Promise<PreValidateMintResult>;
-    private fetchIssuerState;
+interface IssuerStateValidatorLike {
+    preValidateMint(pointToken: Address, amount: bigint): Promise<unknown>;
 }
-
-type DecodedCall$2 = ReturnType<typeof decodeBatchExecuteCalls>[number];
-
 /**
  * v1.4 sig-gated mint handler — mirrors `PTRedeemHandler` on the mint side.
  *
@@ -1971,7 +1890,7 @@ interface PTClaimHandlerConfig {
     /** Optional — when wired, used to estimate the PT gas-reimbursement fee. */
     feeService?: FeeManager;
     /** Optional — pre-validates issuer status + cap before locking balance. */
-    issuerStateValidator?: IssuerStateValidator;
+    issuerStateValidator?: IssuerStateValidatorLike;
     /** How long the off-chain balance lock survives if the mint never lands. Default 15 min. */
     lockDurationMs?: number;
     /** How far ahead of `now` to set the MintRequest deadline. Default 15 min. */
@@ -2581,6 +2500,96 @@ interface IssuerService {
  */
 declare function createIssuerService(config: IssuerServiceConfig): IssuerService;
 
+interface IssuerRegistryRecord {
+    issuerAddress: Address;
+    signerAddress: Address;
+    name: string;
+    symbol: string;
+    declaredTotalSupply: bigint;
+    capBasisPoints: number;
+    active: boolean;
+    pointToken: Address;
+    mintingOracle: Address;
+}
+interface PreValidateMintResult {
+    /** Registry record read at pre-validation time. */
+    issuer: IssuerRegistryRecord;
+    /** Current on-chain PointToken.totalSupply(). */
+    totalSupply: bigint;
+    /** declaredTotalSupply × capBasisPoints / 10000. */
+    hardCap: bigint;
+    /** hardCap − totalSupply (clamped to 0). */
+    remaining: bigint;
+}
+/**
+ * Thrown by `IssuerStateValidator.preValidateMint()`.
+ * `code` maps 1:1 to the HTTP error the issuer API surfaces to clients.
+ */
+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);
+}
+
+/**
+ * Pure (framework-agnostic) validator for issuer state.
+ *
+ * Reads IssuerRegistry + PointToken on-chain state and pre-validates
+ * mint requests before the user submits a UserOp. Catching these
+ * off-chain lets issuers fail fast with a clear error rather than
+ * wasting gas on a revert.
+ *
+ * Caching:
+ *   - `PointToken.issuer()` — memoized for the process lifetime (immutable)
+ *   - Full state (registry + totalSupply) — 30s TTL per PointToken
+ *   - Burst calls while a fetch is in-flight share the same Promise
+ *     (thundering-herd protection)
+ *
+ * Usage in NestJS: wrap this in an `@Injectable()` service; pass
+ * `PublicClient` and `registryAddress` from your DI container.
+ */
+declare class IssuerStateValidator {
+    private readonly provider;
+    private readonly registryAddress;
+    private readonly pointTokenIssuerCache;
+    private readonly stateCache;
+    private readonly inflight;
+    constructor(provider: PublicClient, registryAddress: Address);
+    /**
+     * Convenience factory — reads `registryAddress` from the SDK
+     * `CONTRACT_ADDRESSES` map for the given chain.
+     */
+    static forChain(provider: PublicClient, chainId: number): IssuerStateValidator;
+    /**
+     * Invalidate cached state for one PointToken, or everything if omitted.
+     * Call after admin txs that change registry or cap settings.
+     */
+    invalidate(pointToken?: Address): void;
+    /**
+     * Resolve `PointToken.issuer()` once per token and memoize.
+     * The issuer field is set at `initialize()` and never changes.
+     */
+    getIssuerAddressForPointToken(pointToken: Address): Promise<Address>;
+    /**
+     * Read registry record + totalSupply, with 30s cache and in-flight
+     * deduplication. Does NOT throw on inactive/missing — returns raw state.
+     */
+    getIssuerState(pointToken: Address): Promise<PreValidateMintResult>;
+    /**
+     * Validate that `amount` PT can be minted on `pointToken` right now.
+     *
+     * Throws `IssuerStateError` with:
+     *   - `ISSUER_NOT_REGISTERED` — registry has no record for this issuer
+     *   - `ISSUER_INACTIVE`       — issuer.active is false
+     *   - `MINT_CAP_EXCEEDED`     — totalSupply + amount would exceed hardCap
+     *
+     * Returns the fetched state on success so callers can log without a
+     * second RPC round-trip.
+     */
+    preValidateMint(pointToken: Address, amount: bigint): Promise<PreValidateMintResult>;
+    private fetchIssuerState;
+}
+
 /** SDK package version — bumped on every release */
 declare const PAFI_ISSUER_SDK_VERSION = "0.4.0";
 

package/dist/index.d.ts

@@ -1847,98 +1847,17 @@ declare function handleMobileSubmit(params: HandleMobileSubmitParams): Promise<{
     userOpHash: Hex;
 }>;
 
-interface IssuerRegistryRecord {
-    issuerAddress: Address;
-    signerAddress: Address;
-    name: string;
-    symbol: string;
-    declaredTotalSupply: bigint;
-    capBasisPoints: number;
-    active: boolean;
-    pointToken: Address;
-    mintingOracle: Address;
-}
-interface PreValidateMintResult {
-    /** Registry record read at pre-validation time. */
-    issuer: IssuerRegistryRecord;
-    /** Current on-chain PointToken.totalSupply(). */
-    totalSupply: bigint;
-    /** declaredTotalSupply × capBasisPoints / 10000. */
-    hardCap: bigint;
-    /** hardCap − totalSupply (clamped to 0). */
-    remaining: bigint;
-}
-/**
- * Thrown by `IssuerStateValidator.preValidateMint()`.
- * `code` maps 1:1 to the HTTP error the issuer API surfaces to clients.
- */
-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 DecodedCall$2 = ReturnType<typeof decodeBatchExecuteCalls>[number];
 
 /**
- * Pure (framework-agnostic) validator for issuer state.
- *
- * Reads IssuerRegistry + PointToken on-chain state and pre-validates
- * mint requests before the user submits a UserOp. Catching these
- * off-chain lets issuers fail fast with a clear error rather than
- * wasting gas on a revert.
- *
- * Caching:
- *   - `PointToken.issuer()` — memoized for the process lifetime (immutable)
- *   - Full state (registry + totalSupply) — 30s TTL per PointToken
- *   - Burst calls while a fetch is in-flight share the same Promise
- *     (thundering-herd protection)
- *
- * Usage in NestJS: wrap this in an `@Injectable()` service; pass
- * `PublicClient` and `registryAddress` from your DI container.
+ * Structural shape — accepts both the raw `IssuerStateValidator` from
+ * `@pafi-dev/issuer/issuer-state` and any host-framework wrapper (e.g.
+ * a NestJS Injectable that delegates to it). Only `preValidateMint`
+ * is needed on this surface.
  */
-declare class IssuerStateValidator {
-    private readonly provider;
-    private readonly registryAddress;
-    private readonly pointTokenIssuerCache;
-    private readonly stateCache;
-    private readonly inflight;
-    constructor(provider: PublicClient, registryAddress: Address);
-    /**
-     * Convenience factory — reads `registryAddress` from the SDK
-     * `CONTRACT_ADDRESSES` map for the given chain.
-     */
-    static forChain(provider: PublicClient, chainId: number): IssuerStateValidator;
-    /**
-     * Invalidate cached state for one PointToken, or everything if omitted.
-     * Call after admin txs that change registry or cap settings.
-     */
-    invalidate(pointToken?: Address): void;
-    /**
-     * Resolve `PointToken.issuer()` once per token and memoize.
-     * The issuer field is set at `initialize()` and never changes.
-     */
-    getIssuerAddressForPointToken(pointToken: Address): Promise<Address>;
-    /**
-     * Read registry record + totalSupply, with 30s cache and in-flight
-     * deduplication. Does NOT throw on inactive/missing — returns raw state.
-     */
-    getIssuerState(pointToken: Address): Promise<PreValidateMintResult>;
-    /**
-     * Validate that `amount` PT can be minted on `pointToken` right now.
-     *
-     * Throws `IssuerStateError` with:
-     *   - `ISSUER_NOT_REGISTERED` — registry has no record for this issuer
-     *   - `ISSUER_INACTIVE`       — issuer.active is false
-     *   - `MINT_CAP_EXCEEDED`     — totalSupply + amount would exceed hardCap
-     *
-     * Returns the fetched state on success so callers can log without a
-     * second RPC round-trip.
-     */
-    preValidateMint(pointToken: Address, amount: bigint): Promise<PreValidateMintResult>;
-    private fetchIssuerState;
+interface IssuerStateValidatorLike {
+    preValidateMint(pointToken: Address, amount: bigint): Promise<unknown>;
 }
-
-type DecodedCall$2 = ReturnType<typeof decodeBatchExecuteCalls>[number];
-
 /**
  * v1.4 sig-gated mint handler — mirrors `PTRedeemHandler` on the mint side.
  *
@@ -1971,7 +1890,7 @@ interface PTClaimHandlerConfig {
     /** Optional — when wired, used to estimate the PT gas-reimbursement fee. */
     feeService?: FeeManager;
     /** Optional — pre-validates issuer status + cap before locking balance. */
-    issuerStateValidator?: IssuerStateValidator;
+    issuerStateValidator?: IssuerStateValidatorLike;
     /** How long the off-chain balance lock survives if the mint never lands. Default 15 min. */
     lockDurationMs?: number;
     /** How far ahead of `now` to set the MintRequest deadline. Default 15 min. */
@@ -2581,6 +2500,96 @@ interface IssuerService {
  */
 declare function createIssuerService(config: IssuerServiceConfig): IssuerService;
 
+interface IssuerRegistryRecord {
+    issuerAddress: Address;
+    signerAddress: Address;
+    name: string;
+    symbol: string;
+    declaredTotalSupply: bigint;
+    capBasisPoints: number;
+    active: boolean;
+    pointToken: Address;
+    mintingOracle: Address;
+}
+interface PreValidateMintResult {
+    /** Registry record read at pre-validation time. */
+    issuer: IssuerRegistryRecord;
+    /** Current on-chain PointToken.totalSupply(). */
+    totalSupply: bigint;
+    /** declaredTotalSupply × capBasisPoints / 10000. */
+    hardCap: bigint;
+    /** hardCap − totalSupply (clamped to 0). */
+    remaining: bigint;
+}
+/**
+ * Thrown by `IssuerStateValidator.preValidateMint()`.
+ * `code` maps 1:1 to the HTTP error the issuer API surfaces to clients.
+ */
+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);
+}
+
+/**
+ * Pure (framework-agnostic) validator for issuer state.
+ *
+ * Reads IssuerRegistry + PointToken on-chain state and pre-validates
+ * mint requests before the user submits a UserOp. Catching these
+ * off-chain lets issuers fail fast with a clear error rather than
+ * wasting gas on a revert.
+ *
+ * Caching:
+ *   - `PointToken.issuer()` — memoized for the process lifetime (immutable)
+ *   - Full state (registry + totalSupply) — 30s TTL per PointToken
+ *   - Burst calls while a fetch is in-flight share the same Promise
+ *     (thundering-herd protection)
+ *
+ * Usage in NestJS: wrap this in an `@Injectable()` service; pass
+ * `PublicClient` and `registryAddress` from your DI container.
+ */
+declare class IssuerStateValidator {
+    private readonly provider;
+    private readonly registryAddress;
+    private readonly pointTokenIssuerCache;
+    private readonly stateCache;
+    private readonly inflight;
+    constructor(provider: PublicClient, registryAddress: Address);
+    /**
+     * Convenience factory — reads `registryAddress` from the SDK
+     * `CONTRACT_ADDRESSES` map for the given chain.
+     */
+    static forChain(provider: PublicClient, chainId: number): IssuerStateValidator;
+    /**
+     * Invalidate cached state for one PointToken, or everything if omitted.
+     * Call after admin txs that change registry or cap settings.
+     */
+    invalidate(pointToken?: Address): void;
+    /**
+     * Resolve `PointToken.issuer()` once per token and memoize.
+     * The issuer field is set at `initialize()` and never changes.
+     */
+    getIssuerAddressForPointToken(pointToken: Address): Promise<Address>;
+    /**
+     * Read registry record + totalSupply, with 30s cache and in-flight
+     * deduplication. Does NOT throw on inactive/missing — returns raw state.
+     */
+    getIssuerState(pointToken: Address): Promise<PreValidateMintResult>;
+    /**
+     * Validate that `amount` PT can be minted on `pointToken` right now.
+     *
+     * Throws `IssuerStateError` with:
+     *   - `ISSUER_NOT_REGISTERED` — registry has no record for this issuer
+     *   - `ISSUER_INACTIVE`       — issuer.active is false
+     *   - `MINT_CAP_EXCEEDED`     — totalSupply + amount would exceed hardCap
+     *
+     * Returns the fetched state on success so callers can log without a
+     * second RPC round-trip.
+     */
+    preValidateMint(pointToken: Address, amount: bigint): Promise<PreValidateMintResult>;
+    private fetchIssuerState;
+}
+
 /** SDK package version — bumped on every release */
 declare const PAFI_ISSUER_SDK_VERSION = "0.4.0";