uvd-x402-sdk 2.87.0 → 2.89.0

package/dist/backend/index.mjs

@@ -3150,6 +3150,13 @@ var RELAYED_FEEDBACK_NETWORKS = [
 function supportsRelayedFeedback(network) {
   return RELAYED_FEEDBACK_NETWORKS.includes(wireNetwork(network));
 }
+var SOLANA_FEEDBACK_NETWORKS = [
+  "solana",
+  "solana-devnet"
+];
+function supportsSolanaFeedback(network) {
+  return SOLANA_FEEDBACK_NETWORKS.includes(wireNetwork(network));
+}
 var Erc8004LookupError = class extends Error {
   /** HTTP status returned by the facilitator */
   status;
@@ -3630,6 +3637,135 @@ var Erc8004Client = class {
       };
     }
   }
+  /**
+   * Ask the facilitator for the Solana transaction the rater must sign.
+   *
+   * Step 1 of the rater-authored rail on Solana. Writes nothing on-chain and
+   * costs nothing: it resolves the programs and the agent asset, reads the
+   * registry collection and a finalized blockhash, and hands back an UNSIGNED
+   * transaction whose `client` account is the rater.
+   *
+   * Why this exists, and why it is not the EVM rail: the program's
+   * `give_feedback` instruction declares account 0 as
+   * `[signer, writable] client (feedback author / fee payer)`, and plain
+   * `POST /feedback` puts the FACILITATOR's keypair there — so the chain
+   * records the facilitator as the author of the rating. Solana carries several
+   * signers per transaction natively, so the rater signs as `client` while the
+   * facilitator stays the fee payer. **No delegation and no program change**,
+   * which is why {@link SOLANA_FEEDBACK_NETWORKS} is its own list and `solana`
+   * must never appear in {@link RELAYED_FEEDBACK_NETWORKS} — that one routes to
+   * `/feedback/evm/*`, which answers 400 here.
+   *
+   * What to do with the answer:
+   * 1. Deserialise `transaction` — base64 of the bincode-serialised **legacy**
+   *    transaction, which is `@solana/web3.js`'s `Transaction.from()`, not
+   *    `VersionedTransaction` — and add the RATER's ed25519 signature. Sign the
+   *    message as it came: re-encoding it changes bytes the facilitator will
+   *    compare. The fee payer's slot stays empty; `submit` fills it.
+   * 2. Hand it back to {@link Erc8004Client.submitSolanaFeedback} with the SAME
+   *    feedback parameters, before `lastValidBlockHeight` passes.
+   *
+   * @param request - Network, rater pubkey and feedback parameters
+   * @returns The unsigned transaction, the fee payer and the blockhash window
+   *
+   * @example
+   * ```ts
+   * import { Transaction } from '@solana/web3.js';
+   *
+   * const prep = await erc8004.prepareSolanaFeedback({
+   *   x402Version: 1,
+   *   network: 'solana',
+   *   feedback: {
+   *     agentId: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgHkv',
+   *     rater: raterPubkey,   // base58: who the chain records as the author
+   *     value: 87,
+   *     score: 95,            // without it the rating counts for nothing
+   *     tag1: 'quality',
+   *   },
+   * });
+   *
+   * const tx = Transaction.from(Buffer.from(prep.transaction!, 'base64'));
+   * tx.partialSign(raterKeypair);
+   * ```
+   */
+  async prepareSolanaFeedback(request) {
+    const url = `${this.baseUrl}/feedback/solana/prepare`;
+    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, network: wireNetwork(request.network) }),
+        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
+      };
+    }
+  }
+  /**
+   * Co-sign and send a rater-signed Solana feedback transaction.
+   *
+   * Step 2 of the rater-authored rail on Solana. What lands on-chain has the
+   * RATER as `client`, so the agent's feedback lists the rater rather than the
+   * facilitator — and only the rater can revoke it.
+   *
+   * Pass back the same feedback parameters {@link Erc8004Client.prepareSolanaFeedback}
+   * was given. They are not redundant: the facilitator re-derives the message
+   * from them plus the blockhash inside the submitted transaction, and refuses
+   * to co-sign anything that is not byte-for-byte what it built
+   * (`400 "submitted transaction does not match the one this facilitator built"`).
+   * The rater's signature is verified BEFORE the facilitator adds its own, so a
+   * transaction the network would reject never costs a fee.
+   *
+   * @param request - Feedback parameters plus the rater-signed transaction
+   * @returns Feedback response with the transaction signature
+   */
+  async submitSolanaFeedback(request) {
+    const url = `${this.baseUrl}/feedback/solana/submit`;
+    try {
+      const { response, error } = await this.writeJson(url, {
+        ...request,
+        network: wireNetwork(request.network)
+      });
+      if (error) {
+        return {
+          success: false,
+          error: error.error,
+          network: request.network,
+          ...failureFields(error)
+        };
+      }
+      return await response.json();
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        network: request.network,
+        retryable: true,
+        safeToReplay: false,
+        retryAfterSeconds: DEFAULT_RETRY_AFTER_SECONDS
+      };
+    }
+  }
   /**
    * Revoke previously submitted feedback
    *
@@ -5128,6 +5264,6 @@ var AdvancedEscrowClient = class {
   }
 };
 
-export { AMBIGUOUS_LEASE_REASONS, AdvancedEscrowClient, BASE_MAINNET_CONTRACTS, BazaarClient, DEFAULT_FACILITATOR_RETRIES, DEFAULT_RETRY_AFTER_SECONDS, DEPOSIT_LIMIT_USDC, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, Erc8004LookupError, EscrowClient, FacilitatorClient, HEALTH_FILTERS, MAX_RETRY_AFTER_SECONDS, MAX_SEARCH_LEN, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, RELAYED_FEEDBACK_NETWORKS, REPLAYABLE_LEASE_REASONS, RegistrationPendingError, SETTLEMENT_UNCONFIRMED, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, WRITER_LEASE_REASONS, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestForVersion, buildSettleRequestV2, buildUnavailableResponse, buildVerifyRequest, buildVerifyRequestForVersion, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, carryFailureFields, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, facilitatorFetch, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isAmbiguousLeaseReason, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, isReplayableLeaseReason, isSettlementUnconfirmed, parseFacilitatorErrorBody, parsePaymentHeader, parseRetryAfterSeconds, readFacilitatorError, resolveEnvelopeVersion, supportsRelayedFeedback, toPaymentRequirementsV2, toResourceInfoV2, wireNetwork };
+export { AMBIGUOUS_LEASE_REASONS, AdvancedEscrowClient, BASE_MAINNET_CONTRACTS, BazaarClient, DEFAULT_FACILITATOR_RETRIES, DEFAULT_RETRY_AFTER_SECONDS, DEPOSIT_LIMIT_USDC, ERC8004_CONTRACTS, ERC8004_EXTENSION_ID, ESCROW_CONTRACTS, ESCROW_TIMEOUT_MS, Erc8004Client, Erc8004LookupError, EscrowClient, FacilitatorClient, HEALTH_FILTERS, MAX_RETRY_AFTER_SECONDS, MAX_SEARCH_LEN, OPERATOR_ABI, OPERATOR_ABI_CREATE3, PAYMENT_INFO_TYPEHASH, RELAYED_FEEDBACK_NETWORKS, REPLAYABLE_LEASE_REASONS, RegistrationPendingError, SETTLEMENT_UNCONFIRMED, SOLANA_FEEDBACK_NETWORKS, TIER_FILTERS, TIER_TIMINGS, USDC_DOMAIN_NAME, WRITER_LEASE_REASONS, X402_CORS_HEADERS, X402_HEADER_NAMES, ZERO_ADDRESS, buildErc8004PaymentRequirements, buildPaymentRequirements, buildSettleRequest, buildSettleRequestForVersion, buildSettleRequestV2, buildUnavailableResponse, buildVerifyRequest, buildVerifyRequestForVersion, buildVerifyRequestV2, canRefundEscrow, canReleaseEscrow, carryFailureFields, create402Response, createHonoMiddleware, createPaymentMiddleware, epochToDate, escrowTimeRemaining, extractPaymentFromHeaders, facilitatorFetch, getCorsHeaders, getEscrowContractsByChainId, getEscrowSupportedChainIds, isAlive, isAmbiguousLeaseReason, isEscrowExpired, isEscrowSupportedOnChain, isRegisterJobTerminal, isReplayableLeaseReason, isSettlementUnconfirmed, parseFacilitatorErrorBody, parsePaymentHeader, parseRetryAfterSeconds, readFacilitatorError, resolveEnvelopeVersion, supportsRelayedFeedback, supportsSolanaFeedback, toPaymentRequirementsV2, toResourceInfoV2, wireNetwork };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map