uvd-x402-sdk 2.16.2 → 2.17.0

package/dist/backend/index.js

@@ -13,6 +13,9 @@ var CAIP2_IDENTIFIERS = {
   hyperevm: "eip155:999",
   unichain: "eip155:130",
   monad: "eip155:143",
+  scroll: "eip155:534352",
+  skale: "eip155:1187947933",
+  "skale-testnet": "eip155:324705682",
   // SVM chains
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   fogo: "svm:fogo",
@@ -438,6 +441,106 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
+  scroll: {
+    chainId: 534352,
+    chainIdHex: "0x82750",
+    name: "scroll",
+    displayName: "Scroll",
+    networkType: "evm",
+    rpcUrl: "https://rpc.scroll.io",
+    explorerUrl: "https://scrollscan.com",
+    nativeCurrency: {
+      name: "Ethereum",
+      symbol: "ETH",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
+      decimals: 6,
+      name: "USD Coin",
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  skale: {
+    chainId: 1187947933,
+    chainIdHex: "0x46cea59d",
+    name: "skale",
+    displayName: "SKALE",
+    networkType: "evm",
+    rpcUrl: "https://mainnet.skalenodes.com/v1/honorable-steel-rasalhague",
+    explorerUrl: "https://honorable-steel-rasalhague.explorer.mainnet.skalenodes.com",
+    nativeCurrency: {
+      name: "sFUEL",
+      symbol: "sFUEL",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
+      decimals: 6,
+      name: "USDC",
+      // SKALE uses "USDC"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
+        decimals: 6,
+        name: "USDC",
+        // SKALE uses "USDC"
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
+  "skale-testnet": {
+    chainId: 324705682,
+    chainIdHex: "0x135a9d92",
+    name: "skale-testnet",
+    displayName: "SKALE Testnet",
+    networkType: "evm",
+    rpcUrl: "https://testnet.skalenodes.com/v1/lanky-ill-funny-testnet",
+    explorerUrl: "https://lanky-ill-funny-testnet.explorer.testnet.skalenodes.com",
+    nativeCurrency: {
+      name: "sFUEL",
+      symbol: "sFUEL",
+      decimals: 18
+    },
+    usdc: {
+      address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
+      decimals: 6,
+      name: "USDC",
+      // SKALE testnet uses "USDC"
+      version: "2"
+    },
+    tokens: {
+      usdc: {
+        address: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
+        decimals: 6,
+        name: "USDC",
+        // SKALE testnet uses "USDC"
+        version: "2"
+      }
+    },
+    x402: {
+      facilitatorUrl: DEFAULT_FACILITATOR_URL,
+      enabled: true
+    }
+  },
   // ============================================================================
   // SVM CHAINS (2 networks) - Solana Virtual Machine
   // ============================================================================
@@ -1797,12 +1900,357 @@ function isEscrowExpired(escrow) {
 function escrowTimeRemaining(escrow) {
   return new Date(escrow.expiresAt).getTime() - Date.now();
 }
+var ERC8004_EXTENSION_ID = "8004-reputation";
+var ERC8004_CONTRACTS = {
+  ethereum: {
+    identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
+    reputationRegistry: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63"
+  },
+  "ethereum-sepolia": {
+    identityRegistry: "0x8004A818BFB912233c491871b3d84c89A494BD9e",
+    reputationRegistry: "0x8004B663056A597Dffe9eCcC1965A193B7388713",
+    validationRegistry: "0x8004Cb1BF31DAf7788923b405b754f57acEB4272"
+  }
+};
+var Erc8004Client = class {
+  baseUrl;
+  timeout;
+  constructor(options = {}) {
+    this.baseUrl = options.baseUrl || "https://facilitator.ultravioletadao.xyz";
+    this.timeout = options.timeout || 3e4;
+  }
+  /**
+   * Get agent identity from the Identity Registry
+   *
+   * @param network - Network where agent is registered
+   * @param agentId - Agent's tokenId
+   * @returns Agent identity information
+   */
+  async getIdentity(network, agentId) {
+    const url = `${this.baseUrl}/identity/${network}/${agentId}`;
+    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
+   *
+   * @param agentUri - URI pointing to agent registration file
+   * @returns Resolved agent registration file
+   */
+  async resolveAgentUri(agentUri) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      let url = agentUri;
+      if (agentUri.startsWith("ipfs://")) {
+        const cid = agentUri.replace("ipfs://", "");
+        url = `https://ipfs.io/ipfs/${cid}`;
+      }
+      const response = await fetch(url, {
+        method: "GET",
+        headers: { "Accept": "application/json" },
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        throw new Error(`Failed to resolve agentURI: ${response.status}`);
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      throw error;
+    }
+  }
+  /**
+   * Get agent reputation from the Reputation Registry
+   *
+   * @param network - Network where agent is registered
+   * @param agentId - Agent's tokenId
+   * @param options - Query options (tag filters, include individual feedback)
+   * @returns Reputation summary and optionally individual feedback entries
+   */
+  async getReputation(network, agentId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.tag1) params.set("tag1", options.tag1);
+    if (options.tag2) params.set("tag2", options.tag2);
+    if (options.includeFeedback) params.set("includeFeedback", "true");
+    const url = `${this.baseUrl}/reputation/${network}/${agentId}${params.toString() ? `?${params}` : ""}`;
+    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;
+    }
+  }
+  /**
+   * Submit reputation feedback for an agent
+   *
+   * Requires proof of payment for authorized feedback submission.
+   *
+   * @param request - Feedback request with agent ID, value, and proof
+   * @returns Feedback response with transaction hash
+   *
+   * @example
+   * ```ts
+   * // After settling a payment with ERC-8004 extension
+   * const settleResult = await facilitator.settle(payment, {
+   *   ...requirements,
+   *   extra: { '8004-reputation': { includeProof: true } },
+   * });
+   *
+   * // Submit feedback with proof of payment
+   * const feedback = await erc8004.submitFeedback({
+   *   x402Version: 1,
+   *   network: 'ethereum',
+   *   feedback: {
+   *     agentId: 42,
+   *     value: 95,  // 95/100
+   *     valueDecimals: 0,
+   *     tag1: 'quality',
+   *     tag2: 'response-time',
+   *     proof: settleResult.proofOfPayment,
+   *   },
+   * });
+   * ```
+   */
+  async submitFeedback(request) {
+    const url = `${this.baseUrl}/feedback`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+        },
+        body: JSON.stringify(request),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorText = await response.text();
+        return {
+          success: false,
+          error: `Facilitator error: ${response.status} - ${errorText}`,
+          network: request.network
+        };
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        network: request.network
+      };
+    }
+  }
+  /**
+   * Revoke previously submitted feedback
+   *
+   * Only the original submitter can revoke their feedback.
+   *
+   * @param network - Network where feedback was submitted
+   * @param agentId - Agent ID
+   * @param feedbackIndex - Index of feedback to revoke
+   * @returns Revocation result
+   */
+  async revokeFeedback(network, agentId, feedbackIndex) {
+    const url = `${this.baseUrl}/feedback/revoke`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+        },
+        body: JSON.stringify({
+          x402Version: 1,
+          network,
+          agentId,
+          feedbackIndex
+        }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorText = await response.text();
+        return {
+          success: false,
+          error: `Facilitator error: ${response.status} - ${errorText}`,
+          network
+        };
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        network
+      };
+    }
+  }
+  /**
+   * Get ERC-8004 contract addresses for a network
+   *
+   * @param network - Network to get contracts for
+   * @returns Contract addresses or undefined if not deployed
+   */
+  getContracts(network) {
+    return ERC8004_CONTRACTS[network];
+  }
+  /**
+   * Check if ERC-8004 is available on a network
+   *
+   * @param network - Network to check
+   * @returns True if ERC-8004 contracts are deployed
+   */
+  isAvailable(network) {
+    return network in ERC8004_CONTRACTS;
+  }
+  /**
+   * Get feedback endpoint metadata
+   *
+   * @returns Endpoint information for /feedback
+   */
+  async getFeedbackMetadata() {
+    const url = `${this.baseUrl}/feedback`;
+    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) {
+        throw new Error(`Failed to get feedback metadata: ${response.status}`);
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      throw error;
+    }
+  }
+  /**
+   * Append a response to existing feedback
+   *
+   * Allows agents to respond to feedback they received.
+   * Only the agent (identity owner) can append responses.
+   *
+   * @param network - Network where feedback was submitted
+   * @param agentId - Agent ID
+   * @param feedbackIndex - Index of feedback to respond to
+   * @param response - Response content
+   * @param responseUri - Optional URI to off-chain response file
+   * @returns Response result
+   *
+   * @example
+   * ```ts
+   * // Agent responds to feedback
+   * const result = await erc8004.appendResponse(
+   *   'ethereum',
+   *   42,
+   *   1,
+   *   'Thank you for your feedback! We have addressed the issue.',
+   * );
+   * ```
+   */
+  async appendResponse(network, agentId, feedbackIndex, response, responseUri) {
+    const url = `${this.baseUrl}/feedback/response`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const fetchResponse = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+        },
+        body: JSON.stringify({
+          x402Version: 1,
+          network,
+          agentId,
+          feedbackIndex,
+          response,
+          responseUri
+        }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!fetchResponse.ok) {
+        const errorText = await fetchResponse.text();
+        return {
+          success: false,
+          error: `Facilitator error: ${fetchResponse.status} - ${errorText}`,
+          network
+        };
+      }
+      return await fetchResponse.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        network
+      };
+    }
+  }
+};
+function buildErc8004PaymentRequirements(options) {
+  const base = buildPaymentRequirements(options);
+  return {
+    ...base,
+    extra: {
+      [ERC8004_EXTENSION_ID]: {
+        includeProof: true
+      }
+    }
+  };
+}
 
 exports.BazaarClient = BazaarClient;
+exports.ERC8004_CONTRACTS = ERC8004_CONTRACTS;
+exports.ERC8004_EXTENSION_ID = ERC8004_EXTENSION_ID;
+exports.Erc8004Client = Erc8004Client;
 exports.EscrowClient = EscrowClient;
 exports.FacilitatorClient = FacilitatorClient;
 exports.X402_CORS_HEADERS = X402_CORS_HEADERS;
 exports.X402_HEADER_NAMES = X402_HEADER_NAMES;
+exports.buildErc8004PaymentRequirements = buildErc8004PaymentRequirements;
 exports.buildPaymentRequirements = buildPaymentRequirements;
 exports.buildSettleRequest = buildSettleRequest;
 exports.buildVerifyRequest = buildVerifyRequest;