ryt-sdk 1.0.8 → 1.0.10

package/dist/wallet.js

@@ -1,81 +1,129 @@
 import { ethers } from "ethers";
 /**
- * RYTWallet is a wallet instance that supports signing transactions and interacting with the blockchain.
+ * Unified wallet abstraction for RYT SDK.
+ *
+ * Supports:
+ * - Private key wallets (Node.js / backend)
+ * - Browser injected wallets (MetaMask, Rabby, etc.)
+ *
+ * Automatically adapts behavior based on runtime environment.
  */
 export default class RYTWallet {
     /**
-     * Create a new RYTWallet instance
+     * Create a new wallet instance.
      *
-     * @param privateKey - Ethereum private key (0x...)
-     * @param provider - Optional RYTProvider instance for network access
+     * The wallet can operate in two modes:
      *
-     * @example
-     * ```ts
+     * 1. Backend mode (private key provided)
+     *    - Full signing capability
+     *    - Used in Node.js scripts, servers, bots
+     *
+     * 2. Browser mode (injected wallet)
+     *    - Uses connected wallet (MetaMask, etc.)
+     *    - No private key required or allowed
+     *
+     * @param signerOrPrivateKey
+     * - string → private key (backend mode)
+     * - signer → injected browser signer
+     *
+     * @param provider Optional provider instance for network access
+     *
+     * @throws Error if invalid input is provided
+     *
+     * @example Backend:
      * const wallet = new RYTWallet(PRIVATE_KEY, provider);
-     * ```
+     *
+     * @example Browser:
+     * const wallet = new RYTWallet(signer);
      */
-    constructor(privateKey, provider) {
-        if (!privateKey) {
-            throw new Error("Private key is required");
+    constructor(signerOrPrivateKey, provider) {
+        if (!signerOrPrivateKey) {
+            throw new Error("Wallet signer or private key is required");
         }
-        // Ensure private key format is valid
-        if (!privateKey.startsWith("0x")) {
-            throw new Error("Invalid private key format: must start with 0x");
+        /**
+         * -----------------------------
+         * Backend mode (private key)
+         * -----------------------------
+         */
+        if (typeof signerOrPrivateKey === "string") {
+            if (!signerOrPrivateKey.startsWith("0x")) {
+                throw new Error("Invalid private key format (must start with 0x)");
+            }
+            const rpcProvider = provider?.getProvider();
+            this.signer = rpcProvider
+                ? new ethers.Wallet(signerOrPrivateKey, rpcProvider)
+                : new ethers.Wallet(signerOrPrivateKey);
+            return;
         }
-        const ethersProvider = provider?.getProvider();
-        this.wallet = ethersProvider
-            ? new ethers.Wallet(privateKey, ethersProvider)
-            : new ethers.Wallet(privateKey);
+        /**
+         * -----------------------------
+         * Browser mode (injected signer)
+         * -----------------------------
+         */
+        this.signer = signerOrPrivateKey;
     }
     /**
-     * Returns the wallet address
+     * Get wallet address.
      *
      * @returns Wallet public address
      *
      * @example
-     * ```ts
-     * const address = wallet.getAddress();
-     * ```
+     * const address = await wallet.getAddress();
      */
-    getAddress() {
-        return this.wallet.address;
+    async getAddress() {
+        return await this.signer.getAddress();
     }
     /**
-     * Get wallet balance in wei
+     * Get wallet balance in wei.
      *
-     * @returns Promise resolving to balance (bigint)
+     * Requires connected provider (RPC or injected).
      *
-     * @throws Error if provider is not connected
+     * @returns Balance in wei
      *
-     * @example
-     * ```ts
-     * const balance = await wallet.getBalance();
-     * ```
+     * @throws Error if provider is not available
      */
     async getBalance() {
-        if (!this.wallet.provider) {
-            throw new Error("Provider not initialized. Attach a provider to fetch balance.");
+        if (!this.signer.provider) {
+            throw new Error("No provider available. Connect wallet or attach provider.");
         }
-        return await this.wallet.provider.getBalance(this.wallet.address);
+        return await this.signer.provider.getBalance(await this.signer.getAddress());
     }
     /**
-     * Send a signed transaction
+     * Send a blockchain transaction.
+     *
+     * Works in both:
+     * - Backend (signed via private key)
+     * - Browser (signed via MetaMask / injected wallet)
      *
-     * @param tx - Transaction object (to, value, data, etc.)
-     * @returns Promise resolving to transaction response
+     * @param tx Transaction request object
+     * @returns Transaction response
      *
      * @example
-     * ```ts
      * await wallet.sendTransaction({
-     *   to: "0xabc...",
-     *   value: ethers.parseEther("0.01")
+     *   to: "0x...",
+     *   value: "0.01"
      * });
-     * ```
      */
     async sendTransaction(tx) {
-        if (!this.wallet) {
+        if (!this.signer) {
             throw new Error("Wallet not initialized");
         }
-        return await this.wallet.sendTransaction(tx);
+        return await this.signer.sendTransaction(tx);
+    }
+    /**
+     * Check if wallet is connected to a provider.
+     *
+     * @returns true if provider is available
+     */
+    isConnected() {
+        return !!this.signer.provider;
+    }
+    /**
+     * Get underlying signer instance.
+     *
+     * Useful for advanced contract interactions.
+     */
+    getSigner() {
+        return this.signer;
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ryt-sdk",
   "type": "module",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "RYT blockchain SDK for provider, wallet, and smart contract interactions",
   "author": "Muhammad Hammad Mubeen",
   "license": "MIT",
@@ -59,12 +59,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Hammad-Mubeen/ryt-sdk.git"
-  },
-  "homepage": "https://ryt-docs.vercel.app",
-  "bugs": {
-    "url": "https://github.com/Hammad-Mubeen/ryt-sdk/issues"
-  }
+  "homepage": "https://ryt-docs.vercel.app"
 }