@settlr/sdk 0.1.0 → 0.2.0

package/README.md

@@ -1,22 +1,18 @@
 # @settlr/sdk
 
-> Solana USDC payments in 7 lines of code
+> Solana USDC payments for games - email checkout, no wallet required
 
 ## Installation
 
 ```bash
 npm install @settlr/sdk
-# or
-yarn add @settlr/sdk
-# or
-pnpm add @settlr/sdk
 ```
 
 ## Quick Start
 
 ### 1. Get Your API Key
 
-Sign up at [settlr.dev/dashboard](https://settlr.dev/dashboard) and create an API key.
+Sign up at [settlr.app/dashboard](https://settlr.app/dashboard) and create an API key.
 
 ### 2. Create a Payment Link
 
@@ -87,97 +83,65 @@ import { CheckoutWidget } from "@settlr/sdk";
 />;
 ```
 
-### Direct Payment (with wallet adapter)
+### How It Works
 
-```typescript
-import { Settlr } from "@settlr/sdk";
-import { useWallet } from "@solana/wallet-adapter-react";
+Settlr checkout handles authentication via Privy:
 
-const settlr = new Settlr({
-  apiKey: "sk_live_xxxxxxxxxxxx",
-  merchant: {
-    name: "My Store",
-    walletAddress: "YOUR_WALLET",
-  },
-});
+- **Email login** → Creates embedded Solana wallet automatically
+- **Wallet login** → Connects Phantom, Solflare, or Backpack
 
-// In your component
-const wallet = useWallet();
-
-const result = await settlr.pay({
-  wallet: {
-    publicKey: wallet.publicKey!,
-    signTransaction: wallet.signTransaction!,
-  },
-  amount: 29.99,
-  memo: "Order #1234",
-});
-
-if (result.success) {
-  console.log("Payment successful!", result.signature);
-}
-```
+No wallet-adapter setup needed. Just redirect to checkout.
 
 ### React Hook
 
 ```tsx
 import { SettlrProvider, useSettlr } from "@settlr/sdk";
 
-// Wrap your app
 function App() {
   return (
-    <WalletProvider wallets={wallets}>
-      <ConnectionProvider endpoint={endpoint}>
-        <SettlrProvider
-          config={{
-            apiKey: "sk_live_xxxxxxxxxxxx",
-            merchant: {
-              name: "My Store",
-              walletAddress: "YOUR_WALLET",
-            },
-          }}
-        >
-          <YourApp />
-        </SettlrProvider>
-      </ConnectionProvider>
-    </WalletProvider>
+    <SettlrProvider
+      config={{
+        apiKey: "sk_live_xxxxxxxxxxxx",
+        merchant: {
+          name: "My Game",
+          walletAddress: "YOUR_WALLET",
+        },
+      }}
+    >
+      <YourApp />
+    </SettlrProvider>
   );
 }
 
 // In your component
 function CheckoutButton() {
-  const { pay, connected } = useSettlr();
+  const { getCheckoutUrl } = useSettlr();
 
-  return (
-    <button onClick={() => pay({ amount: 29.99 })} disabled={!connected}>
-      Pay $29.99
-    </button>
-  );
+  const handlePay = () => {
+    const url = getCheckoutUrl({ amount: 29.99, memo: "Premium Pack" });
+    window.location.href = url;
+  };
+
+  return <button onClick={handlePay}>Pay $29.99</button>;
 }
 ```
 
-### Payment Link Generator Hook ⭐ NEW
+### Payment Link Generator Hook
 
 Generate shareable payment links programmatically:
 
 ```tsx
-import { usePaymentLink } from "@settlr/sdk";
+import { useSettlr } from "@settlr/sdk";
 
 function InvoicePage() {
-  const { generateLink, generateQRCode } = usePaymentLink({
-    merchantWallet: "YOUR_WALLET",
-    merchantName: "My Store",
-  });
+  const { getCheckoutUrl } = useSettlr();
 
-  const link = generateLink({
+  const link = getCheckoutUrl({
     amount: 500,
     memo: "Invoice #1234",
     orderId: "inv_1234",
   });
-  // → https://settlr.dev/pay?amount=500&merchant=My+Store&...
-
-  const qrCode = await generateQRCode({ amount: 500 });
-  // → QR code image URL
+  // → https://settlr.app/checkout?amount=500&merchant=My+Game&...
 }
 ```
 
@@ -250,7 +214,7 @@ Full checkout UI component with product info.
 
 ### Get Your API Key
 
-1. Go to [settlr.dev/dashboard](https://settlr.dev/dashboard)
+1. Go to [settlr.app/dashboard](https://settlr.app/dashboard)
 2. Connect your wallet
 3. Click "Create API Key"
 4. Save the key securely (only shown once!)
@@ -298,7 +262,7 @@ const payment = await settlr.createPayment({
   id: 'pay_abc123',
   amount: 29.99,
   status: 'pending',
-  checkoutUrl: 'https://settlr.dev/pay?...',
+  checkoutUrl: 'https://settlr.app/checkout?...',
   qrCode: 'data:image/svg+xml,...',
   createdAt: Date,
   expiresAt: Date,
@@ -372,7 +336,7 @@ window.location.href = session.url;
 // Returns
 {
   id: 'cs_abc123...',
-  url: 'https://settlr.dev/checkout/cs_abc123...',
+  url: 'https://settlr.app/checkout/cs_abc123...',
   expiresAt: 1702659600000, // 30 min expiry
 }
 ```

package/dist/index.d.mts

@@ -5,8 +5,8 @@ import { ReactNode, CSSProperties } from 'react';
 declare const USDC_MINT_DEVNET: PublicKey;
 declare const USDC_MINT_MAINNET: PublicKey;
 declare const SETTLR_CHECKOUT_URL: {
-    readonly production: "https://settlr.dev/pay";
-    readonly development: "http://localhost:3000/pay";
+    readonly production: "https://settlr.dev/checkout";
+    readonly development: "http://localhost:3000/checkout";
 };
 declare const SUPPORTED_NETWORKS: readonly ["devnet", "mainnet-beta"];
 type SupportedNetwork = typeof SUPPORTED_NETWORKS[number];
@@ -182,6 +182,30 @@ declare class Settlr {
      * Get the current tier
      */
     getTier(): 'free' | 'pro' | 'enterprise' | undefined;
+    /**
+     * Get a checkout URL for redirect-based payments
+     *
+     * This is the simplest integration - just redirect users to this URL.
+     * Settlr handles auth (email or wallet) and payment processing.
+     *
+     * @example
+     * ```typescript
+     * const url = settlr.getCheckoutUrl({
+     *   amount: 29.99,
+     *   memo: 'Premium Pack',
+     * });
+     *
+     * // Redirect user to checkout
+     * window.location.href = url;
+     * ```
+     */
+    getCheckoutUrl(options: {
+        amount: number;
+        memo?: string;
+        orderId?: string;
+        successUrl?: string;
+        cancelUrl?: string;
+    }): string;
     /**
      * Create a payment link
      *
@@ -314,21 +338,28 @@ declare function parseUSDC(amount: number | string): bigint;
  */
 declare function shortenAddress(address: string, chars?: number): string;
 
+/**
+ * Checkout URL options
+ */
+interface CheckoutUrlOptions {
+    amount: number;
+    memo?: string;
+    orderId?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+}
 /**
  * Settlr context value
  */
 interface SettlrContextValue {
     /** Settlr client instance */
     settlr: Settlr | null;
-    /** Whether wallet is connected */
-    connected: boolean;
-    /** Create a payment link */
+    /** Whether user is authenticated */
+    authenticated: boolean;
+    /** Create a payment link (redirect flow) */
     createPayment: (options: CreatePaymentOptions) => Promise<Payment>;
-    /** Execute a direct payment */
-    pay: (options: {
-        amount: number;
-        memo?: string;
-    }) => Promise<PaymentResult>;
+    /** Generate checkout URL for redirect */
+    getCheckoutUrl: (options: CheckoutUrlOptions) => string;
     /** Get merchant's USDC balance */
     getBalance: () => Promise<number>;
 }
@@ -337,32 +368,41 @@ interface SettlrContextValue {
  */
 interface SettlrProviderProps {
     children: ReactNode;
-    config: Omit<SettlrConfig, "rpcEndpoint">;
+    config: SettlrConfig;
+    /** Whether user is authenticated (from Privy or other auth) */
+    authenticated?: boolean;
 }
 /**
  * Settlr Provider - Wraps your app to provide Settlr functionality
  *
+ * Works with Privy authentication - just pass the authenticated state.
+ *
  * @example
  * ```tsx
  * import { SettlrProvider } from '@settlr/sdk';
+ * import { usePrivy } from '@privy-io/react-auth';
  *
  * function App() {
+ *   const { authenticated } = usePrivy();
+ *
  *   return (
- *     <WalletProvider wallets={wallets}>
- *       <SettlrProvider config={{
+ *     <SettlrProvider
+ *       authenticated={authenticated}
+ *       config={{
+ *         apiKey: 'sk_live_xxxxxxxxxxxx',
  *         merchant: {
- *           name: 'My Store',
+ *           name: 'My Game',
  *           walletAddress: 'YOUR_WALLET',
  *         },
- *       }}>
- *         <YourApp />
- *       </SettlrProvider>
- *     </WalletProvider>
+ *       }}
+ *     >
+ *       <YourApp />
+ *     </SettlrProvider>
  *   );
  * }
  * ```
  */
-declare function SettlrProvider({ children, config }: SettlrProviderProps): react_jsx_runtime.JSX.Element;
+declare function SettlrProvider({ children, config, authenticated, }: SettlrProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * useSettlr hook - Access Settlr functionality in your components
  *
@@ -371,23 +411,17 @@ declare function SettlrProvider({ children, config }: SettlrProviderProps): reac
  * import { useSettlr } from '@settlr/sdk';
  *
  * function CheckoutButton() {
- *   const { createPayment, pay, connected } = useSettlr();
- *
- *   const handlePay = async () => {
- *     // Option 1: Create payment link
- *     const payment = await createPayment({ amount: 29.99 });
- *     window.location.href = payment.checkoutUrl;
+ *   const { getCheckoutUrl, authenticated } = useSettlr();
  *
- *     // Option 2: Direct payment
- *     const result = await pay({ amount: 29.99 });
- *     if (result.success) {
- *       console.log('Paid!');
- *     }
+ *   const handleCheckout = () => {
+ *     // Redirect to Settlr checkout (handles Privy auth internally)
+ *     const url = getCheckoutUrl({ amount: 29.99, memo: 'Premium Pack' });
+ *     window.location.href = url;
  *   };
  *
  *   return (
- *     <button onClick={handlePay} disabled={!connected}>
- *       Pay $29.99
+ *     <button onClick={handleCheckout}>
+ *       Buy Premium Pack - $29.99
  *     </button>
  *   );
  * }
@@ -455,7 +489,8 @@ interface BuyButtonProps {
     /** Button size */
     size?: "sm" | "md" | "lg";
 }
-declare function BuyButton({ amount, memo, orderId, children, onSuccess, onError, onProcessing, useRedirect, successUrl, cancelUrl, className, style, disabled, variant, size, }: BuyButtonProps): react_jsx_runtime.JSX.Element;
+declare function BuyButton({ amount, memo, orderId, children, onSuccess, onError, onProcessing, useRedirect, // Default to redirect flow (works with Privy)
+successUrl, cancelUrl, className, style, disabled, variant, size, }: BuyButtonProps): react_jsx_runtime.JSX.Element;
 /**
  * Checkout Widget - Embeddable checkout form
  *

package/dist/index.d.ts

@@ -5,8 +5,8 @@ import { ReactNode, CSSProperties } from 'react';
 declare const USDC_MINT_DEVNET: PublicKey;
 declare const USDC_MINT_MAINNET: PublicKey;
 declare const SETTLR_CHECKOUT_URL: {
-    readonly production: "https://settlr.dev/pay";
-    readonly development: "http://localhost:3000/pay";
+    readonly production: "https://settlr.dev/checkout";
+    readonly development: "http://localhost:3000/checkout";
 };
 declare const SUPPORTED_NETWORKS: readonly ["devnet", "mainnet-beta"];
 type SupportedNetwork = typeof SUPPORTED_NETWORKS[number];
@@ -182,6 +182,30 @@ declare class Settlr {
      * Get the current tier
      */
     getTier(): 'free' | 'pro' | 'enterprise' | undefined;
+    /**
+     * Get a checkout URL for redirect-based payments
+     *
+     * This is the simplest integration - just redirect users to this URL.
+     * Settlr handles auth (email or wallet) and payment processing.
+     *
+     * @example
+     * ```typescript
+     * const url = settlr.getCheckoutUrl({
+     *   amount: 29.99,
+     *   memo: 'Premium Pack',
+     * });
+     *
+     * // Redirect user to checkout
+     * window.location.href = url;
+     * ```
+     */
+    getCheckoutUrl(options: {
+        amount: number;
+        memo?: string;
+        orderId?: string;
+        successUrl?: string;
+        cancelUrl?: string;
+    }): string;
     /**
      * Create a payment link
      *
@@ -314,21 +338,28 @@ declare function parseUSDC(amount: number | string): bigint;
  */
 declare function shortenAddress(address: string, chars?: number): string;
 
+/**
+ * Checkout URL options
+ */
+interface CheckoutUrlOptions {
+    amount: number;
+    memo?: string;
+    orderId?: string;
+    successUrl?: string;
+    cancelUrl?: string;
+}
 /**
  * Settlr context value
  */
 interface SettlrContextValue {
     /** Settlr client instance */
     settlr: Settlr | null;
-    /** Whether wallet is connected */
-    connected: boolean;
-    /** Create a payment link */
+    /** Whether user is authenticated */
+    authenticated: boolean;
+    /** Create a payment link (redirect flow) */
     createPayment: (options: CreatePaymentOptions) => Promise<Payment>;
-    /** Execute a direct payment */
-    pay: (options: {
-        amount: number;
-        memo?: string;
-    }) => Promise<PaymentResult>;
+    /** Generate checkout URL for redirect */
+    getCheckoutUrl: (options: CheckoutUrlOptions) => string;
     /** Get merchant's USDC balance */
     getBalance: () => Promise<number>;
 }
@@ -337,32 +368,41 @@ interface SettlrContextValue {
  */
 interface SettlrProviderProps {
     children: ReactNode;
-    config: Omit<SettlrConfig, "rpcEndpoint">;
+    config: SettlrConfig;
+    /** Whether user is authenticated (from Privy or other auth) */
+    authenticated?: boolean;
 }
 /**
  * Settlr Provider - Wraps your app to provide Settlr functionality
  *
+ * Works with Privy authentication - just pass the authenticated state.
+ *
  * @example
  * ```tsx
  * import { SettlrProvider } from '@settlr/sdk';
+ * import { usePrivy } from '@privy-io/react-auth';
  *
  * function App() {
+ *   const { authenticated } = usePrivy();
+ *
  *   return (
- *     <WalletProvider wallets={wallets}>
- *       <SettlrProvider config={{
+ *     <SettlrProvider
+ *       authenticated={authenticated}
+ *       config={{
+ *         apiKey: 'sk_live_xxxxxxxxxxxx',
  *         merchant: {
- *           name: 'My Store',
+ *           name: 'My Game',
  *           walletAddress: 'YOUR_WALLET',
  *         },
- *       }}>
- *         <YourApp />
- *       </SettlrProvider>
- *     </WalletProvider>
+ *       }}
+ *     >
+ *       <YourApp />
+ *     </SettlrProvider>
  *   );
  * }
  * ```
  */
-declare function SettlrProvider({ children, config }: SettlrProviderProps): react_jsx_runtime.JSX.Element;
+declare function SettlrProvider({ children, config, authenticated, }: SettlrProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * useSettlr hook - Access Settlr functionality in your components
  *
@@ -371,23 +411,17 @@ declare function SettlrProvider({ children, config }: SettlrProviderProps): reac
  * import { useSettlr } from '@settlr/sdk';
  *
  * function CheckoutButton() {
- *   const { createPayment, pay, connected } = useSettlr();
- *
- *   const handlePay = async () => {
- *     // Option 1: Create payment link
- *     const payment = await createPayment({ amount: 29.99 });
- *     window.location.href = payment.checkoutUrl;
+ *   const { getCheckoutUrl, authenticated } = useSettlr();
  *
- *     // Option 2: Direct payment
- *     const result = await pay({ amount: 29.99 });
- *     if (result.success) {
- *       console.log('Paid!');
- *     }
+ *   const handleCheckout = () => {
+ *     // Redirect to Settlr checkout (handles Privy auth internally)
+ *     const url = getCheckoutUrl({ amount: 29.99, memo: 'Premium Pack' });
+ *     window.location.href = url;
  *   };
  *
  *   return (
- *     <button onClick={handlePay} disabled={!connected}>
- *       Pay $29.99
+ *     <button onClick={handleCheckout}>
+ *       Buy Premium Pack - $29.99
  *     </button>
  *   );
  * }
@@ -455,7 +489,8 @@ interface BuyButtonProps {
     /** Button size */
     size?: "sm" | "md" | "lg";
 }
-declare function BuyButton({ amount, memo, orderId, children, onSuccess, onError, onProcessing, useRedirect, successUrl, cancelUrl, className, style, disabled, variant, size, }: BuyButtonProps): react_jsx_runtime.JSX.Element;
+declare function BuyButton({ amount, memo, orderId, children, onSuccess, onError, onProcessing, useRedirect, // Default to redirect flow (works with Privy)
+successUrl, cancelUrl, className, style, disabled, variant, size, }: BuyButtonProps): react_jsx_runtime.JSX.Element;
 /**
  * Checkout Widget - Embeddable checkout form
  *

package/dist/index.js

@@ -62,8 +62,8 @@ var SETTLR_API_URL = {
   development: "http://localhost:3000/api"
 };
 var SETTLR_CHECKOUT_URL = {
-  production: "https://settlr.dev/pay",
-  development: "http://localhost:3000/pay"
+  production: "https://settlr.dev/checkout",
+  development: "http://localhost:3000/checkout"
 };
 var SUPPORTED_NETWORKS = ["devnet", "mainnet-beta"];
 var USDC_DECIMALS = 6;
@@ -188,6 +188,37 @@ var Settlr = class {
   getTier() {
     return this.tier;
   }
+  /**
+   * Get a checkout URL for redirect-based payments
+   * 
+   * This is the simplest integration - just redirect users to this URL.
+   * Settlr handles auth (email or wallet) and payment processing.
+   * 
+   * @example
+   * ```typescript
+   * const url = settlr.getCheckoutUrl({
+   *   amount: 29.99,
+   *   memo: 'Premium Pack',
+   * });
+   * 
+   * // Redirect user to checkout
+   * window.location.href = url;
+   * ```
+   */
+  getCheckoutUrl(options) {
+    const { amount, memo, orderId, successUrl, cancelUrl } = options;
+    const baseUrl = this.config.testMode ? SETTLR_CHECKOUT_URL.development : SETTLR_CHECKOUT_URL.production;
+    const params = new URLSearchParams({
+      amount: amount.toString(),
+      merchant: this.config.merchant.name,
+      to: this.config.merchant.walletAddress
+    });
+    if (memo) params.set("memo", memo);
+    if (orderId) params.set("orderId", orderId);
+    if (successUrl) params.set("successUrl", successUrl);
+    if (cancelUrl) params.set("cancelUrl", cancelUrl);
+    return `${baseUrl}?${params.toString()}`;
+  }
   /**
    * Create a payment link
    * 
@@ -221,8 +252,8 @@ var Settlr = class {
     });
     if (memo) params.set("memo", memo);
     if (orderId) params.set("orderId", orderId);
-    if (successUrl) params.set("successUrl", successUrl);
-    if (cancelUrl) params.set("cancelUrl", cancelUrl);
+    if (successUrl) params.set("success", successUrl);
+    if (cancelUrl) params.set("cancel", cancelUrl);
     if (paymentId) params.set("paymentId", paymentId);
     const checkoutUrl = `${baseUrl}?${params.toString()}`;
     const qrCode = await this.generateQRCode(checkoutUrl);
@@ -466,49 +497,34 @@ var Settlr = class {
 
 // src/react.tsx
 var import_react = require("react");
-var import_wallet_adapter_react = require("@solana/wallet-adapter-react");
 var import_jsx_runtime = require("react/jsx-runtime");
 var SettlrContext = (0, import_react.createContext)(null);
-function SettlrProvider({ children, config }) {
-  const { connection } = (0, import_wallet_adapter_react.useConnection)();
-  const wallet = (0, import_wallet_adapter_react.useWallet)();
+function SettlrProvider({
+  children,
+  config,
+  authenticated = false
+}) {
   const settlr = (0, import_react.useMemo)(() => {
     return new Settlr({
       ...config,
-      rpcEndpoint: connection.rpcEndpoint
+      rpcEndpoint: config.rpcEndpoint ?? "https://api.devnet.solana.com"
     });
-  }, [config, connection.rpcEndpoint]);
+  }, [config]);
   const value = (0, import_react.useMemo)(
     () => ({
       settlr,
-      connected: wallet.connected,
+      authenticated,
       createPayment: (options) => {
         return settlr.createPayment(options);
       },
-      pay: async (options) => {
-        if (!wallet.publicKey || !wallet.signTransaction) {
-          return {
-            success: false,
-            signature: "",
-            amount: options.amount,
-            merchantAddress: settlr.getMerchantAddress().toBase58(),
-            error: "Wallet not connected"
-          };
-        }
-        return settlr.pay({
-          wallet: {
-            publicKey: wallet.publicKey,
-            signTransaction: wallet.signTransaction
-          },
-          amount: options.amount,
-          memo: options.memo
-        });
+      getCheckoutUrl: (options) => {
+        return settlr.getCheckoutUrl(options);
       },
       getBalance: () => {
         return settlr.getMerchantBalance();
       }
     }),
-    [settlr, wallet]
+    [settlr, authenticated]
   );
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SettlrContext.Provider, { value, children });
 }
@@ -578,7 +594,8 @@ function BuyButton({
   onSuccess,
   onError,
   onProcessing,
-  useRedirect = false,
+  useRedirect = true,
+  // Default to redirect flow (works with Privy)
   successUrl,
   cancelUrl,
   className,
@@ -587,7 +604,7 @@ function BuyButton({
   variant = "primary",
   size = "md"
 }) {
-  const { pay, createPayment, connected } = useSettlr();
+  const { getCheckoutUrl, createPayment } = useSettlr();
   const [loading, setLoading] = (0, import_react2.useState)(false);
   const [status, setStatus] = (0, import_react2.useState)("idle");
   const handleClick = (0, import_react2.useCallback)(async () => {
@@ -596,32 +613,17 @@ function BuyButton({
     setStatus("processing");
     onProcessing?.();
     try {
-      if (useRedirect) {
-        const payment = await createPayment({
-          amount,
-          memo,
-          orderId,
-          successUrl,
-          cancelUrl
-        });
-        window.location.href = payment.checkoutUrl;
-      } else {
-        const result = await pay({ amount, memo });
-        if (result.success) {
-          setStatus("success");
-          onSuccess?.({
-            signature: result.signature,
-            amount: result.amount,
-            merchantAddress: result.merchantAddress
-          });
-        } else {
-          throw new Error(result.error || "Payment failed");
-        }
-      }
+      const url = getCheckoutUrl({
+        amount,
+        memo,
+        orderId,
+        successUrl,
+        cancelUrl
+      });
+      window.location.href = url;
     } catch (error) {
       setStatus("error");
       onError?.(error instanceof Error ? error : new Error("Payment failed"));
-    } finally {
       setLoading(false);
     }
   }, [
@@ -630,12 +632,9 @@ function BuyButton({
     orderId,
     disabled,
     loading,
-    useRedirect,
     successUrl,
     cancelUrl,
-    pay,
-    createPayment,
-    onSuccess,
+    getCheckoutUrl,
     onError,
     onProcessing
   ]);
@@ -655,11 +654,11 @@ function BuyButton({
     "button",
     {
       onClick: handleClick,
-      disabled: disabled || loading || !connected,
+      disabled: disabled || loading,
       className,
       style: buttonStyle,
       type: "button",
-      children: !connected ? "Connect Wallet" : buttonContent
+      children: buttonContent
     }
   );
 }
@@ -783,7 +782,7 @@ function CheckoutWidget({
   theme = "dark",
   showBranding = true
 }) {
-  const { connected } = useSettlr();
+  const { getCheckoutUrl } = useSettlr();
   const [status, setStatus] = (0, import_react2.useState)("idle");
   const containerStyle = {
     ...widgetStyles.container,

package/dist/index.mjs

@@ -22,8 +22,8 @@ var SETTLR_API_URL = {
   development: "http://localhost:3000/api"
 };
 var SETTLR_CHECKOUT_URL = {
-  production: "https://settlr.dev/pay",
-  development: "http://localhost:3000/pay"
+  production: "https://settlr.dev/checkout",
+  development: "http://localhost:3000/checkout"
 };
 var SUPPORTED_NETWORKS = ["devnet", "mainnet-beta"];
 var USDC_DECIMALS = 6;
@@ -148,6 +148,37 @@ var Settlr = class {
   getTier() {
     return this.tier;
   }
+  /**
+   * Get a checkout URL for redirect-based payments
+   * 
+   * This is the simplest integration - just redirect users to this URL.
+   * Settlr handles auth (email or wallet) and payment processing.
+   * 
+   * @example
+   * ```typescript
+   * const url = settlr.getCheckoutUrl({
+   *   amount: 29.99,
+   *   memo: 'Premium Pack',
+   * });
+   * 
+   * // Redirect user to checkout
+   * window.location.href = url;
+   * ```
+   */
+  getCheckoutUrl(options) {
+    const { amount, memo, orderId, successUrl, cancelUrl } = options;
+    const baseUrl = this.config.testMode ? SETTLR_CHECKOUT_URL.development : SETTLR_CHECKOUT_URL.production;
+    const params = new URLSearchParams({
+      amount: amount.toString(),
+      merchant: this.config.merchant.name,
+      to: this.config.merchant.walletAddress
+    });
+    if (memo) params.set("memo", memo);
+    if (orderId) params.set("orderId", orderId);
+    if (successUrl) params.set("successUrl", successUrl);
+    if (cancelUrl) params.set("cancelUrl", cancelUrl);
+    return `${baseUrl}?${params.toString()}`;
+  }
   /**
    * Create a payment link
    * 
@@ -181,8 +212,8 @@ var Settlr = class {
     });
     if (memo) params.set("memo", memo);
     if (orderId) params.set("orderId", orderId);
-    if (successUrl) params.set("successUrl", successUrl);
-    if (cancelUrl) params.set("cancelUrl", cancelUrl);
+    if (successUrl) params.set("success", successUrl);
+    if (cancelUrl) params.set("cancel", cancelUrl);
     if (paymentId) params.set("paymentId", paymentId);
     const checkoutUrl = `${baseUrl}?${params.toString()}`;
     const qrCode = await this.generateQRCode(checkoutUrl);
@@ -426,49 +457,34 @@ var Settlr = class {
 
 // src/react.tsx
 import { createContext, useContext, useMemo } from "react";
-import { useConnection, useWallet } from "@solana/wallet-adapter-react";
 import { jsx } from "react/jsx-runtime";
 var SettlrContext = createContext(null);
-function SettlrProvider({ children, config }) {
-  const { connection } = useConnection();
-  const wallet = useWallet();
+function SettlrProvider({
+  children,
+  config,
+  authenticated = false
+}) {
   const settlr = useMemo(() => {
     return new Settlr({
       ...config,
-      rpcEndpoint: connection.rpcEndpoint
+      rpcEndpoint: config.rpcEndpoint ?? "https://api.devnet.solana.com"
     });
-  }, [config, connection.rpcEndpoint]);
+  }, [config]);
   const value = useMemo(
     () => ({
       settlr,
-      connected: wallet.connected,
+      authenticated,
       createPayment: (options) => {
         return settlr.createPayment(options);
       },
-      pay: async (options) => {
-        if (!wallet.publicKey || !wallet.signTransaction) {
-          return {
-            success: false,
-            signature: "",
-            amount: options.amount,
-            merchantAddress: settlr.getMerchantAddress().toBase58(),
-            error: "Wallet not connected"
-          };
-        }
-        return settlr.pay({
-          wallet: {
-            publicKey: wallet.publicKey,
-            signTransaction: wallet.signTransaction
-          },
-          amount: options.amount,
-          memo: options.memo
-        });
+      getCheckoutUrl: (options) => {
+        return settlr.getCheckoutUrl(options);
       },
       getBalance: () => {
         return settlr.getMerchantBalance();
       }
     }),
-    [settlr, wallet]
+    [settlr, authenticated]
   );
   return /* @__PURE__ */ jsx(SettlrContext.Provider, { value, children });
 }
@@ -541,7 +557,8 @@ function BuyButton({
   onSuccess,
   onError,
   onProcessing,
-  useRedirect = false,
+  useRedirect = true,
+  // Default to redirect flow (works with Privy)
   successUrl,
   cancelUrl,
   className,
@@ -550,7 +567,7 @@ function BuyButton({
   variant = "primary",
   size = "md"
 }) {
-  const { pay, createPayment, connected } = useSettlr();
+  const { getCheckoutUrl, createPayment } = useSettlr();
   const [loading, setLoading] = useState(false);
   const [status, setStatus] = useState("idle");
   const handleClick = useCallback(async () => {
@@ -559,32 +576,17 @@ function BuyButton({
     setStatus("processing");
     onProcessing?.();
     try {
-      if (useRedirect) {
-        const payment = await createPayment({
-          amount,
-          memo,
-          orderId,
-          successUrl,
-          cancelUrl
-        });
-        window.location.href = payment.checkoutUrl;
-      } else {
-        const result = await pay({ amount, memo });
-        if (result.success) {
-          setStatus("success");
-          onSuccess?.({
-            signature: result.signature,
-            amount: result.amount,
-            merchantAddress: result.merchantAddress
-          });
-        } else {
-          throw new Error(result.error || "Payment failed");
-        }
-      }
+      const url = getCheckoutUrl({
+        amount,
+        memo,
+        orderId,
+        successUrl,
+        cancelUrl
+      });
+      window.location.href = url;
     } catch (error) {
       setStatus("error");
       onError?.(error instanceof Error ? error : new Error("Payment failed"));
-    } finally {
       setLoading(false);
     }
   }, [
@@ -593,12 +595,9 @@ function BuyButton({
     orderId,
     disabled,
     loading,
-    useRedirect,
     successUrl,
     cancelUrl,
-    pay,
-    createPayment,
-    onSuccess,
+    getCheckoutUrl,
     onError,
     onProcessing
   ]);
@@ -618,11 +617,11 @@ function BuyButton({
     "button",
     {
       onClick: handleClick,
-      disabled: disabled || loading || !connected,
+      disabled: disabled || loading,
       className,
       style: buttonStyle,
       type: "button",
-      children: !connected ? "Connect Wallet" : buttonContent
+      children: buttonContent
     }
   );
 }
@@ -746,7 +745,7 @@ function CheckoutWidget({
   theme = "dark",
   showBranding = true
 }) {
-  const { connected } = useSettlr();
+  const { getCheckoutUrl } = useSettlr();
   const [status, setStatus] = useState("idle");
   const containerStyle = {
     ...widgetStyles.container,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@settlr/sdk",
-  "version": "0.1.0",
-  "description": "Solana USDC payments in 7 lines of code",
+  "version": "0.2.0",
+  "description": "Solana USDC payments for games - email checkout, no wallet required",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -36,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ABFX15/x402-hack-payment"
+    "url": "git+https://github.com/ABFX15/x402-hack-payment.git"
   },
   "homepage": "https://settlr.dev",
   "dependencies": {
@@ -44,7 +44,6 @@
     "@solana/web3.js": "^1.98.0"
   },
   "devDependencies": {
-    "@solana/wallet-adapter-react": "^0.15.39",
     "@types/node": "^20.0.0",
     "@types/react": "^19.2.7",
     "react": "^19.2.3",
@@ -52,10 +51,10 @@
     "typescript": "^5.0.0"
   },
   "peerDependencies": {
-    "@solana/wallet-adapter-base": ">=0.9.0"
+    "react": ">=18.0.0"
   },
   "peerDependenciesMeta": {
-    "@solana/wallet-adapter-base": {
+    "react": {
       "optional": true
     }
   },