@chainberry/berry-signer 1.0.1 → 1.0.3

package/README.md

@@ -92,18 +92,93 @@ const { bocBase64, txHash } = signTonTransaction(privateKeyHex, {
 // txHash is the pre-computed transaction hash (needed for TON broadcast fallback)
 ```
 
+## Full Example — EVM
+
+The client prepares the unsigned transaction, signs it locally, then sends the signed tx to the server for broadcast.
+
+**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
+  nonce,
+  gasLimit: "21000",
+  maxFeePerGas: feeData.maxFeePerGas.toString(),
+  maxPriorityFeePerGas: feeData.maxPriorityFeePerGas.toString(),
+  value: ethers.parseEther("0.01").toString(),
+};
+
+// 3. Sign locally — private key never leaves the client
+const signedTx = await signEvmTransaction(privateKeyHex, unsignedTx);
+
+// 4. Send signed tx to server for broadcast
+await fetch("/api/broadcast", { method: "POST", body: JSON.stringify({ signedTx }) });
+```
+
+**Server — broadcast only:**
+```ts
+const tx = await provider.broadcastTransaction(signedTx);
+console.log("txHash:", tx.hash);
+```
+
+## Full Example — TON
+
+**Client — prepare + sign:**
+```ts
+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, init will be included automatically
+
+// 2. Sign locally
+const { bocBase64, txHash } = signTonTransaction(privateKeyHex, {
+  toAddress: "UQA...",
+  amount: "1.5",
+  seqno,
+});
+
+// 3. Send to server for broadcast
+await fetch("/api/broadcast", { method: "POST", body: JSON.stringify({ bocBase64, txHash }) });
+```
+
+**Server — broadcast only:**
+```ts
+await fetch("https://toncenter.com/api/v2/sendBoc", {
+  method: "POST",
+  body: JSON.stringify({ boc: bocBase64 }),
+});
+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.1",
+  "version": "1.0.3",
   "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"],