← Guides / Web3 SDKs / How to fetch Ethereum event logs in Ruby

June 08, 2021

How to fetch Ethereum event logs in Ruby

Overview

Ethereum log records are very useful to understand and keep track of smart contract events. In this guide, we are going to learn how to fetch ethereum event logs in Ruby using ethereum.rb ruby gem.

Prerequisites

Ruby installed on your system (Ruby 2.x +)
Text editor.
An Ethereum node.
Terminal aka Command-Line.

What is Ruby?

Ruby is an open-source, interpreted, object-oriented programming language created by Yukihiro Matsumoto (aka Matz), who chose the gemstone's name to imply ruby is "a jewel of a language." Ruby is designed to be simple, complete, extensible, and portable. Developed mostly on Linux, Ruby works across most platforms, such as most UNIX-based platforms, DOS, Windows, and Mac. According to advocates, Ruby's simple syntax (partially inspired by Ada and Eiffel) makes it readable by anyone familiar with any modern programming language. Ruby is considered similar to Smalltalk and Perl.

What are Ethereum logs?

In event-driven languages like JavaScript, we often listen to events in order to perform other actions. Solidity provides the same paradigm. In addition to sending real-time events over WebSockets, the EVM (Ethereum Virtual Machine) actually stores a log of the events emitted by a particular smart contract for retrieval over HTTP. These logs are often used for debugging purposes, catching events, or telling the viewer of the records that something has happened.

It is common for log records to be used to describe a smart contract event, like a change of ownership or token transfer. Each log record has topics and data. Topics are 32-byte (256 bit) words that describe what’s going on in an event. Different types of opcodes (LOG0 … LOG1) are needed to describe the number of topics that need to be added to the log record. For example, LOG1 can have one topic, while LOG4 can have four topics. Therefore, the maximum number of topics a single log record can have is four. The first part of the log record has an array of topics, and the second part of a log record consists of additional data.

Topics and data work best when together as there are upsides and downsides to each. For example, while topics are searchable, data is not. Including data is cheaper than including topics. Topics are limited to 4 * 32 bytes, while event data is not, which means it can consist of large or complicated data like arrays or strings. Events give you a way to add relevant logging data to the logs of a block.

Contracts cannot read events created by smart contracts; however, they can be read outside the blockchain, and as events are immutable, they can be used to keep track of data changes.

Logs need to be decoded to be used outside of the blockchain. We’ll use ethereum.rb library to get and decode the logs of a smart contract event.

What is ethereum.rb?

ethereum.rb is a Ruby gem that makes it easier to interact with the Ethereum blockchain using Ruby.

Learn more about ethereum.rb in this guide on How to connect to the Ethereum network using Ruby.

We’ll first deploy a smart contract that will emit an event and then write a small Ruby code to fetch logs of that event.

Creating and Deploying a smart contract

We’ll deploy our contract on the Ropsten testnet. To get started, you will need the Metamask browser extension to create an ETH wallet and some test ETH, which you can get by going to the Ropsten faucet. You'll need to select Ropsten Test Network on your Metamask wallet and copy-paste the wallet address into the text field in the faucet, then click Send me test Ether.

Head over to the Ethereum Remix IDE and make a new Solidity file event.sol

Paste the following code into your new Solidity script:

// SPDX-License-Identifier: MIT
pragma solidity 0.8.1;

contract Counter {
    
    event ValueChanged(uint oldValue, uint256 newValue);
    
    // Private variable of type unsigned int to keep the number of counts
    uint256 private count = 0;

    // Function that increments our counter
    function increment() public {
        count += 1;
        emit ValueChanged(count - 1, count);
    }
    
    // Getter to get the count value
    function getCount() public view returns (uint256) {
        return count;
    }

}

Explanation of the code above

Line 1: Specifying SPDX license type, which is an addition after Solidity ^0.6.8; whenever the source code of a smart contract is made available to the public, these licenses can help resolve/avoid copyright issues. If you do not wish to specify any license type, you can use a special value UNLICENSED or simply skip the whole comment (it won’t result in an error, just a warning).

Line 2: Declaring the solidity version

Line 4: Starting our Contract named Counter

Line 6: Creating an event ValueChanged with two arguments, oldValue will be the input value of count and newValue which will be the output value of count.

Line 9: Declaring a private variable count with initial value zero.

Line 12-15: Creating a public function increment, increasing the value of count by 1, and emitting the event ValueChanged with oldValue = count’s current value minus 1 and newValue = count’s current value.

Line 18-19: Creating a public function getCount to return the value of count.

Compile the smart-contract and deploy it using Injected Web3; make sure to select the Ropsten network on your Metamask plugin before deploying the contract.

Also, copy the ABI of the contract from the compile tab. We’ll need it later.

You will see your contract under the "Deployed Contracts'' section in Remix. Open the deployed contract and click on getCount; you’ll see that the value returned is zero, which is expected.

Now click on increment to increase the value of count by one, confirm the transaction, and after receiving the transaction confirmation notification, click again on getCount. This time you’ll see that the value of the count has been changed.

We’ll fetch logs for this transaction. Copy the contract address from the copy button near the contract’s name under the “Deployed contracts'' section. Learn more about smart contracts and Solidity by going through the Solidity section of QuickNode guides.

Booting our Ethereum node

We could use pretty much any Ethereum client, such as Geth or OpenEthereum (fka Parity), for our purposes today. Since that is a bit too involved for fetching logs, we'll just grab a free endpoint from QuickNode to make this easy. We’ll need a Ropsten endpoint to get data from the chain as we’ve deployed our contract on the Ropsten testnet. After you've created your free ethereum endpoint, copy your HTTP Provider endpoint:

You'll need this later, so copy it and save it.

Getting logs in Ruby

Installing the ethereum.rb gem

Let’s first make sure we have Ruby installed on the system. To check just copy-paste and run the following in your terminal/cmd:

$ ruby -v

If not installed, follow the instructions on the download page of the official Ruby website, and Once we ensure ruby is installed and at the correct version (2.0+), let's move forward and install the ethereum.rb gem, You can install it from the command line using RubyGems, the package manager for ruby:

$ gem install ethereum.rb

If you're using macOS, you may encounter a permission-related problem while installing gem because the version of Ruby that ships with macOS is usually for Apple's use; you can always make few changes and get going, but I won't recommend that.

Instead of that, I'll suggest using rbenv or RVM (Ruby Version Manager) to manage a different Ruby version, which will be installed into a sandbox in your home directory, that you can make changes to without worrying about messing up the system Ruby.

Creating and running Ruby Script to fetch logs

Open your text editor and create a Ruby file log.rb, copy-paste the following in it.

require 'ostruct'
require 'ethereum.rb'

client = Ethereum::HttpClient.new("ADD_YOUR_ETHEREUM_NODE_URL")
abi = [
  {
    "inputs": [],
    "name": "increment",
    "outputs": [],
    "stateMutability": "nonpayable",
    "type": "function"
  },
  {
    "anonymous": false,
    "inputs": [
      {
        "indexed": false,
        "internalType": "uint256",
        "name": "oldValue",
        "type": "uint256"
      },
      {
        "indexed": false,
        "internalType": "uint256",
        "name": "newValue",
        "type": "uint256"
      }
    ],
    "name": "ValueChanged",
    "type": "event"
  },

  {
    "inputs": [],
    "name": "getCount",
    "outputs": [
      {
        "internalType": "uint256",
        "name": "",
        "type": "uint256"
      }
    ],
    "stateMutability": "view",
    "type": "function"
  }
]

contract = Ethereum::Contract.create(
  client: client,
  name: "event", 
  address: "CONTRACT_ADDRESS_FROM_REMIX", 
  abi: abi
)
event_abi = contract.abi.find {|a| a['name'] == 'ValueChanged'}
event_inputs = event_abi['inputs'].map {|i| OpenStruct.new(i)}
decoder = Ethereum::Decoder.new
filter_id = contract.new_filter.value_changed(
  {
    from_block: '0x0',
    to_block: 'latest',
    address: 'CONTRACT_ADDRESS_FROM_REMIX',
    topics: []
  }
)

events = contract.get_filter_logs.value_changed(filter_id)
events.each do |event|
  transaction_id = event[:transactionHash]
  transaction = client.eth_get_transaction_receipt(transaction_id)
  logs = transaction.dig('result', 'logs').find { |d| d['data'] != "0x" }
  data = logs.fetch('data')
  args = decoder.decode_arguments(event_inputs, data)
  eventlogs = transaction.inspect
  block = logs.fetch('blockNumber')
  puts "Transaction: #{eventlogs} with args: #{args}"
  puts "-" * 20
  puts "The Transaction was added to block: #{block.to_i(16)}" 
end

Make sure to replace `ADD_YOUR_ETHEREUM_NODE_URL` with the ropsten http provider and `CONTRACT_ADDRESS_FROM_REMIX` with the address of the deployed contract from the above sections

Explanation of the code above

Line 1-2: Importing necessary libraries.

Line 4: Setting up our Ropsten node URL.

Line 5-46: Paste your ABI, Which you copied in the previous section (if you used the same smart contract, you use the same ABI), saving the ABI in abi variables.

Line 48-53: Instantiating our contract object and getting the contract from the blockchain using the details, supplying our node to the client, Adding the name of our smart contract “event,” Replace the address of the deployed contract which you copied in the previous step and the abi.

Line 54: Finding the event ValueChanged from the ABI and storing it in the event_abi variable.

Line 55: Mapping our event_abi to an OpenStruct object to process hashes and storing it in the event_inputs variable.

Line 56: Creating a variable decoder and instantiating the Decoder method object.

Line 57-64: Putting a filter on the contract event value changed with necessary parameters and storing it in filter_id variable.

Line 66: Getting logs from the filter events and storing them in the events variable.

Line 67: Returning all elements of the events array using each method.

Line 68: Getting the transaction hash and storing it in the transaction_id variable.

Line 69: Getting transaction details using the eth_get_transaction_receipt method for transaction hash via our node.

Line 70: Searching the event logs for results and logs and storing it in a logs variable.

Line 71: Fetching data from logs and storing it in a data variable.

Line 72: Decoding the event_inputs and data and storing it in args variable.

Line 73: Getting the transaction details using inspect method and storing it in eventlogs variable.

Line 74: Fetching blockNumber from logs and storing it in block variable.

Line 75:Printing the logs with args which contains the input and output values of count from the smart contract.

Line 76: Printing 20 dashes to beautify the output.

Line 77: Printing the block number after converting it into a decimal number.

Now, save the file and run it as follows:

$ ruby log.rb

If everything goes right, your output must look like this:

The output has the transaction, and the event details, the later part of the output has the block number extracted from the data.

Conclusion

So here we learned about Ethereum logs and how to filter and extract information from them using Ruby.

Subscribe to our newsletter for more articles and guides on Ethereum. If you have any feedback, feel free to reach out to us via Twitter. You can always chat with us on our Discord community server, featuring some of the coolest developers you’ll ever meet :)

Ready to try QuickNode? Start your 7-day free trial

Overview
What is Ruby?
What are Ethereum logs?
What is ethereum.rb?
Creating and Deploying a smart contract
Booting our Ethereum node
Getting logs in Ruby
Conclusion

Sahil Sen

Web developer who believes in power of communities and is passionate about community building. Developer evangelist @ QuickNode.

Want more Web3 tuts?

We'll send you the latest tech and tutorials via our weekly Web3 Vibes newsletter.

Related articles 27

Jul 3, 2021 The Web3 Developer Stack

A developer stack is a bag of technologies a developer possesses. For example, MEAN (MongoDB, Express.js, AngularJS/Angular, and Node.js) and MERN (MongoDB, Express.js, React, and Node.js) are common web developer stacks. Similarly, today we will learn more about the web3...

Jun 7, 2021 How to integrate IPFS with Ethereum

It can be costly to store massive files on a blockchain mainnet, and this is where decentralized file storing systems like IPFS can come in handy. Sometimes, NFTs use IPFS as well. In this guide, we’ll cover how we can integrate IPFS with...

Jun 8, 2021 How to generate a new Ethereum address in PHP

PHP is very popular in developing the backend of websites or web applications. PHP has a huge crowd of developers trusting it as their go-to language. In this guide, we will see how we can generate a new Ethereum address in...

Jun 8, 2021 Estimating gas price using pending transactions in Python

To send a transaction on the Ethereum network, you need to pay fees for including the transaction in a block as well as the computation necessary in the transaction; this fee is called gas. The transactions are accepted into the block based on the amount of gas they are...

Jun 8, 2021 How to connect to Ethereum network with ethers.js

When someone thinks of developing a dApp the first tool that comes to their mind is web3.js which is pretty common because of its popularity in the community and wide use cases, dApp development has been consistently growing and there are a lot of developers who want to...

Jun 8, 2021 How to connect to the Ethereum network using Ruby

Ruby has a huge fanbase. Ruby was developed by its creator with an intention to create a language people can have fun using. Ruby has been largely accepted by the developers all around the world since it’s launch, in fact, the biggest tech communities in many cities are...

Jun 8, 2021 How to re-send a transaction with higher gas price using ethers.js

Sometimes, you submit a transaction on Ethereum without enough gas due to network congestion or too many pending transactions offering a higher gas price than you have offered on your transaction. If you have a high priority transaction but low gas, you could end up...

Jun 17, 2021 How to get the balance of an ERC-20 token

When a new token is made on the Ethereum network, it usually follows a specification. The most popular of which is the ERC20 specification. To meet this ERC20 standard, one's token must have a multitude of...

Jun 8, 2021 How to connect to Ethereum network with Web3.js

Libraries and frameworks make the development process a lot easier and faster. When it comes to Ethereum development, Web3.js is the go to library. That's because Web3.js is the official library, from the

Jun 8, 2021 How to generate a new Ethereum address in Ruby

With high usage in web applications and straightforward syntax, Ruby is used by a vast number of people. This guide will cover creating an Ethereum address in Ruby using ruby-eth...

Jun 8, 2021 How to Fork Ethereum Blockchain with Ganache.

Forking and running a local simulated Ethereum environment is essential if you want to work with DeFi or do Ethereum development in general. In this guide, we’ll cover how to fork Ethereum Blockchain with

Jun 9, 2021 How to generate a new Ethereum address in Go

Golang is very popular among backend developers for building infrastructures and microservices. Go is a procedural programming language. Developed in 2007 by Robert Griesemer, Rob Pike, and Ken Thompson at Google, then launched in 2009 as...

Jun 9, 2021 How to generate a new Ethereum address in Python

Python is one of the most versatile programming languages out there with an abundance of use cases; We can build many applications with Python from client-side to back end. In this guide, we will cover creating an Ethereum address in Python using the

Jun 9, 2021 How to generate a new Ethereum address in JavaScript

When it comes to programming, there’s hardly anyone who has not used or heard about JavaScript. JavaScript was initially created for client-side scripting but has become a full-featured Object-Oriented...

Jun 9, 2021 How to connect to Ethereum network using Go

Go helps you make faster scalable backends and this guide will show you how to connect your backend to Ethereum (and make it even faster, more reliable, and globally accessible, all thanks to QuickNode’s global infrastructure). What is...

Jun 9, 2021 How to connect to Ethereum network using Java / Web3j

We can say that Java is one of the most versatile languages out there, and it continues to be relevant in today's time. Java is so popular because of its massive user base and use cases. In this guide/tutorial, we'll learn how to connect to the Ethereum Blockchain network...

Jul 25, 2021 How to Create an Address in Solana using JavaScript

Hello reader! Welcome to QuickNode's first Solana guide. Solana is an up-and-coming blockchain that seeks to solve the scalability issues that Ethereum has been handling. You will walk through step-by-step how to create a Solana address using the @solana/web3.js...

Jun 9, 2021 How to connect to Ethereum using .NET (Nethereum)

Dotnet or .NET is very popular for the development of desktop applications, most Windows desktop applications are built using .NET, and it also contributes largely to web application’s tech stack. In this guide, let’s see how we can connect to Ethereum using .NET and

Jun 15, 2021 How to connect to Ethereum using PHP

PHP is a very popular choice among developers and has a vast community due to its long presence in web development. In this guide, we’ll cover how to connect to Ethereum with PHP using the web3.php...

Jul 15, 2021 How to Setup Local Development Environment for Solidity

The success story of blockchain started with Bitcoin and was given wings by Ethereum. Ethereum was the first blockchain to introduce programmable software to the immutable ledger; these programs that live on the blockchain are called smart contracts. Solidity is the...

Jun 9, 2021 How to use Subspace with QuickNode

In this guide, we'll understand a bit about reactive development and how to use Subspace with QuickNode.JavaScript is the programming language behind most of the internet apps and websites. JavaScript today has become one of the most used programming languages,...

Jun 9, 2021 How to connect to the Ethereum network using Python using Web3.py

You can build Ethereum applications in different programming languages. In this article, we will connect to the Ethereum network using Python.PrerequisiteEthereum Node (We will use QuickNode’s free...

Jul 24, 2021 How to deploy a smart contract with Brownie

Python is one of the most versatile programming languages; from researchers running their test models to developers using it in heavy production environments, it has use cases in every possible technical field. In today's guide, we will learn about Brownie, a Python-based...

Jul 13, 2021 How To Fork Ethereum Mainnet with Hardhat

Forking the chain at an older block of the blockchain is helpful if you want to simulate the blockchain’s state at that block; Hardhat has this functionality built in. In this guide, let’s go through the process of forking the Ethereum Mainnet at an older...

Jun 26, 2021 How to create and deploy a smart contract with Hardhat

Ethereum development environments like Truffle and Hardhat make it easier to work with smart contracts and Ethereum nodes. They provide a set of tools to seamlessly write, test, and deploy...

Jul 2, 2021 How to do a non-custodial transaction with QuickNode

Private keys are one of the most sensitive pieces of data when it comes to cryptography, cryptocurrencies, and blockchain. However, there has always been debate/confusion about choosing between custodial wallets (where the wallet provider has custody of the user’s private...

Jul 2, 2021 How to generate a new Bitcoin address in JavaScript

To do any type of transaction on the Bitcoin blockchain, you’ll need a public key or a Bitcoin address. In this guide, we’ll cover how to generate a new Bitcoin address in JavaScript using CyrptoCoinJS.