├── assets
    ├── Initia-Banner.png
    └── Initia-Oracle-Banner.png
├── oracle
    └── README.md
└── README.md


/assets/Initia-Banner.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/trusted-point/initia-tools/HEAD/assets/Initia-Banner.png


--------------------------------------------------------------------------------
/assets/Initia-Oracle-Banner.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/trusted-point/initia-tools/HEAD/assets/Initia-Oracle-Banner.png


--------------------------------------------------------------------------------
/oracle/README.md:
--------------------------------------------------------------------------------
  1 | [<img src='../assets\Initia-Oracle-Banner.png' alt='banner' width= '99.9%'>]()
  2 | 
  3 | # Overview
  4 | **[Slinky](https://github.com/skip-mev/slinky/)** is a general-purpose price oracle leveraging ABCI++.
  5 | 
  6 | ## Components
  7 | 
  8 | The Slinky Oracle consists of two main elements:
  9 | 
 10 | 1. **On-Chain Component**
 11 |     - Retrieves price data from the sidecar with each block.
 12 |     - Forwards these prices to the blockchain through vote extensions.
 13 |     - Compiles prices from all validators involved.
 14 | 
 15 | 2. **Sidecar Process**
 16 |     - Dedicated to polling price information from various providers.
 17 |     - Delivers this data to the on-chain component.
 18 | 
 19 | ### Navigation Menu
 20 | - [Overview](#overview)
 21 |   - [Components](#components)
 22 |     - [Navigation Menu](#navigation-menu)
 23 |   - [Hardware requirements](#hardware-requirements)
 24 |   - [Config](#config)
 25 |   - [Installation guide](#installation-guide)
 26 |     - [1. Install required packages](#1-install-required-packages)
 27 |     - [2. Install Go](#2-install-go)
 28 |     - [3. Install `slinky` binary](#3-install-slinky-binary)
 29 |     - [4. Set Up Variables](#4-set-up-variables)
 30 |     - [5. Update oracle configuration](#5-update-oracle-configuration)
 31 |     - [6. Create a Service File](#6-create-a-service-file)
 32 |     - [7. Start the Oracle](#7-start-the-oracle)
 33 |     - [8. Validating Prices](#8-validating-prices)
 34 |     - [9. Enable Oracle Vote Extension](#9-enable-oracle-vote-extension)
 35 |   - [Monitoring](#monitoring)
 36 |     - [Oracle Service Metrics](#oracle-service-metrics)
 37 |     - [Oracle Application Metrics](#oracle-application-metrics)
 38 |   - [Useful commands](#useful-commands)
 39 |     - [Monitor server load](#monitor-server-load)
 40 |     - [Check logs of the oracle](#check-logs-of-the-oracle)
 41 |     - [Restart the oracle](#restart-the-oracle)
 42 |     - [Upgrade the oracle](#upgrade-the-oracle)
 43 |     - [Stop the oracle](#stop-the-oracle)
 44 |     - [Delete the oracle from the server](#delete-the-oracle-from-the-server)
 45 | 
 46 | ## Hardware requirements
 47 | ```py
 48 | - Memory: 16 GB RAM
 49 | - CPU: 4 cores
 50 | - Bandwidth: 1 Gbps
 51 | - Linux amd64 arm64 (Ubuntu LTS release)
 52 | ```
 53 | 
 54 | ## Config
 55 | 
 56 | To operate the oracle sidecar, it is essential to have valid configuration files for both the oracle component and the market component. The oracle executable recognizes flags that specify each configuration file. Below are recommended default settings suitable for the existing Initia Devnet environment.
 57 | 
 58 | 1. **Oracle Component**
 59 |     - Determines how often to poll price providers.
 60 |     - Manages multiplexing behavior of websockets and more.
 61 |     - This configuration has been tested by Skip and is safe to use.
 62 |     - The recommended oracle component configuration can be found in `config/core/oracle.json` within the Slinky repo.
 63 | 
 64 | 2. **Market Component**
 65 |     - Determines which markets the sidecar should fetch prices for.
 66 |     - The desired markets will be stored on-chain and pulled by the sidecar.
 67 |     - To properly configure the sidecar, you must point the sidecar to the GRPC port on a node (typically port 9090). This can be done by:
 68 |         - Adding the `--market-map-endpoint` flag when starting the sidecar.
 69 |         - Modifying the `oracle.json` component as shown below:
 70 |         
 71 |         ```json
 72 |         {
 73 |           "market_map_endpoint": "http://localhost:9090"
 74 |         }
 75 |         ```
 76 | 
 77 | ## Installation guide
 78 | 
 79 | ### 1. Install required packages
 80 | ```bash
 81 | sudo apt update && \
 82 | sudo apt install curl git jq build-essential gcc unzip wget -y
 83 | ```
 84 | 
 85 | ### 2. Install Go
 86 | ```bash
 87 | cd $HOME && \
 88 | ver="1.22.2" && \
 89 | wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
 90 | sudo rm -rf /usr/local/go && \
 91 | sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
 92 | rm "go$ver.linux-amd64.tar.gz" && \
 93 | echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile && \
 94 | source $HOME/.bash_profile && \
 95 | go version
 96 | ```
 97 | 
 98 | ### 3. Install `slinky` binary
 99 | ```bash
100 | cd $HOME && \
101 | ver="v0.4.3" && \
102 | git clone https://github.com/skip-mev/slinky.git && \
103 | cd slinky && \
104 | git checkout $ver && \
105 | make build && \
106 | mv build/slinky /usr/local/bin/
107 | ```
108 | 
109 | ### 4. Set Up Variables
110 | 
111 | Set up the necessary environment variables for the oracle sidecar. The `NODE_GRPC_ENDPOINT` should point to the Initia node (validator) gRPC endpoint, which typically runs on port 9090. The `ORACLE_CONFIG_PATH` should point to the local path of the oracle configuration file. The `ORACLE_GRPC_PORT` is the default port for the GRPC server, and the `ORACLE_METRICS_ENDPOINT` is the default Prometheus metrics endpoint.
112 | 
113 | ```bash
114 | echo 'export NODE_GRPC_ENDPOINT="0.0.0.0:9090"' >> ~/.bash_profile
115 | echo 'export ORACLE_CONFIG_PATH="$HOME/slinky/config/core/oracle.json"' >> ~/.bash_profile
116 | echo 'export ORACLE_GRPC_PORT="8080"' >> ~/.bash_profile
117 | echo 'export ORACLE_METRICS_ENDPOINT="0.0.0.0:8002"' >> ~/.bash_profile
118 | source $HOME/.bash_profile
119 | ```
120 | 
121 | ### 5. Update oracle configuration
122 | ```bash
123 | sed -i "s|\"url\": \".*\"|\"url\": \"$NODE_GRPC_ENDPOINT\"|" $ORACLE_CONFIG_PATH
124 | sed -i "s|\"prometheusServerAddress\": \".*\"|\"prometheusServerAddress\": \"$ORACLE_METRICS_ENDPOINT\"|" $ORACLE_CONFIG_PATH
125 | sed -i "s|\"port\": \".*\"|\"port\": \"$ORACLE_GRPC_PORT\"|" $ORACLE_CONFIG_PATH
126 | ```
127 | 
128 | ### 6. Create a Service File
129 | 
130 | Create a systemd service file to manage the Initia Oracle.
131 | 
132 | ```bash
133 | sudo tee /etc/systemd/system/initia-oracle.service > /dev/null <<EOF
134 | [Unit]
135 | Description=Initia Oracle
136 | After=network.target
137 | 
138 | [Service]
139 | User=$USER
140 | Type=simple
141 | ExecStart=$(which slinky) --oracle-config-path $ORACLE_CONFIG_PATH
142 | Restart=on-failure
143 | LimitNOFILE=65535
144 | 
145 | [Install]
146 | WantedBy=multi-user.target
147 | EOF
148 | ```
149 | 
150 | ### 7. Start the Oracle
151 | 
152 | Start the oracle service. After starting, the oracle gRPC endpoint will be available on `$ORACLE_GRPC_PORT`, which is by default port `8080`, and the Prometheus metrics endpoint will be available on `$ORACLE_METRICS_PORT`, which is by default port `8002`.
153 | 
154 | ```bash
155 | sudo systemctl daemon-reload && \
156 | sudo systemctl enable initia-oracle && \
157 | sudo systemctl restart initia-oracle && \
158 | sudo journalctl -u initia-oracle -f -o cat
159 | ```
160 | 
161 | If everything was configured correctly, the logs should look like this:
162 | 
163 | ```py
164 | May 16 13:13:47 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:47.885Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:47.885Z","num_prices":65}
165 | May 16 13:13:47 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:47.887Z","caller":"marketmap/fetcher.go:116","msg":"successfully fetched market map data from module; checking if market map has changed","pid":1731461,"process":"provider_orchestrator"}
166 | May 16 13:13:48 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:48.135Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:48.135Z","num_prices":65}
167 | May 16 13:13:48 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:48.385Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:48.385Z","num_prices":65}
168 | May 16 13:13:48 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:48.635Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:48.635Z","num_prices":65}
169 | May 16 13:13:48 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:48.886Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:48.886Z","num_prices":65}
170 | May 16 13:13:49 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:49.134Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:49.134Z","num_prices":65}
171 | May 16 13:13:49 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:49.386Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:49.386Z","num_prices":65}
172 | May 16 13:13:49 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:49.634Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:49.634Z","num_prices":65}
173 | May 16 13:13:49 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:49.885Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:49.885Z","num_prices":65}
174 | May 16 13:13:50 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:50.133Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:50.133Z","num_prices":65}
175 | May 16 13:13:50 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:50.384Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:50.383Z","num_prices":65}
176 | May 16 13:13:50 slinky[1731461]: {"level":"info","ts":"2024-05-16T13:13:50.633Z","caller":"oracle/oracle.go:163","msg":"oracle updated prices","pid":1731461,"process":"oracle","last_sync":"2024-05-16T13:13:50.633Z","num_prices":65}
177 | ```
178 | 
179 | ### 8. Validating Prices
180 | 
181 | Upon launching the oracle, you should observe successful price retrieval from the provider sources. Additionally, you have the option to execute the test client script available in the Slinky repository. This script requests the Oracle gRPC endpoint for the latest currency pairs every 10 seconds.
182 | 
183 | ```bash
184 | cd $HOME/slinky && \
185 | make run-oracle-client
186 | ```
187 | 
188 | If everything was configured correctly, the logs should look like this:
189 | 
190 | ```py
191 | 2024/05/16 13:09:55 Calling Prices RPC...
192 | 2024/05/16 13:09:55 Currency Pair, Price: (AAVE/USD, 8521408563)
193 | 2024/05/16 13:09:55 Currency Pair, Price: (ADA/USD, 4513805522)
194 | 2024/05/16 13:09:55 Currency Pair, Price: (AEVO/USD, 802320928)
195 | 2024/05/16 13:09:55 Currency Pair, Price: (AGIX/USD, 9239495798)
196 | 2024/05/16 13:09:55 Currency Pair, Price: (ALGO/USD, 1770708283)
197 | 2024/05/16 13:09:55 Currency Pair, Price: (APE/USD, 1201500000)
198 | 2024/05/16 13:09:55 Currency Pair, Price: (APT/USD, 8320064025)
199 | 2024/05/16 13:09:55 Currency Pair, Price: (ARB/USD, 963735494)
200 | 2024/05/16 13:09:55 Currency Pair, Price: (ARKM/USD, 2290116046)
201 | 2024/05/16 13:09:55 Currency Pair, Price: (ASTR/USD, 883253301)
202 | 2024/05/16 13:09:55 Currency Pair, Price: (ATOM/USD, 8336334533)
203 | 2024/05/16 13:09:55 Currency Pair, Price: (AVAX/USD, 3419267707)
204 | 2024/05/16 13:09:55 Currency Pair, Price: (AXL/USD, 1009203681)
205 | 2024/05/16 13:09:55 Currency Pair, Price: (BCH/USD, 4495898359)
206 | 2024/05/16 13:09:55 Currency Pair, Price: (BLUR/USD, 3677470988)
207 | 2024/05/16 13:09:55 Currency Pair, Price: (BNB/USD, 5752300920)
208 | 2024/05/16 13:09:55 Currency Pair, Price: (BONK/USD, 2447979191)
209 | 2024/05/16 13:09:55 Currency Pair, Price: (BTC/USD, 6591886754)
210 | 2024/05/16 13:09:55 Currency Pair, Price: (COMP/USD, 5482192877)
211 | 2024/05/16 13:09:55 Currency Pair, Price: (CRV/USD, 4140000000)
212 | 2024/05/16 13:09:55 Currency Pair, Price: (DOGE/USD, 15217086834)
213 | 2024/05/16 13:09:55 Currency Pair, Price: (DOT/USD, 6829381752)
214 | 2024/05/16 13:09:55 Currency Pair, Price: (DYDX/USD, 2003801520)
215 | 2024/05/16 13:09:55 Currency Pair, Price: (DYM/USD, 2632052821)
216 | 2024/05/16 13:09:55 Currency Pair, Price: (EOS/USD, 7981192476)
217 | 2024/05/16 13:09:55 Currency Pair, Price: (ETC/USD, 2693187274)
218 | 2024/05/16 13:09:55 Currency Pair, Price: (ETH/USD, 2974684873)
219 | 2024/05/16 13:09:55 Currency Pair, Price: (FET/USD, 22224444777)
220 | 2024/05/16 13:09:55 Currency Pair, Price: (FIL/USD, 5745898359)
221 | 2024/05/16 13:09:55 Currency Pair, Price: (GRT/USD, 2969187675)
222 | 2024/05/16 13:09:55 Currency Pair, Price: (HBAR/USD, 1098939575)
223 | 2024/05/16 13:09:55 Currency Pair, Price: (ICP/USD, 1213685474)
224 | 2024/05/16 13:09:55 Currency Pair, Price: (IMX/USD, 2379825930)
225 | 2024/05/16 13:09:55 Currency Pair, Price: (INJ/USD, 2315626250)
226 | 2024/05/16 13:09:55 Currency Pair, Price: (JTO/USD, 4618847539)
227 | 2024/05/16 13:09:55 Currency Pair, Price: (JUP/USD, 11374049619)
228 | 2024/05/16 13:09:55 Currency Pair, Price: (LDO/USD, 1532613045)
229 | 2024/05/16 13:09:55 Currency Pair, Price: (LINK/USD, 13727691076)
230 | 2024/05/16 13:09:55 Currency Pair, Price: (LTC/USD, 8168767507)
231 | 2024/05/16 13:09:55 Currency Pair, Price: (MANA/USD, 4245698279)
232 | 2024/05/16 13:09:55 Currency Pair, Price: (MATIC/USD, 6774709883)
233 | 2024/05/16 13:09:55 Currency Pair, Price: (MKR/USD, 2730146018)
234 | 2024/05/16 13:09:55 Currency Pair, Price: (NEAR/USD, 8033213285)
235 | 2024/05/16 13:09:55 Currency Pair, Price: (NTRN/USD, 67036814)
236 | 2024/05/16 13:09:55 Currency Pair, Price: (OP/USD, 2383653461)
237 | 2024/05/16 13:09:55 Currency Pair, Price: (ORDI/USD, 3757723089)
238 | 2024/05/16 13:09:55 Currency Pair, Price: (PEPE/USD, 101694677871)
239 | ```
240 | 
241 | ### 9. Enable Oracle Vote Extension
242 | 
243 | To utilize the Slinky oracle data in the Initia node, the Oracle setting should be enabled in the `config/app.toml` file. You can do this programmatically with the following script. Make sure to execute this command on the server where your Initia node is running and set the correct variable values if needed.
244 | 
245 | ```bash
246 | ORACLE_GRPC_ENDPOINT="0.0.0.0:8080"
247 | ORACLE_CLIENT_TIMEOUT="500ms"
248 | NODE_APP_CONFIG_PATH="$HOME/.initia/config/app.toml"
249 | 
250 | sed -i '/\[oracle\]/!b;n;c\
251 | enabled = "true"' $NODE_APP_CONFIG_PATH
252 | 
253 | sed -i "/oracle_address =/c\oracle_address = \"$ORACLE_GRPC_ENDPOINT\"" $NODE_APP_CONFIG_PATH
254 | 
255 | sed -i "/client_timeout =/c\client_timeout = \"$ORACLE_CLIENT_TIMEOUT\"" $NODE_APP_CONFIG_PATH
256 | 
257 | sed -i '/metrics_enabled =/c\metrics_enabled = "false"' $NODE_APP_CONFIG_PATH
258 | ```
259 | 
260 | The configuration file located at `$NODE_APP_CONFIG_PATH` should have these fields:
261 | 
262 | ```py
263 | ###############################################################################
264 | ###                                  Oracle                                 ###
265 | ###############################################################################
266 | [oracle]
267 | # Enabled indicates whether the oracle is enabled.
268 | enabled = "true"
269 | 
270 | # Oracle Address is the URL of the out-of-process oracle sidecar. This is used to
271 | # connect to the oracle sidecar when the application boots up. Note that the address
272 | # can be modified at any point, but will only take effect after the application is
273 | # restarted. This can be the address of an oracle container running on the same
274 | # machine or a remote machine.
275 | oracle_address = "0.0.0.0:8080"
276 | 
277 | # Client Timeout is the time that the client is willing to wait for responses from 
278 | # the oracle before timing out.
279 | client_timeout = "500ms"
280 | 
281 | # MetricsEnabled determines whether oracle metrics are enabled. Specifically,
282 | # this enables instrumentation of the oracle client and the interaction between
283 | # the oracle and the app.
284 | metrics_enabled = "false"
285 | ```
286 | 
287 | ## Monitoring
288 | 
289 | ### Oracle Service Metrics
290 | 
291 | Slinky exposes metrics on the `/metrics` endpoint on port `8002` by default. These metrics are in the Prometheus format and can be scraped by Prometheus or any other monitoring system that supports the Prometheus format.
292 | 
293 | The Slinky repository contains a sidecar Grafana dashboard that can be used to monitor Slinky Metrics. Instructions can be found here: [Set Up Grafana Dashboard](https://github.com/skip-mev/slinky/blob/main/metrics.md#set-up)
294 | 
295 | ### Oracle Application Metrics
296 | 
297 | If metrics for the oracle are enabled on the Initia node, they will be exposed on the node's Prometheus port. These metrics provide information about validators' reporting activity for prices and their votes.
298 | 
299 | Metrics can also be checked here: [Slinky Service Metrics](https://github.com/skip-mev/slinky/blob/main/service/metrics/README.md)
300 | 
301 | 
302 | ## Useful commands
303 | ### Monitor server load
304 | ```bash 
305 | sudo apt update
306 | sudo apt install htop -y
307 | htop
308 | ```
309 | 
310 | ### Check logs of the oracle
311 | ```bash
312 | sudo journalctl -u initia-oracle -f -o cat
313 | ```
314 | 
315 | ### Restart the oracle
316 | ```bash
317 | sudo systemctl restart initia-oracle
318 | ```
319 | 
320 | ### Upgrade the oracle
321 | ```bash
322 | ORACLE_VERSION="v0.4.3"
323 | 
324 | cd $HOME && \
325 | git clone https://github.com/skip-mev/slinky.git && \
326 | cd slinky && \
327 | git checkout $ORACLE_VERSION && \
328 | make build && \
329 | mv build/slinky /usr/local/bin/
330 | 
331 | # Restart the oracle
332 | sudo systemctl restart initia-oracle && sudo journalctl -u initia-oracle -f -o cat
333 | ```
334 | 
335 | ### Stop the oracle
336 | ```bash
337 | sudo systemctl stop initia-oracle
338 | ```
339 | 
340 | ### Delete the oracle from the server
341 | ```bash
342 | sudo systemctl stop initia-oracle
343 | sudo systemctl disable initia-oracle
344 | sudo rm /etc/systemd/system/initia-oracle.service
345 | rm -rf $HOME/slinky
346 | sudo rm /usr/local/bin/slinky
347 | ```
348 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | [<img src='assets\Initia-Banner.png' alt='banner' width= '99.9%'>]()
  2 | 
  3 | <font size = 7><center><b><u>About Initia</u></b></center></font>
  4 | 
  5 | * ### **[Initia](https://initia.xyz/)** is a pioneering network for interwoven rollups, revolutionizing blockchain by simplifying complexity and providing a unified platform akin to using your favorite smartphone, inspired by Apple's design philosophy.
  6 | 
  7 | <div align="center">
  8 |   <a href="https://initia.xyz/"><img src="https://github.com/bartosian/celestia-tools/assets/20209819/85aaef48-7ea4-4857-b339-985645c6850c" alt="Website" width="16%"></a>
  9 |   <a href="https://github.com/initia-labs"><img src="https://github.com/bartosian/celestia-tools/assets/20209819/229ec400-72ff-48ee-ac18-7bdb1f5e221a" alt="Github" width="16%"></a>
 10 |   <a href="https://twitter.com/initiaFDN"><img src="https://github.com/bartosian/celestia-tools/assets/20209819/3978b7fc-d575-44a6-8d41-327c14c8ba31" alt="Twitter" width="16%"></a>
 11 |   <a href="https://discord.com/invite/initia"><img src="https://github.com/bartosian/celestia-tools/assets/20209819/944a0b87-548d-4109-ad0c-def572d307cb" alt="Discord" width="16%"></a>
 12 |   <a href="https://medium.com/@initiafdn"><img src="https://github.com/bartosian/celestia-tools/assets/20209819/ac52729b-64d7-44d1-9a66-1e0d159848f6" alt="Blog" width="16.2%"></a>
 13 | </div>
 14 | 
 15 | ### Navigation Menu
 16 | - [Hardware requirements](#hardware-requirements)
 17 | - [TrustedPoint Services](#trustedpoint-services)
 18 | - [Installation guide](#installation-guide)
 19 |   - [1. Install required packages](#1-install-required-packages)
 20 |   - [2. Install Go](#2-install-go)
 21 |   - [3. Install `initia` binary](#3-install-initia-binary)
 22 |   - [4. Set up variables](#4-set-up-variables)
 23 |   - [5. Initialize the node](#5-initialize-the-node)
 24 |   - [6. Download genesis.json](#6-download-genesisjson)
 25 |   - [7. Add seeds and peers to the config.toml](#7-add-seeds-and-peers-to-the-configtoml)
 26 |   - [8. Change ports (Optional)](#8-change-ports-optional)
 27 |   - [9. Configure prunning to save storage (Optional)](#9-configure-prunning-to-save-storage-optional)
 28 |   - [10. Set min gas price](#10-set-min-gas-price)
 29 |   - [11. Enable indexer (Optional)](#11-enable-indexer-optional)
 30 |   - [12. Create a service file](#12-create-a-service-file)
 31 |   - [13. Start the node](#13-start-the-node)
 32 |   - [14. Create a wallet for your validator](#14-create-a-wallet-for-your-validator)
 33 |   - [15. Request tokens from the faucet on Discord](#15-request-tokens-from-the-faucet-on-discord)
 34 |   - [16. Check wallet balance](#16-check-wallet-balance)
 35 |   - [17. Create a validator](#17-create-a-validator)
 36 | - [State sync](#state-sync)
 37 |   - [1. Stop the node](#1-stop-the-node)
 38 |   - [2. Backup priv\_validator\_state.json](#2-backup-priv_validator_statejson)
 39 |   - [3. Reset DB](#3-reset-db)
 40 |   - [4. Setup required variables (One command)](#4-setup-required-variables-one-command)
 41 |   - [4. Move priv\_validator\_state.json back](#4-move-priv_validator_statejson-back)
 42 |   - [5. Start the node](#5-start-the-node)
 43 |   - [6. Check the synchronization status](#6-check-the-synchronization-status)
 44 |   - [7. Disable state sync](#7-disable-state-sync)
 45 | - [Download fresh addrbook.json](#download-fresh-addrbookjson)
 46 |   - [1. Stop the node and use `wget` to download the file](#1-stop-the-node-and-use-wget-to-download-the-file)
 47 |   - [2. Restart the node](#2-restart-the-node)
 48 |   - [3. Check the synchronization status](#3-check-the-synchronization-status)
 49 | - [Add fresh persistent peers](#add-fresh-persistent-peers)
 50 |   - [1. Extract persistent\_peers from our endpoint](#1-extract-persistent_peers-from-our-endpoint)
 51 |   - [2. Restart the node](#2-restart-the-node-1)
 52 |   - [3. Check the synchronization status](#3-check-the-synchronization-status-1)
 53 | - [Download Snapshot](#download-snapshot)
 54 |   - [1. Download latest snapshot from our endpoint](#1-download-latest-snapshot-from-our-endpoint)
 55 |   - [2. Stop the node](#2-stop-the-node)
 56 |   - [3. Backup priv\_validator\_state.json](#3-backup-priv_validator_statejson)
 57 |   - [4. Reset DB](#4-reset-db)
 58 |   - [5. Extract files from the archive](#5-extract-files-fromt-the-arvhive)
 59 |   - [6. Move priv\_validator\_state.json back](#6-move-priv_validator_statejson-back)
 60 |   - [7. Restart the node](#7-restart-the-node)
 61 |   - [8. Check the synchronization status](#8-check-the-synchronization-status)
 62 | - [Useful commands](#useful-commands)
 63 |   - [Check node status](#check-node-status)
 64 |   - [Query your validator](#query-your-validator)
 65 |   - [Query missed blocks counter \& jail details of your validator](#query-missed-blocks-counter--jail-details-of-your-validator)
 66 |   - [Unjail your validator](#unjail-your-validator)
 67 |   - [Delegate tokens to your validator](#delegate-tokens-to-your-validator)
 68 |   - [Get your p2p peer address](#get-your-p2p-peer-address)
 69 |   - [Edit your validator](#edit-your-validator)
 70 |   - [Send tokens between wallets](#send-tokens-between-wallets)
 71 |   - [Query your wallet balance](#query-your-wallet-balance)
 72 |   - [Monitor server load](#monitor-server-load)
 73 |   - [Query active validators](#query-active-validators)
 74 |   - [Query inactive validators](#query-inactive-validators)
 75 |   - [Check logs of the node](#check-logs-of-the-node)
 76 |   - [Restart the node](#restart-the-node)
 77 |   - [Stop the node](#stop-the-node)
 78 |   - [Delete the node from the server](#delete-the-node-from-the-server)
 79 |   - [Example gRPC usage](#example-grpc-usage)
 80 |   - [Example REST API query](#example-rest-api-query)
 81 | 
 82 | ## Hardware requirements
 83 | ```py
 84 | - Memory: 16 GB RAM
 85 | - CPU: 4 cores
 86 | - Disk: 1 TB SSD
 87 | - Bandwidth: 1 Gbps
 88 | - Linux amd64 arm64 (Ubuntu LTS release)
 89 | ```
 90 | ## TrustedPoint Services
 91 | 
 92 | | Parameter | Value
 93 | |-|-
 94 | | indexing | kv
 95 | | pruning | custom (100/17)
 96 | | min-retain-blocks | 0
 97 | | snapshot-interval | 2000
 98 | | snapshot-keep-recent | 2
 99 | | minimum-gas-prices | 0.15uinit
100 | 
101 | ---
102 | - RPC: https://rpc-initia-testnet.trusted-point.com:443
103 | - REST API: https://rpc-initia-testnet.trusted-point.com:443
104 | - WSS: wss://rpc-initia-testnet.trusted-point.com:443/websocket
105 | - P2P Persistent Peer: a63a6f6eae66b5dce57f5c568cdb0a79923a4e18@peer-initia-testnet.trusted-point.com:26628
106 | ---
107 | - State sync: [Guide](#state-sync)
108 | - Fresh Snapshot: [URL](https://rpc-initia-testnet.trusted-point.com/latest_snapshot.tar.lz4) / [Guide](#download-snapshot) **(Being updated every 10 hours)**
109 | - Fresh addrbook: [URL](https://rpc-initia-testnet.trusted-point.com/addrbook.json) / [Guide](#download-fresh-addrbookjson) **(Being updated every 5 minutes)**
110 | - Live Peers scanner: [URL](https://rpc-initia-testnet.trusted-point.com/peers.txt) / [Guide](#add-fresh-persistent-peers) **(Being updated every 5 minutes)**
111 | 
112 | ## Installation guide
113 | 
114 | ### 1. Install required packages
115 | ```bash
116 | sudo apt update && \
117 | sudo apt install curl git jq build-essential gcc unzip wget lz4 -y
118 | ```
119 | ### 2. Install Go
120 | ```bash
121 | cd $HOME && \
122 | ver="1.22.0" && \
123 | wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
124 | sudo rm -rf /usr/local/go && \
125 | sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
126 | rm "go$ver.linux-amd64.tar.gz" && \
127 | echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile && \
128 | source $HOME/.bash_profile && \
129 | go version
130 | ```
131 | ### 3. Install `initia` binary
132 | ```bash
133 | git clone https://github.com/initia-labs/initia.git
134 | cd initia
135 | git checkout v0.2.15
136 | make install
137 | initiad version
138 | ```
139 | ### 4. Set up variables
140 | ```bash
141 | # Customize if you need
142 | echo 'export MONIKER="My_Node"' >> ~/.bash_profile
143 | echo 'export CHAIN_ID="initiation-1"' >> ~/.bash_profile
144 | echo 'export WALLET_NAME="wallet"' >> ~/.bash_profile
145 | echo 'export RPC_PORT="26657"' >> ~/.bash_profile
146 | source $HOME/.bash_profile
147 | ```
148 | ### 5. Initialize the node
149 | ```bash
150 | cd $HOME
151 | initiad init $MONIKER --chain-id $CHAIN_ID
152 | initiad config set client chain-id $CHAIN_ID
153 | initiad config set client node tcp://localhost:$RPC_PORT
154 | initiad config set client keyring-backend os # You can set it to "test" so you will not be asked for a password
155 | ```
156 | ### 6. Download genesis.json
157 | ```bash
158 | wget https://initia.s3.ap-southeast-1.amazonaws.com/initiation-1/genesis.json -O $HOME/.initia/config/genesis.json
159 | ```
160 | ### 7. Add seeds and peers to the config.toml
161 | ```bash
162 | PEERS="e3ac92ce5b790c76ce07c5fa3b257d83a517f2f6@178.18.251.146:30656,2692225700832eb9b46c7b3fc6e4dea2ec044a78@34.126.156.141:26656,2a574706e4a1eba0e5e46733c232849778faf93b@84.247.137.184:53456,40d3f977d97d3c02bd5835070cc139f289e774da@168.119.10.134:26313,1f6633bc18eb06b6c0cab97d72c585a6d7a207bc@65.109.59.22:25756,4a988797d8d8473888640b76d7d238b86ce84a2c@23.158.24.168:26656,e3679e68616b2cd66908c460d0371ac3ed7795aa@176.34.17.102:26656,d2a8a00cd5c4431deb899bc39a057b8d8695be9e@138.201.37.195:53456,329227cf8632240914511faa9b43050a34aa863e@43.131.13.84:26656,517c8e70f2a20b8a3179a30fe6eb3ad80c407c07@37.60.231.212:26656,07632ab562028c3394ee8e78823069bfc8de7b4c@37.27.52.25:19656,028999a1696b45863ff84df12ebf2aebc5d40c2d@37.27.48.77:26656,3c44f7dbb473fee6d6e5471f22fa8d8095bd3969@185.219.142.137:53456,8db320e665dbe123af20c4a5c667a17dc146f4d0@51.75.144.149:26656,c424044f3249e73c050a7b45eb6561b52d0db456@158.220.124.183:53456,767fdcfdb0998209834b929c59a2b57d474cc496@207.148.114.112:26656,edcc2c7098c42ee348e50ac2242ff897f51405e9@65.109.34.205:36656,140c332230ac19f118e5882deaf00906a1dba467@185.219.142.119:53456,4eb031b59bd0210481390eefc656c916d47e7872@37.60.248.151:53456,ff9dbc6bb53227ef94dc75ab1ddcaeb2404e1b0b@178.170.47.171:26656,ffb9874da3e0ead65ad62ac2b569122f085c0774@149.28.134.228:26656" && \
163 | SEEDS="2eaa272622d1ba6796100ab39f58c75d458b9dbc@34.142.181.82:26656,c28827cb96c14c905b127b92065a3fb4cd77d7f6@testnet-seeds.whispernode.com:25756" && \
164 | sed -i \
165 |     -e "s/^seeds *=.*/seeds = \"$SEEDS\"/" \
166 |     -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" \
167 |     "$HOME/.initia/config/config.toml"
168 | ```
169 | ### 8. Change ports (Optional)
170 | ```bash
171 | # Customize if you need
172 | EXTERNAL_IP=$(wget -qO- eth0.me) \
173 | PROXY_APP_PORT=26658 \
174 | P2P_PORT=26656 \
175 | PPROF_PORT=6060 \
176 | API_PORT=1317 \
177 | GRPC_PORT=9090 \
178 | GRPC_WEB_PORT=9091
179 | ```
180 | ```bash
181 | sed -i \
182 |     -e "s/\(proxy_app = \"tcp:\/\/\)\([^:]*\):\([0-9]*\).*/\1\2:$PROXY_APP_PORT\"/" \
183 |     -e "s/\(laddr = \"tcp:\/\/\)\([^:]*\):\([0-9]*\).*/\1\2:$RPC_PORT\"/" \
184 |     -e "s/\(pprof_laddr = \"\)\([^:]*\):\([0-9]*\).*/\1localhost:$PPROF_PORT\"/" \
185 |     -e "/\[p2p\]/,/^\[/{s/\(laddr = \"tcp:\/\/\)\([^:]*\):\([0-9]*\).*/\1\2:$P2P_PORT\"/}" \
186 |     -e "/\[p2p\]/,/^\[/{s/\(external_address = \"\)\([^:]*\):\([0-9]*\).*/\1${EXTERNAL_IP}:$P2P_PORT\"/; t; s/\(external_address = \"\).*/\1${EXTERNAL_IP}:$P2P_PORT\"/}" \
187 |     $HOME/.initia/config/config.toml
188 | ```
189 | ```bash
190 | sed -i \
191 |     -e "/\[api\]/,/^\[/{s/\(address = \"tcp:\/\/\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$API_PORT\4/}" \
192 |     -e "/\[grpc\]/,/^\[/{s/\(address = \"\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$GRPC_PORT\4/}" \
193 |     -e "/\[grpc-web\]/,/^\[/{s/\(address = \"\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$GRPC_WEB_PORT\4/}" \
194 |     $HOME/.initia/config/app.toml
195 | ```
196 | ### 9. Configure prunning to save storage (Optional)
197 | ```bash
198 | sed -i \
199 |     -e "s/^pruning *=.*/pruning = \"custom\"/" \
200 |     -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" \
201 |     -e "s/^pruning-interval *=.*/pruning-interval = \"10\"/" \
202 |     "$HOME/.initia/config/app.toml"
203 | ```
204 | ### 10. Set min gas price 
205 | ```bash
206 | sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.15uinit,0.01uusdc\"/" $HOME/.initia/config/app.toml
207 | ```
208 | ### 11. Disable indexer
209 | ```bash
210 | sed -i "s/^indexer *=.*/indexer = \"null\"/" $HOME/.initia/config/config.toml
211 | ```
212 | ### 12. Create a service file
213 | ```bash
214 | sudo tee /etc/systemd/system/initiad.service > /dev/null <<EOF
215 | [Unit]
216 | Description=Initia Node
217 | After=network.target
218 | 
219 | [Service]
220 | User=$USER
221 | Type=simple
222 | ExecStart=$(which initiad) start --home $HOME/.initia
223 | Restart=on-failure
224 | LimitNOFILE=65535
225 | 
226 | [Install]
227 | WantedBy=multi-user.target
228 | EOF
229 | ```
230 | ### 13. Start the node
231 | ```bash
232 | sudo systemctl daemon-reload && \
233 | sudo systemctl enable initiad && \
234 | sudo systemctl restart initiad && \
235 | sudo journalctl -u initiad -f -o cat
236 | ```
237 | P.S. Consider [downloading snapshot](#download-snapshot) or using [state-sync](#state-sync) for the quick sync.
238 | 
239 | ### 14. Create a wallet for your validator
240 | ```bash
241 | initiad keys add $WALLET_NAME
242 | 
243 | # DO NOT FORGET TO SAVE THE SEED PHRASE
244 | # You can add --recover flag to restore existing key instead of creating
245 | ```
246 | ### 15. Request tokens from the faucet on Discord
247 | -> <a href="https://faucet.testnet.initia.xyz/"><font size="4"><b><u>FAUCET</u></b></font></a> <-
248 | ### 16. Check wallet balance
249 | Make sure your node is fully synced unless it won't work.
250 | ```bash
251 | initiad status | jq -r .sync_info
252 | ```
253 | ```bash
254 | initiad q bank balances $(initiad keys show $WALLET_NAME -a) 
255 | ```
256 | ### 17. Create a validator
257 | ```bash
258 | initiad tx mstaking create-validator \
259 |   --amount=1000000uinit \
260 |   --pubkey=$(initiad tendermint show-validator) \
261 |   --moniker=$MONIKER \
262 |   --chain-id=$CHAIN_ID \
263 |   --commission-rate=0.05 \
264 |   --commission-max-rate=0.10 \
265 |   --commission-max-change-rate=0.01 \
266 |   --from=$WALLET_NAME \
267 |   --identity="" \
268 |   --website="" \
269 |   --details="Initia to the moon!" \
270 |   --gas=2000000 --fees=300000uinit \
271 |   -y
272 | ```
273 | Do not forget to save `priv_validator_key.json` file located in $HOME/.initia/config/
274 | 
275 | ## State sync
276 | 
277 | ### 1. Stop the node
278 | ```bash
279 | sudo systemctl stop initiad
280 | ```
281 | ### 2. Backup priv_validator_state.json 
282 | ```bash
283 | cp $HOME/.initia/data/priv_validator_state.json $HOME/.initia/priv_validator_state.json.backup
284 | ```
285 | ### 3. Reset DB
286 | ```bash
287 | initiad tendermint unsafe-reset-all --home $HOME/.initia --keep-addr-book
288 | ```
289 | ### 4. Setup required variables (One command)
290 | ```bash
291 | PEERS="a63a6f6eae66b5dce57f5c568cdb0a79923a4e18@peer-initia-testnet.trusted-point.com:26628" && \
292 | RPC="https://rpc-initia-testnet.trusted-point.com:443" && \
293 | LATEST_HEIGHT=$(curl -s --max-time 3 --retry 2 --retry-connrefused $RPC/block | jq -r .result.block.header.height) && \
294 | TRUST_HEIGHT=$((LATEST_HEIGHT - 1500)) && \
295 | TRUST_HASH=$(curl -s --max-time 3 --retry 2 --retry-connrefused "$RPC/block?height=$TRUST_HEIGHT" | jq -r .result.block_id.hash) && \
296 | 
297 | if [ -n "$PEERS" ] && [ -n "$RPC" ] && [ -n "$LATEST_HEIGHT" ] && [ -n "$TRUST_HEIGHT" ] && [ -n "$TRUST_HASH" ]; then
298 |     sed -i.bak \
299 |         -e "/\[statesync\]/,/^\[/{s/\(enable = \).*$/\1true/}" \
300 |         -e "/^rpc_servers =/ s|=.*|= \"$RPC,$RPC\"|;" \
301 |         -e "/^trust_height =/ s/=.*/= $TRUST_HEIGHT/;" \
302 |         -e "/^trust_hash =/ s/=.*/= \"$TRUST_HASH\"/" \
303 |         -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" \
304 |         $HOME/.initia/config/config.toml
305 |     echo -e "\nLATEST_HEIGHT: $LATEST_HEIGHT\nTRUST_HEIGHT: $TRUST_HEIGHT\nTRUST_HASH: $TRUST_HASH\nPEERS: $PEERS\n\nALL IS FINE"
306 | else
307 |     echo -e "\nError: One or more variables are empty. Please try again or change RPC\nExiting...\n"
308 | fi
309 | ```
310 | ### 4. Move priv_validator_state.json back
311 | ```bash
312 | mv $HOME/.initia/priv_validator_state.json.backup $HOME/.initia/data/priv_validator_state.json
313 | ```
314 | ### 5. Start the node
315 | ```bash
316 | sudo systemctl restart initiad && sudo journalctl -u initiad -f -o cat
317 | ```
318 | You should see the following logs. It may take up to 5 minutes for the snapshot to be discovered. If doesn't work, try downloading [snapshot](#download-snapshot)
319 | ```py
320 | 2:39PM INF sync any module=statesync msg="Discovering snapshots for 15s" server=node
321 | 2:39PM INF Discovered new snapshot format=3 hash="?^��I��\r�=�O�E�?�CQD�6�\x18�F:��\x006�" height=602000 module=statesync server=node
322 | 2:39PM INF Discovered new snapshot format=3 hash="%���\x16\x03�T0�v�f�C��5�<TlLb�5��l!�M" height=600000 module=statesync server=node
323 | 2:42PM INF VerifyHeader hash=CFC07DAB03CEB02F53273F5BDB6A7C16E6E02535B8A88614800ABA9C705D4AF7 height=602001 module=light server=node
324 | ```
325 | After some time you should see the following logs. It make take 5 minutes for the node to catch up the rest of the blocks
326 | ```py
327 | 2:43PM INF indexed block events height=602265 module=txindex server=node
328 | 2:43PM INF executed block height=602266 module=state num_invalid_txs=0 num_valid_txs=0 server=node
329 | 2:43PM INF commit synced commit=436F6D6D697449447B5B31313720323535203139203132392031353920313035203136352033352031353320313220353620313533203139352031372036342034372033352034372032333220373120313939203720313734203620313635203338203336203633203235203136332039203134395D3A39333039417D module=server
330 | 2:43PM INF committed state app_hash=75FF13819F69A523990C3899C311402F232FE847C707AE06A526243F19A30995 height=602266 module=state num_txs=0 server=node
331 | 2:43PM INF indexed block events height=602266 module=txindex server=node
332 | 2:43PM INF executed block height=602267 module=state num_invalid_txs=0 num_valid_txs=0 server=node
333 | 2:43PM INF commit synced commit=436F6D6D697449447B5B323437203134322032342031313620323038203631203138362032333920323238203138312032333920313039203336203420383720323238203236203738203637203133302032323220313431203438203337203235203133302037302032343020313631203233372031312036365D3A39333039427D module=server
334 | ```
335 | ### 6. Check the synchronization status
336 | ```bash
337 | initiad status | jq -r .sync_info
338 | ```
339 | ### 7. Disable state sync
340 | ```bash
341 | sed -i.bak -e "/\[statesync\]/,/^\[/{s/\(enable = \).*$/\1false/}" $HOME/.initia/config/app.toml
342 | ```
343 | ## Download fresh addrbook.json
344 | 
345 | ### 1. Stop the node and use `wget` to download the file
346 | ```bash
347 | sudo systemctl stop initiad && \
348 | wget -O $HOME/.initia/config/addrbook.json https://rpc-initia-testnet.trusted-point.com/addrbook.json
349 | ```
350 | ### 2. Restart the node
351 | ```bash
352 | sudo systemctl restart initiad && sudo journalctl -u initiad -f -o cat
353 | ```
354 | ### 3. Check the synchronization status
355 | ```bash
356 | initiad status | jq -r .sync_info
357 | ```
358 | The file is being updated every 5 minutes
359 | 
360 | ## Add fresh persistent peers
361 | 
362 | ### 1. Extract persistent_peers from our endpoint
363 | ```bash
364 | PEERS=$(curl -s --max-time 3 --retry 2 --retry-connrefused "https://rpc-initia-testnet.trusted-point.com/peers.txt")
365 | if [ -z "$PEERS" ]; then
366 |     echo "No peers were retrieved from the URL."
367 | else
368 |     echo -e "\nPEERS: "$PEERS""
369 |     sed -i "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" "$HOME/.initia/config/config.toml"
370 |     echo -e "\nConfiguration file updated successfully.\n"
371 | fi
372 | ```
373 | ### 2. Restart the node
374 | ```bash
375 | sudo systemctl restart initiad && sudo journalctl -u initiad -f -o cat
376 | ```
377 | ### 3. Check the synchronization status
378 | ```bash
379 | initiad status | jq -r .sync_info
380 | ```
381 | Peers are being updated every 5 minutes
382 | 
383 | ## Download Snapshot
384 | 
385 | ### 1. Download latest snapshot from our endpoint
386 | ```bash
387 | wget https://snapshots.kjnodes.com/initia-testnet/snapshot_latest.tar.lz4 -O latest_snapshot.tar.lz4
388 | 
389 | # https://rpc-initia-testnet.trusted-point.com/latest_snapshot.tar.lz4 is under maintenance. Please use kjnode's one
390 | ```
391 | ### 2. Stop the node
392 | ```bash
393 | sudo systemctl stop initiad
394 | ```
395 | ### 3. Backup priv_validator_state.json 
396 | ```bash
397 | cp $HOME/.initia/data/priv_validator_state.json $HOME/.initia/priv_validator_state.json.backup
398 | ```
399 | ### 4. Reset DB
400 | ```bash
401 | initiad tendermint unsafe-reset-all --home $HOME/.initia --keep-addr-book
402 | ```
403 | ### 5. Extract files from the archive 
404 | ```bash
405 | lz4 -d -c ./latest_snapshot.tar.lz4 | tar -xf - -C $HOME/.initia
406 | ```
407 | ### 6. Move priv_validator_state.json back
408 | ```bash
409 | mv $HOME/.initia/priv_validator_state.json.backup $HOME/.initia/data/priv_validator_state.json
410 | ```
411 | ### 7. Restart the node
412 | ```bash
413 | sudo systemctl restart initiad && sudo journalctl -u initiad -f -o cat
414 | ```
415 | ### 8. Check the synchronization status
416 | ```bash
417 | initiad status | jq -r .sync_info
418 | ```
419 | Snapshot is being updated every 3 hours
420 | 
421 | ## Useful commands
422 | ### Check node status 
423 | ```bash
424 | initiad status | jq
425 | ```
426 | ### Query your validator
427 | ```bash
428 | initiad q mstaking validator $(initiad keys show $WALLET_NAME --bech val -a) 
429 | ```
430 | ### Query missed blocks counter & jail details of your validator
431 | ```bash
432 | initiad q slashing signing-info $(initiad tendermint show-validator)
433 | ```
434 | ### Unjail your validator 
435 | ```bash
436 | initiad tx slashing unjail --from $WALLET_NAME --gas=2000000 --fees=300000uinit -y
437 | ```
438 | ### Delegate tokens to your validator 
439 | ```bash 
440 | initiad tx mstaking delegate $(initiad keys show $WALLET_NAME --bech val -a)  <AMOUNT>uinit --from $WALLET_NAME --gas=2000000 --fees=300000uinit -y
441 | ```
442 | ### Get your p2p peer address
443 | ```bash
444 | initiad status | jq -r '"\(.NodeInfo.id)@\(.NodeInfo.listen_addr)"'
445 | ```
446 | ### Edit your validator
447 | ```bash 
448 | initiad tx mstaking edit-validator --website="<WEBSITE>" --details="<DESCRIPTION>" --moniker="<NEW_MONIKER>" --from=$WALLET_NAME --gas=2000000 --fees=300000uinit -y
449 | ```
450 | ### Send tokens between wallets 
451 | ```bash
452 | initiad tx bank send $WALLET_NAME <TO_WALLET> <AMOUNT>uinit --gas=2000000 --fees=300000uinit -y
453 | ```
454 | ### Query your wallet balance 
455 | ```bash
456 | initiad q bank balances $WALLET_NAME
457 | ```
458 | ### Monitor server load
459 | ```bash 
460 | sudo apt update
461 | sudo apt install htop -y
462 | htop
463 | ```
464 | ### Query active validators
465 | ```bash
466 | initiad q mstaking validators -o json --limit=1000 \
467 | | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' \
468 | | jq -r '.voting_power + " - " + .description.moniker' \
469 | | sort -gr | nl
470 | ```
471 | ### Query inactive validators
472 | ```bash
473 | initiad q mstaking validators -o json --limit=1000 \
474 | | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' \
475 | | jq -r '.voting_power + " - " + .description.moniker' \
476 | | sort -gr | nl
477 | ```
478 | ### Check logs of the node
479 | ```bash
480 | sudo journalctl -u initiad -f -o cat
481 | ```
482 | ### Restart the node
483 | ```bash
484 | sudo systemctl restart initiad
485 | ```
486 | ### Stop the node
487 | ```bash
488 | sudo systemctl stop initiad
489 | ```
490 | ### Delete the node from the server
491 | ```bash
492 | # !!! IF YOU HAVE CREATED A VALIDATOR, MAKE SURE TO BACKUP `priv_validator_key.json` file located in $HOME/.initia/config/ 
493 | sudo systemctl stop initiad
494 | sudo systemctl disable initiad
495 | sudo rm /etc/systemd/system/initiad.service
496 | rm -rf $HOME/.initia
497 | sudo rm /usr/local/bin/initiad
498 | ```
499 | ### Example gRPC usage
500 | ```bash
501 | wget https://github.com/fullstorydev/grpcurl/releases/download/v1.7.0/grpcurl_1.7.0_linux_x86_64.tar.gz
502 | tar -xvf grpcurl_1.7.0_linux_x86_64.tar.gz
503 | chmod +x grpcurl
504 | ./grpcurl  -plaintext  localhost:$GRPC_PORT list
505 | ### MAKE SURE gRPC is enabled in app.toml
506 | # grep -A 3 "\[grpc\]" $HOME/.initia/config/app.toml
507 | ```
508 | ### Example REST API query
509 | ```bash
510 | curl localhost:$API_PORT/cosmos/mstaking/v1beta1/validators
511 | ### MAKE SURE API is enabled in app.toml
512 | # grep -A 3 "\[api\]" $HOME/.initia/config/app.toml
513 | ```
514 | 
515 | 


--------------------------------------------------------------------------------