Skip to content

docs: complete La Tanda testnet validator guide — closes #373#377

Closed
zeroknowledge0x wants to merge 1 commit into
INDIGOAZUL:mainfrom
zeroknowledge0x:docs/validator-guide-373
Closed

docs: complete La Tanda testnet validator guide — closes #373#377
zeroknowledge0x wants to merge 1 commit into
INDIGOAZUL:mainfrom
zeroknowledge0x:docs/validator-guide-373

Conversation

@zeroknowledge0x

Copy link
Copy Markdown

Closes #373

Summary

Adds a comprehensive La Tanda Testnet Validator Guide (chain/la-tanda-testnet-validator-guide.md) covering the full validator lifecycle — from server provisioning through validator creation, state sync, systemd service management, monitoring, and ongoing maintenance.

What's Included

All 18 sections specified in the issue, plus 4 appendices:

Sections (1–18)

  1. Server requirements — hardware minimums, cloud provider recommendations, port table
  2. Ubuntu preparation — system updates, packages, UFW firewall, SSH hardening, swap, system limits
  3. Go installation — Go 1.24.1 setup with PATH configuration
  4. Latanda binary installation — quick install script + manual build from source
  5. Chain initializationlatandad init with explanation of every created file
  6. Genesis download — with SHA-256 hash verification (mismatch warning)
  7. Peer configuration — persistent peers, seeds, gas price, config.toml/app.toml tuning
  8. Systemd service creation — complete unit file with parameter explanations
  9. Starting and managing the node — systemctl commands, log viewing, sync verification
  10. State sync configuration — trusted block fetching, config application, data reset, disable after sync
  11. Wallet creation — create, list, show, recover, balance check, key backup
  12. Faucet/verification process — Discord faucet, platform KYC, team contact, balance verification
  13. Validator creation — full create-validator command with parameter table explanation
  14. Validator management commands — edit, delegate, unbond, withdraw, redelegate, unjail, delegations, rewards, send
  15. Monitoring and health checks — quick checks, signing status, health check script with cron, disk monitoring
  16. Common troubleshooting — 7 scenarios: won't start, 0 peers, jailed, stuck block, genesis mismatch, out of disk, insufficient funds, out of gas
  17. Security recommendations — SSH, fail2ban, key permissions, backup strategy table, sentry node architecture diagram
  18. Useful maintenance commands — categorized quick-reference cheatsheet

Appendices

  • A. Quick Start — Complete zero-to-validator in one code block
  • B. State Sync Quick Setup — Copy-paste state sync for existing nodes
  • C. Network Information — All URLs, endpoints, hashes, contacts in one table
  • D. CLI Command Quick Reference — ASCII cheatsheet card

Key Differentiators from Existing Guides

Feature Existing chain/ guides This guide
Process manager PM2 (requires Node.js) Systemd (native Linux)
Sync method Full sync from genesis only State sync (minutes vs hours)
Monitoring Basic jq checks Health check script + cron + signing info
Audience Node operators / beginners Validator operators specifically
Troubleshooting 3 basic scenarios 7 scenarios with solutions
Security Brief checklist SSH hardening + key management + sentry architecture
CLI reference Scattered commands Categorized cheatsheet + ASCII card

File Added

  • chain/la-tanda-testnet-validator-guide.md — 1,400 lines, complete validator lifecycle documentation

Reward

Comprehensive scope — 75 LTD as specified in the issue.
Payment wallet (EVM): 0x036E525f4569865DA76A0ef758304b309740aeef

…L#373)

Comprehensive 18-section validator guide covering:
- Server requirements and Ubuntu preparation
- Go installation and latandad binary build
- Chain initialization, genesis, and peer configuration
- Systemd service creation (replaces PM2)
- State sync configuration for fast bootstrapping
- Wallet creation and backup
- Faucet/token request process
- Validator creation with commission explanation
- Full validator management command reference
- Monitoring, health checks, and cron automation
- Troubleshooting for common issues
- Security hardening recommendations
- Maintenance command cheatsheet
- 4 appendices: quick start, state sync, network info, CLI ref
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown

PR Gatekeeper

This PR has been automatically closed. Follow the process in CONTRIBUTING.md and try again.

@github-actions github-actions Bot closed this Jun 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOCS] Complete La Tanda Testnet Validator Guide (Systemd + State Sync + Validator Setup)

1 participant