Feature/Transfer balance script (#1)

* bootstrap script added

* transfer balance script added to examples and updated package-lock files

* readme file updated

* address PR comments

Author: ruisereno

examples/custom-rpc/package-lock.json

@@ -1,4 +1,6 @@
 CHAIN_ID=
 PRIVATE_KEY=
 RPC_URL=
-TOKEN_ADDRESS=
+TOKEN_ADDRESS=
+TRANSFER_VALUE_ETH=
+TRANSFER_WALLET_ADDRESS=

examples/ethers-provider-metamask/package-lock.json

@@ -7,7 +7,8 @@ This repository demonstrates how to interact with the Silent Data [Rollup] using
 - Connect to the Silent Data [Rollup] network
 - Retrieve token details (name, symbol, decimals)
 - Transfer tokens to a randomly generated wallet
-- Check token balances
+- Check wallet balances
+- Transfer wallet balances
 
 ## Prerequisites
 
@@ -34,10 +35,12 @@ This repository demonstrates how to interact with the Silent Data [Rollup] using
 3. Create a `.env` file in the root directory and add your environment variables:
 
    ```plaintext
-   RPC_URL=<your_rpc_url>
    CHAIN_ID=<your_chain_id>
    PRIVATE_KEY=<your_private_key>
+   RPC_URL=<your_rpc_url>
    TOKEN_ADDRESS=<your_token_address>
+   TRANSFER_VALUE_ETH=<transfer_to_value>
+   TRANSFER_WALLET_ADDRESS=<transfer_to_private_key>
    ```
 
 ## Usage
@@ -53,3 +56,9 @@ or
 ```bash
 npm run get-balance
 ```
+
+or
+
+```bash
+npm run transfer-balance
+```

examples/ethers-provider-nodejs/.env-example

@@ -2,7 +2,8 @@
   "name": "example-ethers-provider-nodejs",
   "scripts": {
     "contract-interaction": "ts-node src/contract-interaction.ts",
-    "get-balance": "ts-node src/get-balance.ts"
+    "get-balance": "ts-node src/get-balance.ts",
+    "transfer-balance": "ts-node src/transfer-balance.ts"
   },
   "dependencies": {
     "@appliedblockchain/silentdatarollup-core": "file:../../packages/core",

examples/ethers-provider-nodejs/README.md

@@ -84,4 +84,4 @@ const main = async () => {
   console.log('✅ My token balance:', formatEther(balanceAfter), symbol)
 }
 
-main()
+main().catch(console.error)

examples/ethers-provider-nodejs/package-lock.json

@@ -10,9 +10,9 @@ REQUIRED_ENV_VARS.forEach((envVar) => {
   }
 })
 
-const RPC_URL = process.env.RPC_URL as string
 const CHAIN_ID = process.env.CHAIN_ID as string
 const PRIVATE_KEY = process.env.PRIVATE_KEY as string
+const RPC_URL = process.env.RPC_URL as string
 
 const provider = new SilentDataRollupProvider({
   rpcUrl: RPC_URL,
@@ -22,8 +22,9 @@ const provider = new SilentDataRollupProvider({
 
 const main = async () => {
   const wallet = new Wallet(PRIVATE_KEY)
-  const balance = await provider.getBalance(wallet.address)
-  console.log('Balance:', formatEther(balance))
+  const walletAddress = await wallet.getAddress()
+  const balance = await provider.getBalance(walletAddress)
+  console.log(`Balance of "${walletAddress}" is ${formatEther(balance)} ETH`)
 }
 
-main()
+main().catch(console.error)

examples/ethers-provider-nodejs/package.json

@@ -0,0 +1,65 @@
+import 'dotenv/config'
+import { SilentDataRollupProvider } from '@appliedblockchain/silentdatarollup-ethers-provider'
+import { formatEther, parseEther, Wallet } from 'ethers'
+
+const REQUIRED_ENV_VARS = [
+  'CHAIN_ID',
+  'PRIVATE_KEY',
+  'RPC_URL',
+  'TRANSFER_VALUE_ETH',
+  'TRANSFER_WALLET_ADDRESS',
+] as const
+
+REQUIRED_ENV_VARS.forEach((envVar) => {
+  if (!process.env[envVar]) {
+    throw new Error(`${envVar} environment variable is required`)
+  }
+})
+
+const CHAIN_ID = process.env.CHAIN_ID as string
+const PRIVATE_KEY = process.env.PRIVATE_KEY as string
+const RPC_URL = process.env.RPC_URL as string
+const TRANSFER_VALUE_ETH = parseEther(process.env.TRANSFER_VALUE_ETH as string)
+const TRANSFER_WALLET_ADDRESS = process.env.TRANSFER_WALLET_ADDRESS as string
+
+const provider = new SilentDataRollupProvider({
+  rpcUrl: RPC_URL,
+  chainId: Number(CHAIN_ID),
+  privateKey: PRIVATE_KEY,
+})
+
+const main = async () => {
+  const fromWalletAddress = await provider.signer.getAddress()
+
+  const balanceBeforeFrom = await provider.getBalance(fromWalletAddress)
+  console.log(
+    `Balance of "${fromWalletAddress}" is ${formatEther(balanceBeforeFrom)} ETH`,
+  )
+
+  const balanceBeforeTo = await provider.getBalance(TRANSFER_WALLET_ADDRESS)
+  console.log(
+    `Balance of "${TRANSFER_WALLET_ADDRESS}" is ${formatEther(balanceBeforeTo)} ETH\n`,
+  )
+
+  console.log(
+    `Sending ${formatEther(TRANSFER_VALUE_ETH)} ETH from "${fromWalletAddress}" to "${TRANSFER_WALLET_ADDRESS}"`,
+  )
+  const tx = await provider.signer.sendTransaction({
+    to: TRANSFER_WALLET_ADDRESS,
+    value: TRANSFER_VALUE_ETH,
+  })
+  await provider.waitForTransaction(tx.hash)
+  console.log(`Transaction hash: ${tx.hash}\n`)
+
+  const balanceAfterFrom = await provider.getBalance(fromWalletAddress)
+  console.log(
+    `Balance of "${fromWalletAddress}" is ${formatEther(balanceAfterFrom)} ETH`,
+  )
+
+  const balanceAfterTo = await provider.getBalance(TRANSFER_WALLET_ADDRESS)
+  console.log(
+    `Balance of "${TRANSFER_WALLET_ADDRESS}" is ${formatEther(balanceAfterTo)} ETH`,
+  )
+}
+
+main().catch(console.error)