uvd-x402-sdk 2.33.0 → 2.34.0

package/dist/backend/index.d.mts

@@ -1480,6 +1480,21 @@ interface RegisterAgentResponse {
     /** Network where agent was registered */
     network: string;
 }
+/**
+ * Response from GET /identity/{network}/owner/{address}
+ */
+interface IdentityByOwnerResponse {
+    /** First (lowest) token ID owned by this address */
+    agentId: AgentId;
+    /** The queried address (checksummed) */
+    owner: string;
+    /** Agent's registration URI (may be empty) */
+    agentUri: string;
+    /** Network name */
+    network: string;
+    /** Total number of agent NFTs owned (as string) */
+    balance: string;
+}
 /**
  * Response from GET /identity/{network}/{agent_id}/metadata/{key}
  */
@@ -1562,6 +1577,22 @@ declare class Erc8004Client {
      * @returns Agent identity information
      */
     getIdentity(network: Erc8004Network, agentId: AgentId): Promise<AgentIdentity>;
+    /**
+     * Get agent identity by owner address
+     *
+     * Resolves the first ERC-8004 agent ID owned by a wallet address on a given network.
+     *
+     * @param network - Network to query
+     * @param address - Owner wallet address
+     * @returns Agent identity information including balance
+     *
+     * @example
+     * ```ts
+     * const identity = await client.getIdentityByOwner('base-mainnet', '0x52E0...');
+     * console.log(`Agent #${identity.agentId}, balance: ${identity.balance}`);
+     * ```
+     */
+    getIdentityByOwner(network: Erc8004Network, address: string): Promise<IdentityByOwnerResponse>;
     /**
      * Resolve agent registration file from agentURI
      *
@@ -1683,10 +1714,11 @@ declare class Erc8004Client {
         sealHash?: string;
     }): Promise<FeedbackResponse>;
     /**
-     * Register a new agent on the Identity Registry
+     * Register an agent on the Identity Registry (idempotent)
      *
-     * The facilitator pays gas fees. Optionally transfer the NFT to a
-     * recipient address (gasless delegation).
+     * If the recipient already owns an agent on the target network, returns the
+     * existing one instead of minting a duplicate. The facilitator pays gas fees.
+     * Optionally transfer the NFT to a recipient address (gasless delegation).
      *
      * @param request - Registration request
      * @returns Registration response with agent ID and transaction hash
@@ -2138,4 +2170,4 @@ declare class AdvancedEscrowClient {
     refundPostEscrow(paymentInfo: AdvancedPaymentInfo, amount?: string, tokenCollector?: string, collectorData?: string): Promise<AdvancedTransactionResult>;
 }
 
-export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, BASE_MAINNET_CONTRACTS, type BazaarCategory, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarNetwork, type BazaarRegisterOptions, type BazaarResource, type BazaarToken, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, type HonoMiddlewareOptions, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type SettleRequest, type SettleResponse, type SettleResponseWithProof, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildVerifyRequest, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isEscrowExpired, isEscrowSupportedOnChain, 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, BASE_MAINNET_CONTRACTS, type BazaarCategory, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarNetwork, type BazaarRegisterOptions, type BazaarResource, type BazaarToken, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type SettleRequest, type SettleResponse, type SettleResponseWithProof, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildVerifyRequest, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isEscrowExpired, isEscrowSupportedOnChain, parsePaymentHeader };

package/dist/backend/index.d.ts

@@ -1480,6 +1480,21 @@ interface RegisterAgentResponse {
     /** Network where agent was registered */
     network: string;
 }
+/**
+ * Response from GET /identity/{network}/owner/{address}
+ */
+interface IdentityByOwnerResponse {
+    /** First (lowest) token ID owned by this address */
+    agentId: AgentId;
+    /** The queried address (checksummed) */
+    owner: string;
+    /** Agent's registration URI (may be empty) */
+    agentUri: string;
+    /** Network name */
+    network: string;
+    /** Total number of agent NFTs owned (as string) */
+    balance: string;
+}
 /**
  * Response from GET /identity/{network}/{agent_id}/metadata/{key}
  */
@@ -1562,6 +1577,22 @@ declare class Erc8004Client {
      * @returns Agent identity information
      */
     getIdentity(network: Erc8004Network, agentId: AgentId): Promise<AgentIdentity>;
+    /**
+     * Get agent identity by owner address
+     *
+     * Resolves the first ERC-8004 agent ID owned by a wallet address on a given network.
+     *
+     * @param network - Network to query
+     * @param address - Owner wallet address
+     * @returns Agent identity information including balance
+     *
+     * @example
+     * ```ts
+     * const identity = await client.getIdentityByOwner('base-mainnet', '0x52E0...');
+     * console.log(`Agent #${identity.agentId}, balance: ${identity.balance}`);
+     * ```
+     */
+    getIdentityByOwner(network: Erc8004Network, address: string): Promise<IdentityByOwnerResponse>;
     /**
      * Resolve agent registration file from agentURI
      *
@@ -1683,10 +1714,11 @@ declare class Erc8004Client {
         sealHash?: string;
     }): Promise<FeedbackResponse>;
     /**
-     * Register a new agent on the Identity Registry
+     * Register an agent on the Identity Registry (idempotent)
      *
-     * The facilitator pays gas fees. Optionally transfer the NFT to a
-     * recipient address (gasless delegation).
+     * If the recipient already owns an agent on the target network, returns the
+     * existing one instead of minting a duplicate. The facilitator pays gas fees.
+     * Optionally transfer the NFT to a recipient address (gasless delegation).
      *
      * @param request - Registration request
      * @returns Registration response with agent ID and transaction hash
@@ -2138,4 +2170,4 @@ declare class AdvancedEscrowClient {
     refundPostEscrow(paymentInfo: AdvancedPaymentInfo, amount?: string, tokenCollector?: string, collectorData?: string): Promise<AdvancedTransactionResult>;
 }
 
-export { type AdvancedAuthorizationResult, AdvancedEscrowClient, type AdvancedEscrowClientOptions, type AdvancedEscrowContracts, type AdvancedEscrowTaskTier, type AdvancedPaymentInfo, type AdvancedTransactionResult, type AgentId, type AgentIdentity, type AgentRegistration, type AgentRegistrationFile, type AgentService, BASE_MAINNET_CONTRACTS, type BazaarCategory, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarNetwork, type BazaarRegisterOptions, type BazaarResource, type BazaarToken, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, type HonoMiddlewareOptions, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type SettleRequest, type SettleResponse, type SettleResponseWithProof, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildVerifyRequest, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isEscrowExpired, isEscrowSupportedOnChain, 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, BASE_MAINNET_CONTRACTS, type BazaarCategory, BazaarClient, type BazaarClientOptions, type BazaarDiscoverOptions, type BazaarDiscoverResponse, type BazaarNetwork, type BazaarRegisterOptions, type BazaarResource, type BazaarToken, type CreateEscrowOptions, DEPOSIT_LIMIT_USDC, type Dispute, type DisputeOutcome, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, type Erc8004ClientOptions, type Erc8004Network, EscrowClient, type EscrowClientOptions, type EscrowPayment, type EscrowStateResponse, type EscrowStatus, FacilitatorClient, type FacilitatorClientOptions, type FeedbackEntry, type FeedbackParams, type FeedbackRequest, type FeedbackResponse, type HonoMiddlewareOptions, type IdentityByOwnerResponse, type IdentityMetadataResponse, type IdentityTotalSupplyResponse, type MetadataEntryParam, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, type PaymentAcceptance, type PaymentMiddlewareOptions, type PaymentRequirementResolver, type PaymentRequirements, type PaymentRequirementsOptions, type ProofOfPayment, type RefundRequest, type RefundStatus, type RegisterAgentRequest, type RegisterAgentResponse, type ReputationResponse, type ReputationSummary, type RequestRefundOptions, type SettleRequest, type SettleResponse, type SettleResponseWithProof, TIER_TIMINGS, USDC_DOMAIN_NAME, type VerifiedPaymentState, type VerifyRequest, type VerifyResponse, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildVerifyRequest, canRefundEscrow, canReleaseEscrow, create402Response, createHonoMiddleware, createPaymentMiddleware, escrowTimeRemaining, extractPaymentFromHeaders, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isEscrowExpired, isEscrowSupportedOnChain, parsePaymentHeader };

package/dist/backend/index.js

@@ -2521,6 +2521,42 @@ var Erc8004Client = class {
       throw error;
     }
   }
+  /**
+   * Get agent identity by owner address
+   *
+   * Resolves the first ERC-8004 agent ID owned by a wallet address on a given network.
+   *
+   * @param network - Network to query
+   * @param address - Owner wallet address
+   * @returns Agent identity information including balance
+   *
+   * @example
+   * ```ts
+   * const identity = await client.getIdentityByOwner('base-mainnet', '0x52E0...');
+   * console.log(`Agent #${identity.agentId}, balance: ${identity.balance}`);
+   * ```
+   */
+  async getIdentityByOwner(network, address) {
+    const url = `${this.baseUrl}/identity/${network}/owner/${address}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: { "Accept": "application/json" },
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`ERC-8004 API error: ${response.status} - ${errorText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      throw error;
+    }
+  }
   /**
    * Resolve agent registration file from agentURI
    *
@@ -2817,10 +2853,11 @@ var Erc8004Client = class {
     }
   }
   /**
-   * Register a new agent on the Identity Registry
+   * Register an agent on the Identity Registry (idempotent)
    *
-   * The facilitator pays gas fees. Optionally transfer the NFT to a
-   * recipient address (gasless delegation).
+   * If the recipient already owns an agent on the target network, returns the
+   * existing one instead of minting a duplicate. The facilitator pays gas fees.
+   * Optionally transfer the NFT to a recipient address (gasless delegation).
    *
    * @param request - Registration request
    * @returns Registration response with agent ID and transaction hash