@b3dotfun/sdk 0.0.24 → 0.0.25

package/src/anyspend/docs/error-handling.md

@@ -18,7 +18,7 @@ enum OrderStatus {
   // Processing States
   SENDING_TOKEN_FROM_VAULT = "sending_token_from_vault",
   RELAY = "relay",
-  
+
   // Success States
   EXECUTED = "executed",
 
@@ -90,13 +90,13 @@ function PaymentComponent() {
   const { createOrder, isCreatingOrder } = useAnyspendCreateOrder({
     onError: (error) => {
       console.error("Payment failed:", error);
-      
+
       // Handle specific errors
       switch (error.message) {
         case "INSUFFICIENT_BALANCE":
           setError("Insufficient balance. Please add funds to your wallet.");
           break;
-          
+
         case "SLIPPAGE":
           if (retryCount < 3) {
             setError("Price moved unfavorably. Retrying...");
@@ -108,16 +108,16 @@ function PaymentComponent() {
             setError("Price too volatile. Please try again later.");
           }
           break;
-          
+
         case "NETWORK_ERROR":
           setError("Network issue. Please check your connection and try again.");
           break;
-          
+
         case "QUOTE_EXPIRED":
           setError("Price quote expired. Getting fresh quote...");
           refreshQuote();
           break;
-          
+
         default:
           setError("Payment failed. Please try again or contact support.");
       }
@@ -129,7 +129,7 @@ function PaymentComponent() {
         timestamp: new Date().toISOString(),
       });
     },
-    
+
     onSuccess: () => {
       setError(null);
       setRetryCount(0);
@@ -145,9 +145,9 @@ function PaymentComponent() {
           <button onClick={() => setError(null)}>Dismiss</button>
         </div>
       )}
-      
-      <button 
-        onClick={handlePayment} 
+
+      <button
+        onClick={handlePayment}
         disabled={isCreatingOrder}
       >
         {isCreatingOrder ? "Processing..." : "Pay Now"}
@@ -163,8 +163,8 @@ function PaymentComponent() {
 import { useAnyspendOrderAndTransactions } from "@b3dotfun/sdk/anyspend";
 
 function OrderStatusMonitor({ orderId }: { orderId: string }) {
-  const { orderAndTransactions, getOrderAndTransactionsError } = 
-    useAnyspendOrderAndTransactions(true, orderId);
+  const { orderAndTransactions, getOrderAndTransactionsError } =
+    useAnyspendOrderAndTransactions(orderId);
 
   if (getOrderAndTransactionsError) {
     return (
@@ -194,7 +194,7 @@ function OrderStatusMonitor({ orderId }: { orderId: string }) {
               <h3>⏳ Waiting for payment confirmation</h3>
               <p>This usually takes 1-2 minutes. Please don't close this window.</p>
               {depositTxs.length > 0 && (
-                <a 
+                <a
                   href={getExplorerUrl(depositTxs[0].txHash, depositTxs[0].chainId)}
                   target="_blank"
                   rel="noopener noreferrer"
@@ -225,7 +225,7 @@ function OrderStatusMonitor({ orderId }: { orderId: string }) {
               <h3>Transaction completed successfully!</h3>
               <p>Your order has been processed.</p>
               {executeTx && (
-                <a 
+                <a
                   href={getExplorerUrl(executeTx.txHash, executeTx.chainId)}
                   target="_blank"
                   rel="noopener noreferrer"
@@ -265,7 +265,7 @@ function OrderStatusMonitor({ orderId }: { orderId: string }) {
               <h3>Refund processed</h3>
               <p>Your payment has been refunded automatically.</p>
               {refundTxs.length > 0 && (
-                <a 
+                <a
                   href={getExplorerUrl(refundTxs[0].txHash, refundTxs[0].chainId)}
                   target="_blank"
                   rel="noopener noreferrer"
@@ -355,7 +355,7 @@ class AnySpendErrorBoundary extends Component<Props, State> {
 
   componentDidCatch(error: Error, errorInfo: ErrorInfo) {
     console.error("AnySpend Error Boundary caught an error:", error, errorInfo);
-    
+
     // Report to error tracking service
     if (typeof window !== "undefined") {
       // Example: Sentry.captureException(error, { contexts: { errorInfo } });
@@ -370,9 +370,9 @@ class AnySpendErrorBoundary extends Component<Props, State> {
     if (this.state.hasError) {
       const FallbackComponent = this.props.fallback || DefaultErrorFallback;
       return (
-        <FallbackComponent 
-          error={this.state.error!} 
-          resetError={this.resetError} 
+        <FallbackComponent
+          error={this.state.error!}
+          resetError={this.resetError}
         />
       );
     }
@@ -433,42 +433,42 @@ function DiagnoseQuoteIssue() {
       // Check if tokens are valid
       const srcTokenValid = await validateToken(quoteRequest.srcTokenAddress, quoteRequest.srcChain);
       const dstTokenValid = await validateToken(quoteRequest.dstTokenAddress, quoteRequest.dstChain);
-      
+
       if (!srcTokenValid) {
         setDiagnosis("Source token address is invalid or not supported");
         return;
       }
-      
+
       if (!dstTokenValid) {
         setDiagnosis("Destination token address is invalid or not supported");
         return;
       }
-      
+
       // Check if amount is within limits
       const amount = parseFloat(quoteRequest.amount);
       if (amount < MIN_SWAP_AMOUNT) {
         setDiagnosis(`Amount too small. Minimum: ${MIN_SWAP_AMOUNT}`);
         return;
       }
-      
+
       if (amount > MAX_SWAP_AMOUNT) {
         setDiagnosis(`Amount too large. Maximum: ${MAX_SWAP_AMOUNT}`);
         return;
       }
-      
+
       // Check if chain pair is supported
       const chainPairSupported = await checkChainPairSupport(
-        quoteRequest.srcChain, 
+        quoteRequest.srcChain,
         quoteRequest.dstChain
       );
-      
+
       if (!chainPairSupported) {
         setDiagnosis("This chain pair is not currently supported");
         return;
       }
-      
+
       setDiagnosis("All checks passed. Try refreshing the quote.");
-      
+
     } catch (error) {
       setDiagnosis(`Network error: ${error.message}`);
     }
@@ -498,8 +498,8 @@ function DepositDiagnostics({ orderId }: { orderId: string }) {
 
   const diagnoseDespositIssue = async () => {
     try {
-      const order = await anyspendService.getOrder(true, orderId);
-      
+      const order = await anyspendService.getOrder(orderId);
+
       if (!order.depositAddress) {
         setDepositDiag({
           issue: "No deposit address generated",
@@ -507,11 +507,11 @@ function DepositDiagnostics({ orderId }: { orderId: string }) {
         });
         return;
       }
-      
+
       // Check if payment was sent to correct address
       const expectedAddress = order.depositAddress;
       const userTxs = await getTransactionsToAddress(expectedAddress);
-      
+
       if (userTxs.length === 0) {
         setDepositDiag({
           issue: "No payment received at deposit address",
@@ -519,11 +519,11 @@ function DepositDiagnostics({ orderId }: { orderId: string }) {
         });
         return;
       }
-      
+
       // Check if amount matches
       const expectedAmount = order.srcAmount;
       const receivedAmount = userTxs[0].amount;
-      
+
       if (receivedAmount !== expectedAmount) {
         setDepositDiag({
           issue: `Amount mismatch. Expected: ${expectedAmount}, Received: ${receivedAmount}`,
@@ -531,11 +531,11 @@ function DepositDiagnostics({ orderId }: { orderId: string }) {
         });
         return;
       }
-      
+
       // Check transaction confirmations
       const confirmations = await getTransactionConfirmations(userTxs[0].hash);
       const requiredConfirmations = getRequiredConfirmations(order.srcChain);
-      
+
       if (confirmations < requiredConfirmations) {
         setDepositDiag({
           issue: `Waiting for confirmations: ${confirmations}/${requiredConfirmations}`,
@@ -543,12 +543,12 @@ function DepositDiagnostics({ orderId }: { orderId: string }) {
         });
         return;
       }
-      
+
       setDepositDiag({
         issue: "Payment detected but not processed",
         solution: "This may be a system delay. Contact support if it persists."
       });
-      
+
     } catch (error) {
       setDepositDiag({
         issue: "Unable to diagnose",
@@ -562,7 +562,7 @@ function DepositDiagnostics({ orderId }: { orderId: string }) {
       <button onClick={diagnoseDespositIssue}>
         Diagnose Deposit Issue
       </button>
-      
+
       {depositDiag && (
         <div className="diagnosis-result">
           <h4>Issue: {depositDiag.issue}</h4>
@@ -651,19 +651,19 @@ function DebugInfo({ orderId }: { orderId: string }) {
       userAgent: navigator.userAgent,
       url: window.location.href,
       orderId,
-      
+
       // Network info
       connection: (navigator as any).connection,
-      
+
       // Order data
-      order: await anyspendService.getOrder(true, orderId),
-      
+      order: await anyspendService.getOrder(orderId),
+
       // Browser storage
       localStorage: { ...localStorage },
-      
+
       // Console errors
       recentErrors: getRecentConsoleErrors(),
-      
+
       // SDK version
       sdkVersion: process.env.REACT_APP_SDK_VERSION,
     };
@@ -681,7 +681,7 @@ function DebugInfo({ orderId }: { orderId: string }) {
       <button onClick={collectDebugInfo}>
         Collect Debug Info
       </button>
-      
+
       {debugData && (
         <div>
           <button onClick={copyDebugInfo}>
@@ -732,4 +732,4 @@ interface BugReport {
 
 - [View Installation Guide →](./installation.md)
 - [Explore Components →](./components.md)
-- [See Examples →](./examples.md) 
+- [See Examples →](./examples.md)

package/src/anyspend/docs/examples.md

@@ -43,13 +43,13 @@ function TokenSwapPage() {
         onSuccess={(txHash) => {
           // Update user's portfolio
           toast.success("Swap completed successfully!");
-          
+
           // Optional: Track analytics
           analytics.track("swap_completed", {
             txHash,
             userAddress,
           });
-          
+
           // Refresh user balances
           queryClient.invalidateQueries(['user-balances', userAddress]);
         }}
@@ -80,7 +80,7 @@ function AdvancedSwapInterface() {
     amount: parseUnits(amount || "0", fromToken.decimals).toString(),
   }), [fromToken, toToken, amount]);
 
-  const { anyspendQuote, isLoadingAnyspendQuote } = useAnyspendQuote(true, quoteRequest);
+  const { anyspendQuote, isLoadingAnyspendQuote } = useAnyspendQuote(quoteRequest);
 
   return (
     <div className="advanced-swap">
@@ -92,12 +92,12 @@ function AdvancedSwapInterface() {
           onTokenChange={setFromToken}
           onAmountChange={setAmount}
         />
-        
+
         <SwapArrowButton onClick={() => {
           setFromToken(toToken);
           setToToken(fromToken);
         }} />
-        
+
         <TokenInput
           label="To"
           token={toToken}
@@ -105,7 +105,7 @@ function AdvancedSwapInterface() {
           onTokenChange={setToToken}
           readOnly
         />
-        
+
         {anyspendQuote && (
           <div className="quote-details">
             <div>Rate: 1 {fromToken.symbol} = {anyspendQuote.rate} {toToken.symbol}</div>
@@ -114,7 +114,7 @@ function AdvancedSwapInterface() {
             <div>Total: ${anyspendQuote.totalUsdCost}</div>
           </div>
         )}
-        
+
         <button
           onClick={() => setIsSwapOpen(true)}
           disabled={isLoadingAnyspendQuote || !anyspendQuote}
@@ -172,7 +172,7 @@ function NFTCard({ nft }: { nft: NFTListing }) {
         <div className="price">
           {nft.priceFormatted} {nft.currency.symbol}
         </div>
-        
+
         {isOwned ? (
           <div className="owned-badge">✅ Owned</div>
         ) : (
@@ -181,10 +181,10 @@ function NFTCard({ nft }: { nft: NFTListing }) {
             recipientAddress={userAddress}
             onSuccess={(txHash) => {
               setIsOwned(true);
-              
+
               // Update user's NFT collection
               queryClient.invalidateQueries(['user-nfts', userAddress]);
-              
+
               // Show success message with explorer link
               toast.success(
                 <div>
@@ -224,8 +224,8 @@ function NFTMarketplace() {
     <div className="marketplace">
       <div className="nft-grid">
         {nfts.map((nft) => (
-          <NFTCard 
-            key={nft.id} 
+          <NFTCard
+            key={nft.id}
             nft={nft}
             onSelect={(selected) => {
               if (selected) {
@@ -237,7 +237,7 @@ function NFTMarketplace() {
           />
         ))}
       </div>
-      
+
       {selectedNFTs.length > 0 && (
         <div className="bulk-purchase">
           <p>Selected: {selectedNFTs.length} NFTs</p>
@@ -267,9 +267,9 @@ function StakingPool({ pool }: { pool: StakingPool }) {
 
   const stakingCalldata = useMemo(() => {
     if (!stakeAmount) return "0x";
-    
+
     const amountWei = parseUnits(stakeAmount, pool.token.decimals);
-    
+
     return encodeFunctionData({
       abi: stakingPoolABI,
       functionName: "stake",
@@ -350,10 +350,10 @@ function StakingPool({ pool }: { pool: StakingPool }) {
           )}
           onSuccess={(txHash) => {
             toast.success("Staking successful!");
-            
+
             // Update user's staking positions
             queryClient.invalidateQueries(['staking-positions', userAddress]);
-            
+
             // Reset form
             setStakeAmount("");
           }}
@@ -401,7 +401,7 @@ function SpinWheel({ game }: { game: GameConfig }) {
           // Listen for spin result event
           listenForSpinResult(txHash).then((result) => {
             setSpinHistory([result, ...spinHistory]);
-            
+
             if (result.isWinner) {
               toast.success(`You won ${result.prize.name}!`);
             } else {
@@ -435,7 +435,7 @@ import { AnySpendTournament } from "@b3dotfun/sdk/anyspend/react";
 function TournamentCard({ tournament }: { tournament: Tournament }) {
   const [userAddress] = useWallet();
   const [isRegistered, setIsRegistered] = useState(false);
-  
+
   const timeUntilStart = tournament.startTime - Date.now();
   const isStartingSoon = timeUntilStart < 60 * 60 * 1000; // 1 hour
 
@@ -460,12 +460,12 @@ function TournamentCard({ tournament }: { tournament: Tournament }) {
           <h4>Prize Pool</h4>
           <p>{tournament.prizePool} {tournament.currency.symbol}</p>
         </div>
-        
+
         <div className="participants">
           <h4>Participants</h4>
           <p>{tournament.currentParticipants} / {tournament.maxParticipants}</p>
         </div>
-        
+
         <div className="entry-fee">
           <h4>Entry Fee</h4>
           <p>{tournament.entryFee} {tournament.currency.symbol}</p>
@@ -484,7 +484,7 @@ function TournamentCard({ tournament }: { tournament: Tournament }) {
           onSuccess={() => {
             setIsRegistered(true);
             toast.success("Successfully registered for tournament!");
-            
+
             // Update tournament data
             queryClient.invalidateQueries(['tournament', tournament.id]);
           }}
@@ -523,14 +523,14 @@ function FiatOnramp({ targetToken }: { targetToken: Token }) {
         onSuccess={(txHash) => {
           // Welcome new user
           toast.success("Welcome to crypto! Your purchase was successful.");
-          
+
           // Track onboarding completion
           analytics.track("onramp_completed", {
             userAddress,
             token: targetToken.symbol,
             txHash,
           });
-          
+
           // Redirect to main app
           router.push("/dashboard");
         }}
@@ -557,7 +557,7 @@ function OnboardingWizard() {
       </div>
 
       {step === 1 && (
-        <WalletConnectionStep 
+        <WalletConnectionStep
           onConnect={(address) => {
             setUserAddress(address);
             setStep(2);
@@ -647,10 +647,10 @@ function CryptoCheckout({ order }: { order: Order }) {
           onSuccess={(txHash) => {
             // Process order fulfillment
             processOrder(order.id, txHash);
-            
+
             // Send confirmation email
             sendOrderConfirmation(order, txHash);
-            
+
             // Redirect to success page
             router.push(`/order-confirmation/${order.id}`);
           }}
@@ -680,7 +680,7 @@ function PortfolioRebalancer() {
   return (
     <div className="portfolio-rebalancer">
       <h2>Portfolio Rebalancing</h2>
-      
+
       <div className="current-allocation">
         <h3>Current Allocation</h3>
         <AllocationChart balances={currentBalances} />
@@ -724,4 +724,4 @@ function PortfolioRebalancer() {
 
 - [Error Handling Guide →](./error-handling.md)
 - [Components Reference →](./components.md)
-- [Hooks Reference →](./hooks.md) 
+- [Hooks Reference →](./hooks.md)

package/src/anyspend/docs/hooks.md

@@ -16,14 +16,13 @@ const {
   isLoadingAnyspendQuote,
   getAnyspendQuoteError,
   refetchAnyspendQuote
-} = useAnyspendQuote(isMainnet, quoteRequest);
+} = useAnyspendQuote(quoteRequest);
 ```
 
 #### Parameters
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `isMainnet` | `boolean` | Use mainnet or testnet environment |
 | `quoteRequest` | `QuoteRequest` | Quote configuration object |
 
 #### QuoteRequest Interface
@@ -63,8 +62,8 @@ function SwapQuote() {
     amount: "1000000", // 1 USDC (6 decimals)
   };
 
-  const { anyspendQuote, isLoadingAnyspendQuote, getAnyspendQuoteError } = 
-    useAnyspendQuote(true, quoteRequest);
+  const { anyspendQuote, isLoadingAnyspendQuote, getAnyspendQuoteError } =
+    useAnyspendQuote(quoteRequest);
 
   if (isLoadingAnyspendQuote) return <div>Getting best price...</div>;
   if (getAnyspendQuoteError) return <div>Failed to get quote</div>;
@@ -138,7 +137,6 @@ function PaymentForm() {
 
   const handlePayment = () => {
     createOrder({
-      isMainnet: true,
       recipientAddress: userWalletAddress,
       orderType: "swap",
       srcChain: 1,
@@ -164,8 +162,8 @@ function PaymentForm() {
   };
 
   return (
-    <button 
-      onClick={handlePayment} 
+    <button
+      onClick={handlePayment}
       disabled={isCreatingOrder}
     >
       {isCreatingOrder ? "Processing..." : "Pay with Crypto"}
@@ -187,14 +185,13 @@ const {
   orderAndTransactions,
   isLoadingOrderAndTransactions,
   getOrderAndTransactionsError
-} = useAnyspendOrderAndTransactions(isMainnet, orderId);
+} = useAnyspendOrderAndTransactions(orderId);
 ```
 
 #### Parameters
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `isMainnet` | `boolean` | Environment selection |
 | `orderId` | `string` | Order ID to track |
 
 #### Return Values
@@ -223,8 +220,8 @@ interface OrderWithTransactions {
 
 ```tsx
 function OrderTracker({ orderId }: { orderId: string }) {
-  const { orderAndTransactions, isLoadingOrderAndTransactions } = 
-    useAnyspendOrderAndTransactions(true, orderId);
+  const { orderAndTransactions, isLoadingOrderAndTransactions } =
+    useAnyspendOrderAndTransactions(orderId);
 
   if (isLoadingOrderAndTransactions) {
     return <div>Loading order status...</div>;
@@ -255,11 +252,11 @@ function OrderTracker({ orderId }: { orderId: string }) {
     <div className="order-status">
       <h2>Order #{orderId.slice(0, 8)}</h2>
       <p>{getStatusMessage(order.status)}</p>
-      
+
       {depositTxs.length > 0 && (
         <div>
           <h3>Payment Transaction</h3>
-          <a 
+          <a
             href={`https://etherscan.io/tx/${depositTxs[0].txHash}`}
             target="_blank"
             rel="noopener noreferrer"
@@ -272,7 +269,7 @@ function OrderTracker({ orderId }: { orderId: string }) {
       {executeTx && (
         <div>
           <h3>Execution Transaction</h3>
-          <a 
+          <a
             href={`https://explorer.b3.fun/tx/${executeTx.txHash}`}
             target="_blank"
             rel="noopener noreferrer"
@@ -305,14 +302,13 @@ const {
   orderHistory,
   isLoadingOrderHistory,
   getOrderHistoryError
-} = useAnyspendOrderHistory(isMainnet, creatorAddress, limit, offset);
+} = useAnyspendOrderHistory(creatorAddress, limit, offset);
 ```
 
 #### Parameters
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `isMainnet` | `boolean` | Environment selection |
 | `creatorAddress` | `string` | User wallet address |
 | `limit` | `number` | Number of orders to fetch (max 100) |
 | `offset` | `number` | Pagination offset |
@@ -325,7 +321,6 @@ function OrderHistory({ userAddress }: { userAddress: string }) {
   const pageSize = 10;
 
   const { orderHistory, isLoadingOrderHistory } = useAnyspendOrderHistory(
-    true,
     userAddress,
     pageSize,
     page * pageSize
@@ -346,14 +341,14 @@ function OrderHistory({ userAddress }: { userAddress: string }) {
           <p>Date: {new Date(order.createdAt).toLocaleDateString()}</p>
         </div>
       ))}
-      
-      <button 
-        onClick={() => setPage(page - 1)} 
+
+      <button
+        onClick={() => setPage(page - 1)}
         disabled={page === 0}
       >
         Previous
       </button>
-      <button 
+      <button
         onClick={() => setPage(page + 1)}
         disabled={!orderHistory?.data || orderHistory.data.length < pageSize}
       >
@@ -371,7 +366,7 @@ function OrderHistory({ userAddress }: { userAddress: string }) {
 Get available tokens for a specific chain.
 
 ```tsx
-const { tokens, isLoadingTokens } = useAnyspendTokens(true, 1, "USDC");
+const { tokens, isLoadingTokens } = useAnyspendTokens(1, "USDC");
 ```
 
 ### `useCoinbaseOnrampOptions`
@@ -400,7 +395,7 @@ function PaymentComponent() {
     onError: (error) => {
       // Log error for debugging
       console.error("Payment failed:", error);
-      
+
       // Show user-friendly message
       switch (error.message) {
         case "INSUFFICIENT_BALANCE":
@@ -423,7 +418,7 @@ function PaymentComponent() {
 
 ```tsx
 function SwapInterface() {
-  const { anyspendQuote, isLoadingAnyspendQuote } = useAnyspendQuote(true, quoteRequest);
+  const { anyspendQuote, isLoadingAnyspendQuote } = useAnyspendQuote(quoteRequest);
   const { createOrder, isCreatingOrder } = useAnyspendCreateOrder();
 
   const isLoading = isLoadingAnyspendQuote || isCreatingOrder;
@@ -441,7 +436,7 @@ function SwapInterface() {
 
 ```tsx
 function OrderStatus({ orderId }: { orderId: string }) {
-  const { orderAndTransactions } = useAnyspendOrderAndTransactions(true, orderId);
+  const { orderAndTransactions } = useAnyspendOrderAndTransactions(orderId);
 
   // Auto-refresh every 5 seconds for pending orders
   useEffect(() => {
@@ -449,7 +444,7 @@ function OrderStatus({ orderId }: { orderId: string }) {
       const interval = setInterval(() => {
         // Refetch is handled automatically by the hook
       }, 5000);
-      
+
       return () => clearInterval(interval);
     }
   }, [orderAndTransactions?.data.order.status]);
@@ -462,4 +457,4 @@ function OrderStatus({ orderId }: { orderId: string }) {
 
 - [See Examples →](./examples.md)
 - [Error Handling →](./error-handling.md)
-- [Components Reference →](./components.md) 
+- [Components Reference →](./components.md)