Hello World — La Tua Prima Transazione su Savitri

Questo tutorial ti guida da zero fino all'invio della tua prima transazione sulla testnet di Savitri. Scegli il percorso più adatto al tuo profilo.

Percorso	Per	Tempo	Prerequisiti
A. Portafoglio Browser	Utenti crypto	2 min	Chrome/Brave
B. App Mobile	Utenti mobile	3 min	iOS o Android
C. Installer Desktop	Utenti non tecnici	5 min	Windows o macOS
D. Docker (Sviluppatore)	Sviluppatori	5 min	Docker installato
E. Build dal Sorgente	Sviluppatori Rust	15 min	Rust 1.82+

---

A. Portafoglio Browser

Tempo: 2 minuti

1. Installa l'estensione Savitri Wallet dal Chrome Web Store

2. Apri l'estensione e clicca su Crea Portafoglio

3. Annota la tua frase seed di 12 parole e conservala in modo sicuro

4. Il tuo portafoglio è connesso automaticamente alla testnet di Savitri

5. Ottieni token testnet dal faucet:

   • Apri il portafoglio
   • Clicca su Richiedi Token Testnet
   • Attendi 10 secondi per la conferma

6. Invia la tua prima transazione:

   • Clicca su Invia
   • Inserisci qualsiasi indirizzo testnet (o usa l'indirizzo di esempio mostrato nel portafoglio)
   • Inserisci un importo (es. 10 SAVI)
   • Clicca su Conferma

7. Controlla la transazione nella scheda Cronologia del portafoglio

Hai finito. Hai creato un portafoglio, ricevuto token e inviato una transazione su Savitri.

---

B. App Mobile

Tempo: 3 minuti

1. Scarica l'app Savitri:

   • iOS (App Store)
   • Android (Play Store)

2. Apri l'app e tocca Crea Nuovo Portafoglio

3. Salva la tua frase seed in modo sicuro

4. L'app si connette alla testnet e avvia un nodo leggero in background

5. Tocca Ricevi per vedere il tuo indirizzo di portafoglio

6. Tocca Faucet per ricevere SAVI testnet gratuiti

7. Tocca Invia → inserisci un indirizzo destinatario → inserisci l'importo → conferma

8. Osserva la transazione apparire in Attività

In più: vai alla scheda Nodo per vedere lo stato del tuo lightnode, i peer connessi e il punteggio PoU.

---

C. Installer Desktop

Tempo: 5 minuti

1. Scarica il programma di installazione:

   • Windows (.exe)
   • macOS (.dmg)

2. Esegui il programma di installazione e segui la procedura guidata (15 passaggi, con guida)

3. Scegli il tipo di nodo:

   • Lightnode (consigliato per la prima volta) — risorse minime
   • Masternode — validatore completo (richiede 8 GB+ di RAM)

4. Il programma di installazione scarica il binario del nodo, genera le chiavi e configura tutto

5. Clicca su Avvia Nodo — il tuo nodo si connette alla testnet

6. Apri la scheda Portafoglio → Crea Portafoglio → salva la tua frase seed

7. Clicca su Faucet → ricevi token testnet

8. Clicca su Invia → inserisci il destinatario → inserisci l'importo → conferma

9. Controlla la scheda Dashboard per le metriche in tempo reale: altezza del blocco, peer, punteggio PoU

---

D. Docker (Sviluppatore)

Tempo: 5 minuti

Prerequisiti

• Docker installato (scarica Docker)

Passo 1: Avvia un lightnode

docker run -d --name savitri-node \
  -p 4001:4001 -p 8545:8545 -p 9090:9090 \
  savitri/lightnode:testnet

Passo 2: Verifica che sia in esecuzione

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"chain_getBlockHeight","params":[],"id":1}'

Risposta attesa:

{"jsonrpc":"2.0","result":{"height":12345},"id":1}

Passo 3: Crea un portafoglio

# Genera una nuova coppia di chiavi
curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"wallet_create","params":[],"id":2}'

Salva l'indirizzo e la chiave privata restituiti.

Passo 4: Ottieni token testnet

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"faucet_request","params":["YOUR_ADDRESS"],"id":3}'

Passo 5: Controlla il saldo

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"account_getBalance","params":["YOUR_ADDRESS"],"id":4}'

Passo 6: Invia una transazione

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tx_send",
    "params":{
      "from":"YOUR_ADDRESS",
      "to":"RECIPIENT_ADDRESS",
      "amount":"1000000000000000000",
      "private_key":"YOUR_PRIVATE_KEY"
    },
    "id":5
  }'

L'importo è in wei (18 decimali). 1000000000000000000 = 1 SAVI.

Passo 7: Esegui una testnet locale completa (opzionale)

git clone --recurse-submodules https://github.com/Savitri-Network/savitri-network.git
cd savitri-network/savitri-testnet
docker-compose up -d

Questo avvia: 2 masternode, 1 lightnode, 1 guardian, Prometheus e Grafana.

• Dashboard Grafana: http://localhost:3000
• Metriche Prometheus: http://localhost:9090
• RPC (masternode 1): http://localhost:8545
• RPC (masternode 2): http://localhost:8546
• RPC (lightnode): http://localhost:8547

---

E. Build dal Sorgente

Tempo: 15 minuti

Prerequisiti

# macOS
brew install rustup cmake ninja llvm openssl zstd lz4 ccache protobuf
rustup install stable

# Ubuntu / Debian
sudo apt install build-essential pkg-config clang llvm-dev libclang-dev \
  cmake ninja-build libssl-dev zlib1g-dev liblz4-dev libzstd-dev
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Windows — installa Visual Studio Build Tools con il carico di lavoro C++ + Windows SDK

Passo 1: Clona e compila

git clone --recurse-submodules https://github.com/Savitri-Network/savitri-network.git
cd savitri-network

# Compila un lightnode
cargo build --release -p savitri-lightnode

Passo 2: Avvia il nodo

./target/release/lightnode \
  --listen-port 4001 \
  --tx-interval-secs 2 \
  --block-interval-secs 10 \
  --max-block-txs 32 \
  --bootstrap <PEER_ID>@/ip4/<TESTNET_IP>/tcp/4002

Ottieni l'indirizzo di bootstrap della testnet corrente dalla configurazione testnet.

Passo 3: Genera le chiavi

cargo build --release -p savitri-sdk
./target/release/key_generator

Questo restituisce la tua chiave pubblica (indirizzo) e la chiave privata.

Passo 4: Invia una transazione via RPC

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tx_send",
    "params":{
      "from":"YOUR_ADDRESS",
      "to":"RECIPIENT_ADDRESS",
      "amount":"1000000000000000000",
      "private_key":"YOUR_PRIVATE_KEY"
    },
    "id":1
  }'

Passo 5: Deploy di un token (opzionale)

Vedi il tutorial completo: Deploy di un Token SAVITRI-20

---

Prossimi Passi

Obiettivo	Risorsa
Comprendere l'architettura	Panoramica Architettura
Deploy di un token	Tutorial Deploy Token
Esegui un validatore (masternode)	Tipi di Nodo
Sviluppa con l'SDK	Panoramica SDK
Esplora l'API RPC	Riferimento Metodi RPC
Unisciti alla community	Discord
Leggi la tokenomics	Allocazione Token
Documentazione completa	docs.savitrinetwork.com