uvd-x402-sdk 2.87.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, 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 ProofOfPayment, bh as RELAYED_FEEDBACK_NETWORKS, R as REPLAYABLE_LEASE_REASONS, bi as RefundRequest, bj as RefundStatus, bk as RegisterAgentRequest, bl as RegisterAgentResponse, bm as RegisterJobResponse, bn as RegisterJobStatus, bo as RegistrationPendingError, bp as RelayAuthorizationParams, bq as ReputationResponse, br as ReputationSummary, bs as RequestRefundOptions, u as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bt as SettleRequest, v as SettleRequestV2, bu as SettleResponse, bv as SettleResponseWithProof, bw as SubmitRelayFeedbackRequest, bx as SubmitRelayResponseRequest, by as TIER_FILTERS, bz as TIER_TIMINGS, bA as USDC_DOMAIN_NAME, bB as UnavailableBody, bC as UnavailableResponse, V as VerifiedPaymentState, bD as VerifyRequest, w as VerifyRequestV2, bE as VerifyResponse, W as WRITER_LEASE_REASONS, y as WriterLeaseReason, X as X402_CORS_HEADERS, z as X402_HEADER_NAMES, bF as ZERO_ADDRESS, bG as buildErc8004PaymentRequirements, G as buildPaymentRequirements, I as buildSettleRequest, J as buildSettleRequestForVersion, K as buildSettleRequestV2, bH as buildUnavailableResponse, N as buildVerifyRequest, O as buildVerifyRequestForVersion, Q as buildVerifyRequestV2, bI as canRefundEscrow, bJ as canReleaseEscrow, bK as carryFailureFields, T as create402Response, U as createHonoMiddleware, Y as createPaymentMiddleware, bL as epochToDate, bM as escrowTimeRemaining, Z as extractPaymentFromHeaders, _ as facilitatorFetch, $ as getCorsHeaders, bN as getEscrowContractsByChainId, bO as getEscrowSupportedChainIds, bP as isAlive, a0 as isAmbiguousLeaseReason, bQ as isEscrowExpired, bR as isEscrowSupportedOnChain, bS as isRegisterJobTerminal, a1 as isReplayableLeaseReason, a2 as isSettlementUnconfirmed, a4 as parseFacilitatorErrorBody, bT as parsePaymentHeader, a5 as parseRetryAfterSeconds, a6 as readFacilitatorError, a7 as resolveEnvelopeVersion, bU as supportsRelayedFeedback, a8 as toPaymentRequirementsV2, a9 as toResourceInfoV2, bV as wireNetwork } from '../index-BHfYxpzI.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, 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 ProofOfPayment, bh as RELAYED_FEEDBACK_NETWORKS, R as REPLAYABLE_LEASE_REASONS, bi as RefundRequest, bj as RefundStatus, bk as RegisterAgentRequest, bl as RegisterAgentResponse, bm as RegisterJobResponse, bn as RegisterJobStatus, bo as RegistrationPendingError, bp as RelayAuthorizationParams, bq as ReputationResponse, br as ReputationSummary, bs as RequestRefundOptions, u as ResourceInfoV2, S as SETTLEMENT_UNCONFIRMED, bt as SettleRequest, v as SettleRequestV2, bu as SettleResponse, bv as SettleResponseWithProof, bw as SubmitRelayFeedbackRequest, bx as SubmitRelayResponseRequest, by as TIER_FILTERS, bz as TIER_TIMINGS, bA as USDC_DOMAIN_NAME, bB as UnavailableBody, bC as UnavailableResponse, V as VerifiedPaymentState, bD as VerifyRequest, w as VerifyRequestV2, bE as VerifyResponse, W as WRITER_LEASE_REASONS, y as WriterLeaseReason, X as X402_CORS_HEADERS, z as X402_HEADER_NAMES, bF as ZERO_ADDRESS, bG as buildErc8004PaymentRequirements, G as buildPaymentRequirements, I as buildSettleRequest, J as buildSettleRequestForVersion, K as buildSettleRequestV2, bH as buildUnavailableResponse, N as buildVerifyRequest, O as buildVerifyRequestForVersion, Q as buildVerifyRequestV2, bI as canRefundEscrow, bJ as canReleaseEscrow, bK as carryFailureFields, T as create402Response, U as createHonoMiddleware, Y as createPaymentMiddleware, bL as epochToDate, bM as escrowTimeRemaining, Z as extractPaymentFromHeaders, _ as facilitatorFetch, $ as getCorsHeaders, bN as getEscrowContractsByChainId, bO as getEscrowSupportedChainIds, bP as isAlive, a0 as isAmbiguousLeaseReason, bQ as isEscrowExpired, bR as isEscrowSupportedOnChain, bS as isRegisterJobTerminal, a1 as isReplayableLeaseReason, a2 as isSettlementUnconfirmed, a4 as parseFacilitatorErrorBody, bT as parsePaymentHeader, a5 as parseRetryAfterSeconds, a6 as readFacilitatorError, a7 as resolveEnvelopeVersion, bU as supportsRelayedFeedback, a8 as toPaymentRequirementsV2, a9 as toResourceInfoV2, bV as wireNetwork } from '../index-D67eNxY8.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

@@ -3152,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;
@@ -3632,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
    *
@@ -5155,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;
@@ -5197,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;