[SDK] Add fundWalletLink prop to x402 responses (#8443)

Author: joaquim-verges

.changeset/real-bugs-boil.md

@@ -0,0 +1,5 @@
+---
+"thirdweb": patch
+---
+
+Add fundWalletLink prop to x402 responses

packages/thirdweb/src/x402/schemas.ts

@@ -41,13 +41,15 @@ export type RequestedPaymentRequirements = z.infer<
 const FacilitatorSettleResponseSchema = SettleResponseSchema.extend({
   network: FacilitatorNetworkSchema,
   errorMessage: z.string().optional(),
+  fundWalletLink: z.string().optional(),
 });
 export type FacilitatorSettleResponse = z.infer<
   typeof FacilitatorSettleResponseSchema
 >;
 
 const FacilitatorVerifyResponseSchema = VerifyResponseSchema.extend({
   errorMessage: z.string().optional(),
+  fundWalletLink: z.string().optional(),
 });
 
 export type FacilitatorVerifyResponse = z.infer<

packages/thirdweb/src/x402/settle-payment.ts

@@ -167,6 +167,7 @@ export async function settlePayment(
           error,
           errorMessage:
             errorMessages?.settlementFailed || settlement.errorMessage,
+          fundWalletLink: settlement.fundWalletLink,
           accepts: paymentRequirements,
         },
       };

packages/thirdweb/src/x402/types.ts

@@ -58,6 +58,8 @@ export type PaymentRequiredResult = {
     accepts: RequestedPaymentRequirements[];
     /** Optional payer address if verification partially succeeded */
     payer?: string;
+    /** Optional link to a wallet to fund the wallet of the payer */
+    fundWalletLink?: string;
   };
   /** Response headers for the error response */
   responseHeaders: Record<string, string>;

packages/thirdweb/src/x402/verify-payment.ts

@@ -112,6 +112,7 @@ export async function verifyPayment(
           error: error,
           errorMessage:
             errorMessages?.verificationFailed || verification.errorMessage,
+          fundWalletLink: verification.fundWalletLink,
           accepts: paymentRequirements,
         },
       };