Skip to content

Commit fe24fdc

Browse files
authored
chore: add note on XRPL node spinup (#1371)
1 parent 56c0e85 commit fe24fdc

File tree

2 files changed

+17
-4
lines changed

2 files changed

+17
-4
lines changed

src/content/docs/validator/amplifier/verifier-onboarding.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,11 @@ docker run -p 50051:50051 --env MNEMONIC_CMD=auto --env NOPASSWORD=true --env AD
9696
Leave this process running in the background, and perform additional commands in a new terminal window or shell.
9797

9898
<Callout>
99-
Note: If you are running a validator as well, you must run different `tofnd` instances for `vald` (for your validator) and `ampd` (for your verifier). You cannot use the same `tofnd` instance for both.
99+
Note: If you are running a validator as well, you should use a different node for your verifier (the Axelar node that ampd connects to) on both testnet and mainnet than the one being run for your validator node to prevent loss of rewards in case the verifier fails. This node can use the `everything` pruning config to reduce resource use.
100+
</Callout>
101+
102+
<Callout>
103+
Note: You also must run different `tofnd` instances for `vald` (for your validator) and `ampd` (for your verifier). You cannot use the same `tofnd` instance for both.
100104
</Callout>
101105

102106
## Set up `ampd`

src/content/docs/validator/external-chains/xrpl.mdx

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -147,12 +147,21 @@ You can query the node with:
147147
curl -H 'Content-Type: application/json' -d '{"method":"server_info","params":[{}]}' http://localhost:5005
148148
```
149149

150+
## Axelar Node Configuration
150151

151-
### Ampd Configuration
152-
Once your node is up and running, you need to add the `XRPL` chain to your [ampd daemon's](https://github.com/axelarnetwork/axelar-amplifier/tree/main/ampd) `config.toml`file. This can be done by adding in the following configuration:
152+
Due to a bug in the Cosmos SDK that appears when the database is being read from under heavy load, when `ampd` is trying to broadcast transactions, your Axelar node may run into issues when running (such as an `AppHash` error). An example of such an error may appear as follows:
153+
154+
`ERR CONSENSUS FAILURE!!! err="precommit step; +2/3 prevoted for an invalid block: wrong Block.Header.AppHash`
153155

154-
For testnet:
156+
Your node orchestration needs to be updated to perform a `rollback` when a node crashes. The rollback command must be executed **before restarting the Axelar node** to auto-recover from such errors. The rollback can be performed by running:
155157

158+
```bash
159+
axelard rollback
160+
```
161+
162+
163+
### Ampd Configuration
164+
Once your node is up and running, you need to add the `XRPL` chain to your [ampd daemon's](https://github.com/axelarnetwork/axelar-amplifier/tree/main/ampd) `config.toml`file. This can be done by adding in the following configuration:
156165

157166
<tabs>
158167
<tab-item title="Mainnet">

0 commit comments

Comments
 (0)