uvd-x402-sdk 2.66.0 → 2.69.0

package/README.md

@@ -14,7 +14,7 @@ Users sign a message or transaction, and the Ultravioleta facilitator handles on
 - **React & Wagmi**: First-class integrations
 - **Signing Wallet Adapters**: EnvKeyAdapter (server/CLI), OWSWalletAdapter (Open Wallet Standard), or bring your own
 - **ERC-8128 Signed Requests**: Authenticate HTTP requests with a wallet (RFC 9421 + EIP-191) — no API keys
-- **ERC-8004 Trustless Agents**: On-chain reputation and identity across 20 networks (18 EVM + 2 Solana)
+- **ERC-8004 Trustless Agents**: On-chain reputation and identity across 21 networks (19 EVM + 2 Solana)
 - **Escrow & Refunds**: Hold payments with dispute resolution
 - **Advanced Escrow**: Full escrow lifecycle (authorize, release, refund, charge) with SigningWalletAdapter support
 - **Escrow Pre-Auth**: Sign-on-assignment `X-Payment-Auth` builder (`buildEscrowPreAuth`) — vector-pinned parity with the Python SDK and Execution Market
@@ -871,7 +871,10 @@ try {
 
 ## ERC-8004 Trustless Agents
 
-Build verifiable on-chain reputation for AI agents and services. Supports **20 networks** (18 EVM + 2 Solana).
+Build verifiable on-chain reputation for AI agents and services. Supports **21 networks** (19 EVM + 2 Solana).
+
+> Name Base as `'base'`. The old `'base-mainnet'` spelling is rejected by the facilitator
+> (`400 Invalid network`); the SDK now rewrites it for you, but new code should use `'base'`.
 
 On EVM networks, agent IDs are sequential numbers. On Solana, agent IDs are base58 pubkey strings. The `AgentId` type (`number | string`) handles both.
 

package/dist/backend/index.d.mts

@@ -60,7 +60,24 @@ interface SettleResponse {
     success: boolean;
     transactionHash?: string;
     network?: string;
+    /** Transport-level failure (unreachable facilitator, non-2xx, timeout). */
     error?: string;
+    /**
+     * The facilitator's own reason when it settled nothing — e.g. a transfer that
+     * mined and reverted. Distinct from `error` above, which is this client
+     * failing to ask; this one is the facilitator answering "no".
+     */
+    errorReason?: string;
+    /** The address the facilitator confirmed as the payer. */
+    payer?: string;
+    /**
+     * Settlement proof, present when the ERC-8004 extension asked for it.
+     *
+     * Typed here rather than only on {@link SettleResponseWithProof} because
+     * `settle()` returns it whenever the facilitator sends it, and it is what
+     * DX402's `anchorEvidence` needs to reach `verified: true`.
+     */
+    proofOfPayment?: ProofOfPayment;
 }
 /**
  * Options for building payment requirements
@@ -1340,7 +1357,7 @@ declare const ERC8004_EXTENSION_ID = "8004-reputation";
  */
 type AgentId = number | string;
 /**
- * ERC-8004 contract addresses per network (20 networks: 18 EVM + 2 Solana)
+ * ERC-8004 contract addresses per network (21 networks: 19 EVM + 2 Solana)
  */
 declare const ERC8004_CONTRACTS: Record<string, {
     identityRegistry?: string;
@@ -1350,9 +1367,24 @@ declare const ERC8004_CONTRACTS: Record<string, {
     atomEngineProgram?: string;
 }>;
 /**
- * Network type for ERC-8004 operations (20 networks: 18 EVM + 2 Solana)
+ * Return the network name the facilitator actually accepts.
+ *
+ * `base-mainnet` reads like the canonical spelling and is not: the facilitator
+ * answers `400 {"error": "Invalid network: base-mainnet"}`. Every name is passed
+ * through here before it reaches a URL or a request body, so callers holding the
+ * old spelling keep working instead of being rejected at the edge.
+ */
+declare function wireNetwork(network: string): string;
+/**
+ * Network type for ERC-8004 operations (21 networks: 19 EVM + 2 Solana)
+ *
+ * These are the names the FACILITATOR accepts, verified against
+ * GET /feedback -> supportedNetworks. 'base-mainnet' is kept only as a
+ * deprecated alias: the facilitator rejects it outright (400 "Invalid network"),
+ * so anything passed through this module is normalised to 'base' before it
+ * reaches the wire. Use 'base'.
  */
-type Erc8004Network = 'ethereum' | 'base-mainnet' | 'polygon' | 'arbitrum' | 'optimism' | 'celo' | 'bsc' | 'monad' | 'avalanche' | 'skale-base' | 'ethereum-sepolia' | 'base-sepolia' | 'polygon-amoy' | 'arbitrum-sepolia' | 'optimism-sepolia' | 'celo-sepolia' | 'avalanche-fuji' | 'skale-base-sepolia' | 'solana' | 'solana-devnet';
+type Erc8004Network = 'ethereum' | 'base' | 'polygon' | 'arbitrum' | 'optimism' | 'celo' | 'bsc' | 'monad' | 'avalanche' | 'scroll' | 'skale-base' | 'base-mainnet' | 'ethereum-sepolia' | 'base-sepolia' | 'polygon-amoy' | 'arbitrum-sepolia' | 'optimism-sepolia' | 'celo-sepolia' | 'avalanche-fuji' | 'skale-base-sepolia' | 'solana' | 'solana-devnet';
 /**
  * Proof of payment returned when settling with ERC-8004 extension
  */
@@ -2496,4 +2528,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, 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 };
+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, wireNetwork };

package/dist/backend/index.d.ts

@@ -60,7 +60,24 @@ interface SettleResponse {
     success: boolean;
     transactionHash?: string;
     network?: string;
+    /** Transport-level failure (unreachable facilitator, non-2xx, timeout). */
     error?: string;
+    /**
+     * The facilitator's own reason when it settled nothing — e.g. a transfer that
+     * mined and reverted. Distinct from `error` above, which is this client
+     * failing to ask; this one is the facilitator answering "no".
+     */
+    errorReason?: string;
+    /** The address the facilitator confirmed as the payer. */
+    payer?: string;
+    /**
+     * Settlement proof, present when the ERC-8004 extension asked for it.
+     *
+     * Typed here rather than only on {@link SettleResponseWithProof} because
+     * `settle()` returns it whenever the facilitator sends it, and it is what
+     * DX402's `anchorEvidence` needs to reach `verified: true`.
+     */
+    proofOfPayment?: ProofOfPayment;
 }
 /**
  * Options for building payment requirements
@@ -1340,7 +1357,7 @@ declare const ERC8004_EXTENSION_ID = "8004-reputation";
  */
 type AgentId = number | string;
 /**
- * ERC-8004 contract addresses per network (20 networks: 18 EVM + 2 Solana)
+ * ERC-8004 contract addresses per network (21 networks: 19 EVM + 2 Solana)
  */
 declare const ERC8004_CONTRACTS: Record<string, {
     identityRegistry?: string;
@@ -1350,9 +1367,24 @@ declare const ERC8004_CONTRACTS: Record<string, {
     atomEngineProgram?: string;
 }>;
 /**
- * Network type for ERC-8004 operations (20 networks: 18 EVM + 2 Solana)
+ * Return the network name the facilitator actually accepts.
+ *
+ * `base-mainnet` reads like the canonical spelling and is not: the facilitator
+ * answers `400 {"error": "Invalid network: base-mainnet"}`. Every name is passed
+ * through here before it reaches a URL or a request body, so callers holding the
+ * old spelling keep working instead of being rejected at the edge.
+ */
+declare function wireNetwork(network: string): string;
+/**
+ * Network type for ERC-8004 operations (21 networks: 19 EVM + 2 Solana)
+ *
+ * These are the names the FACILITATOR accepts, verified against
+ * GET /feedback -> supportedNetworks. 'base-mainnet' is kept only as a
+ * deprecated alias: the facilitator rejects it outright (400 "Invalid network"),
+ * so anything passed through this module is normalised to 'base' before it
+ * reaches the wire. Use 'base'.
  */
-type Erc8004Network = 'ethereum' | 'base-mainnet' | 'polygon' | 'arbitrum' | 'optimism' | 'celo' | 'bsc' | 'monad' | 'avalanche' | 'skale-base' | 'ethereum-sepolia' | 'base-sepolia' | 'polygon-amoy' | 'arbitrum-sepolia' | 'optimism-sepolia' | 'celo-sepolia' | 'avalanche-fuji' | 'skale-base-sepolia' | 'solana' | 'solana-devnet';
+type Erc8004Network = 'ethereum' | 'base' | 'polygon' | 'arbitrum' | 'optimism' | 'celo' | 'bsc' | 'monad' | 'avalanche' | 'scroll' | 'skale-base' | 'base-mainnet' | 'ethereum-sepolia' | 'base-sepolia' | 'polygon-amoy' | 'arbitrum-sepolia' | 'optimism-sepolia' | 'celo-sepolia' | 'avalanche-fuji' | 'skale-base-sepolia' | 'solana' | 'solana-devnet';
 /**
  * Proof of payment returned when settling with ERC-8004 extension
  */
@@ -2496,4 +2528,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, 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 };
+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, wireNetwork };

package/dist/backend/index.js

@@ -1292,9 +1292,34 @@ var FacilitatorClient = class {
         );
       }
       return {
-        success: true,
+        // Read the facilitator's verdict instead of asserting one.
+        //
+        // This was the literal `true`, so a settle was reported successful
+        // whenever the HTTP call was — and "the request arrived" is not "the
+        // money moved". A payment that MINES AND THEN REVERTS is answered with
+        // 200 and `success: false` (x402-rs src/chain/evm.rs:1343, serialised
+        // through StatusCode::OK), which is precisely the case a caller most
+        // needs to hear about. Every consumer doing `result.success === true`
+        // was reading a constant, so a reverted payment was booked as settled
+        // and no reconciliation path could ever fire.
+        //
+        // Absent `success` is treated as NOT successful: a facilitator that
+        // does not say it worked has not said it worked.
+        success: result.success === true,
         transactionHash,
-        network: result.network
+        network: result.network,
+        // Why it failed, when it did. Without this the caller gets `success:
+        // false` and no way to tell a reverted transfer from a rejected
+        // authorization except by parsing prose.
+        errorReason: result.errorReason ?? result.error_reason,
+        // The settlement proof, when the facilitator attached one (it does for
+        // the ERC-8004 extension). Dropping it here made `verified: true`
+        // unreachable for DX402 anchoring through this client: `anchorEvidence`
+        // documents proofOfPayment as the only thing that gets there, the
+        // facilitator returns it, and this method threw it away — so a seller
+        // using the SDK end to end could only ever produce provisional anchors.
+        proofOfPayment: result.proofOfPayment ?? result.proof_of_payment,
+        payer: result.payer
       };
     } catch (error) {
       clearTimeout(timeoutId);
@@ -2459,53 +2484,76 @@ function escrowTimeRemaining(escrow) {
 var ERC8004_EXTENSION_ID = "8004-reputation";
 var MAINNET_IDENTITY = "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432";
 var MAINNET_REPUTATION = "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63";
+var MAINNET_VALIDATION = "0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58";
 var TESTNET_IDENTITY = "0x8004A818BFB912233c491871b3d84c89A494BD9e";
 var TESTNET_REPUTATION = "0x8004B663056A597Dffe9eCcC1965A193B7388713";
 var TESTNET_VALIDATION = "0x8004Cb1BF31DAf7788923b405b754f57acEB4272";
 var SOLANA_AGENT_REGISTRY = "8oo4dC4JvBLwy5tGgiH3WwK4B9PWxL9Z4XjA2jzkQMbQ";
 var SOLANA_ATOM_ENGINE = "AToMw53aiPQ8j7iHVb4fGt6nzUNxUhcPc3tbPBZuzVVb";
 var ERC8004_CONTRACTS = {
-  // Mainnets (10)
+  // Mainnets (11)
   ethereum: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
-  "base-mainnet": {
+  base: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   polygon: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   arbitrum: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   optimism: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   celo: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   bsc: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   monad: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
   avalanche: {
     identityRegistry: MAINNET_IDENTITY,
-    reputationRegistry: MAINNET_REPUTATION
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
   },
+  scroll: {
+    identityRegistry: MAINNET_IDENTITY,
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
+  },
+  // SKALE Base is the one mainnet without a validation registry (no code at
+  // the canonical address), so leaving it out is correct, not an omission.
   "skale-base": {
     identityRegistry: MAINNET_IDENTITY,
     reputationRegistry: MAINNET_REPUTATION
   },
+  // Deprecated alias for 'base' -- kept so existing lookups keep resolving.
+  "base-mainnet": {
+    identityRegistry: MAINNET_IDENTITY,
+    reputationRegistry: MAINNET_REPUTATION,
+    validationRegistry: MAINNET_VALIDATION
+  },
   // Testnets (8)
   "ethereum-sepolia": {
     identityRegistry: TESTNET_IDENTITY,
@@ -2557,6 +2605,9 @@ var ERC8004_CONTRACTS = {
     atomEngineProgram: SOLANA_ATOM_ENGINE
   }
 };
+function wireNetwork(network) {
+  return network === "base-mainnet" ? "base" : network;
+}
 var Erc8004LookupError = class extends Error {
   /** HTTP status returned by the facilitator */
   status;
@@ -2623,7 +2674,7 @@ var Erc8004Client = class {
    * @returns Agent identity information
    */
   async getIdentity(network, agentId) {
-    const url = `${this.baseUrl}/identity/${network}/${agentId}`;
+    const url = `${this.baseUrl}/identity/${wireNetwork(network)}/${agentId}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -2659,7 +2710,7 @@ var Erc8004Client = class {
    * ```
    */
   async getIdentityByOwner(network, address) {
-    const url = `${this.baseUrl}/identity/${network}/owner/${address}`;
+    const url = `${this.baseUrl}/identity/${wireNetwork(network)}/owner/${address}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -2729,7 +2780,7 @@ var Erc8004Client = class {
     if (options.tag2) params.set("tag2", options.tag2);
     if (options.includeFeedback) params.set("includeFeedback", "true");
     if (options.clientAddresses) params.set("clientAddresses", options.clientAddresses);
-    const url = `${this.baseUrl}/reputation/${network}/${agentId}${params.toString() ? `?${params}` : ""}`;
+    const url = `${this.baseUrl}/reputation/${wireNetwork(network)}/${agentId}${params.toString() ? `?${params}` : ""}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -2791,7 +2842,7 @@ var Erc8004Client = class {
           "Content-Type": "application/json",
           "Accept": "application/json"
         },
-        body: JSON.stringify(request),
+        body: JSON.stringify({ ...request, network: wireNetwork(request.network) }),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -2829,7 +2880,7 @@ var Erc8004Client = class {
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     const payload = {
       x402Version: 1,
-      network,
+      network: wireNetwork(network),
       agentId,
       feedbackIndex
     };
@@ -2940,7 +2991,7 @@ var Erc8004Client = class {
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     const payload = {
       x402Version: 1,
-      network,
+      network: wireNetwork(network),
       agentId,
       feedbackIndex,
       response
@@ -3029,7 +3080,7 @@ var Erc8004Client = class {
           "Content-Type": "application/json",
           "Accept": "application/json"
         },
-        body: JSON.stringify(request),
+        body: JSON.stringify({ ...request, network: wireNetwork(request.network) }),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -3088,7 +3139,7 @@ var Erc8004Client = class {
           "Accept": "application/json",
           "Prefer": "respond-async"
         },
-        body: JSON.stringify(request),
+        body: JSON.stringify({ ...request, network: wireNetwork(request.network) }),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -3196,7 +3247,7 @@ var Erc8004Client = class {
    * @returns Metadata value (hex-encoded and UTF-8 decoded if possible)
    */
   async getIdentityMetadata(network, agentId, key) {
-    const url = `${this.baseUrl}/identity/${network}/${agentId}/metadata/${encodeURIComponent(key)}`;
+    const url = `${this.baseUrl}/identity/${wireNetwork(network)}/${agentId}/metadata/${encodeURIComponent(key)}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -3223,7 +3274,7 @@ var Erc8004Client = class {
    * @returns Total supply count
    */
   async getIdentityTotalSupply(network) {
-    const url = `${this.baseUrl}/identity/${network}/total-supply`;
+    const url = `${this.baseUrl}/identity/${wireNetwork(network)}/total-supply`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -3861,7 +3912,10 @@ var AdvancedEscrowClient = class {
             transactionHash: result.transaction || result.transactionHash || result.transaction_hash
           };
         }
-        return { success: false, error: result.errorReason || result.error || "Release failed" };
+        return {
+          success: false,
+          error: result.errorReason || result.error || `Release refused with no reason (HTTP ${response.status}, body keys: ${Object.keys(result ?? {}).sort().join(", ") || "none"})`
+        };
       } catch (fetchErr) {
         clearTimeout(timeoutId);
         if (fetchErr.name === "AbortError") {
@@ -4225,5 +4279,6 @@ exports.isEscrowExpired = isEscrowExpired;
 exports.isEscrowSupportedOnChain = isEscrowSupportedOnChain;
 exports.isRegisterJobTerminal = isRegisterJobTerminal;
 exports.parsePaymentHeader = parsePaymentHeader;
+exports.wireNetwork = wireNetwork;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map