1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-02 08:20:22 +01:00
docs/content/concepts/testnets.md

70 lines
3.9 KiB
Markdown
Raw Normal View History

2018-11-27 11:22:56 +01:00
---
title: Testnets
description: An overview of public test networks that you can test Ocean Protocol applications against.
2018-11-27 11:22:56 +01:00
---
2019-07-08 18:24:40 +02:00
This page is a brief overview of available testnets. The [tutorials](/tutorials/) cover more details (e.g. how to connect to specific ones).
2018-11-27 11:22:56 +01:00
2019-05-09 13:30:18 +02:00
## A Spree Testnet (for Local Development)
2019-07-08 18:24:40 +02:00
By default, [Barge](https://github.com/oceanprotocol/barge) will deploy a local _Spree Testnet_[^1] on your machine: a local testnet not connected to any external public testnet.
2019-05-09 13:30:18 +02:00
When running a Spree Testnet, you can connect to a node at RPC URL [http://localhost:8545](http://localhost:8545) (called "Localhost 8545" in MetaMask).
2019-05-09 13:30:18 +02:00
Spree Testnet details can be found in the [Barge README.md file](https://github.com/oceanprotocol/barge#spree-network). You can configure the Spree nodes by editing the files in the `barge/networks/spree/` directory.
2019-07-08 18:24:40 +02:00
> Spree testnets are named after the Spree River, the main river flowing through Berlin, Germany, where many Ocean Protocol developers are located.
## The Nile Testnet
2019-07-08 18:24:40 +02:00
In the _Nile Testnet_[^2] all nodes are operated by BigchainDB GmbH.
2019-07-08 18:24:40 +02:00
> For developers building on Ocean Protocol, we recommend starting with a [Spree Testnet](#a-spree-testnet-for-local-development).
### Connect to the Nile Testnet
2019-07-09 21:56:59 +02:00
See [Tutorial: Connect to the Nile Testnet](/tutorials/connect-to-networks/#connect-to-the-nile-testnet).
### Nile Blockchain Explorers
2020-01-10 15:19:36 +01:00
There is a Nile blockchain explorer at [https://submarine.nile.dev-ocean.com/](https://submarine.nile.dev-ocean.com/). You can use it to check the status of a transaction, the balance of an account, and more. It uses the following symbols for Nile Ether and Nile Ocean Tokens:
2019-04-04 11:56:56 +02:00
| Cryptocurrency | Symbol used |
| ----------------- | ---------------- |
| Nile Ether | POA |
| Nile Ocean Tokens | OCEAN or SBT-OCN |
### Ocean Components Connected to Nile
There are several Ocean Protocol software components that are live, connected to the Nile Testnet, and operated by BigchainDB GmbH:
2019-08-20 11:42:35 +02:00
| Component | URL |
| ---------------------- | -------------------------------------------- |
| Node | `https://nile.dev-ocean.com` |
| Secret Store | `https://secret-store.nile.dev-ocean.com` |
| Aquarius Test instance | `https://aquarius.nile.dev-ocean.com` |
| Brizo Test instance | `https://brizo.nile.dev-ocean.com` |
2019-08-19 14:02:52 +02:00
| Aquarius for Commons | `https://aquarius.marketplace.dev-ocean.com` |
| Brizo for Commons | `https://brizo.marketplace.dev-ocean.com` |
2019-08-20 11:42:35 +02:00
| Commons Marketplace | `https://commons.nile.dev-ocean.com` |
| Jupyter Hub | `https://mantaray.dev-ocean.com` |
| Faucet Server | `https://faucet.nile.dev-ocean.com` |
> Internal note: The private "atlantic" repo documents the internal details of the Nile Testnet in `networks/nile/README.md`.
### Using Barge with Nile
2019-07-08 18:24:40 +02:00
If you run [Barge](https://github.com/oceanprotocol/barge) with the `--local-nile-node` option, then Barge will run a Nile node on your local machine (along with everything else Barge runs).
There might be many blocks in the Nile Testnet's blockchain, so it might take a long time for your local Nile node to sync, i.e. to download a local copy of all the blocks. **In the meantime, the local Nile node won't be able to do certain things.**
## A Ganache-Based Testnet (for Local Development)
2019-03-18 14:14:40 +01:00
A local testnet similar to Spree but launched by using the `--local-ganache-node` option with Barge.
2019-04-08 12:05:14 +02:00
2019-07-08 18:24:40 +02:00
> You shouldn't use a Ganache-Based Testnet unless you know why you're doing so. For example, a Ganache-based testnet can be used to test some smart contracts, but it can't be used with a Secret Store.
2019-05-16 10:22:24 +02:00
2019-07-08 18:24:40 +02:00
[^1]: Formerly called Ocean Protocol Testnet v0.1, it was announced as part of the Plankton milestone.
[^2]: Also known as the Nile Beta Network. Formerly called the Ocean POA Testnet.