Guadagna TON con la Tua GPU

Fornisci potenza di calcolo alla rete Cocoon e ricevi TON per l'elaborazione delle richieste di inferenza AI. Sicuro, trasparente e completamente automatizzato.

Scarica Cocoon Worker Leggi la Documentazione

Come Funziona

Scarica e Installa

Scarica la distribuzione Cocoon Worker, estraila e configura le tue impostazioni.

Configura GPU e Wallet

Configura la tua GPU NVIDIA per il calcolo confidenziale e fornisci il tuo indirizzo wallet TON.

Guadagna TON

Avvia il worker e ricevi pagamenti automatici in TON per ogni richiesta AI elaborata.

Requisiti Hardware

Requisiti GPU

GPU: NVIDIA H100 / H200
VRAM: 80GB+
CC: Supporto Confidential Computing richiesto
Serie RTX NON supportata per produzione

Requisiti Server

CPU: Intel (TDX)
Linux: 6.16+
QEMU: 10.1+
RAM: 128GB+

Software e Account

VBIOS aggiornato (tramite supporto NVIDIA)
Token Hugging Face
Wallet TON per i pagamenti

Calcolatore di Guadagni

Seleziona GPU

Modello AI

Utilizzo della Rete: 50%

~125 TON

al mese (stimato)

Questi sono valori stimati. I guadagni effettivi dipendono dalla domanda della rete, dalla selezione del modello e dal tempo di attivita.

Avvio Rapido

1. Scarica e decomprimi

wget https://ci.cocoon.org/cocoon-worker-release-latest.tar.xz
tar xzf cocoon-worker-release-latest.tar.xz
cd cocoon-worker

2. Avvia seal-server (richiesto per produzione)

./bin/seal-server --enclave-path ./bin/enclave.signed.so

3. Configura il worker

cp worker.conf.example worker.conf
# Modifica configurazione:
# owner_address = IL_TUO_INDIRIZZO_WALLET_TON
# gpu = 0000:01:00.0
# model = Qwen/Qwen3-0.6B
# hf_token = hf_xxx...

4. Avvia il worker

./scripts/cocoon-launch worker.conf

Per istruzioni dettagliate, consulta la guida di configurazione completa.

Come Funzionano i Pagamenti

👤 Wallet Cliente

→

🔄 Contratto Proxy

→

⚙️ Contratto Worker

→

💰 Il Tuo Wallet

Pagamenti Automatici

Gli smart contract sulla blockchain TON gestiscono tutti i pagamenti automaticamente. Nessuna richiesta manuale necessaria.

Trasparente e Verificabile

Tutte le transazioni sono registrate on-chain. Visualizza i tuoi guadagni in qualsiasi momento tramite l'explorer TON.

Sicurezza e Privacy

🔒

Intel TDX

I worker operano all'interno di macchine virtuali isolate hardware. L'host non puo accedere ai dati delle richieste.

🛡️

Privacy dei Dati

Tutti i prompt e le risposte sono crittografati. Non vedi mai i dati degli utenti.

✅

Attestazione GPU

La verifica hardware garantisce che solo GPU genuine partecipino alla rete.

📄

Smart Contract

Contratti open-source su TON garantiscono pagamenti equi e trasparenti.

Guida di Configurazione Completa

1 Prerequisiti

Prima di iniziare, assicurati che il tuo hardware e software soddisfino i seguenti requisiti per eseguire un worker Cocoon.

Requisiti Hardware

GPU: NVIDIA H100 / H200 (Confidential Computing)
CPU: Intel Xeon (TDX support)
RAM: 128GB+ DDR5
Storage: NVMe SSD, 500GB+
Network: 1Gbps+, stable connection

Requisiti Software

Linux: Kernel 6.16+ (TDX support)
QEMU: 10.1+ (TDX patches)
NVIDIA Driver: 560+

Note: Le GPU consumer (serie RTX) non sono supportate per mancanza di capacità Confidential Computing.

2 Aggiornamento VBIOS

L'attestazione GPU richiede un VBIOS speciale abilitato per CC. Le versioni VBIOS standard non supportano le funzionalità di attestazione necessarie per il deployment in produzione.

Processo di Aggiornamento

Contatta il Supporto Aziendale NVIDIA con il numero di serie della tua GPU
Richiedi un VBIOS abilitato per CC per il tuo modello specifico di GPU (H100/H200)
Segui le istruzioni NVIDIA per flashare il nuovo VBIOS
Verifica l'aggiornamento con nvidia-smi e controlla la disponibilità della modalità CC

Attenzione: Il flashing errato del VBIOS può danneggiare la tua GPU. Segui attentamente le istruzioni NVIDIA.

3 Configurazione TDX

Intel Trust Domain Extensions (TDX) fornisce macchine virtuali isolate a livello hardware. TDX deve essere abilitato nel BIOS per i worker di produzione.

Impostazioni BIOS

Entra nel setup del BIOS (di solito F2/Del all'avvio)
Vai alle impostazioni Sicurezza o CPU Avanzate
Abilita "Intel TDX" o "Trust Domain Extensions"
Salva e riavvia

Verifica che TDX sia Attivo

dmesg | grep -i tdx

4 File di Configurazione

Il file worker.conf (formato INI) contiene tutte le impostazioni per il tuo worker. Copia il file di esempio e modificalo con i tuoi valori.

cp worker.conf.example worker.conf
nano worker.conf

Parametri Richiesti

Parametro	Descrizione
`type`	Deve essere "worker"
`model`	Modello AI da servire (es. Qwen/Qwen3-0.6B)
`owner_address`	Il tuo indirizzo wallet TON per i pagamenti
`gpu`	Indirizzo PCI della GPU (trova con lspci \| grep -i nvidia)
`hf_token`	Token API Hugging Face per il download del modello
`node_wallet_key`	Chiave privata del wallet worker codificata in Base64

Parametri Opzionali

Parametro	Predefinito	Descrizione
`instance`	0	Numero di istanza del worker per configurazioni multi-GPU
`worker_coefficient`	1000	Moltiplicatore di prezzo (1000 = 1.0x, 1500 = 1.5x)
`persistent`	auto	Percorso all'immagine disco persistente

Esempio di Configurazione

type = worker
model = Qwen/Qwen3-0.6B
owner_address = EQC...your_ton_address
gpu = 0000:01:00.0
hf_token = hf_xxxxxxxxxxxxx
node_wallet_key = base64_encoded_key
ton_config = ./mainnet-config.json
root_contract_address = EQ...

Tip: Usa lspci | grep -i nvidia per trovare l'indirizzo PCI della tua GPU.

5 Seal Server

seal-server fornisce una derivazione sicura delle chiavi per i guest TDX utilizzando un enclave SGX. Deve essere eseguito sull'host prima di avviare i worker.

Perché seal-server è Richiesto

Deriva chiavi crittografiche legate all'immagine TDX
Le chiavi persistono attraverso i riavvii
Garantisce che l'host non possa accedere ai segreti del worker

Avvia seal-server

./bin/seal-server --enclave-path ./bin/enclave.signed.so

Note: Una singola istanza di seal-server può servire più worker. Mantienila in esecuzione in un terminale separato o come servizio systemd.

6 Avvia Worker

Dopo aver configurato worker.conf e avviato seal-server, puoi lanciare il worker in diverse modalità.

Modalità di Esecuzione

Modalità	Comando
Produzione	`./scripts/cocoon-launch worker.conf`
Test (TON reale)	`./scripts/cocoon-launch --test worker.conf`
Test (TON simulato)	`./scripts/cocoon-launch --test --fake-ton worker.conf`

Sovrascritture da Riga di Comando

./scripts/cocoon-launch \
  --instance 0 \
  --worker-coefficient 1500 \
  --model Qwen/Qwen3-8B \
  worker.conf

7 Configurazione Multi-GPU

Esegui più worker su un singolo server, ciascuno gestendo una GPU. Usa il flag --instance per assegnare identificatori unici.

Assegnazione Porte

Instance	Port	CID
0	12000	6
1	12010	16
2	12020	26

Avvia Più Worker

# GPU 1
./scripts/cocoon-launch --instance 0 --gpu 0000:01:00.0 worker.conf &

# GPU 2
./scripts/cocoon-launch --instance 1 --gpu 0000:41:00.0 worker.conf &

Tip: Ogni istanza ottiene automaticamente uno storage persistente separato.

8 Monitoraggio

Monitora lo stato e le prestazioni del worker attraverso endpoint HTTP e l'utilità health-client.

Endpoint HTTP

Endpoint	Descrizione
`/stats`	Stato leggibile
`/jsonstats`	Formato JSON per automazione
`/perf`	Metriche delle prestazioni

curl http://localhost:12000/stats
curl http://localhost:12000/jsonstats | jq

Comandi Health Client

./health-client --instance worker status
./health-client -i worker gpu
./health-client -i worker logs cocoon-vllm 100
./health-client -i worker all

9 Risoluzione dei Problemi

Problemi comuni e relative soluzioni nell'esecuzione dei worker Cocoon.

Il Worker Non Si Avvia

Verifica che seal-server sia in esecuzione
Controlla che la GPU sia in modalità CC
Conferma che il VBIOS sia aggiornato
Assicurati che TDX sia abilitato nel BIOS

Comandi Diagnostici

# Check GPU CC mode
nvidia-smi -q | grep "Confidential"

# Verify seal-server
ps aux | grep seal-server

# Check TDX
dmesg | grep -i tdx

# View logs
./health-client -i worker logs cocoon-vllm 50

Risorse

Domande Frequenti

Quanto posso guadagnare?

I guadagni dipendono dal tuo modello GPU, dai modelli AI che servi, dall'utilizzo della rete e dal tempo di attivita. Usa il nostro calcolatore sopra per le stime. Man mano che la rete cresce, il potenziale di guadagno aumentera.

Quali GPU sono supportate?

Attualmente, solo NVIDIA H100 e GPU piu recenti con supporto Confidential Computing sono accettate per la produzione. Le GPU consumer (serie RTX) non sono supportate per mancanza di capacita CC.

E sicuro per il mio hardware?

Si. Cocoon esegue carichi di lavoro di inferenza AI, non mining tradizionale. Non c'e usura eccessiva della tua GPU. L'ambiente TEE garantisce un'esecuzione sicura e isolata.

Come configuro piu GPU?

Esegui istanze worker separate per ogni GPU usando il flag --instance. Ogni istanza ottiene porte uniche e gestisce una GPU. Esempio: ./scripts/cocoon-launch --instance 0 --gpu 0000:01:00.0 worker.conf

Cos'e seal-server e perche e richiesto?

seal-server fornisce derivazione sicura delle chiavi per i guest TDX usando un enclave SGX. Garantisce che le chiavi crittografiche del tuo worker sopravvivano ai riavvii e siano legate all'immagine verificata. Senza di esso, i worker di produzione non si avvieranno.

Come aggiorno il VBIOS per l'attestazione GPU?

Contatta il supporto NVIDIA per richiedere un VBIOS abilitato CC per il tuo modello GPU. Le versioni VBIOS standard potrebbero non supportare l'attestazione. Questo e richiesto per il deployment in produzione.

Cosa fare se il mio worker non si avvia?

Verifica: 1) seal-server e in esecuzione, 2) GPU e in modalita CC (usa lo script setup-gpu-vfio), 3) VBIOS e aggiornato, 4) TDX e abilitato nel BIOS. Consulta la documentazione di deployment per la risoluzione dei problemi.