Skip to main content

Understanding The Testnet

This section covers information about Subsocial's testnet i.e. SoonSocialX.

Subsocial provides developers with a new and fast testnet (named Soonsocial, because testnet features will be on the mainnet soon) for building and testing your social Dapps. It enables you to start building and deploy your dapps on our testnet, and invite your early community to start using it without need to buy real SUB tokens on the mainnet.

Why do we need a testnet?#

Building Dapps on Subsocial is simple and quick but it requires your users to own some $SUB tokens. As of now, we haven't listed $SUB so people can't buy tokens yet. It's important to build a community around your social Dapp before going to the mainnet, and the testnet lets you do that.

Tokens on the testnet can be received by writing the following command in our Discord server.

Run this command under #faucet :


Join our Discord server here.

How many tokens will I get?#

The Discord bot will grant you 10 SUB tokens to test on the Soonsocial solochain.

You can check your balances here by choosing the Soonsocial network from the list of test networks on the left.

SDK Configuration#

To integrate the testnet with your Subsocial Dapp, you have to add these details in the code:

// config.js
export const TESTNET_CONFIG = {
substrateNodeUrl: 'wss://',
offchainUrl: '',
ipfsNodeUrl: ''
// index.js
import { newFlatSubsocialApi } from '@subsocial/api'
import { TESTNET_CONFIG } from 'config'
const initSubsocialApi = async () => {
const api = await newFlatSubsocialApi(
return api

NOTE: If you face any issues while using the testnet, please let us know in our Discord server or Telegram developer chat.