[SDK] Add x402 recipientAddress to payment request and replace deprecated payTo (#8226)

Author: joaquim-verges

.changeset/loud-apples-poke.md

@@ -0,0 +1,5 @@
+---
+"thirdweb": patch
+---
+
+Add optional recipientAddress to x402 settlePayment

.changeset/lucky-meals-join.md

@@ -0,0 +1,5 @@
+---
+"thirdweb": patch
+---
+
+Expose 7702 utility functions

packages/thirdweb/src/exports/wallets/in-app.ts

@@ -54,6 +54,7 @@ export {
   createSessionKey,
   isCreateSessionKeySupported,
 } from "../../extensions/erc7702/account/createSessionKey.js";
+
 export type {
   Condition,
   LimitType,

packages/thirdweb/src/x402/common.ts

@@ -44,6 +44,7 @@ export async function decodePaymentRequest(
     price,
     network,
     facilitator,
+    payTo,
     resourceUrl,
     routeConfig = {},
     method,
@@ -104,7 +105,7 @@ export async function decodePaymentRequest(
     resource: resourceUrl,
     description: description ?? "",
     mimeType: mimeType ?? "application/json",
-    payTo: getAddress(facilitator.address),
+    payTo: getAddress(facilitator.address), // always pay to the facilitator address first
     maxTimeoutSeconds: maxTimeoutSeconds ?? 300,
     asset: getAddress(asset.address),
     outputSchema: {
@@ -117,6 +118,7 @@ export async function decodePaymentRequest(
       output: outputSchema,
     },
     extra: {
+      recipientAddress: payTo, // input payTo is the final recipient address
       ...((asset as ERC20TokenAmount["asset"]).eip712 ?? {}),
     },
   });

packages/thirdweb/src/x402/types.ts

@@ -34,7 +34,7 @@ export type PaymentArgs = {
   facilitator: ThirdwebX402Facilitator;
   /** Optional configuration for the payment middleware route */
   routeConfig?: PaymentMiddlewareConfig;
-  /** @deprecated Use facilitator.address instead */
+  /** Optional recipient address to receive the payment if different from your facilitator address */
   payTo?: string;
 };