@pafi-dev/issuer 0.5.26 → 0.5.28

package/dist/index.d.cts

@@ -1555,12 +1555,32 @@ interface SponsorshipResponse {
     callGasLimit?: bigint;
     verificationGasLimit?: bigint;
     preVerificationGas?: bigint;
+    /**
+     * Bundler-required gas price (Pimlico's `pimlico_getUserOperationGasPrice`
+     * fast tier). Pimlico's paymaster signs over these — caller MUST apply
+     * to the userOp before computing the EIP-712 userOpHash. Base RPC's
+     * `eth_feeHistory` underestimates the bundler floor by 10-15 %, so
+     * relying on it produces "maxFeePerGas must be at least ..." rejections.
+     */
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
     expiresAt: number;
 }
 declare class PafiBackendClient {
     private readonly config;
     constructor(config: PafiBackendConfig);
     requestSponsorship(request: SponsorshipRequest): Promise<SponsorshipResponse>;
+    /**
+     * Fetch ERC-4337 UserOp receipt via PAFI's authenticated bundler proxy.
+     * Returns `null` when the bundler hasn't seen the userOp yet — caller
+     * should keep polling. Used by status endpoints to short-circuit the
+     * on-chain indexer when several PENDING locks share the same amount.
+     */
+    getUserOpReceipt(userOpHash: Hex): Promise<{
+        success: boolean;
+        txHash: Hex;
+        blockNumber: string;
+    } | null>;
     relayUserOperation(request: RelayUserOpRequest): Promise<RelayUserOpResponse>;
     private _doRequest;
 }

package/dist/index.d.ts

@@ -1555,12 +1555,32 @@ interface SponsorshipResponse {
     callGasLimit?: bigint;
     verificationGasLimit?: bigint;
     preVerificationGas?: bigint;
+    /**
+     * Bundler-required gas price (Pimlico's `pimlico_getUserOperationGasPrice`
+     * fast tier). Pimlico's paymaster signs over these — caller MUST apply
+     * to the userOp before computing the EIP-712 userOpHash. Base RPC's
+     * `eth_feeHistory` underestimates the bundler floor by 10-15 %, so
+     * relying on it produces "maxFeePerGas must be at least ..." rejections.
+     */
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
     expiresAt: number;
 }
 declare class PafiBackendClient {
     private readonly config;
     constructor(config: PafiBackendConfig);
     requestSponsorship(request: SponsorshipRequest): Promise<SponsorshipResponse>;
+    /**
+     * Fetch ERC-4337 UserOp receipt via PAFI's authenticated bundler proxy.
+     * Returns `null` when the bundler hasn't seen the userOp yet — caller
+     * should keep polling. Used by status endpoints to short-circuit the
+     * on-chain indexer when several PENDING locks share the same amount.
+     */
+    getUserOpReceipt(userOpHash: Hex): Promise<{
+        success: boolean;
+        txHash: Hex;
+        blockNumber: string;
+    } | null>;
     relayUserOperation(request: RelayUserOpRequest): Promise<RelayUserOpResponse>;
     private _doRequest;
 }

package/dist/index.js

@@ -2028,6 +2028,51 @@ var PafiBackendClient = class {
     }
     throw lastError;
   }
+  /**
+   * Fetch ERC-4337 UserOp receipt via PAFI's authenticated bundler proxy.
+   * Returns `null` when the bundler hasn't seen the userOp yet — caller
+   * should keep polling. Used by status endpoints to short-circuit the
+   * on-chain indexer when several PENDING locks share the same amount.
+   */
+  async getUserOpReceipt(userOpHash) {
+    const fetchFn = this.config.fetchImpl ?? fetch;
+    const url = `${this.config.url}/bundler/receipt`;
+    let response;
+    try {
+      response = await fetchFn(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.config.apiKey}`,
+          "X-Issuer-Id": this.config.issuerId
+        },
+        body: JSON.stringify({ userOpHash })
+      });
+    } catch (err) {
+      throw new PafiBackendError(
+        "NETWORK_ERROR",
+        `Network error: ${err instanceof Error ? err.message : String(err)}`,
+        0
+      );
+    }
+    const text = await response.text();
+    let json = {};
+    try {
+      json = JSON.parse(text);
+    } catch {
+    }
+    if (!response.ok) {
+      const code = json.code ?? "INTERNAL_ERROR";
+      const message = json.message ?? `HTTP ${response.status}`;
+      throw new PafiBackendError(code, message, response.status, json);
+    }
+    if (json.pending) return null;
+    return {
+      success: json.success,
+      txHash: json.txHash,
+      blockNumber: json.blockNumber
+    };
+  }
   async relayUserOperation(request) {
     const fetchFn = this.config.fetchImpl ?? fetch;
     const url = `${this.config.url}/bundler/relay`;
@@ -2110,6 +2155,8 @@ var PafiBackendClient = class {
       callGasLimit: json.callGasLimit != null ? BigInt(json.callGasLimit) : void 0,
       verificationGasLimit: json.verificationGasLimit != null ? BigInt(json.verificationGasLimit) : void 0,
       preVerificationGas: json.preVerificationGas != null ? BigInt(json.preVerificationGas) : void 0,
+      maxFeePerGas: json.maxFeePerGas != null ? BigInt(json.maxFeePerGas) : void 0,
+      maxPriorityFeePerGas: json.maxPriorityFeePerGas != null ? BigInt(json.maxPriorityFeePerGas) : void 0,
       expiresAt: json.expiresAt
     };
   }