@settlr/sdk 0.4.2 → 0.4.4

package/README.md

@@ -4,19 +4,21 @@
 [![npm downloads](https://img.shields.io/npm/dm/@settlr/sdk.svg)](https://www.npmjs.com/package/@settlr/sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> **Settlr** - Accept Solana USDC payments in games and apps. Email checkout, gasless transactions, no wallet required.
+> **Accept crypto payments without wallets.** Customers pay with email. You get USDC instantly.
 
 🌐 **Website:** [settlr.dev](https://settlr.dev)  
 📖 **Docs:** [settlr.dev/docs](https://settlr.dev/docs)  
-🎮 **Demo:** [settlr.dev/demo](https://settlr.dev/demo)
+🎮 **Demo:** [settlr.dev/demo](https://settlr.dev/demo)  
+💻 **GitHub:** [github.com/ABFX15/x402-hack-payment](https://github.com/ABFX15/x402-hack-payment)
 
 ## Why Settlr?
 
-- ✅ **No wallet required** - Users pay with just an email
-- ✅ **Gasless transactions** - No SOL needed for fees
-- ✅ **USDC on Solana** - Fast, cheap, stable payments
-- ✅ **Drop-in components** - React components ready to use
-- ✅ **Gaming focused** - Built for in-game purchases
+- ✅ **No wallet required** - Customers pay with just an email
+- ✅ **Zero gas fees** - No SOL needed, ever (Kora gasless)
+- ✅ **Pay from any chain** - Accept USDC from Ethereum, Base, Arbitrum, Polygon, Optimism (Mayan)
+- ✅ **Instant settlement** - USDC direct to your Solana wallet
+- ✅ **One component** - Drop-in React `<BuyButton>`
+- ✅ **2% flat fee** - No hidden costs
 
 ## Installation
 
@@ -28,7 +30,7 @@ npm install @settlr/sdk
 
 ### 1. Get Your API Key
 
-Sign up at [settlr.app/dashboard](https://settlr.app/dashboard) and create an API key.
+Sign up at [settlr.dev/onboarding](https://settlr.dev/onboarding) to register your business and get an API key. Your wallet address is linked to your API key automatically.
 
 ### 2. Create a Payment Link
 
@@ -36,10 +38,10 @@ Sign up at [settlr.app/dashboard](https://settlr.app/dashboard) and create an AP
 import { Settlr } from "@settlr/sdk";
 
 const settlr = new Settlr({
-  apiKey: "sk_live_xxxxxxxxxxxx", // Your API key
+  apiKey: "sk_live_xxxxxxxxxxxx", // Your API key from dashboard
   merchant: {
     name: "My Store",
-    walletAddress: "YOUR_SOLANA_WALLET_ADDRESS",
+    // walletAddress is optional - automatically fetched from your API key
   },
 });
 
@@ -52,6 +54,8 @@ const payment = await settlr.createPayment({
 window.location.href = payment.checkoutUrl;
 ```
 
+> **Note:** When you register at [settlr.dev/onboarding](https://settlr.dev/onboarding), your wallet address is linked to your API key. The SDK automatically fetches it - no need to include it in your code!
+
 ### 3. Drop-in Buy Button ⭐ NEW
 
 The easiest way to accept payments - just drop in a button:
@@ -64,7 +68,7 @@ function App() {
     <SettlrProvider
       config={{
         apiKey: "sk_live_xxxxxxxxxxxx",
-        merchant: { name: "GameStore", walletAddress: "YOUR_WALLET" },
+        merchant: { name: "GameStore" }, // Wallet fetched from API key
       }}
     >
       <BuyButton
@@ -108,6 +112,21 @@ Settlr checkout handles authentication via Privy:
 
 No wallet-adapter setup needed. Just redirect to checkout.
 
+### Multichain Payments
+
+Customers can pay with USDC from any supported chain. Settlr automatically bridges funds to your Solana wallet via Mayan:
+
+| Source Chain | Bridge Time | Gas Cost       |
+| ------------ | ----------- | -------------- |
+| Solana       | Instant     | Free (gasless) |
+| Base         | ~1-2 min    | ~$0.01         |
+| Arbitrum     | ~1-2 min    | ~$0.01         |
+| Optimism     | ~1-2 min    | ~$0.01         |
+| Polygon      | ~1-2 min    | ~$0.01         |
+| Ethereum     | ~1-3 min    | ~$1-5          |
+
+**You only need a Solana wallet** - cross-chain bridging is automatic.
+
 ### React Hook
 
 ```tsx
@@ -120,7 +139,7 @@ function App() {
         apiKey: "sk_live_xxxxxxxxxxxx",
         merchant: {
           name: "My Game",
-          walletAddress: "YOUR_WALLET",
+          // walletAddress optional - linked to your API key
         },
       }}
     >
@@ -245,9 +264,10 @@ Main client class.
 
 ```typescript
 interface SettlrConfig {
+  apiKey: string; // Required: your API key from dashboard
   merchant: {
     name: string;
-    walletAddress: string;
+    walletAddress?: string; // Optional: auto-fetched from API key
     logoUrl?: string;
     webhookUrl?: string;
   };
@@ -257,6 +277,8 @@ interface SettlrConfig {
 }
 ```
 
+> **Tip:** When you register at [settlr.dev/onboarding](https://settlr.dev/onboarding), your wallet address is linked to your API key. You don't need to specify it in the config!
+
 #### Methods
 
 ##### `createPayment(options)`

package/dist/index.js

@@ -633,7 +633,7 @@ var defaultStyles = {
     fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif'
   },
   primary: {
-    background: "linear-gradient(135deg, #f472b6 0%, #67e8f9 100%)",
+    background: "linear-gradient(135deg, rgb(168, 85, 247) 0%, rgb(34, 211, 238) 100%)",
     color: "white"
   },
   secondary: {
@@ -643,8 +643,8 @@ var defaultStyles = {
   },
   outline: {
     background: "transparent",
-    color: "#f472b6",
-    border: "2px solid #f472b6"
+    color: "rgb(168, 85, 247)",
+    border: "2px solid rgb(168, 85, 247)"
   },
   sm: {
     padding: "8px 16px",

package/dist/index.mjs

@@ -590,7 +590,7 @@ var defaultStyles = {
     fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif'
   },
   primary: {
-    background: "linear-gradient(135deg, #f472b6 0%, #67e8f9 100%)",
+    background: "linear-gradient(135deg, rgb(168, 85, 247) 0%, rgb(34, 211, 238) 100%)",
     color: "white"
   },
   secondary: {
@@ -600,8 +600,8 @@ var defaultStyles = {
   },
   outline: {
     background: "transparent",
-    color: "#f472b6",
-    border: "2px solid #f472b6"
+    color: "rgb(168, 85, 247)",
+    border: "2px solid rgb(168, 85, 247)"
   },
   sm: {
     padding: "8px 16px",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@settlr/sdk",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Settlr SDK - Accept Solana USDC payments in games and apps. Email checkout, gasless transactions, no wallet required. The easiest way to add crypto payments.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",