Using the Valhalla Test Network

Before you begin

Before you can interact with the test network, you need to install Brambl



This tutorial is compatible with BramblJS 1.3.x. After you have installed the prerequisites, you must install BramblJS

This tutorial is also compatible with BramblSC. The steps to installing and importing are also above.


When imported with no arguments, BramblJS defaults to point at a private node running on your localhost. While this is an option, it is easier to use Topl's test network (Valhalla) where Polys have no real-world value.

Using BramblSc, the quickest and easiest way to experiment and begin developing on Topl is to use the ValhallaTestNet provider found here



The Topl development team pushes new updates and features to Valhalla before they are pushed to the main Toplnet. This may cause some behavior differences for a short period between the two networks.

Interacting with the network

You can use Brambl to interact with the Valhalla network. BramblJS allows you to make transactions, view blocks on the chain, and other functionality!

At the bottom of this page, you can view this tutorial as a recipe, with an interactive flow to help you to visualize how to get connected.

Step 1. Importing the Brambl Module

To create a minimal instance of Brambl in your application, include the following lines in your application

const BramblJS = require('brambljs');
val brambl: Brambl = Brambl.standalone("my_key_file_directory", Some(ValhallaTestNet(apiKey = "myApiKey", , uri = "{{myProjectId}}")))

To use Valhalla, use the network prefix valhalla when creating a new instance of BramblJS or use the ValhallaTestNet provider when using BramblSC

const brambl = new BramblJS({
   networkPrefix : "valhalla"
val provider: Provider = ValhallaTestNet(apiKey = "myApiKey")
val brambl: Brambl = Brambl.standalone("myKeyFileDirectory", provider)

To get free polys for testing, please follow the instructions here to get polys using our faucet available in the BaaS portal