trade-iac/doc/etap-005-solana-rpc-user-svc.md

Etap 005: Solana RPC jako usługa użytkownika solana

Cel etapu: przygotować i wdrożyć baseline pod solana-rpc, uruchamiany jako dedykowany użytkownik systemowy solana (nie root).

Zakres

1. Rozszerzyć playbook o:
   • pakiety bazowe dla hosta RPC,
   • utworzenie użytkownika i katalogów solana,
   • deployment unitu systemd solana-rpc.service z User=solana.
2. Dodać zmienne grupowe sol_rpc (ścieżki, porty, opcje startu).
3. Dodać bezpieczną logikę startu:
   • unit jest wdrażany zawsze,
   • start usługi tylko gdy istnieją wymagane artefakty (agave-validator, identity keypair).
4. Wdrożyć na mevnode i zweryfikować stan.

Kryteria akceptacji

• id solana istnieje na mevnode.
• /etc/systemd/system/solana-rpc.service istnieje i zawiera User=solana.
• Playbook kończy się bez błędów.
• Jeśli binarka/identity nie istnieją, playbook raportuje to jawnie i nie wymusza startu.