Skip to content

Commit

Permalink
Merge pull request #413 from anoma/brent/networks
Browse files Browse the repository at this point in the history
Networks pages
  • Loading branch information
brentstone authored Dec 20, 2024
2 parents 0c431cf + f4d119a commit 196676b
Show file tree
Hide file tree
Showing 15 changed files with 42 additions and 700 deletions.
2 changes: 1 addition & 1 deletion packages/docs/pages/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"introduction": "Getting Started",
"users": "User Guide",
"operators": "Operator Guide",
"integrating-with-namada" : "Integration Guide",
"integrating-with-namada": "Integration Guide",
"networks": "Networks",
"utils": "Utils"
}
4 changes: 2 additions & 2 deletions packages/docs/pages/networks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

This section contains information about the current public Namada networks (mainnet and testnet) as well as instructions for creating a new decentralized network or local devnet.

* [Mainnets](./networks/mainnets.mdx) - the main networks
* [Testnets](./networks/testnets.mdx) - the test networks
* [Mainnets](./networks/mainnets.mdx) - the mainnet network
* [Testnets](./networks/testnets.mdx) - live test networks
* [Setting up a local network](./networks/starting-network/local-network.mdx) - how to set up a local network (useful for development and testing)
* [Setting up a decentralized network](./networks/starting-network/genesis-flow.mdx) - how to launch a decentralized network involving multiple participants
30 changes: 29 additions & 1 deletion packages/docs/pages/networks/mainnets.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,31 @@
# Mainnets
This page will be updated and filled wen mainnet is launched.
The Namada mainnet is currently live after having been launched on December 3 @ 15:00 UTC.

The genesis files are hosted in the following repository: https://github.com/anoma/namada-mainnet-genesis.

### Mainnet status and attributes:
- chain ID: `namada.5f5de2dd1b88cba30586420`
- Namada binaries: [`v1.0.0`](https://github.com/anoma/namada/releases/tag/v1.0.0)
- Namada libs: [`v0.46.1`](https://github.com/anoma/namada/releases/tag/libs-v0.46.1)
- CometBFT version: [`v0.37.11`](https://github.com/cometbft/cometbft/releases/tag/v0.37.11)

### Joining the network from the CLI
The simplest way to join the network is the following:
```
export NAMADA_NETWORK_CONFIGS_SERVER="https://github.com/anoma/namada-mainnet-genesis/releases/download/mainnet-genesis"
export CHAIN_ID=namada.5f5de2dd1b88cba30586420
# Download the network files and join
namadac utils join-network --chain-id $CHAIN_ID
```

With these steps, a user can join the Namada mainnet, allowing for querying and transacting on the blockchain.
These beginning steps are necessary for running a full node or a validator node as well.
More details on how to join the network in these cases can be found in [this mainnet guide](https://github.com/anoma/namada-mainnet-genesis/blob/main/MAINNET-GUIDE.md).

### Services and infrastructure

The `namada-ecosystem` repository contains data on the available mainnet services and infrastructure in json format in [this directory](https://github.com/Luminara-Hub/namada-ecosystem/tree/main/user-and-dev-tools/mainnet).
This is an actively maintained resource for finding RPC nodes to connect to, active IBC relayers, Namadillo front-end instances, active indexers, state snapshot providers and more.

Block explorers and Namadillo instances can also be found on https://namada.net/apps.
65 changes: 10 additions & 55 deletions packages/docs/pages/networks/testnets.mdx
Original file line number Diff line number Diff line change
@@ -1,60 +1,15 @@
import { Callout } from 'nextra-theme-docs'
# Live Testnets

# Namada Testnets
Currently, while the Namada mainnet is live and has not reached Phase 5 of the mainnet launch, two public test networks are currently running, housefire and campfire.

For more context read:
### Housefire Testnet
This is a mainnet-tracking testnet and the intended primary staging ground for software upgrades and governance proposals.
Before Phase 5 of mainnet, it is used to test the proposals to advance between the phases.

[Announcing Namada Public Testnets](https://blog.namada.net/announcing-namada-public-testnets/)
[Instructions to join and use the housefire testnet](https://testnet.housefire.tududes.com).

## Shielded expedition
### Campfire Testnet
A more experimental testnet that is already configured to have full, Phase 5 functionality at genesis.
This network will be abandoned once the Namada mainnet and housefire testnet reach Phase 5 functionality.

<Callout type="info" emoji="👷">
For the shielded expedition, it is important to remember to add the `--memo` flag to every transaction. The memo should be filled with the `tpknam` submitted at the shielded-expedition registration period.
For example `namadac transfer --source me --target you --amount 10 --token naan --signing-keys my-key --memo tpknamq1337mypubkey1964qqqqqq`
</Callout>

<Callout>
As of version `v0.31.8` you must specify `--node http://127.0.0.1:26657` when running `namadac` commands. This is a temporary bug until the `namadac` client is updated.
</Callout>

The `balances.toml` file is located at `https://github.com/anoma/namada-shielded-expedition`.

- Namada Shielded expedition 2:
- From date: 6th of February 2024 18:00 UTC
- Namada protocol version: `v0.31.9`
- Cometbft version: `0.37.2`
- CHAIN_ID: `shielded-expedition.88f17d1d14`


The history of all testnets can be found [here](./testnets/testnet-history.mdx).

## Namada protocol versions

A testnet might deploy different versions of the Namada protocol. To see in-detail what each protocol version includes, refer to the [GitHub changelog](https://github.com/anoma/namada/tree/main/.changelog), which specifies what changes have been made in between versions.

## Report a bug

If you find a bug, please submit an issue with the `bug` [issue template](https://github.com/anoma/namada/issues/new/choose).

## How to join a Namada testnet

1. [Environment setup](./testnets/environment-setup.mdx)
2. [Pre-genesis instructions](./testnets/pre-genesis.mdx)
3. [Pre-genesis validator setup](../operators/validators/validator-setup.mdx)
4. [Pre-genesis validator apply](./testnets/genesis-validator-apply.mdx)
5. [Running your genesis validator](../operators/validators/validator-setup.mdx#start-validating)
6. [Running a full node](../operators/ledger/running-a-full-node.mdx)
7. [Becoming a validator post-genesis](./testnets/post-genesis-validator.mdx)

## Testnet flowchart
![testnet_flowchart](/images/testnet_flowchart.png)

The Namada public testnet is permissionless, anyone can join without the authorisation of a centralized party. Expect frequent upgrades (every two weeks).

## Block explorer

The block explorer is currently in development. The latest version can be found at [namada.world](https://namada.world/)

## Community

For questions or feedback, please use [GitHub](https://github.com/anoma/namada/issues) or [Discord](https://discord.gg/namada). Don't forget to [follow Namada](https://twitter.com/namada) on Twitter for fun memes and testnet relevant updates.
[Instructions to join and use the campfire testnet](https://testnet.campfire.tududes.com/).
12 changes: 0 additions & 12 deletions packages/docs/pages/networks/testnets/_meta.json

This file was deleted.

89 changes: 0 additions & 89 deletions packages/docs/pages/networks/testnets/campfire.mdx

This file was deleted.

71 changes: 0 additions & 71 deletions packages/docs/pages/networks/testnets/environment-setup.mdx

This file was deleted.

32 changes: 0 additions & 32 deletions packages/docs/pages/networks/testnets/faq.mdx

This file was deleted.

15 changes: 0 additions & 15 deletions packages/docs/pages/networks/testnets/faucet.mdx

This file was deleted.

Loading

0 comments on commit 196676b

Please sign in to comment.