Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Networks pages #413

Merged
merged 6 commits into from
Dec 20, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
Loading