Signing Raw Transactions

The closest real world example of a raw transaction — probably a bank cheque 💸

Some ways we can utilize raw transactions include signing a transaction offline on a secure machine and then broadcasting it separately or to send a transaction at a later point of time.

You will need Node.js installed and a valid Gnosisscan API Key.

1. Setting up a Node.js project

In a new folder, initiate a new Node.js project with the command npm init -y to accept all default project parameters.

A package.json file will be created for you, which contains all your packages and project information.

2. Integrating Ethers.js

We'll need to integrate a helpful JavaScript library known as Ethers.js that will help with interacting with the Ethereum blockchain.

We can do so using the command npm i ethers from a terminal within this project, which will add ethers as a dependency.

We'll then create a new file named transaction.js where we'll write the rest of the code in JavaScript and import ethers at the top of the file.

const ethers = require('ethers');

async function main() {

  // rest of code goes here

}

main();

3. Creating a wallet

One of the useful classes that Ethers.js provides is a Wallet, which represents a regular Ethereum address that you can use to store and send xDAI.

We can initiate a new Wallet by specifying a private key which we can generate or grab one from an existing wallet like MetaMask.

const ethers = require('ethers');

async function main() {

  // defining the wallet private key
  let privatekey = 'CE75F1A875F2DB7FB064F5DBD302B0C77FFEAA18CC4C314167A5111A04F79AFA';
  let wallet = new ethers.Wallet(privatekey);

  // print the wallet address
  console.log('Using wallet address ' + wallet.address);
  
}

main();

4. Crafting the transaction

A transactions is made up of several parameters that have to be defined, for this example we'll be making a simple xDAI transfer.

If you are following this article, feel free to get some xDAI from a faucet to fund your address.

Parameter	Description
to	the address to send xDAI to
value	the amount of xDAI to send
gasLimit	the maximum units of gas to consume in this transaction, set to 21000 for basic xDAI transfers
maxPriorityFeePerGas	the tip paid to miners, introduced in EIP-1559
maxFeePerGas	the maximum price paid per unit of gas, introduced in EIP-1559
nonce	the number of transactions sent from the address
type	set to 0x2, to denote EIP-1559 type transactions
chainId	the chain ID to send the transaction, for example 100 for Gnosis

The sample code to send 1 xDAI to address 0xa238b6008Bc2FBd9E386A5d4784511980cE504Cd on the Gnosis mainnet will be as follows.

const ethers = require('ethers');

async function main() {

  let privatekey = 'CE75F1A875F2DB7FB064F5DBD302B0C77FFEAA18CC4C314167A5111A04F79AFA';
  let wallet = new ethers.Wallet(privatekey);

  console.log('Using wallet address ' + wallet.address);

  let transaction = {
    to: '0xa238b6008Bc2FBd9E386A5d4784511980cE504Cd',
    value: ethers.utils.parseEther('1'),
    gasLimit: '21000',
    maxPriorityFeePerGas: ethers.utils.parseUnits('5', 'gwei'),
    maxFeePerGas: ethers.utils.parseUnits('20', 'gwei'),
    nonce: 1,
    type: 2,
    chainId: 100
  };

}

main();

5. Sign & serialize

After detailing the contents of the transaction, we'll need to sign it — using the wallet's private key we created in Step 3 to prove we are allowed to spend funds in the wallet address.

With the transaction signed, we have just one more step to serialize, or simply converting our transaction into a hexadecimal format.

const ethers = require('ethers');

async function main() {

  let privatekey = 'CE75F1A875F2DB7FB064F5DBD302B0C77FFEAA18CC4C314167A5111A04F79AFA';
  let wallet = new ethers.Wallet(privatekey);

  console.log('Using wallet address ' + wallet.address);

  let transaction = {
    to: '0xa238b6008Bc2FBd9E386A5d4784511980cE504Cd',
    value: ethers.utils.parseEther('1'),
    gasLimit: '21000',
    maxPriorityFeePerGas: ethers.utils.parseUnits('5', 'gwei'),
    maxFeePerGas: ethers.utils.parseUnits('20', 'gwei'),
    nonce: 1,
    type: 2,
    chainId: 100
  };

  // sign and serialize the transaction 
  let rawTransaction = await wallet.signTransaction(transaction).then(ethers.utils.serializeTransaction(transaction));
  
  // print the raw transaction hash
  console.log('Raw txhash string ' + rawTransaction);

}

main();

6. Send via API

With the signed raw transaction, we can now pass it to the "eth_sendRawTransaction" endpoint to be broadcasted to the Gnosis network.

A successfully broadcasted transaction will return a transaction hash, which you can use the "eth_getTransactionbyHash" endpoint or look it up on Gnosisscan!

You can run this code using the command node transaction.js

const ethers = require('ethers');

async function main() {

  let privatekey = '<privatekey>';
  let wallet = new ethers.Wallet(privatekey);

  console.log('Using wallet address ' + wallet.address);

  let transaction = {
    to: '0xa238b6008Bc2FBd9E386A5d4784511980cE504Cd',
    value: ethers.utils.parseEther('1'),
    gasLimit: '21000',
    maxPriorityFeePerGas: ethers.utils.parseUnits('5', 'gwei'),
    maxFeePerGas: ethers.utils.parseUnits('20', 'gwei'),
    nonce: 2,
    type: 2,
    chainId: 100,
  };

  let rawTransaction = await wallet.signTransaction(transaction).then(ethers.utils.serializeTransaction(transaction));
  console.log('Raw txhash string ' + rawTransaction);

  // pass the raw transaction hash to the "eth_sendRawTransaction" endpoint
  let gethProxy = await fetch(`https://api.gnosisscan.io/api?module=proxy&action=eth_sendRawTransaction&hex=${rawTransaction}&apikey=YourApiKeyToken`);    
  let response = await gethProxy.json();    
     
  // print the API response
  console.log(response);
  
}

main();

Wrapping Up

The full sample code for this tutorial is on Github, feel free to fork and extend the functionality of it ! 🤖