https://github.com/epignatelli/solange
https://github.com/epignatelli/solange
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/epignatelli/solange
- Owner: epignatelli
- Created: 2024-11-24T10:25:37.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-11-26T22:15:04.000Z (11 months ago)
- Last Synced: 2024-11-26T22:25:37.683Z (11 months ago)
- Language: Shell
- Size: 25.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SOLANGE: Building and executing solana validators
**[Quickstart](#what-is-solange)** | **[Setup](#setup-the-node)** | **[Execution](#execute-the-node)** | **[Monitoring](#monitoring)** | **[Examples](#examples)**
## What is SOLANGE?
Solange is a set of scripts to build and execute a solana validator node. It is designed to be a plug-and-play solution for developers who want to run a validator node on the solana network.
## Setup the node
#### 1. [On validator machine] Setup solana on validator node
*Make sure you run this a `sol` user!*
```bash
git clone https://github.com/epignatelli/solange $HOME/solange
chmod +x $HOME/solange/install/setup.sh
$HOME/solange/install/setup.sh --ledger-drive /dev/nvme0n1 --accounts-drive /dev/nvme1n1
```
#### 2. [On personal machine] Create accounts
```bash
git clone https://github.com/epignatelli/solange $HOME/solange
chmod +x $HOME/solange/install/create_accounts.sh
chmod +x $HOME/solange/install/transfer_keys.sh
$HOME/solange/install/create_accounts.sh --network 'devnet'
$HOME/solange/install/transfer_keys.sh --remote-host solana-latte.ignorelist.com
```
## Execute the node
The installation script creates a systemd service that runs the validator. You can start the service with the following command:
```bash
sudo systemctl enable --now sol
```
## Monitoring
Checks how many slots behind the validator is, and if it is syncing
```bash
solana catchup
```
Displays information about the validator progressing through the slots
```bash
solana-validator -l monitor
```
The command solana gossip lists all validators that have registered with the protocol.
```bash
solana gossip | grep
```
## Roadmap
1. Setup paper wallet or ledger.
1. Add support for solblaze - https://stake-docs.solblaze.org/protocol/delegation-strategy
2. Add support for marinade - https://github.com/marinade-finance/validator-bonds/tree/main/packages/validator-bonds-cli
3. Add support for jito
4. Add support for jpool
5. Add support for socean
6. Add support for daopool
7. Add support for eversol
8. Setup fail2ban
## References
- Operating a validator: https://docs.anza.xyz/operations
- Install solana: https://docs.anza.xyz/cli/install
- Jito: https://www.jito.network/docs/jitosol/introduction-to-jito/
- Youtube workshop: https://www.youtube.com/watch?v=b0-vMyoojuo&list=PLilwLeBwGuK6jKrmn7KOkxRxS9tvbRa5p
- Solana economic design: https://solana.com/docs/core/fees#basic-economic-design
- Economy calculator: https://cogentcrypto.io/ValidatorProfitCalculator#AuBB9st3RqhHBkzZgBSm6SVnHZNJQSHeBWCSkik4bzdA
- Initiatives: https://docs.anza.xyz/operations/validator-initiatives
- Solana delegation program: https://solana.org/delegation-program
- Solblaze: https://solblaze.com/
- Marinade: https://marinade.finance/
- Validator economy articles:
- https://laine-sa.medium.com/solana-staking-rewards-validator-economics-how-does-it-work-6718e4cccc4e
- https://apfikunmi.medium.com/running-a-solana-validator-a95cdfd6488a#5533
- https://medium.com/@aadesolaade2341/decoding-solana-unraveling-the-role-of-validators-and-fee-economics-bd3eb40a08c3
- Vote modding: https://www.anza.xyz/blog/feature-gate-spotlight-timely-vote-credits
- Lending solana: https://solend.fi/
## Stake delegators
- [Solblaze](https://stake-docs.solblaze.org/protocol/delegation-strategy)
- [Marinade](https://docs.marinade.finance/marinade-protocol/validators-1/)
- [Jito](https://www.jito.network/)
- [Jpool](https://jpool.io/)
- [Socean](https://socean.io/)
- [DaoPool](https://daopool.io/)
- [EverSol] https://eversol.eu/en/
## How to pick top validators
- https://www.reddit.com/r/solana/comments/119viy4/which_is_best_solana_staking_validator/
- https://topvalidators.app/
- https://solanabeach.io/validators
- https://app.marinade.finance/network/validators/?validatorsFilter=All+Validators&direction=descending&sorting=stake
## Monitoring app
Things to monitor:
- If the validator is running / alert if delinquent
- Account balance / alert if below a threshold
- If the validator is caught up with the network / alert if not
- Have a tab with the logs
- Have a tab with the gossip