Skip to content

Commit

Permalink
namada added
Browse files Browse the repository at this point in the history
  • Loading branch information
redwest88 committed Dec 21, 2023
1 parent 3f416a8 commit eeb7f0d
Show file tree
Hide file tree
Showing 19 changed files with 339 additions and 6 deletions.
4 changes: 4 additions & 0 deletions docs/namada/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Namada",
"position": 13
}
44 changes: 44 additions & 0 deletions docs/namada/endpoints.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
sidebar_position: 2
description: Endpoints
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# RPC Endpoints

> The RPC endpoints within Namada's infrastructure serve as gateways, enabling users to interact with Namada's nodes effectively. These endpoints facilitate seamless querying of node states and the transmission of transactions across the Namada Network. They empower developers and users to access real-time blockchain data, execute transactions, and integrate Namada's decentralized infrastructure into their applications or tools with ease.
:::tip
If there's an RPC you don't see listed here, simply click "Edit this page" below, add it using Markdown, and initiate a pull request for review.

Visit [Introduction page](/intro) for more information.
:::

### There are a number of RPC endpoints that you can use for Namada Network:


**CryptoSJ:**

```bash
https://namadarpc1.cryptosj.net
```

**ITRocket:**

```bash
https://namada-testnet-rpc.itrocket.net:443
```

**kjnodes:**

```bash
https://namada-testnet.rpc.kjnodes.com
```

**Lavender.Five:**

```bash
https://testnet-namada-rpc.lavenderfive.com
```
Binary file added docs/namada/img/namada.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/namada/img/namada1.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
19 changes: 19 additions & 0 deletions docs/namada/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Namada

import MainpageMetrics from '@site/src/components/MainpageMetrics';

<MainpageMetrics rpc="https://namada-testnet-rpc.itrocket.net" binary="namadad" />

[Namada](https://namada.net) is a privacy-for-assets centric blockchain using zero-knowledge proof technology. Namada's cryptographical features give users asset-agnostic, interchain privacy, and is being built by the Anoma foundation.

Namada delivers an unparalleled layer of privacy across a myriad of assets, decentralized applications, and even entire blockchain networks.

![injective](./img/namada1.gif)

[Website](https://namada.net) | [Blog](https://namada.net/blog) | [GitHub](https://github.com/anoma/namada) | [Twitter](https://twitter.com/namada) | [Discord](https://discord.com/invite/namada) | [Docs](https://docs.namada.net) | [Forums](https://forum.namada.net)

```mdx-code-block
import DocCardList from '@theme/DocCardList';
<DocCardList />
```
4 changes: 4 additions & 0 deletions docs/namada/sync/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Sync",
"position": 3
}
27 changes: 27 additions & 0 deletions docs/namada/sync/addrbook.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
sidebar_position: 4
description: AddrBook
---

# AddrBook

> Address book refers to a local database or record that a node maintains of all the peers it has come into contact with or learned about. This helps in the peer discovery process.
import SelectPaste from '@site/src/components/SelectPaste';

import { addrBook } from '@site/src/components/SelectPaste/addrBook.ts';

export let endpoints = [
`https://files.cryptosj.net/files/namadatestnet/addrbook.json`,
`https://testnet-files.itrocket.net/namada/addrbook.json`,
`https://snapshots.lavenderfive.com/testnet-addrbooks/namada/addrbook.json`,
];

export let home = 'local/share/namada/public-testnet-15.0dacadb8d663/cometbft';

export let binary = 'namadad';

<SelectPaste endpoints={endpoints} codeTemplate={addrBook} home={home} binary={binary} tip="Click on any endpoint to paste it into the code block." />



20 changes: 20 additions & 0 deletions docs/namada/sync/peers-seeds.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
sidebar_position: 3
description: Live Peers / Seeds
---

# Live Peers / Seeds

> When you start a node, you often need to connect to the network. This requires you to connect to one or more peers to start downloading the blockchain and receiving new blocks and transactions. Seeding nodes or bootstrap nodes help in this initial connection process.
:::info
Copy and run the commands below to add your peers into `config.toml`.
:::

import LivePeers from '@site/src/components/LivePeers';

export let home = 'local/share/namada/public-testnet-15.0dacadb8d663/cometbft';

export let binary = 'namadad';

<LivePeers rpc="https://namada-testnet.rpc.kjnodes.com" home={home} binary={binary} />
44 changes: 44 additions & 0 deletions docs/namada/sync/snapshot.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
sidebar_position: 1
description: Snapshot
---

# Snapshot

> When a new node joins a network, it can use a snapshot — a compressed backup of the chain's data — to quickly synchronize with the current state. Snapshots expedite the process, reducing the need to download and verify every transaction from the beginning.
:::info
Choose a snapshot from the list and run the commands below. Don't forget to change `<snapshot_url>`.
:::

```bash
sudo systemctl stop namadad

# make a backup
cp $HOME/.local/share/namada/public-testnet-15.0dacadb8d663/cometbft/data/priv_validator_state.json $HOME/.local/share/namada/public-testnet-15.0dacadb8d663/cometbft/priv_validator_state.json.backup

# delete your data and download snapshot
rm -rf $HOME/.local/share/namada/public-testnet-15.0dacadb8d663/db $HOME/.local/share/namada/public-testnet-15.0dacadb8d663/cometbft/data
wget -O snapshot.tar <snapshot_url>
tar -xvf snapshot.tar -C $HOME/.local/share/namada/public-testnet-15.0dacadb8d663

# replace the priv_validator_state.json you have backed up
mv $HOME/.local/share/namada/public-testnet-15.0dacadb8d663/cometbft/priv_validator_state.json.backup $HOME/.local/share/namada/public-testnet-15.0dacadb8d663/cometbft/data/priv_validator_state.json

sudo systemctl restart namadad && sudo journalctl -u namadad -f
```

A list of Snapshots you can use:

**CryptoSJ:**

```bash
https://files.cryptosj.net/files/namadatestnet/namadatestnet.tar.gz
```

**ITRocket:**

```bash
https://testnet-files.itrocket.net/namada/snap_namada.tar
```

130 changes: 130 additions & 0 deletions docs/namada/troubleshooting.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
---
sidebar_position: 1
description: Troubleshooting
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Troubleshooting

Welcome to the Troubleshooting section of Namada Wiki 🛠

This documentation is dedicated to resolving common errors, bugs, and issues that arise when interacting with the Namada network and maintaining validators. This resource is specifically designed to provide instant resolution to these common issues.

:::tip
To share your own troubleshooting solutions, simply click "Edit this page" below, add your solution using Markdown, and initiate a pull request for review.

Visit [Introduction page](/intro) for more information.
:::

---

## Validator is jailed

- **Error:** `validator tnam1q... is jailed` while running `namada client validator-state --validator <address>`

- **Solution:**

Get the current epoch:

```bash
namada client epoch

#output: Last committed epoch: 24
```

Submit unjail txn:

```bash
namadac unjail-validator --validator <address>
```

:::note
If your node is not synced, add `--node <ip_address:port>` flag to use RPC.
:::

Wait 2 epochs and your validator should be unjailed. To check it, run:

```bash
namada client validator-state --validator <address>
#output: Validator tnam1q... is in the consensus set
```

---

## Cannot bond tokens to my validator

- **Error:**

```
0: The address tnam1q... doesn't belong to any known validator account.
1: The address tnam1q... doesn't belong to any known validator account.
```

- **Solution:** You can add your validator address as an alias to use it in bond txs, etc.

Find your validator address:
```bash
namadac find-validator --tm-address=$(curl -s localhost:26657/status | jq -r .result.validator_info.address)
#output: Found validator address tnam1q...
```

Add your address:
```bash
namadaw address add --alias <your_address> --address <your_address>
```

Bond tokens:
```bash
namadac bond --source <your_wallet> --validator <your_validator> --amount 1000
```

---

## Stack overflow error

- **Error:** `thread 'main' has overflowed its stack, fatal runtime error: stack overflow`

- **Solution:**

Make sure your node is on the latest version:
```bash
namada --version
```

:::note
The latest version can be found [here](https://github.com/anoma/namada/releases).
:::

Find cometbft process:

```bash
ps aux | grep cometbft
```

Kill the process:

```bash
kill -9 <pid>
```

Increase stack limit in `namadad.service` file:

```bash
nano /etc/systemd/system/namadad.service
#then add the line:
LimitSTACK=ulimit -s 32768
```

Restart node and service:

```bash
sudo systemctl daemon-reload && sudo systemctl restart namadad
```

---

4 changes: 4 additions & 0 deletions docs/namada/useful-tools/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Useful Resources",
"position": 4
}
17 changes: 17 additions & 0 deletions docs/namada/useful-tools/explorers.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
sidebar_position: 1
description: Explorers
---

# Explorers

> A block explorer is a search engine that allows users to access and explore the contents of individual blocks, transactions, validators, and addresses on a blockchain. It provides a visual interface to navigate the intricate details of blockchain operations.
### There are a number of explorers that you can use for Namada:

| Name | Layer | Network | URL |
| --- | --- | --- | --- |
| Namada (under dev.) | Cosmos | public-testnet-15.0dacadb8d663 | https://namada.world |
| Namada (official) | Cosmos | public-testnet-15.0dacadb8d663 | https://namada.info |
| Nodes.Guru | Cosmos| public-testnet-15.0dacadb8d663 | https://namada.explorers.guru |
| 0xgen | Cosmos | public-testnet-15.0dacadb8d663 | https://namada-explorer.0xgen.online |
20 changes: 20 additions & 0 deletions docs/namada/useful-tools/other-tools.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
sidebar_position: 3
description: Other-tools
---

# Other Tools

> This page is a repository of valuable tools and resources offered by the Namada Community, including monitoring systems, dashboards, and versatile platforms. These resources are designed to enhance your capabilities and are backed by Namada Community's commitment to support your needs.
:::tip
All the contributions are crafted by third-party members, signifying external individuals or entities unaffiliated with the Namada Network.

To contribute your own resource, simply click on **Edit this page** at the bottom, insert your resource using Markdown formatting, and then initiate a pull request for the submission to be reviewed.
:::

| Contribution | Description | Author | Date added/updated |
| --- | --- | --- | --- |



2 changes: 1 addition & 1 deletion docs/nibiru/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Nibiru",
"position": 13
"position": 14
}
2 changes: 1 addition & 1 deletion docs/quicksilver/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Quicksilver",
"position": 14
"position": 15
}
2 changes: 1 addition & 1 deletion docs/realio-network/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Realio Network",
"position": 15
"position": 16
}
2 changes: 1 addition & 1 deletion docs/sge-network/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "SGE Network",
"position": 16
"position": 17
}
2 changes: 1 addition & 1 deletion docs/sui/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Sui",
"position": 17
"position": 18
}
2 changes: 1 addition & 1 deletion docs/zetachain/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Zetachain",
"position": 18
"position": 19
}

0 comments on commit eeb7f0d

Please sign in to comment.