ryt-sdk 1.0.11 → 1.0.12

package/README.md

@@ -33,7 +33,156 @@ or
 
 <br>
 
-### 🔐 Environment Setup
+### 🌐 Frontend Dapp Setup (Browser Mode)
+
+<br>
+
+RYT SDK supports browser-based dApps using injected wallets such as:
+
+- MetaMask
+- Rabby
+- Coinbase Wallet
+
+No private keys are required in frontend mode.
+
+<br>
+
+### 💻 Frontend Example Dapp
+
+<br>
+
+```javascript
+
+import { useState } from "react";
+
+import {
+  RYTContract,
+  RYTWallet,
+  hasRYT,
+  requestAccounts,
+  RYTProvider,
+  parseTokenUnits,
+} from "ryt-sdk";
+
+const CONTRACT_ADDRESS = process.env.ERC20_ADDRESS; /* deploy erc20 token */ 
+const CHAIN_ID= process.env.CHAIN_ID; /* provide chain id */ 
+
+const ABI = [
+  "function approve(address spender, uint256 value) returns (bool)",
+  "function transfer(address to, uint256 value) returns (bool)",
+  "function decimals() view returns (uint8)",
+];
+
+function App() {
+  const [account, setAccount] = useState<string | null>(null);
+  const [contract, setContract] = useState<RYTContract | null>(null);
+
+  const [recipient, setRecipient] = useState("");
+  const [amount, setAmount] = useState("");
+  const [spender, setSpender] = useState("");
+  const [loading, setLoading] = useState(false);
+  const [txHash, setTxHash] = useState<string | null>(null);
+
+  /**
+   * Connect wallet using RTY SDK
+   */
+  const connectWallet = async () => {
+    try {
+      if (!hasRYT()) {
+        alert("Install MetaMask or compatible wallet");
+        return;
+      }
+
+      setLoading(true);
+
+      // 1. request accounts via SDK
+      const accounts = await requestAccounts();
+      const address = accounts[0];
+
+      // 2. create provider via SDK
+      const provider = new RYTProvider({
+        chainId: CHAIN_ID,
+        rpcUrls: [process.env.RPC_URL] /* provide rpc url */
+      });
+
+      // 3. create wallet
+      const signer = await provider.getSigner();
+      const wallet = new RYTWallet(signer);
+
+      // 4. create contract instance via SDK
+      const rytContract = new RYTContract(
+        CONTRACT_ADDRESS,
+        ABI,
+        wallet
+      );
+
+      setAccount(address);
+      setContract(rytContract);
+    } catch (err) {
+      console.error(err);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  /**
+   * Approve tokens
+   */
+  const handleApprove = async () => {
+    if (!contract) return alert("Connect wallet");
+
+    try {
+      setLoading(true);
+
+      const decimals = await contract.read("decimals");
+
+      const parsed = parseTokenUnits(amount, decimals);
+
+      const tx = await contract.write("approve", spender, parsed);
+
+      setTxHash(tx.hash);
+      await tx.wait();
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  /**
+   * Transfer tokens
+   */
+  const handleTransfer = async () => {
+    if (!contract) return alert("Connect wallet");
+
+    try {
+      setLoading(true);
+
+      const decimals = await contract.read("decimals");
+
+      const parsed = parseTokenUnits(amount, decimals);
+
+      const tx = await contract.write("transfer", recipient, parsed);
+
+      setTxHash(tx.hash);
+      await tx.wait();
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (/* Build your stunning UI here*/);
+}
+
+export default App;
+
+```
+
+<br>
+
+### ⚡ Backend Quickstart Guide
+
+<br>
+
+#### 🔐 Environment Setup
 
 <br>
 
@@ -55,13 +204,18 @@ MATH_LIB_ADDRESS=0xLibraryAddress
 
 <br>
 
-### ⚡ 30-Second Quickstart
+#### 💻 Code Example
+
 <br>
 
+
 ```javascript
-import RYTProvider from "ryt-sdk/provider";
-import RYTWallet from "ryt-sdk/wallet";
-import RYTContract from "ryt-sdk/contract";
+
+import {
+  RYTContract,
+  RYTWallet,
+  RYTProvider
+} from "ryt-sdk";
 
 const provider = new RYTProvider({
   chainId: process.env.CHAIN_ID,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ryt-sdk",
   "type": "module",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "RYT blockchain SDK for provider, wallet, and smart contract interactions",
   "author": "Muhammad Hammad Mubeen",
   "license": "MIT",