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

xion added #76

Merged
merged 5 commits into from
Jan 18, 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
4 changes: 1 addition & 3 deletions docs/archway/useful-tools/other-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,4 @@ To contribute your own resource, simply click on **Edit this page** at the botto
| [Slashboard](https://services.kjnodes.com/mainnet/archway/slashboard/) | Dedicated tool designed to showcase the historical data of validator slashing incidents. | [kjnodes](https://github.com/kj89) | 2023-04-19 |
| [Archway analytics](https://analytics.smartstake.io/archway) | Dashboard that displays current/avg uptime of validators, actively participates in governance, changes in stake, etc. | [Smart Stake](https://smartstake.io/) | 2023-03-07 |
| [Reward calculator](https://analytics.smartstake.io/archway/calc) | The tool used to estimate the potential earnings or returns that can be gained by staking. | [Smart Stake](https://smartstake.io/) | 2023-03-07 |
| [Unagii](https://app.unagii.com/stake/archway) | Staking platform empowers users to securely participate in the decentralized network, enabling them to earn rewards by staking their ARCH tokens and actively contributing to the protocol's stability and growth. | [Stakewithus](https://www.stakewith.us) | 2023-11-21 |


| [Unagii](https://app.unagii.com/stake/archway) | Staking platform empowers users to securely participate in the decentralized network, enabling them to earn rewards by staking their ARCH tokens and actively contributing to the protocol's stability and growth. | [Stakewithus](https://www.stakewith.us) | 2023-11-21 |
4 changes: 4 additions & 0 deletions docs/xion/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Xion",
"position": 20
}
91 changes: 91 additions & 0 deletions docs/xion/endpoints.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
sidebar_position: 1
description: Endpoints
---

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

# Endpoints — API / RPC / gRPC

> In the Cosmos SDK, the gRPC-gateway translates gRPC endpoints into RESTful ones, enabling users to interact via the REST API. This adaptation is essential for clients that don't natively support gRPC or HTTP2.

> The RPC endpoint enables users to interact with Xion's nodes, querying the node's state and transmitting transactions within the Xion Network.

> The gRPC endpoint enables user interactions with a Xion Node through the efficient gRPC framework. In the Cosmos SDK, this protocol is crucial for state queries and transaction broadcasts.

<Tabs>
<TabItem value="api" label="API" default>

#### Xion (official):
```bash
https://api.xion-testnet-1.burnt.com
```

#### F5 Nodes:
```bash
https://xion-api.f5nodes.com
```

#### Imperator:
```bash
https://lcd-burnt-testnet.imperator.co
```

#### NodeX:
```bash
https://xion-testnet.api.nodex.one
```

</TabItem>
<TabItem value="rpc" label="RPC">

#### Xion (official):
```bash
https://rpc.xion-testnet-1.burnt.com
```

```bash
wss://websocket.xion-testnet-1.burnt.com/websocket # Websocket RPC
```

#### F5 Nodes:
```bash
https://xion-rpc.f5nodes.com
```

#### Imperator:
```bash
https://rpc-burnt-testnet.imperator.co
```

#### NodeX:
```bash
https://xion-testnet.rpc.nodex.one
```

</TabItem>
<TabItem value="grpc" label="gRPC">

#### Xion (official):
```bash
grpc.xion-testnet-1.burnt.com
```

#### F5 Nodes:
```bash
xion-grpc.f5nodes.com
```

#### Imperator:
```bash
grpc-burnt-testnet.imperator.co:3832
```

#### NodeX:
```bash
xion-testnet.grpc.nodex.one
```

</TabItem>
</Tabs>
Binary file added docs/xion/img/xion.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 22 additions & 0 deletions docs/xion/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Xion

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

<MainpageMetrics rpc="https://rpc.xion-testnet-1.burnt.com" binary="xiond" />

[Xion](https://xion.burnt.com/) is the first modular Generalized Abstraction Layer-1 blockchain that enshrines user experience (UX) at the protocol level.

XION created Burnt on the industry's most dependable and secure consensus framework (Comet BFT), inter-chain communication protocol (IBC), and developer toolkit (Cosmos SDK).

Combining the modular design of XION’s meta accounts, their signature agnostic implementation, and XION’s parameterized fee layer
offers a composable, future-proof infrastructure layer. XION simplifies the developer experience and enables a user-centric environment that retins the decentralized ethos of blockchain technology, while significantly lowering the entry threshold for mainstream users.

![xion](./img/xion.png)

[Website](https://xion.burnt.com) | [Blog](https://xion.burnt.com/blog) | [GitHub](https://github.com/burnt-labs) | [Twitter](https://twitter.com/burnt_xion) | [Discord](https://discord.com/invite/burnt) | [Docs](https://docs.burnt.com/xion)

```mdx-code-block
import DocCardList from '@theme/DocCardList';

<DocCardList />
```
4 changes: 4 additions & 0 deletions docs/xion/sync/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Sync",
"position": 2
}
23 changes: 23 additions & 0 deletions docs/xion/sync/addrbook.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
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://snap.nodex.one/xion-testnet/addrbook.json`,
`https://s3.imperator.co/testnets-addrbook/burnt/addrbook.json`,
];

export let home = 'xiond';

export let binary = 'xiond';

<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/xion/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 = 'xiond';

export let binary = 'xiond';

<LivePeers rpc="https://rpc.xion-testnet-1.burnt.com" home={home} binary={binary} />
40 changes: 40 additions & 0 deletions docs/xion/sync/snapshot.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
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 xiond

# make a backup
cp $HOME/.xiond/data/priv_validator_state.json $HOME/.xiond/priv_validator_state.json.backup

# reset your node and download a snapshot
xiond tendermint unsafe-reset-all --home $HOME/.xiond --keep-addr-book
wget <snapshot_url> | lz4 -dc - | tar -xf - -C $HOME/.xiond

# replace the priv_validator_state.json you have backed up
mv $HOME/.xiond/priv_validator_state.json.backup $HOME/.xiond/data/priv_validator_state.json

sudo systemctl restart xiond && sudo journalctl -u xiond -f -o cat
```

A list of Snapshots you can use:

#### Xion (official):
```bash
https://files.xion-testnet-1.burnt.com/xion-testnet-1-latest.tar.lz4
```

#### NodeX:
```bash
https://snap.nodex.one/xion-testnet/xion-latest.tar.lz4
```
25 changes: 25 additions & 0 deletions docs/xion/sync/state-sync.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
sidebar_position: 2
description: State Sync
---

# State Sync

> State Sync allows new nodes to join a blockchain network by downloading a recent snapshot of the application state instead of processing all historical blocks. This approach is typically faster and requires less data, as the application state is usually more concise than the entire block history.

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

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

export let endpoints = [
`https://rpc.xion-testnet-1.burnt.com`,
`https://xion-rpc.f5nodes.com`,
`https://rpc-burnt-testnet.imperator.co`,
`https://xion-testnet.rpc.nodex.one`,
];

export let home = 'xiond';

export let binary = 'xiond';

<SelectPaste endpoints={endpoints} codeTemplate={stateSync} home={home} binary={binary} tip="Click on any RPC to paste it into the code block." />
4 changes: 4 additions & 0 deletions docs/xion/useful-tools/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Useful Resources",
"position": 3
}
15 changes: 15 additions & 0 deletions docs/xion/useful-tools/explorers.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
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 Xion Network:

| Name | Layer | Network | URL |
| --- | --- | --- | --- |
| Xion (official) | Cosmos | xion-testnet-1 | https://explorer.burnt.com/xion-testnet-1 |

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": 20
"position": 21
}