How Does It Work?

The service offers two main API endpoints:

1. Decoding Endpoint - /decode/:chain/:hash

   This endpoint provides detailed information about a transaction, including:

   • Decoded transaction data

   • Event logs and transaction traces

   • Error messages, if any

   • Additional context such as token transfers and metadata for all addresses involved in the transaction

2. Interpreting Endpoint - /interpret/:chain/:hash

   This endpoint translates the decoded transaction into a more accessible, human-readable format.

Example Transactions

Here’s an example of a decoded and interpreted transaction from the Blur NFT marketplace:

• Decoded Transaction

• Interpreted Transaction

Note: The live version of the Decoder API (available at decoder-api.3loop.io) currently supports Ethereum Mainnet transactions. It is available for demonstration purposes only and is not equipped to handle high traffic.

Key Features of Decoder API

• Open-source: The Decoder API is fully open-source, customizable, and does not rely on proprietary services for the decoding.

• Minimal external dependencies: Only requires an RPC URL and an SQLite database for caching. If the database is empty, public contract data can be resolved using external APIs by providing them as strategies. See supported strategies in the Loop Decoder documentation.

• Swagger Interface: Provides an OPEN API interface at /swagger for easy interaction with the service.

• SQLite database with popular contracts: Includes metadata and ABIs for widely used contracts on Ethereum. Contact us on X for a database file.

• OpenTelemetry: Built-in support for monitoring and observability.

• Ready for deployment: Can be easily deployed to platforms like Fly.io.

Getting Started

1. Clone the repository from GitHub: Decoder API Repository

2. Set the required .env variables.

3. Follow the instructions in the README to run the project.

4. Deploy the API, for instance, using the fly deploy command on Fly.io.

Links

• Decoder API Repository

• Live Demo decoder-api.3loop.io

• Swagger decoder-api.3loop.io/swagger and request example

• Loop Decoder Repository and Playground

• Loop Decoder documentation

Looking for Feedback

We are constantly improving our libraries and open-source tools for decoding EVM transactions. If you have any feedback, please reach us out. Explore our GitHub repositories and if you found it useful, give us a star on GitHub and follow us on X for updates.

Every Web3 developer building user-facing dApps faces a common challenge: how to display transactions in a clear and understandable way. While blockchain data is freely available, it is often not easily readable or digestible for end-users. Developers typically have two options to address this problem:

1. Implement an In-House Transaction Decoder: This requires significant expertise and time to develop and often leads to issues with data enrichment and ongoing support for new types of transactions.

2. Use a Third-Party API: While this provides indexed and readable data, it can quickly become costly, especially for projects in the early stages.

To illustrate the challenges of the first approach, here is a screenshot from the open-source portfolio tracker tool Rotki, which has implemented decoding functions for popular EVM contracts.

Introducing Loop Decoder

Loop Decoder is a TypeScript library that transforms any EVM transaction into a human-readable format. This library offers several key features:

1. Client-Side and Server-Side Compatibility

Loop Decoder can be used on both the client-side and server-side, without introducing any external infrastructure dependencies.

2. Minimal External Dependencies

The library has minimal external dependencies, allowing developers to integrate it into their stack without enforcing any data sources. Developers can use their own storage or specify optional API providers to fetch contract metadata.

3. Flexible Interpretation Utilities

Loop Decoder provides flexible interpreter utilities that enable developers to define custom interpretations of EVM transactions.

Recent Updates

We’ve recently released a few major updates.

JavaScript Template Functions for Data Transformation

The library now supports JavaScript functions to transform decoded transactions into human-readable structures. We are going to create a library of reusable data transformations for popular contracts.

Improved Decoding Performance and New Transaction Types

The decoding performance has been significantly improved, and we now support more types of transactions, including NFT transfers and Account Abstraction transactions. We are also now better at resolving proxy contracts.

Integrations with Various API Providers

Loop Decoder now integrates with a range of API providers, such as Etherscan, 4bytes, Sourcify, and Blockscout, to fetch contract metadata. Developers can also specify their own database and do not depend on the external APIs.

Documentation Website

We’ve created a new documentation website, with more guides and resources coming soon.

Get Involved

If you are building a dApp with TypeScript, and looking to simplify the process of displaying transactions in your dApp, be sure to check out the Loop Decoder project on GitHub. Give it a star, follow for updates, and explore the new documentation website to get started.

Here comes 3loop - a no-code blockchain data integration platform that allows you to bring blockchain data into the Web2 stack.

🤔 Why we are building 3loop

Data is an essential component of successful decision-making. Web2 startups rely heavily on data to improve products, run A/B tests, conduct marketing activities, and reach the right users. However, in today's Web3 world, using data effectively is challenging due to the following reasons:

• Data fragmentation: Relevant data is scattered across different interfaces, tools, and blockchains.

• Lack of tools: Web3 companies cannot fully leverage existing analytics or marketing tools because these tools do not natively integrate with blockchain data, which is essential for Web3 companies.

• Non-human-readable data: Blockchain data is not human-readable, noisy, and requires special skills to decipher.

We have taken it upon ourselves to tackle these problems and help Web3 companies use the best existing tools for product development.

🔎 What is 3loop?

3loop is a no-code blockchain data integration platform that brings relevant blockchain data into your product analytics or marketing tools.

Here are some ways you can use it:

• Explore full user paths in product analytics tools: With 3loop, you can explore how users move from website visits to blockchain interactions using tools like Amplitude or Mixpanel.

• Reach users based on wallet information: Communicate with users via tools like Braze, taking into account their wallet history and more.

Unlike other analytics platforms that require SQL skills, 3loop helps non-technical users understand and use on-chain data. It also ensures that both off-chain and on-chain events are linked to the same entity in your destination.

To get started, select a smart contract to track, choose where the data should go, and see human-readable blockchain events in real-time at your destination.

👥 Who We Are

We are a duo on a journey to empower Web3 companies with all available tools and data. Our mission is to help the Web3 industry build better products.

Our expertise in both the Web2 and Web3 worlds enables us to understand and support Web3 teams with the data and tools they need to succeed. We know firsthand how efficient work can be in a startup when it has access to the right data, and how challenging it is in the Web3 world.

❗️ Before You Go, Join the Waitlist

Join now at 3loop.io to be to try out 3loop and bring relevant blockchain data to your product analytics tools.

Don't forget to follow us on Twitter to stay up-to-date with our latest news and updates 👇

Follow us on Twitter