@chainberry/berry-signer 1.0.1 → 1.0.2

package/README.md

@@ -92,6 +92,82 @@ const { bocBase64, txHash } = signTonTransaction(privateKeyHex, {
 // txHash is the pre-computed transaction hash (needed for TON broadcast fallback)
 ```
 
+## Full Example — EVM
+
+This example shows the complete flow: backend prepares the unsigned transaction, frontend signs it, backend broadcasts it.
+
+**Backend (Node.js) — prepare unsigned tx:**
+```ts
+import { ethers } from "ethers";
+
+const provider = new ethers.JsonRpcProvider("https://arb1.arbitrum.io/rpc");
+const feeData = await provider.getFeeData();
+const nonce = await provider.getTransactionCount(fromAddress, "latest");
+
+const unsignedTx = {
+  to: toAddress,
+  chainId: 42161, // Arbitrum
+  nonce,
+  gasLimit: "21000",
+  maxFeePerGas: feeData.maxFeePerGas.toString(),
+  maxPriorityFeePerGas: feeData.maxPriorityFeePerGas.toString(),
+  value: ethers.parseEther("0.01").toString(),
+};
+
+// Send unsignedTx to frontend
+```
+
+**Frontend — sign with BerrySigner:**
+```ts
+import { signEvmTransaction } from "@chainberry/berry-signer";
+
+const signedTx = await signEvmTransaction(privateKeyHex, unsignedTx);
+// Send signedTx back to backend
+```
+
+**Backend — broadcast:**
+```ts
+const tx = await provider.broadcastTransaction(signedTx);
+console.log("txHash:", tx.hash);
+```
+
+## Full Example — TON
+
+**Backend — fetch seqno:**
+```ts
+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";
+
+const { bocBase64, txHash } = signTonTransaction(privateKeyHex, {
+  toAddress: "UQA...",
+  amount: "1.5",
+  seqno,
+});
+// Send bocBase64 and txHash back to backend
+```
+
+**Backend — broadcast:**
+```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:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainberry/berry-signer",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "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"],