From 6638e27bb2680734a20e07b8923fcf20d5b1ebbb Mon Sep 17 00:00:00 2001 From: Sean King Date: Wed, 8 May 2024 15:55:13 +0200 Subject: [PATCH] initial testnet docs structure --- testnets/README.md | 86 +++++++++++++++++++ testnets/devnets/README.md | 33 +++++++ testnets/testnets/nillion-testnet-1/IBC.md | 23 +++++ testnets/testnets/nillion-testnet-1/README.md | 78 +++++++++++++++++ .../nillion-testnet-1/genesis/genesis.json | 3 + .../previous/incident-reports.md/template.md | 19 ++++ 6 files changed, 242 insertions(+) create mode 100644 testnets/README.md create mode 100644 testnets/devnets/README.md create mode 100644 testnets/testnets/nillion-testnet-1/IBC.md create mode 100644 testnets/testnets/nillion-testnet-1/README.md create mode 100644 testnets/testnets/nillion-testnet-1/genesis/genesis.json create mode 100644 testnets/testnets/previous/incident-reports.md/template.md diff --git a/testnets/README.md b/testnets/README.md new file mode 100644 index 0000000..db37d15 --- /dev/null +++ b/testnets/README.md @@ -0,0 +1,86 @@ +
+ +

+ Nillion Testnets +

+

This repository contains information on Nillion public testnets and devnets

+
+
+ +| Chain ID | Type | Status | Version | Notes | +|---------------------------------------|-----------|------------|---------------|---------------------------| +| [nillion-testnet-1](./testnets/nillion-testnet-1) | `testnet` | **Inactive** | `v0.1.0` | Testnet | +| [devnet](./devnets/) | `devnet` | **Beta** | `v0.1.0` | Devnet with mainnet state | + +## Testnets + +Testnets are a type of blockchain used exclusively for testing purposes. They function as a sandbox environment, allowing developers to test new code and functionalities without worrying about affecting the live blockchain (mainnet). They are persistent environments, meaning that they remain active for extended periods of time. + +Testnets come with a range of integrated services, including relayers to other testnets, frontends, explorers, and snapshot services. + +### nillion-testnet-1 + +| Chain ID | `nillion-testnet-1` | +|------------------|----------------------------------------------------| +| Nilliond version | `v0.1.0` | +| Genesis | | +| RPC | | +| gRPC | | +| REST | | +| Faucet | | +| Explorer | | +| Snapshots | | +| Frontend | | + +#### Join the testnet + +Join the testnet following the instructions on the [nillion-testnet-1 page](./testnets/nillion-testnet-1/README.md). + +## Devnets + +Devnets, short for development networks, are also used for testing new functionalities and code. However, unlike testnets, devnets are temporary environments. + +Devnets are ephemeral, which means they do not persist state long term and are recreated on an ongoing basis. This ensures that the testing environment closely mirrors the current state of the latest nillion codebase. Devnets are minimal environments, consisting only of a validator. Unlike testnets, devnets do not feature frontends or relayers to other testnets. + +### devnet + +| Chain ID | `devnet` | +|------------------|--------------------------------------------------------------------------| +| Nilliond version | `v0.1.0` | +| Genesis | | +| Starting Height | | +| RPC | | +| REST | | +| gRPC | `grpc.devnet.nillion.com:30090` | +| websocket | `wss://rpc.devnet.nillion.com:443/websocket` | +| Faucet | | +| Seed Node | `5943e04edc5397018803f73e47f826be016010e1@p2p.devnet.nillion.com:30056` | + +## 🆘 Issues and support + +If you encounter any issues while joining the Nillion network or have questions about the process, please don't hesitate to reach out for support. + +- For general questions and community support, join the [Nillion Discord](https://discord.com/) and ask in the `#testnet` channel. + +- For technical issues or bugs related to the testnet, submit a detailed issue report on this repository with a clear description of the problem and any relevant error messages or logs. + +## 🙋‍♀️ FAQ + +**1) I need some funds on the `nillion-testnet-1` testnet, how can I get them?** + +You can request testnet tokens for the `nillion-testnet-1` testnet from the faucet available at . Please note that the faucet currently dispenses up to 500 NILLION per day per address. + +**2) I am an integrator on the `nillion-testnet-1` testnet. How can I request more funds?** + +If you are an integrator needing additional testnet tokens for development or testing purposes, you can request them via [this form](https://form-integrators.testnet.nillion.com). Please provide detailed information about your project and the number of tokens you require, and our team will review your request as soon as possible. + +**3) What are the differences between testnets and devnets?** + +| **Features** | **Testnets** | **Devnets** | +|--------------|--------------------------|--------------------------------------------------| +| Persistent | ✅ | ❌ | +| State | Maintains its own state. | Forks of the mainnet, mimicking its state. | +| Faucet | ✅ | ✅ | +| Explorer | ✅ | ❌ | +| Frontend | ✅ | ❌ | +| Relayers | ✅ | ❌ | diff --git a/testnets/devnets/README.md b/testnets/devnets/README.md new file mode 100644 index 0000000..0fd68dc --- /dev/null +++ b/testnets/devnets/README.md @@ -0,0 +1,33 @@ +# devnet + +> This page is a work in progress. Please check back later for more information. + +## Details + +| Chain ID | `devnet` | +|------------------|-----------------------------------------------------------------------| +| Nilliond version | `v0.1.0` | +| Genesis | | +| Starting Height | | + +### Public Nodes + +| Protocol | Url | +|-----------|-----------------------------------------------| +| RPC | | +| REST | | +| gRPC | `grpc.devnet.nillion.com:30090` | +| websocket | `wss://rpc.devnet.nillion.com:443/websocket` | + +### 🌱 Seed + +| Node | ID | +|-----------|--------------------------------------------------------------------------| +| Seed Node | `5943e04edc5397018803f73e47f826be016010e1@p2p.devnet.nillion.com:30056` | + +### 🚰 Faucet + +The `devnet` testnet faucet is available at + +Given that this devnet is a state export, your mainnet funds would be available on the `devnet` as testnet tokens. +Please be extremely careful about explicitly checking the `chain-id` before signing any transactions. diff --git a/testnets/testnets/nillion-testnet-1/IBC.md b/testnets/testnets/nillion-testnet-1/IBC.md new file mode 100644 index 0000000..b32063b --- /dev/null +++ b/testnets/testnets/nillion-testnet-1/IBC.md @@ -0,0 +1,23 @@ +# IBC Resources + +## 📺 IBC Channels + +| src-chain-id | dst-chain-id | src-channel | dst-channel | Note | +|---------------|---------------------------|---------------|----------------|---------------------| +| `nillion-testnet-1` | `test-chain` | `channel-0` | `channel-0` | Example channel | + +## 🫰 IBC Assets + +The following are all the assets currently supported by `nillion-testnet-1` along with their corresponding IBC denomination. + +When assets are transferred through IBC, they lose their base denomination (i.e `akt`) and obtain a new IBC denomination (e.g. `ibc/7153C8C55DB988805FAC69E449B680A8BAAC15944B87CF210ADCD1A3A9542857`). + +| Token | Base Denom | IBC Denom | +|-------------|------------|------------------------------------------------------------------------| +| EXAMPLE-TOKEN | `amazingcoin` | `ibc/A8C2D23A1E6F95DA4E48BA349667E322BD7A6C996D8A4AAE8BA72E190F3D1477` | + +## 🧑‍💻 IBC Development + +### 🇰 Add chains to keplr wallet + +You can add the nillion-testchain-1 chain to your Keplr wallet, as well as all other connected chains, at: diff --git a/testnets/testnets/nillion-testnet-1/README.md b/testnets/testnets/nillion-testnet-1/README.md new file mode 100644 index 0000000..bc9c022 --- /dev/null +++ b/testnets/testnets/nillion-testnet-1/README.md @@ -0,0 +1,78 @@ +# nillion-testnet-1 testnet + +## Details + +| Chain ID | `nillion-testnet-1` | +|-------------------|---------------------------------------------------------------------------------| +| Launch Date | 20th May 2024 | +| Nilliond version | `v0.1.0` | +| Genesis | | +| Genesis SHA256SUM | `7f84b50c0ad65582c9c52126cd33443c9f2541436ea4c525106ed9b58f7c9ef4` | + +## Endpoints + +Summary of the `nillion-testnet-1` endpoints: + +| Service | Url | +|-------------|----------------------------------------------------------------------------------------------------------------------------------------| +| Public RPC | | +| Public LCD | | +| Public gRPC | | +| Faucet | | +| Seed Node | `1f9a9c694c46bd28ad9ad6126e923993fc6c56b1@137.184.121.105:26656` | +| Peers | `3ab030b7fd75ed895c48bcc899b99c17a396736b@137.184.190.127:26656`
`3dbffa30baab16cc8597df02945dcee0aa0a4581@143.198.139.33:26656` | +| Explorer | | +| Frontend | | + +### Public Nodes + +| Protocol | Url | +|----------|-------------------------------------| +| RPC | | +| gRPC | | +| REST | | + +### 🌱 Seed + +| Node | ID | +|------|------------------------------------------------------------------| +| Seed | `0g2a9c694c46bd28ad9ad6126e923993fc6c56b1@117.183.181.105:26656` | + +Add the Node ID in your `p2p.seeds` section of you `config.toml`: + +```toml +####################################################### +### P2P Configuration Options ### +####################################################### +[p2p] + +# ... + +# Comma separated list of seed nodes to connect to +seeds = "0g9a9c694c46bd28ad9ad6126e923993fc6c56b2@132.182.181.105:26656" +``` + +### 🚰 Faucet + +The `nillion-testnet-1` testnet faucet is available at + +## Join the network + +Before joining the network, ensure that your system meets the following minimum requirements: + +- 4 CPU +- 8GB RAM +- 100GB free disk space + +To join the Nillion network, there are various options available. Choose the option that works best for you based on your preferences and technical requirements. + +1. (Manual) Manual setup + +### Option: Manual setup + +1. Download the `nilliond` binary: +2. Initialize the node: +3. Download genesis +4. Download the latest snapshot: +5. Set the seed node in the `config.toml`: +6. Start the node: diff --git a/testnets/testnets/nillion-testnet-1/genesis/genesis.json b/testnets/testnets/nillion-testnet-1/genesis/genesis.json new file mode 100644 index 0000000..0212777 --- /dev/null +++ b/testnets/testnets/nillion-testnet-1/genesis/genesis.json @@ -0,0 +1,3 @@ +{ + "genesis": "empty" +} \ No newline at end of file diff --git a/testnets/testnets/previous/incident-reports.md/template.md b/testnets/testnets/previous/incident-reports.md/template.md new file mode 100644 index 0000000..3332553 --- /dev/null +++ b/testnets/testnets/previous/incident-reports.md/template.md @@ -0,0 +1,19 @@ +# $date $testnet-id $title + +|   |   | +|----------|--------------------------------------------------| +| Incident | $REASON | +| Chain-id | $CHAIN-ID | +| Date | $DATE | +| Block | $BLOCKHEIGHT | +| Authors | $FIRSTNAME-LASTNAME | + +## Overview + +## Incident Details + +## Root Cause + +## Impact + +## Remediation Measures