@relai-fi/x402 0.6.10 → 0.6.11-rc.0

package/README.md

@@ -1751,6 +1751,8 @@ import {
   getPayRequest,
   payPayRequest,
   payPayRequestWithCode,
+  payPayRequestWithStoredCode,
+  type PaymentRequestObject,
 } from '@relai-fi/x402';
 
 const config = { facilitatorUrl: 'https://relai.fi/facilitator' };
@@ -1784,6 +1786,16 @@ console.log('Explorer:', result.explorerUrl);
 if (result.changeCode) {
   console.log(`Change $${Number(result.change) / 1e6} USDC → code: ${result.changeCode}`);
 }
+
+// ── Agent / vault flow: reuse a fetched request object directly ─────────────
+const fetchedRequest: PaymentRequestObject = await getPayRequest(config, 'MW78SGTW');
+const storedCodeResult = await payPayRequestWithStoredCode(
+  config,
+  fetchedRequest,
+  'MYVAULT78',
+  { returnChange: 'code' },
+);
+console.log('Stored code payment success:', storedCodeResult.success);
 ```
 
 ### `payPayRequestWithCode` options
@@ -1793,6 +1805,13 @@ if (result.changeCode) {
 | `returnChange` | `'code' \| 'wallet'` | `'code'` | How to return surplus when code value > invoice |
 | `allowOverpayment` | `boolean` | `true` | If `false`, throws when code value ≠ invoice amount |
 
+`payPayRequestWithStoredCode()` accepts either:
+
+- a payment request code string, or
+- a fetched `PaymentRequestObject` from `getPayRequest()`
+
+Passing the object lets agents skip the extra request lookup when they already have the decoded request in memory. For stored Solana codes, the object must include a valid `code` field because the Solana facilitator endpoint still resolves the merchant request by `requestCode`.
+
 **`returnChange` behaviour:**
 
 | Value | Mechanism | Requires buyer wallet? |

package/dist/index.cjs

@@ -5418,6 +5418,9 @@ var EIP3009_TYPES3 = {
     { name: "nonce", type: "bytes32" }
   ]
 };
+function isPaymentRequestObject(value) {
+  return typeof value !== "string";
+}
 function isEvmAddress(value) {
   return /^0x[0-9a-fA-F]{40}$/i.test(value);
 }
@@ -5876,12 +5879,16 @@ async function claimPaymentLink(config2, claimUrlOrToken, params) {
   });
   return sanitizeClaimLinkResponse(payload, facilitatorUrl, claimToken);
 }
-async function payPayRequestWithStoredCode(config2, requestCode, paymentCode, options = {}) {
+async function payPayRequestWithStoredCode(config2, request, paymentCode, options = {}) {
   const facilitatorUrl = config2.facilitatorUrl ?? DEFAULT_FACILITATOR4;
-  const normalizedRequestCode = requestCode.trim().toUpperCase();
   const normalizedPaymentCode = paymentCode.trim().toUpperCase();
+  const requestInfo = isPaymentRequestObject(request) ? request : await getPayRequest(config2, request.trim().toUpperCase());
+  const normalizedRequestCode = isPaymentRequestObject(request) ? requestInfo.code.trim().toUpperCase() : request.trim().toUpperCase();
   const codeStatusInfo = await fetchStoredCodeWithFallback(facilitatorUrl, normalizedPaymentCode);
   if (codeStatusInfo.kind === "solana") {
+    if (!normalizedRequestCode) {
+      throw new Error("A payment request object with a valid code is required when paying a request with a stored Solana code");
+    }
     return fetchOrThrow(`${facilitatorUrl}/solana-payment-codes/${normalizedPaymentCode}/pay-request`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -5891,7 +5898,6 @@ async function payPayRequestWithStoredCode(config2, requestCode, paymentCode, op
       })
     });
   }
-  const requestInfo = await getPayRequest(config2, normalizedRequestCode);
   const codeStatus = codeStatusInfo.payload;
   const allowOverpayment = options.allowOverpayment ?? true;
   const returnChange = options.returnChange ?? "code";