Skip to content
Branch: master
Find file Copy path
Find file Copy path
1 contributor

Users who have contributed to this file

52 lines (36 sloc) 3.11 KB

Blockchain Service URL

What is a blockchain service URL?

A blockchain service url is a URL that SubstratumNode uses to interact with the Ropsten testnet or Ethereum mainnet blockchains.

To be fully functional SubstratumNode needs access to:

  1. pay HOT/SUB to other nodes for routing, blockchain, and exit services consumed,
  2. determine if other requesting nodes have enough SUB to pay for services -- also ROP/ETH for gas fees, and
  3. discover payments from other nodes for routing, blockchain, and exit services provided. This keeps your node from incorrectly banning other nodes for not paying.

There are two general types of Blockchain Services SubstratumNode currently supports.

  1. Connect with a remote service that provides a JSON RPC Ethereum client like,
  2. Run your own Ethereum miner such as a Go Ethereum (geth) or Parity Ethereum JSON RPC client locally on the same machine as SubstratumNode or on another machine within your private network.

1. Sign up for a free account.

Follow the instructions here to create a "Project" Choose one of the following options for the Ropsten testnet:

  • Enter your url<YOUR-PROJECT-ID> in the blockchain service url field of the UI. Image

  • For the command-line interface (CLI) start your SubstratumNode providing the argument


  • Edit your config.toml file and include the entry

    blockservice-service-url = "<YOUR-PROJECT-ID>"

  • Or define an environment variable

    • Windows


    • Linux or macOS


Change <YOUR-PROJECT-ID> with the PROJECT ID from your Project Dashboard. Change the URL to mainnet when ready to spend and earn real SUB. NOTE: the network will initially only be testing on Ropsten.

Soon SubstratumNode will have the ability to request clandestine blockchain services from other nodes through services like Requests for blockchain services will be routed just as if your browser sent a request to a website through the Substratum Network. In this mode your blockchain service requests will cost HOT or SUB.

2. Do you feel up to the technical challenge of running a full Ethereum client, keep it running, and synchronized with the blockchain?

If so, run either geth or parity and let it sync the full ethereum blockchain. You do not need to enable mining. Keeping it synchronized is sufficient. At this point CPU mining is not likely to earn any block rewards since GPU miners win all the rewards having the vast majority of the hashing power.

Be aware a fully synchronized blockchain can have considerable disk space requirements.

Enter the URL of your miner for example:

You can’t perform that action at this time.