@kwespay/widget 1.0.7 → 1.0.8

package/Readme.MD

@@ -1,12 +1,20 @@
 # @kwespay/widget
 
-> Accept crypto payments in 3 lines of code — drop-in JavaScript widget for EVM chains.
+> Accept crypto payments on any EVM chain with a single JavaScript widget.
 
 [![npm version](https://img.shields.io/npm/v/@kwespay/widget)](https://www.npmjs.com/package/@kwespay/widget)
 [![license](https://img.shields.io/npm/l/@kwespay/widget)](LICENSE)
 
 ---
 
+## Get Started
+
+1. Create a merchant account at [app.kwespay.xyz](https://app.kwespay.xyz)
+2. Grab your **API Key** and **Vendor ID** from the dashboard
+3. Install the widget and start accepting payments
+
+---
+
 ## Installation
 
 ```bash
@@ -27,8 +35,8 @@ Or load via CDN (no bundler required):
 import KwesPayWidget from "@kwespay/widget";
 
 const widget = new KwesPayWidget({
-  apiKey: "your_api_key",
-  vendorId: "your_vendor_id",
+  apiKey: "your_api_key", // from app.kwespay.xyz
+  vendorId: "your_vendor_id", // from app.kwespay.xyz
   amount: 10.0,
   currency: "USD",
 });
@@ -36,7 +44,7 @@ const widget = new KwesPayWidget({
 widget.open();
 ```
 
-That's it. The widget handles wallet connection, network switching, token selection, transaction signing, and success/error states.
+The widget handles everything — wallet connection, network switching, token selection, transaction signing, and success/error states.
 
 ---
 
@@ -44,11 +52,11 @@ That's it. The widget handles wallet connection, network switching, token select
 
 ```js
 const widget = new KwesPayWidget({
-  apiKey: "your_api_key", // Required — your KwesPay API key
-  vendorId: "your_vendor_id", // Required — your merchant identifier
+  apiKey: "your_api_key", // Required — from app.kwespay.xyz
+  vendorId: "your_vendor_id", // Required — from app.kwespay.xyz
   amount: 25.0, // Required — fiat amount to charge
   currency: "USD", // Optional — "USD" (default) or "GHS"
-  acceptedTokens: ["USDT", "USDC"], // Optional — restrict tokens. Pass "stablecoins" to allow all stables
+  acceptedTokens: ["USDT", "USDC"], // Optional — restrict accepted tokens
 });
 ```
 
@@ -60,7 +68,7 @@ const widget = new KwesPayWidget({
 | `"stablecoins"`    | USDT, USDC, DAI, BUSD, USDc          |
 | `["USDT", "USDC"]` | Only the listed tokens               |
 
-Tokens are also scoped by your API key's network/token permissions set in the KwesPay dashboard.
+Token and network availability is also scoped by the permissions set on your API key in the dashboard.
 
 ---
 
@@ -77,27 +85,23 @@ Tokens are also scoped by your API key's network/token permissions set in the Kw
 | Base Sepolia | 84532    | Testnet |
 | Lisk Sepolia | 4202     | Testnet |
 
-Network and token availability in the widget is automatically filtered by your API key's permitted scope.
-
 ---
 
 ## Methods
 
 ```js
-widget.open(); // Opens the payment widget
-widget.close(); // Closes the widget
+widget.open(); // Open the payment widget
+widget.close(); // Close the widget
 widget.isOpen(); // Returns boolean
-widget.updateAmount(15.0, "USD"); // Update amount without re-creating the widget
-widget.getState(); // Returns current widget + config state
-widget.destroy(); // Removes widget from DOM and cleans up
+widget.updateAmount(15.0, "USD"); // Update amount on the fly
+widget.getState(); // Returns current widget and config state
+widget.destroy(); // Remove widget from DOM and clean up
 ```
 
 ---
 
 ## Events
 
-Listen for widget lifecycle and payment events on the `window`:
-
 ```js
 window.addEventListener("kwespay:paymentSuccess", (e) => {
   const {
@@ -109,7 +113,7 @@ window.addEventListener("kwespay:paymentSuccess", (e) => {
     token,
     network,
   } = e.detail;
-  // Fulfil the order
+  // fulfil your order here
 });
 
 window.addEventListener("kwespay:paymentError", (e) => {
@@ -121,6 +125,7 @@ window.addEventListener("kwespay:paymentCancelled", (e) => {
 });
 
 window.addEventListener("kwespay:widgetOpened", () => {});
+
 window.addEventListener("kwespay:widgetClosed", (e) => {
   console.log(e.detail.completedPayment); // boolean
 });
@@ -134,10 +139,8 @@ window.addEventListener("kwespay:apiKeyValidated", (e) => {
 
 ## Wallet Support
 
-- **Injected wallets** (MetaMask, Coinbase Wallet, Rabby, etc.) via EIP-6963
-- **Mobile wallets** via WalletConnect v2 (QR code + deep link)
-
----
+- **Injected wallets** — MetaMask, Coinbase Wallet, Rabby, and any EIP-6963 compatible wallet
+- **Mobile wallets** — WalletConnect v2 via QR code and deep link
 
 ## Examples
 
@@ -148,12 +151,6 @@ window.addEventListener("kwespay:apiKeyValidated", (e) => {
 
 ---
 
-## Fee Model
-
-KwesPay uses a **customer-pays-fee** architecture. The fee is calculated by the backend and signed into the payment payload — the merchant always receives the exact `amount` specified. Fee details are shown to the customer before they confirm the transaction.
-
----
-
 ## License
 
 MIT © KwesPay

package/dist/esm/index.js

@@ -8,7 +8,7 @@ const SUPPORTED_CURRENCIES = {
 const STABLECOIN_SYMBOLS = ["USDT", "USDC", "DAI", "BUSD", "USDc"];
 
 const DEFAULT_CONFIG = {
-  graphqlEndpoint: "https://8284-154-161-98-26.ngrok-free.app",
+  graphqlEndpoint: "https://api.kwespay.xyz/",
   currency: SUPPORTED_CURRENCIES.USD,
 };
 
@@ -97,7 +97,6 @@ const TOKEN_CONFIGS = {
       decimals: 18,
       coingeckoId: "ethereum",
       binanceSymbol: "ETHUSDT",
-      
     },
     {
       symbol: "USDT",
@@ -3183,7 +3182,7 @@ const QuoteMethods = {
     } catch (err) {
       console.error("[KwesPayWidget] Quote fetch failed:", err.message);
       if (cryptoLine) {
-        cryptoLine.textContent = "Could not load rate — please try again.";
+        cryptoLine.textContent = "Could not load please try again.";
         cryptoLine.classList.remove("loading");
       }
       if (proceedBtn) proceedBtn.disabled = true;

package/dist/kwespay-widget.js

@@ -14,7 +14,7 @@
   const STABLECOIN_SYMBOLS = ["USDT", "USDC", "DAI", "BUSD", "USDc"];
 
   const DEFAULT_CONFIG = {
-    graphqlEndpoint: "https://8284-154-161-98-26.ngrok-free.app",
+    graphqlEndpoint: "https://api.kwespay.xyz/",
     currency: SUPPORTED_CURRENCIES.USD,
   };
 
@@ -103,7 +103,6 @@
         decimals: 18,
         coingeckoId: "ethereum",
         binanceSymbol: "ETHUSDT",
-        
       },
       {
         symbol: "USDT",
@@ -19129,7 +19128,7 @@ ${e.length}`,n=new TextEncoder().encode(t+e);return "0x"+toString$1(keccak_256$3
       } catch (err) {
         console.error("[KwesPayWidget] Quote fetch failed:", err.message);
         if (cryptoLine) {
-          cryptoLine.textContent = "Could not load rate — please try again.";
+          cryptoLine.textContent = "Could not load please try again.";
           cryptoLine.classList.remove("loading");
         }
         if (proceedBtn) proceedBtn.disabled = true;