Build your first web3 app

Welcome to the Tatum SDK Demo: Simplifying Blockchain Development! πŸš€

In this step-by-step guide, we'll showcase just how remarkably easy it is to work with the Tatum SDK and retrieve the balance of an Ethereum address using vanilla JavaScript. Get ready to witness the power of simplicity!

With the Tatum SDK, fetching the balance is a breeze, thanks to its intuitive API. No complex setup or convoluted coding required! Just a few lines of vanilla JavaScript code, and we'll connect to the Tatum SDK, retrieve the balance, and display it on a user-friendly interface.

Join us as we embark on our journey to build a Tatum DApp with vanilla JavaScript.

Let's break it down into simple steps:

  1. Create a new Node.js project and install the Tatum SDK package. πŸ“¦
  2. Build an HTML page with an input field and a button. This will allow users to enter the Ethereum address and initiate the balance retrieval process. πŸ’»
  3. Write vanilla JavaScript code that leverages the Tatum SDK's address.getBalance() method. This function will fetch the balance of the provided Ethereum address. πŸ€‘
  4. Launch our application using the Parcel server. Sit back and watch as our vanilla JavaScript-powered DApp comes to life, fetching and displaying the balance in a decentralized, secure, and efficient manner. πŸš€

So, grab your coding hat, and let's get started on our Tatum SDK adventure.

Create a new project πŸ†•

The first step is to create a new project by running npm init in the terminal. This will prompt you to enter some basic information about the project, such as the project name and version.

npm init

Install Tatum SDK πŸ“¦

To install SDK, simply run the following command in your terminal or command prompt.
This will install the Tatum SDK package and its dependencies:

npm install @tatumio/tatum
yarn add @tatumio/tatum
pnpm install @tatumio/tatum
bun install @tatumio/tatum

Create an index.html file πŸ“

After installing the Tatum SDK, you need to create an index.html file in your project directory. This file will contain the HTML code that displays the input field, button and a div element for displaying the balance. The button is set up with an event listener that triggers the function to retrieve the balance when clicked. As you can see in the script tag we are import app.js which doesn't exist right now, but we will create this file in the next step!

    <meta charset="utf-8"/>
    <title>My First Tatum DApp</title>
    <script type="module" src="./app.js"></script>
    <h1>Get Eth balance with Tatum!</h1>
    <input type="text" id="address" placeholder="Enter wallet address" />
    <button id="get-balance">Get Balance</button>
    <div id="balance"></div>

Create an app.js file πŸ“

Next, you will create a app.js file in your project directory. This file will contain the code that interacts with the Tatum SDK to retrieve the balance of a given Ethereum wallet address.

import { TatumSDK, Network } from '@tatumio/tatum'

const button = document.getElementById('get-balance');
const addressInput = document.getElementById('address');
const balanceDiv = document.getElementById('balance');

button.addEventListener('click', async () => {
    const tatum = await TatumSDK.init({ network: Network.ETHEREUM });
    const balance = await tatum.address.getBalance({
        addresses: [addressInput.value],
    const balanceData = => asset.asset === 'ETH')[0];;
    balanceDiv.textContent = `${balanceData.balance} ${balanceData.asset}`;

You initialise the Tatum SDK by calling and passing in the Network object for the Ethereum network. Then you call tatum.address.getBalance and pass in an object with an array of addresses to retrieve the balance for. Finally, you display the retrieved balance in the balance div element.


There are various blockchain networks available - each instance of the TatumSDK is tied to 1 specific network. All supported networks are available here.

Update package.json πŸ“

To start the app from the index.html file, you need to update the source property in your package.json file.

  "name": "my-first-tatum-dapp",
  "version": "1.0.0",
  "source": "./index.html",
  "license": "MIT",
  "dependencies": {
    "@tatumio/tatum": "^3.0.0"

Start server πŸš€

The last step is to start the server using Parcel. You can run npx parcel in the terminal to start the server, and your app will be available at http://localhost:1234.

npx parcel

You can enter a wallet address and click the "Get Balance" button to retrieve the balance for that Ethereum address. The balance will be displayed below the button.


πŸ‘‰ Hint: Parcel will automatically bundle and serve your app.

All the files we created together are available on our TatumSDK repository on github πŸ“.

πŸŽ‰ Congratulations! You have successfully built your first DApp using TatumSDK!

πŸŽ‰ With just a few lines of vanilla JavaScript code, you were able to connect to the Ethereum blockchain network and retrieve the balance for a given Ethereum wallet address. Now, it's time to explore the full power of Tatum!

πŸš€ TatumSDK opens up a world of possibilities for your vanilla JavaScript-powered blockchain development journey. Whether you're building decentralised finance (DeFi) applications, NFT platforms, or integrating blockchain into your existing projects, TatumSDK has got you covered.

πŸ‘¨β€πŸ’» To unlock the full potential of TatumSDK and discover its extensive features, head over to our Tatum Dashboard at Sign up for an account and gain access to a range of powerful tools and services that will accelerate your blockchain development.

🌟 The Tatum Dashboard provides a user-friendly interface to manage your API keys, create notifications, and much more. It's your gateway to streamline your blockchain development process.

πŸ”” In addition, if you're interested in learning more about specific topics like NFTs, wallet operations, and RPCs, be sure to check out the comprehensive Tatum Notifications Documentation for detailed insights and step-by-step guides. This resource will help you dive deeper into advanced functionalities and unleash the full potential of TatumSDK.

πŸ‘‹ Thank you for following along with this guide and taking your first steps into the exciting world of blockchain development with TatumSDK. Get ready to unleash the true potential of decentralised applications!

πŸ‘‰ Don't forget to check out other example apps on our TatumSDK repository on GitHub. Happy coding! 🌟