@b3dotfun/sdk 0.0.88-alpha.6 → 0.0.88-alpha.7

package/src/anyspend/react/components/common/OrderDetails.tsx

@@ -65,6 +65,10 @@ interface OrderDetailsProps {
   onBack?: () => void;
   disableUrlParamManagement?: boolean; // When true, will not modify URL parameters
   points?: number | undefined; // Points earned from the transaction
+  /** Custom URL to redirect to when clicking "Return to Home" on complete order screen */
+  returnToHomeUrl?: string;
+  /** Custom label for the return home button (overrides "Return to Home" / "Close") */
+  returnHomeLabel?: string;
 }
 
 // Add this helper function near the top or just above the component
@@ -217,6 +221,8 @@ export const OrderDetails = memo(function OrderDetails({
   onBack,
   disableUrlParamManagement = false,
   points,
+  returnToHomeUrl,
+  returnHomeLabel,
 }: OrderDetailsProps) {
   const router = useRouter();
   const searchParams = useSearchParams();
@@ -377,6 +383,49 @@ export const OrderDetails = memo(function OrderDetails({
     onBack?.();
   }, [cleanupUrlParams, onBack]);
 
+  // Handle "Return to Home" click - redirects to custom URL if provided
+  const handleReturnToHome = useCallback(() => {
+    if (returnToHomeUrl) {
+      // Validate URL to prevent Open Redirect / XSS attacks
+      try {
+        const url = new URL(returnToHomeUrl, window.location.origin);
+        // Only allow http/https protocols
+        if (url.protocol === "http:" || url.protocol === "https:") {
+          window.location.href = url.href;
+          return;
+        }
+      } catch {
+        // If URL parsing fails, check if it's a safe relative URL
+        if (returnToHomeUrl.startsWith("/") && !returnToHomeUrl.startsWith("//")) {
+          window.location.href = returnToHomeUrl;
+          return;
+        }
+      }
+      // Fallback to handleBack if URL is not safe
+      handleBack();
+    } else {
+      handleBack();
+    }
+  }, [returnToHomeUrl, handleBack]);
+
+  // Reusable "Return to Home" / "Close" button
+  const returnHomeOrCloseButton = (
+    <button
+      className="order-close-button order-details-close-btn bg-as-brand flex w-full items-center justify-center gap-2 rounded-lg p-2 font-semibold text-white"
+      onClick={returnToHomeUrl ? handleReturnToHome : mode === "page" ? handleBack : handleCloseModal}
+    >
+      {returnHomeLabel ? (
+        returnHomeLabel
+      ) : mode === "page" ? (
+        <>
+          Return to Home <Home className="ml-2 h-4 w-4" />
+        </>
+      ) : (
+        "Close"
+      )}
+    </button>
+  );
+
   useEffect(() => {
     if (txSuccess) {
       toast.success("Transaction successful! We are processing your order.", { duration: 10000 });
@@ -521,18 +570,7 @@ export const OrderDetails = memo(function OrderDetails({
             </span>
           </div>
         )}
-        <button
-          className="order-close-button order-details-close-btn bg-as-brand flex w-full items-center justify-center gap-2 rounded-lg p-2 font-semibold text-white"
-          onClick={mode === "page" ? handleBack : handleCloseModal}
-        >
-          {mode === "page" ? (
-            <>
-              Return to Home <Home className="ml-2 h-4 w-4" />
-            </>
-          ) : (
-            "Close"
-          )}
-        </button>
+        {returnHomeOrCloseButton}
       </>
     );
   }
@@ -649,20 +687,7 @@ export const OrderDetails = memo(function OrderDetails({
           </ShinyButton>
         )}
 
-        {order.status === "executed" && (
-          <button
-            className="order-close-button order-details-close-btn bg-as-brand flex w-full items-center justify-center gap-2 rounded-lg p-2 font-semibold text-white"
-            onClick={mode === "page" ? handleBack : handleCloseModal}
-          >
-            {mode === "page" ? (
-              <>
-                Return to Home <Home className="ml-2 h-4 w-4" />
-              </>
-            ) : (
-              "Close"
-            )}
-          </button>
-        )}
+        {order.status === "executed" && returnHomeOrCloseButton}
       </>
     );
   }
@@ -786,20 +811,7 @@ export const OrderDetails = memo(function OrderDetails({
           </ShinyButton>
         )}
 
-        {order.status === "executed" && (
-          <button
-            className="order-close-button order-details-close-btn bg-as-brand flex w-full items-center justify-center gap-2 rounded-lg p-2 font-semibold text-white"
-            onClick={mode === "page" ? handleBack : handleCloseModal}
-          >
-            {mode === "page" ? (
-              <>
-                Return to Home <Home className="ml-2 h-4 w-4" />
-              </>
-            ) : (
-              "Close"
-            )}
-          </button>
-        )}
+        {order.status === "executed" && returnHomeOrCloseButton}
       </>
     );
   }

package/src/anyspend/react/components/common/PanelOnramp.tsx

@@ -33,6 +33,7 @@ export function PanelOnramp({
   onShowPointsDetail,
   onShowFeeDetail,
   customUsdInputValues = ["5", "10", "20", "25"],
+  customRecipientLabel,
 }: {
   srcAmountOnRamp: string;
   setSrcAmountOnRamp: (amount: string) => void;
@@ -52,6 +53,8 @@ export function PanelOnramp({
   onShowPointsDetail?: () => void;
   onShowFeeDetail?: () => void;
   customUsdInputValues?: string[];
+  /** Custom label for recipient display (overrides recipientName) */
+  customRecipientLabel?: string;
 }) {
   // Helper function to get fees from anyspend quote
   const getFeeFromApi = (paymentMethod: FiatPaymentMethod): number | null => {
@@ -228,7 +231,8 @@ export function PanelOnramp({
               onClick={() => setActivePanel(recipientSelectionPanelIndex)} // Recipient selection panel
             >
               <span className="text-sm">
-                {recipientName ? formatUsername(recipientName) : formatAddress(_recipientAddress)}
+                {customRecipientLabel ||
+                  (recipientName ? formatUsername(recipientName) : formatAddress(_recipientAddress))}
               </span>
               <ChevronRight size={16} />
             </button>

package/src/global-account/react/stores/useModalStore.ts

@@ -426,6 +426,12 @@ export interface AnySpendDepositHypeProps extends BaseModalProps {
   customUsdInputValues?: string[];
   /** prefer eoa wallet */
   preferEoa?: boolean;
+  /** Custom URL to redirect to when clicking "Return to Home" on complete order screen */
+  returnToHomeUrl?: string;
+  /** Custom label for recipient display (e.g., "OBSN Telegram Bot") */
+  customRecipientLabel?: string;
+  /** Custom label for the return home button (overrides "Return to Home" / "Close") */
+  returnHomeLabel?: string;
 }
 
 export interface AvatarEditorModalProps extends BaseModalProps {