uvd-x402-sdk 2.86.0 → 2.88.0

package/README.md

@@ -1142,6 +1142,69 @@ chain that supports EIP-7702 -- the payment stays where it was made.
 
 Requires facilitator v1.93.0+ for the mainnets; base-sepolia since v1.74.0.
 
+### The same thing on Solana, without a delegate
+
+Solana reaches the same place by a shorter road, so it is a **different pair of
+calls and a different network list**. The program's `give_feedback` instruction
+already declares account 0 as `[signer, writable] client (feedback author)`, and
+a Solana transaction carries several signatures natively: the rater signs as
+`client`, the facilitator co-signs as fee payer. Nothing is delegated because
+nothing has to be.
+
+**`solana` never goes in `RELAYED_FEEDBACK_NETWORKS`.** That list drives
+`/feedback/evm/*` and names chains with a deployed `FeedbackDelegate`; a Solana
+rating sent there is a 400, and the entry would assert a delegate that was never
+deployed and is not missing. Use `SOLANA_FEEDBACK_NETWORKS` /
+`supportsSolanaFeedback()`.
+
+```typescript
+import { Erc8004Client, supportsSolanaFeedback } from 'uvd-x402-sdk/backend';
+import { Transaction } from '@solana/web3.js';
+
+const erc8004 = new Erc8004Client();
+
+if (!supportsSolanaFeedback('solana')) {
+  // fall back to submitFeedback(); the facilitator is the author there
+}
+
+const prep = await erc8004.prepareSolanaFeedback({
+  x402Version: 1,
+  network: 'solana',
+  feedback: {
+    agentId: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgHkv', // the agent asset
+    rater: raterPubkey,   // base58: who the chain will record as the author
+    value: 87,
+    valueDecimals: 0,
+    score: 95,            // WITHOUT THIS the rating counts for nothing
+    tag1: 'quality',
+  },
+});
+
+// Sign the message as it came. Re-encoding it changes bytes the facilitator
+// will compare, and it refuses to co-sign anything it did not build. It is a
+// LEGACY transaction: `Transaction.from()`, not `VersionedTransaction`.
+const tx = Transaction.from(Buffer.from(prep.transaction!, 'base64'));
+tx.partialSign(raterKeypair);   // ...or a wallet: await wallet.signTransaction(tx)
+
+const result = await erc8004.submitSolanaFeedback({
+  x402Version: 1,
+  network: 'solana',
+  feedback: { /* exactly what went to prepare, rater included */ },
+  transaction: tx.serialize({ requireAllSignatures: false }).toString('base64'),
+});
+```
+
+`prep.feePayer` is the facilitator and `prep.rater` is the rater — that split is
+the whole point. Submit before `prep.lastValidBlockHeight`: past it the network
+drops the transaction, nothing is written and nothing is charged, and a resend
+needs a fresh `prepare()` because the blockhash the rater signed over is gone.
+
+**Set `score`.** It is optional on the wire and the ATOM Engine ignores an
+unscored feedback: the transaction succeeds, the record lands on the agent, and
+reputation stays at zero (`had_impact=false`) — and it is not retroactive.
+
+Available on `solana` and `solana-devnet`. Requires facilitator v2.16.0+.
+
 ## `/accepts` Negotiation
 
 Discover what the facilitator can settle before constructing payment authorizations. Used by Faremeter middleware and clients.

package/dist/backend/index.d.mts

@@ -1,3 +1,3 @@
 import '../wallet-w7BnImDG.mjs';
 import '../index-DOBhTF-j.mjs';
-export { A as AMBIGUOUS_LEASE_REASONS, a9 as AdvancedAuthorizationResult, aa as AdvancedEscrowClient, ab as AdvancedEscrowClientOptions, ac as AdvancedEscrowContracts, ad as AdvancedEscrowTaskTier, ae as AdvancedPaymentInfo, af as AdvancedTransactionResult, ag as AgentId, ah as AgentIdentity, ai as AgentRegistration, aj as AgentRegistrationFile, ak as AgentService, al as AtomStats, am as BASE_MAINNET_CONTRACTS, an as BazaarClient, ao as BazaarClientOptions, ap as BazaarDiscoverOptions, aq as BazaarDiscoverResponse, ar as BazaarRegisterOptions, as as BazaarResource, at as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, a as DEFAULT_RETRY_AFTER_SECONDS, au as DEPOSIT_LIMIT_USDC, av as DiscoveryAccepts, aw as DiscoveryCuration, ax as DiscoveryHealth, ay as DiscoveryHealthStatus, az as DiscoveryListOptions, aA as DiscoveryPagination, aB as DiscoveryRegisterOptions, aC as DiscoveryResource, aD as DiscoveryResponse, aE as DiscoverySource, aF as DiscoveryStats, aG as DiscoveryTier, aH as Dispute, aI as DisputeOutcome, aJ as ERC8004_CONTRACTS, aK as ERC8004_EXTENSION_ID, aL as ESCROW_CONTRACTS, aM as ESCROW_TIMEOUT_MS, aN as Erc8004Client, aO as Erc8004ClientOptions, aP as Erc8004LookupError, aQ as Erc8004Network, aR as EscrowClient, aS as EscrowClientOptions, aT as EscrowPayment, aU as EscrowStateResponse, aV as EscrowStatus, F as FacilitatorClient, b as FacilitatorClientOptions, c as FacilitatorErrorInfo, d as FacilitatorFailureFields, e as FacilitatorFetchOptions, aW as FeedbackEntry, aX as FeedbackParams, aY as FeedbackRequest, aZ as FeedbackResponse, a_ as HEALTH_FILTERS, H as HonoMiddlewareOptions, a$ as IdentityByOwnerResponse, b0 as IdentityMetadataResponse, b1 as IdentityTotalSupplyResponse, b2 as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, b3 as MAX_SEARCH_LEN, b4 as MetadataEntryParam, b5 as OPERATOR_ABI, b6 as OPERATOR_ABI_CREATE3, b7 as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, p as PaymentAcceptance, q as PaymentMiddlewareOptions, r as PaymentPayloadV2, b8 as PaymentRequirementResolver, b9 as PaymentRequirements, ba as PaymentRequirementsOptions, s as PaymentRequirementsV2, bb as PrepareRelayFeedbackRequest, bc as PrepareRelayFeedbackResponse, bd as PrepareRelayResponseRequest, be as ProofOfPayment, bf as RELAYED_FEEDBACK_NETWORKS, R as REPLAYABLE_LEASE_REASONS, bg as RefundRequest, bh as RefundStatus, bi as RegisterAgentRequest, bj as RegisterAgentResponse, bk as RegisterJobResponse, bl as RegisterJobStatus, bm as RegistrationPendingError, bn as RelayAuthorizationParams, bo as ReputationResponse, bp as ReputationSummary, bq as RequestRefundOptions, t as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, br as SettleRequest, u as SettleRequestV2, bs as SettleResponse, bt as SettleResponseWithProof, bu as SubmitRelayFeedbackRequest, bv as SubmitRelayResponseRequest, bw as TIER_FILTERS, bx as TIER_TIMINGS, by as USDC_DOMAIN_NAME, bz as UnavailableBody, bA as UnavailableResponse, V as VerifiedPaymentState, bB as VerifyRequest, v as VerifyRequestV2, bC as VerifyResponse, W as WRITER_LEASE_REASONS, x as WriterLeaseReason, X as X402_CORS_HEADERS, y as X402_HEADER_NAMES, bD as ZERO_ADDRESS, bE as buildErc8004PaymentRequirements, E as buildPaymentRequirements, G as buildSettleRequest, I as buildSettleRequestForVersion, J as buildSettleRequestV2, bF as buildUnavailableResponse, K as buildVerifyRequest, N as buildVerifyRequestForVersion, O as buildVerifyRequestV2, bG as canRefundEscrow, bH as canReleaseEscrow, bI as carryFailureFields, Q as create402Response, T as createHonoMiddleware, U as createPaymentMiddleware, bJ as epochToDate, bK as escrowTimeRemaining, Y as extractPaymentFromHeaders, Z as facilitatorFetch, _ as getCorsHeaders, bL as getEscrowContractsByChainId, bM as getEscrowSupportedChainIds, bN as isAlive, $ as isAmbiguousLeaseReason, bO as isEscrowExpired, bP as isEscrowSupportedOnChain, bQ as isRegisterJobTerminal, a0 as isReplayableLeaseReason, a1 as isSettlementUnconfirmed, a2 as parseFacilitatorErrorBody, bR as parsePaymentHeader, a3 as parseRetryAfterSeconds, a4 as readFacilitatorError, a5 as resolveEnvelopeVersion, bS as supportsRelayedFeedback, a6 as toPaymentRequirementsV2, a7 as toResourceInfoV2, bT as wireNetwork } from '../index-De03nksW.mjs';
+export { A as AMBIGUOUS_LEASE_REASONS, ab as AdvancedAuthorizationResult, ac as AdvancedEscrowClient, ad as AdvancedEscrowClientOptions, ae as AdvancedEscrowContracts, af as AdvancedEscrowTaskTier, ag as AdvancedPaymentInfo, ah as AdvancedTransactionResult, ai as AgentId, aj as AgentIdentity, ak as AgentRegistration, al as AgentRegistrationFile, am as AgentService, an as AtomStats, ao as BASE_MAINNET_CONTRACTS, ap as BazaarClient, aq as BazaarClientOptions, ar as BazaarDiscoverOptions, as as BazaarDiscoverResponse, at as BazaarRegisterOptions, au as BazaarResource, av as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, a as DEFAULT_RETRY_AFTER_SECONDS, aw as DEPOSIT_LIMIT_USDC, ax as DiscoveryAccepts, ay as DiscoveryCuration, az as DiscoveryHealth, aA as DiscoveryHealthStatus, aB as DiscoveryListOptions, aC as DiscoveryPagination, aD as DiscoveryRegisterOptions, aE as DiscoveryResource, aF as DiscoveryResponse, aG as DiscoverySource, aH as DiscoveryStats, aI as DiscoveryTier, aJ as Dispute, aK as DisputeOutcome, aL as ERC8004_CONTRACTS, aM as ERC8004_EXTENSION_ID, aN as ESCROW_CONTRACTS, aO as ESCROW_TIMEOUT_MS, aP as Erc8004Client, aQ as Erc8004ClientOptions, aR as Erc8004LookupError, aS as Erc8004Network, aT as EscrowClient, aU as EscrowClientOptions, aV as EscrowPayment, aW as EscrowStateResponse, aX as EscrowStatus, F as FacilitatorClient, b as FacilitatorClientOptions, c as FacilitatorErrorInfo, d as FacilitatorFailureFields, e as FacilitatorFetchOptions, aY as FeedbackEntry, aZ as FeedbackParams, a_ as FeedbackRequest, a$ as FeedbackResponse, b0 as HEALTH_FILTERS, H as HonoMiddlewareOptions, b1 as IdentityByOwnerResponse, b2 as IdentityMetadataResponse, b3 as IdentityTotalSupplyResponse, b4 as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, b5 as MAX_SEARCH_LEN, b6 as MetadataEntryParam, b7 as OPERATOR_ABI, b8 as OPERATOR_ABI_CREATE3, b9 as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, q as PaymentAcceptance, r as PaymentMiddlewareOptions, s as PaymentPayloadV2, ba as PaymentRequirementResolver, bb as PaymentRequirements, bc as PaymentRequirementsOptions, t as PaymentRequirementsV2, bd as PrepareRelayFeedbackRequest, be as PrepareRelayFeedbackResponse, bf as PrepareRelayResponseRequest, bg as PrepareSolanaFeedbackRequest, bh as PrepareSolanaFeedbackResponse, bi as ProofOfPayment, bj as RELAYED_FEEDBACK_NETWORKS, R as REPLAYABLE_LEASE_REASONS, bk as RefundRequest, bl as RefundStatus, bm as RegisterAgentRequest, bn as RegisterAgentResponse, bo as RegisterJobResponse, bp as RegisterJobStatus, bq as RegistrationPendingError, br as RelayAuthorizationParams, bs as ReputationResponse, bt as ReputationSummary, bu as RequestRefundOptions, u as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bv as SOLANA_FEEDBACK_NETWORKS, bw as SettleRequest, v as SettleRequestV2, bx as SettleResponse, by as SettleResponseWithProof, bz as SubmitRelayFeedbackRequest, bA as SubmitRelayResponseRequest, bB as SubmitSolanaFeedbackRequest, bC as TIER_FILTERS, bD as TIER_TIMINGS, bE as USDC_DOMAIN_NAME, bF as UnavailableBody, bG as UnavailableResponse, V as VerifiedPaymentState, bH as VerifyRequest, w as VerifyRequestV2, bI as VerifyResponse, W as WRITER_LEASE_REASONS, y as WriterLeaseReason, X as X402_CORS_HEADERS, z as X402_HEADER_NAMES, bJ as ZERO_ADDRESS, bK as buildErc8004PaymentRequirements, G as buildPaymentRequirements, I as buildSettleRequest, J as buildSettleRequestForVersion, K as buildSettleRequestV2, bL as buildUnavailableResponse, N as buildVerifyRequest, O as buildVerifyRequestForVersion, Q as buildVerifyRequestV2, bM as canRefundEscrow, bN as canReleaseEscrow, bO as carryFailureFields, T as create402Response, U as createHonoMiddleware, Y as createPaymentMiddleware, bP as epochToDate, bQ as escrowTimeRemaining, Z as extractPaymentFromHeaders, _ as facilitatorFetch, $ as getCorsHeaders, bR as getEscrowContractsByChainId, bS as getEscrowSupportedChainIds, bT as isAlive, a0 as isAmbiguousLeaseReason, bU as isEscrowExpired, bV as isEscrowSupportedOnChain, bW as isRegisterJobTerminal, a1 as isReplayableLeaseReason, a2 as isSettlementUnconfirmed, a4 as parseFacilitatorErrorBody, bX as parsePaymentHeader, a5 as parseRetryAfterSeconds, a6 as readFacilitatorError, a7 as resolveEnvelopeVersion, bY as supportsRelayedFeedback, bZ as supportsSolanaFeedback, a8 as toPaymentRequirementsV2, a9 as toResourceInfoV2, b_ as wireNetwork } from '../index-BMp3kzLX.mjs';

package/dist/backend/index.d.ts

@@ -1,3 +1,3 @@
 import '../wallet-w7BnImDG.js';
 import '../index-DOBhTF-j.js';
-export { A as AMBIGUOUS_LEASE_REASONS, a9 as AdvancedAuthorizationResult, aa as AdvancedEscrowClient, ab as AdvancedEscrowClientOptions, ac as AdvancedEscrowContracts, ad as AdvancedEscrowTaskTier, ae as AdvancedPaymentInfo, af as AdvancedTransactionResult, ag as AgentId, ah as AgentIdentity, ai as AgentRegistration, aj as AgentRegistrationFile, ak as AgentService, al as AtomStats, am as BASE_MAINNET_CONTRACTS, an as BazaarClient, ao as BazaarClientOptions, ap as BazaarDiscoverOptions, aq as BazaarDiscoverResponse, ar as BazaarRegisterOptions, as as BazaarResource, at as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, a as DEFAULT_RETRY_AFTER_SECONDS, au as DEPOSIT_LIMIT_USDC, av as DiscoveryAccepts, aw as DiscoveryCuration, ax as DiscoveryHealth, ay as DiscoveryHealthStatus, az as DiscoveryListOptions, aA as DiscoveryPagination, aB as DiscoveryRegisterOptions, aC as DiscoveryResource, aD as DiscoveryResponse, aE as DiscoverySource, aF as DiscoveryStats, aG as DiscoveryTier, aH as Dispute, aI as DisputeOutcome, aJ as ERC8004_CONTRACTS, aK as ERC8004_EXTENSION_ID, aL as ESCROW_CONTRACTS, aM as ESCROW_TIMEOUT_MS, aN as Erc8004Client, aO as Erc8004ClientOptions, aP as Erc8004LookupError, aQ as Erc8004Network, aR as EscrowClient, aS as EscrowClientOptions, aT as EscrowPayment, aU as EscrowStateResponse, aV as EscrowStatus, F as FacilitatorClient, b as FacilitatorClientOptions, c as FacilitatorErrorInfo, d as FacilitatorFailureFields, e as FacilitatorFetchOptions, aW as FeedbackEntry, aX as FeedbackParams, aY as FeedbackRequest, aZ as FeedbackResponse, a_ as HEALTH_FILTERS, H as HonoMiddlewareOptions, a$ as IdentityByOwnerResponse, b0 as IdentityMetadataResponse, b1 as IdentityTotalSupplyResponse, b2 as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, b3 as MAX_SEARCH_LEN, b4 as MetadataEntryParam, b5 as OPERATOR_ABI, b6 as OPERATOR_ABI_CREATE3, b7 as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, p as PaymentAcceptance, q as PaymentMiddlewareOptions, r as PaymentPayloadV2, b8 as PaymentRequirementResolver, b9 as PaymentRequirements, ba as PaymentRequirementsOptions, s as PaymentRequirementsV2, bb as PrepareRelayFeedbackRequest, bc as PrepareRelayFeedbackResponse, bd as PrepareRelayResponseRequest, be as ProofOfPayment, bf as RELAYED_FEEDBACK_NETWORKS, R as REPLAYABLE_LEASE_REASONS, bg as RefundRequest, bh as RefundStatus, bi as RegisterAgentRequest, bj as RegisterAgentResponse, bk as RegisterJobResponse, bl as RegisterJobStatus, bm as RegistrationPendingError, bn as RelayAuthorizationParams, bo as ReputationResponse, bp as ReputationSummary, bq as RequestRefundOptions, t as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, br as SettleRequest, u as SettleRequestV2, bs as SettleResponse, bt as SettleResponseWithProof, bu as SubmitRelayFeedbackRequest, bv as SubmitRelayResponseRequest, bw as TIER_FILTERS, bx as TIER_TIMINGS, by as USDC_DOMAIN_NAME, bz as UnavailableBody, bA as UnavailableResponse, V as VerifiedPaymentState, bB as VerifyRequest, v as VerifyRequestV2, bC as VerifyResponse, W as WRITER_LEASE_REASONS, x as WriterLeaseReason, X as X402_CORS_HEADERS, y as X402_HEADER_NAMES, bD as ZERO_ADDRESS, bE as buildErc8004PaymentRequirements, E as buildPaymentRequirements, G as buildSettleRequest, I as buildSettleRequestForVersion, J as buildSettleRequestV2, bF as buildUnavailableResponse, K as buildVerifyRequest, N as buildVerifyRequestForVersion, O as buildVerifyRequestV2, bG as canRefundEscrow, bH as canReleaseEscrow, bI as carryFailureFields, Q as create402Response, T as createHonoMiddleware, U as createPaymentMiddleware, bJ as epochToDate, bK as escrowTimeRemaining, Y as extractPaymentFromHeaders, Z as facilitatorFetch, _ as getCorsHeaders, bL as getEscrowContractsByChainId, bM as getEscrowSupportedChainIds, bN as isAlive, $ as isAmbiguousLeaseReason, bO as isEscrowExpired, bP as isEscrowSupportedOnChain, bQ as isRegisterJobTerminal, a0 as isReplayableLeaseReason, a1 as isSettlementUnconfirmed, a2 as parseFacilitatorErrorBody, bR as parsePaymentHeader, a3 as parseRetryAfterSeconds, a4 as readFacilitatorError, a5 as resolveEnvelopeVersion, bS as supportsRelayedFeedback, a6 as toPaymentRequirementsV2, a7 as toResourceInfoV2, bT as wireNetwork } from '../index-4_LWWlyF.js';
+export { A as AMBIGUOUS_LEASE_REASONS, ab as AdvancedAuthorizationResult, ac as AdvancedEscrowClient, ad as AdvancedEscrowClientOptions, ae as AdvancedEscrowContracts, af as AdvancedEscrowTaskTier, ag as AdvancedPaymentInfo, ah as AdvancedTransactionResult, ai as AgentId, aj as AgentIdentity, ak as AgentRegistration, al as AgentRegistrationFile, am as AgentService, an as AtomStats, ao as BASE_MAINNET_CONTRACTS, ap as BazaarClient, aq as BazaarClientOptions, ar as BazaarDiscoverOptions, as as BazaarDiscoverResponse, at as BazaarRegisterOptions, au as BazaarResource, av as CreateEscrowOptions, D as DEFAULT_FACILITATOR_RETRIES, a as DEFAULT_RETRY_AFTER_SECONDS, aw as DEPOSIT_LIMIT_USDC, ax as DiscoveryAccepts, ay as DiscoveryCuration, az as DiscoveryHealth, aA as DiscoveryHealthStatus, aB as DiscoveryListOptions, aC as DiscoveryPagination, aD as DiscoveryRegisterOptions, aE as DiscoveryResource, aF as DiscoveryResponse, aG as DiscoverySource, aH as DiscoveryStats, aI as DiscoveryTier, aJ as Dispute, aK as DisputeOutcome, aL as ERC8004_CONTRACTS, aM as ERC8004_EXTENSION_ID, aN as ESCROW_CONTRACTS, aO as ESCROW_TIMEOUT_MS, aP as Erc8004Client, aQ as Erc8004ClientOptions, aR as Erc8004LookupError, aS as Erc8004Network, aT as EscrowClient, aU as EscrowClientOptions, aV as EscrowPayment, aW as EscrowStateResponse, aX as EscrowStatus, F as FacilitatorClient, b as FacilitatorClientOptions, c as FacilitatorErrorInfo, d as FacilitatorFailureFields, e as FacilitatorFetchOptions, aY as FeedbackEntry, aZ as FeedbackParams, a_ as FeedbackRequest, a$ as FeedbackResponse, b0 as HEALTH_FILTERS, H as HonoMiddlewareOptions, b1 as IdentityByOwnerResponse, b2 as IdentityMetadataResponse, b3 as IdentityTotalSupplyResponse, b4 as LifecycleAuthOptions, M as MAX_RETRY_AFTER_SECONDS, b5 as MAX_SEARCH_LEN, b6 as MetadataEntryParam, b7 as OPERATOR_ABI, b8 as OPERATOR_ABI_CREATE3, b9 as PAYMENT_INFO_TYPEHASH, P as ParsedFacilitatorErrorBody, q as PaymentAcceptance, r as PaymentMiddlewareOptions, s as PaymentPayloadV2, ba as PaymentRequirementResolver, bb as PaymentRequirements, bc as PaymentRequirementsOptions, t as PaymentRequirementsV2, bd as PrepareRelayFeedbackRequest, be as PrepareRelayFeedbackResponse, bf as PrepareRelayResponseRequest, bg as PrepareSolanaFeedbackRequest, bh as PrepareSolanaFeedbackResponse, bi as ProofOfPayment, bj as RELAYED_FEEDBACK_NETWORKS, R as REPLAYABLE_LEASE_REASONS, bk as RefundRequest, bl as RefundStatus, bm as RegisterAgentRequest, bn as RegisterAgentResponse, bo as RegisterJobResponse, bp as RegisterJobStatus, bq as RegistrationPendingError, br as RelayAuthorizationParams, bs as ReputationResponse, bt as ReputationSummary, bu as RequestRefundOptions, u as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bv as SOLANA_FEEDBACK_NETWORKS, bw as SettleRequest, v as SettleRequestV2, bx as SettleResponse, by as SettleResponseWithProof, bz as SubmitRelayFeedbackRequest, bA as SubmitRelayResponseRequest, bB as SubmitSolanaFeedbackRequest, bC as TIER_FILTERS, bD as TIER_TIMINGS, bE as USDC_DOMAIN_NAME, bF as UnavailableBody, bG as UnavailableResponse, V as VerifiedPaymentState, bH as VerifyRequest, w as VerifyRequestV2, bI as VerifyResponse, W as WRITER_LEASE_REASONS, y as WriterLeaseReason, X as X402_CORS_HEADERS, z as X402_HEADER_NAMES, bJ as ZERO_ADDRESS, bK as buildErc8004PaymentRequirements, G as buildPaymentRequirements, I as buildSettleRequest, J as buildSettleRequestForVersion, K as buildSettleRequestV2, bL as buildUnavailableResponse, N as buildVerifyRequest, O as buildVerifyRequestForVersion, Q as buildVerifyRequestV2, bM as canRefundEscrow, bN as canReleaseEscrow, bO as carryFailureFields, T as create402Response, U as createHonoMiddleware, Y as createPaymentMiddleware, bP as epochToDate, bQ as escrowTimeRemaining, Z as extractPaymentFromHeaders, _ as facilitatorFetch, $ as getCorsHeaders, bR as getEscrowContractsByChainId, bS as getEscrowSupportedChainIds, bT as isAlive, a0 as isAmbiguousLeaseReason, bU as isEscrowExpired, bV as isEscrowSupportedOnChain, bW as isRegisterJobTerminal, a1 as isReplayableLeaseReason, a2 as isSettlementUnconfirmed, a4 as parseFacilitatorErrorBody, bX as parsePaymentHeader, a5 as parseRetryAfterSeconds, a6 as readFacilitatorError, a7 as resolveEnvelopeVersion, bY as supportsRelayedFeedback, bZ as supportsSolanaFeedback, a8 as toPaymentRequirementsV2, a9 as toResourceInfoV2, b_ as wireNetwork } from '../index-Cc5JUhLY.js';

package/dist/backend/index.js

@@ -1213,6 +1213,14 @@ function randomNonce() {
   }
   return ethers.ethers.hexlify(ethers.ethers.randomBytes(32));
 }
+function resolveOrderTiming(params) {
+  const nowSec = params.now === void 0 ? Math.floor(Date.now() / 1e3) : Math.floor(params.now);
+  return {
+    nowSec,
+    deadline: params.deadline === void 0 ? nowSec + LIFECYCLE_DEFAULT_DEADLINE_SECS : Math.floor(params.deadline),
+    nonce: params.nonce === void 0 ? randomNonce() : params.nonce
+  };
+}
 function toUintString(value, field) {
   let n;
   try {
@@ -1226,7 +1234,8 @@ function toUintString(value, field) {
   return n.toString();
 }
 function buildLifecycleTypedData(params) {
-  const { action, paymentInfo, payer, amount, chainId, deadline, nonce } = params;
+  const { action, paymentInfo, payer, amount, chainId } = params;
+  const { deadline, nonce } = resolveOrderTiming(params);
   if (!LIFECYCLE_ACTIONS.includes(action)) {
     throw new X402Error(
       `unknown lifecycle action ${String(action)}; the facilitator only signs ${LIFECYCLE_ACTIONS.join(", ")}`,
@@ -1285,10 +1294,8 @@ function buildLifecycleTypedData(params) {
   };
 }
 async function buildLifecycleAuth(params) {
-  const { wallet, deadline, nonce, now, ...rest } = params;
-  const nowSec = now === void 0 ? Math.floor(Date.now() / 1e3) : Math.floor(now);
-  const dl = deadline === void 0 ? nowSec + LIFECYCLE_DEFAULT_DEADLINE_SECS : Math.floor(deadline);
-  const nonceHex = nonce === void 0 ? randomNonce() : nonce;
+  const { wallet, ...rest } = params;
+  const { nowSec, deadline: dl, nonce: nonceHex } = resolveOrderTiming(params);
   if (dl < nowSec) {
     throw new X402Error(
       `deadline ${dl} is in the past (now ${nowSec}): the facilitator discards it as \`expired\``,
@@ -3145,6 +3152,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;
@@ -3625,6 +3639,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
    *
@@ -4259,6 +4402,25 @@ var TIER_TIMINGS = {
   premium: { pre: 14400, auth: 172800, refund: 1209600 },
   enterprise: { pre: 86400, auth: 604800, refund: 2592e3 }
 };
+async function resolveLifecycleAuth(action, options, order) {
+  if (options?.lifecycleSigner && options?.lifecycleAuth) {
+    throw new X402Error(
+      "lifecycleSigner and lifecycleAuth are mutually exclusive: the first signs an order here, the second was already signed elsewhere. Passing both means two different orders exist and only one can travel.",
+      "INVALID_CONFIG"
+    );
+  }
+  if (options?.lifecycleAuth) return options.lifecycleAuth;
+  if (!options?.lifecycleSigner) return void 0;
+  return buildLifecycleAuth({
+    action,
+    paymentInfo: order.paymentInfo,
+    payer: order.payer,
+    amount: order.amount,
+    chainId: order.chainId,
+    wallet: options.lifecycleSigner,
+    deadline: options.lifecycleDeadline
+  });
+}
 var OPERATOR_ABI = [
   "function release(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, uint256 amount)",
   "function refundInEscrow(tuple(address operator, address payer, address receiver, address token, uint120 maxAmount, uint48 preApprovalExpiry, uint48 authorizationExpiry, uint48 refundExpiry, uint16 minFeeBps, uint16 maxFeeBps, address feeReceiver, uint256 salt) paymentInfo, uint120 amount)",
@@ -4669,6 +4831,13 @@ var AdvancedEscrowClient = class {
    *   lifecycleSigner: payerWallet,   // EnvKeyAdapter, OWS, wagmiLifecycleSigner(...)
    * });
    * ```
+   *
+   * @example Transporting an order the publisher signed in their browser
+   * ```typescript
+   * // The browser sent back a signature over a document THIS backend built.
+   * const lifecycleAuth = lifecycleAuthFromSignature(typedData, signature, payer);
+   * await client.releaseViaFacilitator(pi, amount, { lifecycleAuth });
+   * ```
    */
   async releaseViaFacilitator(paymentInfo, amount, options) {
     if (!this.payerAddress) await this.init();
@@ -4687,15 +4856,12 @@ var AdvancedEscrowClient = class {
         salt: paymentInfo.salt
       };
       const releaseAmount = amount || paymentInfo.maxAmount;
-      const lifecycleAuth = options?.lifecycleSigner ? await buildLifecycleAuth({
-        action: "release",
+      const lifecycleAuth = await resolveLifecycleAuth("release", options, {
         paymentInfo: wirePaymentInfo,
         payer: this.payerAddress,
         amount: releaseAmount,
-        chainId: this.chainId,
-        wallet: options.lifecycleSigner,
-        deadline: options.lifecycleDeadline
-      }) : void 0;
+        chainId: this.chainId
+      });
       const payload = {
         x402Version: 2,
         scheme: "escrow",
@@ -4824,15 +4990,12 @@ var AdvancedEscrowClient = class {
         salt: paymentInfo.salt
       };
       const refundAmount = amount || paymentInfo.maxAmount;
-      const lifecycleAuth = options?.lifecycleSigner ? await buildLifecycleAuth({
-        action: "refundInEscrow",
+      const lifecycleAuth = await resolveLifecycleAuth("refundInEscrow", options, {
         paymentInfo: wirePaymentInfo,
         payer: this.payerAddress,
         amount: refundAmount,
-        chainId: this.chainId,
-        wallet: options.lifecycleSigner,
-        deadline: options.lifecycleDeadline
-      }) : void 0;
+        chainId: this.chainId
+      });
       const payload = {
         x402Version: 2,
         scheme: "escrow",
@@ -5128,6 +5291,7 @@ exports.RELAYED_FEEDBACK_NETWORKS = RELAYED_FEEDBACK_NETWORKS;
 exports.REPLAYABLE_LEASE_REASONS = REPLAYABLE_LEASE_REASONS;
 exports.RegistrationPendingError = RegistrationPendingError;
 exports.SETTLEMENT_UNCONFIRMED = SETTLEMENT_UNCONFIRMED;
+exports.SOLANA_FEEDBACK_NETWORKS = SOLANA_FEEDBACK_NETWORKS;
 exports.TIER_FILTERS = TIER_FILTERS;
 exports.TIER_TIMINGS = TIER_TIMINGS;
 exports.USDC_DOMAIN_NAME = USDC_DOMAIN_NAME;
@@ -5170,6 +5334,7 @@ exports.parseRetryAfterSeconds = parseRetryAfterSeconds;
 exports.readFacilitatorError = readFacilitatorError;
 exports.resolveEnvelopeVersion = resolveEnvelopeVersion;
 exports.supportsRelayedFeedback = supportsRelayedFeedback;
+exports.supportsSolanaFeedback = supportsSolanaFeedback;
 exports.toPaymentRequirementsV2 = toPaymentRequirementsV2;
 exports.toResourceInfoV2 = toResourceInfoV2;
 exports.wireNetwork = wireNetwork;