uvd-x402-sdk 2.52.1 → 2.53.0

package/dist/backend/index.d.mts

@@ -1685,6 +1685,24 @@ interface RegisterJobResponse {
 }
 /** Whether polling can stop: the job either finished or failed. */
 declare function isRegisterJobTerminal(job: RegisterJobResponse): boolean;
+/**
+ * Thrown when a registration is still running after the wait elapsed.
+ *
+ * This is emphatically **not** a failure. The mint may still land. `jobId` is a
+ * field rather than only part of the message, because the correct recovery is to
+ * keep polling `getRegisterStatus(jobId)` — and a caller who cannot reach the id
+ * without parsing a string will re-register instead, minting a duplicate agent.
+ * That is the exact sequence that once produced five duplicate mints.
+ *
+ * Never map this to "registration failed".
+ */
+declare class RegistrationPendingError extends Error {
+    readonly jobId: string;
+    readonly lastStatus: RegisterJobStatus;
+    readonly timeoutMs: number;
+    readonly retryable = true;
+    constructor(jobId: string, lastStatus: RegisterJobStatus, timeoutMs: number);
+}
 interface IdentityMetadataResponse {
     /** Agent ID (EVM: number, Solana: string) */
     agentId: AgentId;
@@ -1944,7 +1962,11 @@ declare class Erc8004Client {
      * console.log(`Agent #${result.agentId} transferred to user`);
      * ```
      */
-    registerAgent(request: RegisterAgentRequest): Promise<RegisterAgentResponse>;
+    registerAgent(request: RegisterAgentRequest, options?: {
+        asyncTransport?: boolean;
+        pollIntervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<RegisterAgentResponse>;
     /**
      * Start a registration without waiting for the chain to confirm it.
      *
@@ -2471,4 +2493,4 @@ declare class AdvancedEscrowClient {
     private sendViaAdapter;
 }
 
-export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, type AtomStats, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, Erc8004LookupError, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentPayloadV2, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type PaymentRequirementsV2, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type RegisterJobResponse, type RegisterJobStatus, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type ResourceInfoV2, type SettleRequest, type SettleRequestV2, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyRequestV2, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestV2, buildVerifyRequest, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, parsePaymentHeader };
+export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, type AtomStats, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, Erc8004LookupError, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentPayloadV2, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type PaymentRequirementsV2, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type RegisterJobResponse, type RegisterJobStatus, RegistrationPendingError, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type ResourceInfoV2, type SettleRequest, type SettleRequestV2, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyRequestV2, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestV2, buildVerifyRequest, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, parsePaymentHeader };

package/dist/backend/index.d.ts

@@ -1685,6 +1685,24 @@ interface RegisterJobResponse {
 }
 /** Whether polling can stop: the job either finished or failed. */
 declare function isRegisterJobTerminal(job: RegisterJobResponse): boolean;
+/**
+ * Thrown when a registration is still running after the wait elapsed.
+ *
+ * This is emphatically **not** a failure. The mint may still land. `jobId` is a
+ * field rather than only part of the message, because the correct recovery is to
+ * keep polling `getRegisterStatus(jobId)` — and a caller who cannot reach the id
+ * without parsing a string will re-register instead, minting a duplicate agent.
+ * That is the exact sequence that once produced five duplicate mints.
+ *
+ * Never map this to "registration failed".
+ */
+declare class RegistrationPendingError extends Error {
+    readonly jobId: string;
+    readonly lastStatus: RegisterJobStatus;
+    readonly timeoutMs: number;
+    readonly retryable = true;
+    constructor(jobId: string, lastStatus: RegisterJobStatus, timeoutMs: number);
+}
 interface IdentityMetadataResponse {
     /** Agent ID (EVM: number, Solana: string) */
     agentId: AgentId;
@@ -1944,7 +1962,11 @@ declare class Erc8004Client {
      * console.log(`Agent #${result.agentId} transferred to user`);
      * ```
      */
-    registerAgent(request: RegisterAgentRequest): Promise<RegisterAgentResponse>;
+    registerAgent(request: RegisterAgentRequest, options?: {
+        asyncTransport?: boolean;
+        pollIntervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<RegisterAgentResponse>;
     /**
      * Start a registration without waiting for the chain to confirm it.
      *
@@ -2471,4 +2493,4 @@ declare class AdvancedEscrowClient {
     private sendViaAdapter;
 }
 
-export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, type AtomStats, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, Erc8004LookupError, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentPayloadV2, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type PaymentRequirementsV2, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type RegisterJobResponse, type RegisterJobStatus, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type ResourceInfoV2, type SettleRequest, type SettleRequestV2, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyRequestV2, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestV2, buildVerifyRequest, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, parsePaymentHeader };
+export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, type AtomStats, BASE_MAINNET_CONTRACTS, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarRegisterOptions, type BazaarResource, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type DiscoveryAccepts, type DiscoveryCuration, type DiscoveryHealth, type DiscoveryHealthStatus, type DiscoveryListOptions, type DiscoveryPagination, type DiscoveryRegisterOptions, type DiscoveryResource, type DiscoveryResponse, type DiscoverySource, type DiscoveryStats, type DiscoveryTier, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, Erc8004LookupError, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, HEALTH_FILTERS, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, MAX_SEARCH_LEN, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentPayloadV2, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type PaymentRequirementsV2, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type RegisterJobResponse, type RegisterJobStatus, RegistrationPendingError, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type ResourceInfoV2, type SettleRequest, type SettleRequestV2, type SettleResponse, type SettleResponseWithProof, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyRequestV2, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestV2, buildVerifyRequest, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, parsePaymentHeader };

package/dist/backend/index.js

@@ -2576,6 +2576,34 @@ var Erc8004LookupError = class extends Error {
 function isRegisterJobTerminal(job) {
   return job.status === "done" || job.status === "failed";
 }
+var RegistrationPendingError = class extends Error {
+  jobId;
+  lastStatus;
+  timeoutMs;
+  retryable = true;
+  constructor(jobId, lastStatus, timeoutMs) {
+    super(
+      `Registration job ${jobId} still '${lastStatus}' after ${Math.round(
+        timeoutMs / 1e3
+      )}s. It may still complete: poll getRegisterStatus('${jobId}') rather than registering again.`
+    );
+    this.name = "RegistrationPendingError";
+    this.jobId = jobId;
+    this.lastStatus = lastStatus;
+    this.timeoutMs = timeoutMs;
+  }
+};
+function jobToRegisterResponse(job, network) {
+  return {
+    success: job.status !== "failed",
+    agentId: job.agentId,
+    transaction: job.transaction,
+    transferTransaction: job.transferTransaction,
+    owner: job.owner,
+    error: job.error,
+    network: job.network ?? network
+  };
+}
 var Erc8004Client = class {
   baseUrl;
   timeout;
@@ -2978,7 +3006,15 @@ var Erc8004Client = class {
    * console.log(`Agent #${result.agentId} transferred to user`);
    * ```
    */
-  async registerAgent(request) {
+  async registerAgent(request, options) {
+    if (options?.asyncTransport) {
+      const job = await this.registerAgentAsync(request);
+      const terminal = await this.waitForRegistration(job.jobId, {
+        pollIntervalMs: options.pollIntervalMs,
+        timeoutMs: options.timeoutMs
+      });
+      return jobToRegisterResponse(terminal, request.network);
+    }
     const url = `${this.baseUrl}/register`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
@@ -3116,11 +3152,7 @@ var Erc8004Client = class {
         return job;
       }
       if (Date.now() >= deadline) {
-        throw new Error(
-          `Registration job ${jobId} still '${job.status}' after ${Math.round(
-            timeoutMs / 1e3
-          )}s. It may still complete: poll getRegisterStatus('${jobId}') rather than registering again.`
-        );
+        throw new RegistrationPendingError(jobId, job.status, timeoutMs);
       }
       await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
     }
@@ -4156,6 +4188,7 @@ exports.MAX_SEARCH_LEN = MAX_SEARCH_LEN;
 exports.OPERATOR_ABI = OPERATOR_ABI;
 exports.OPERATOR_ABI_CREATE3 = OPERATOR_ABI_CREATE3;
 exports.PAYMENT_INFO_TYPEHASH = PAYMENT_INFO_TYPEHASH;
+exports.RegistrationPendingError = RegistrationPendingError;
 exports.TIER_FILTERS = TIER_FILTERS;
 exports.TIER_TIMINGS = TIER_TIMINGS;
 exports.USDC_DOMAIN_NAME = USDC_DOMAIN_NAME;