@chainberry/berry-signer 1.0.2 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # BerrySigner
 
-Pure signing library for multiple blockchain networks. No network calls — takes an unsigned transaction prepared elsewhere and signs it locally with a private key. Designed to run on the frontend (mobile wallet, browser extension) while the unsigned transaction is prepared on the backend.
+Pure signing library for multiple blockchain networks. No network calls — takes an unsigned transaction and signs it with a private key. Can run anywhere: frontend, mobile wallet, browser extension, or backend.
 
 ## Installation
 
@@ -22,7 +22,7 @@ npm install berry-signer
 
 ## Usage
 
-Each function takes a private key and an unsigned transaction prepared by the backend, and returns a signed transaction ready for broadcast.
+Each function takes a private key and an unsigned transaction prepared elsewhere, and returns a signed transaction ready for broadcast.
 
 ### EVM (ETH, BNB, POL, AVAX, ARB, OP, BASE, SONIC)
 
@@ -94,16 +94,19 @@ const { bocBase64, txHash } = signTonTransaction(privateKeyHex, {
 
 ## Full Example — EVM
 
-This example shows the complete flow: backend prepares the unsigned transaction, frontend signs it, backend broadcasts it.
+The client prepares the unsigned transaction, signs it locally, then sends the signed tx to the server for broadcast.
 
-**Backend (Node.js) — prepare unsigned tx:**
+**Client — prepare + sign:**
 ```ts
 import { ethers } from "ethers";
+import { signEvmTransaction } from "@chainberry/berry-signer";
 
+// 1. Fetch network data
 const provider = new ethers.JsonRpcProvider("https://arb1.arbitrum.io/rpc");
 const feeData = await provider.getFeeData();
 const nonce = await provider.getTransactionCount(fromAddress, "latest");
 
+// 2. Build unsigned tx
 const unsignedTx = {
   to: toAddress,
   chainId: 42161, // Arbitrum
@@ -114,18 +117,14 @@ const unsignedTx = {
   value: ethers.parseEther("0.01").toString(),
 };
 
-// Send unsignedTx to frontend
-```
-
-**Frontend — sign with BerrySigner:**
-```ts
-import { signEvmTransaction } from "@chainberry/berry-signer";
-
+// 3. Sign locally — private key never leaves the client
 const signedTx = await signEvmTransaction(privateKeyHex, unsignedTx);
-// Send signedTx back to backend
+
+// 4. Send signed tx to server for broadcast
+await fetch("/api/broadcast", { method: "POST", body: JSON.stringify({ signedTx }) });
 ```
 
-**Backend — broadcast:**
+**Server — broadcast only:**
 ```ts
 const tx = await provider.broadcastTransaction(signedTx);
 console.log("txHash:", tx.hash);
@@ -133,33 +132,32 @@ console.log("txHash:", tx.hash);
 
 ## Full Example — TON
 
-**Backend — fetch seqno:**
+**Client — prepare + sign:**
 ```ts
-const response = await fetch(
-  "https://toncenter.com/api/v2/runGetMethod",
-  { method: "POST", body: JSON.stringify({ address: walletAddress, method: "seqno", stack: [] }) }
-);
+import { signTonTransaction } from "@chainberry/berry-signer";
+
+// 1. Fetch seqno from network
+const response = await fetch("https://toncenter.com/api/v2/runGetMethod", {
+  method: "POST",
+  body: JSON.stringify({ address: walletAddress, method: "seqno", stack: [] }),
+});
 const data = await response.json();
 const seqno = data.result?.exit_code === 0
   ? parseInt(data.result.stack[0][1], 16)
-  : 0; // 0 = wallet not yet deployed
-
-// Send seqno to frontend
-```
-
-**Frontend — sign:**
-```ts
-import { signTonTransaction } from "@chainberry/berry-signer";
+  : 0; // 0 = wallet not yet deployed, init will be included automatically
 
+// 2. Sign locally
 const { bocBase64, txHash } = signTonTransaction(privateKeyHex, {
   toAddress: "UQA...",
   amount: "1.5",
   seqno,
 });
-// Send bocBase64 and txHash back to backend
+
+// 3. Send to server for broadcast
+await fetch("/api/broadcast", { method: "POST", body: JSON.stringify({ bocBase64, txHash }) });
 ```
 
-**Backend — broadcast:**
+**Server — broadcast only:**
 ```ts
 await fetch("https://toncenter.com/api/v2/sendBoc", {
   method: "POST",
@@ -170,16 +168,17 @@ console.log("txHash:", txHash);
 
 ## Design
 
-The split between signing and broadcasting allows the private key to stay on the client:
+The private key never leaves the client. The client prepares and signs the transaction locally, then sends only the signed tx to the server for broadcast.
 
 ```
-Backend                          Frontend (BerrySigner)         Backend
-  │                                      │                        │
-  │── prepare unsigned tx ──────────────>│                        │
-  │                                      │── sign with key        │
-  │<─────────────────────── signed tx ───│                        │
-  │                                                               │
-  │── broadcast to network ──────────────────────────────────────>│
+Client (BerrySigner)                          Server
+  │                                              │
+  │── fetch nonce/fee/seqno from network ───────>│ (or directly from RPC)
+  │── build unsigned tx                          │
+  │── sign with private key (stays on client)    │
+  │                                              │
+  │── send signed tx ───────────────────────────>│
+  │                                              │── broadcast to network
 ```
 
 ## Private Key Format

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainberry/berry-signer",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "files": ["dist", "README.md"],
   "description": "Pure signing library for multiple blockchain networks — EVM, BTC, LTC, SOL, TRX, XRP, TON",
   "keywords": ["blockchain", "signing", "wallet", "ethereum", "bitcoin", "solana", "tron", "ton", "xrp", "litecoin"],