From 1dbdcfefcd1ef20c3993c4fb6e2e6bb8158fb9ec Mon Sep 17 00:00:00 2001
From: loweel <loweel@gmx.de>
Date: Sun, 28 Sep 2025 13:40:21 +0200
Subject: [PATCH] Migliorato README.md

---
 README.md | 44 ++++++++++++++++++++++++++++++++------------
 1 file changed, 32 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 2d8b643..ac24e4c 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 ---
 
-## ✨ Cosa fa
+## Cosa fa
 
 1. **Scarica** gli ultimi *kline* da Binance per il pair ETH/USDT (fino a ~300 giorni).
 2. **Costruisce un dataset** di log-return e feature derivate.
@@ -22,7 +22,7 @@
 
 ---
 
-## 🧠 Modello / Pipeline ML
+## Modello / Pipeline ML
 
 * **RNN:** LSTM a **64 unità** su finestre temporali (sequenze) dei log-return.
 * **Target:** variazione percentuale del prezzo *close* del giorno successivo.
@@ -34,7 +34,7 @@
 
 ---
 
-## 🔎 Logica decisionale (semplificata)
+## Logica decisionale (semplificata)
 
 1. **Predizione** `pred_rel_move` (es. +0.8%).
 2. **Quote THORNode** → **fee_totale** (bp o valore assoluto) per importi di riferimento.
@@ -54,7 +54,7 @@
 
 ---
 
-## 🧩 Perché Matrix
+##  Perché Matrix
 
 Il demone **non esegue ordini**: invia **notifiche su Matrix** con la decisione, i numeri (predizione, fee, edge) e le **istruzioni manuali** per lo swap. In questo modo:
 
@@ -74,7 +74,7 @@ Istruzioni: eseguire swap su THORChain con slip <= 1%, poi aggiornare balance.js
 
 ---
 
-## 🛠️ Installazione
+## Installazione
 
 ### Requisiti
 
@@ -98,7 +98,7 @@ docker run --rm -d \
 
 ---
 
-## ⚙️ Variabili d’ambiente
+## Variabili d’ambiente
 
 > Tutte opzionali salvo dove indicato.
 
@@ -122,16 +122,16 @@ docker run --rm -d \
 * `RUN_AT_START`
   Se `true`, esegue subito un ciclo all’avvio oltre alla schedule. Default: `true`.
 * `RUN_HOUR`
-  Ora locale (0–23) per il giro giornaliero. Default: `7`.
+  Ora locale (0–23) per il giro giornaliero. Default: `24`.
 * `TZ`
-  Timezone (es. `Europe/Berlin`). Default: sistema/container.
+  Timezone (es. `Europe/Berlin`). Default: quello del sistema/container.
 
 ### THORNode / Fee
 
 * `THORNODE_URL` **(richiesto)**
   Endpoint THORNode per quote (es. `https://thornode.ninerealms.com`).
 * `REF_FROM`
-  **Importo di riferimento in asset A (ETH)** per stimare fee. Default: `5.0`.
+  **Importo di riferimento in asset A (ETH)** per stimare fee. Default: `5.0`. Serve per avere la quotazione dello swap da THORNet.
 * `REF_TO`
   **Importo di riferimento in asset B (USDT)** per stima inversa. Default: `10000`.
 * `MAX_SLIP_BPS`
@@ -230,6 +230,28 @@ state/
 2025/09/28 07:00:13 instructions: eseguire swap ETH→USDT su THORChain, slip<=1.0%, size≈ref
 ```
 
+##  Esempi di output su matrix
+
+HOLD
+
+```
+consiglio: azione=HOLD expectedBps=18.602 feeBps=26.000 netBps=-7.398 confOK=true motivo=Previsione rialzista ma non abbastanza sopra fee+margine o confidenza bassa
+Suggerimento: nessuna azione (HOLD). Motivo=Previsione rialzista ma non abbastanza sopra fee+margine o confidenza bassa
+Suggerimento valido sino a: 2025-09-28 12:58:03 CEST
+La quotazione dei costi è valida sino a 2025-09-28 12:58:03 CEST (≈ 14m 59s restanti). Non fare lo swap dopo questa data.
+```
+
+SWAP
+
+```
+consiglio: azione=ETH -> USDT expectedBps=-63.477 feeBps=8.000 netBps=45.477 confOK=true motivo=Previsione ribassista per asset from, confidenza valida, guadagno oltre fee+margine
+ISTRUZIONI MANUALI: esegui swap ETH.ETH->ETH.USDT amount=0.10000000; procedi solo se feeTotali<=53.477 bps (stima THOR=8.000 bps) e costo<=~0.00053477 ETH.ETH | motivo=Previsione ribassista per asset from, confidenza valida, guadagno oltre fee+margine
+Suggerimento valido sino a: 2025-09-28 12:58:03 CEST
+La quotazione dei costi è valida sino a 2025-09-28 12:58:03 CEST (≈ 14m 59s restanti). Dopo questa data, verifica i costi di swap
+```
+
+
+
 ---
 
 ##  Troubleshooting
@@ -255,7 +277,7 @@ state/
 
 ## 📄 Licenza
 
-MIT (o specificare).
+VEDI file LICENSE (o specificare).
 
 ---
 
@@ -267,6 +289,4 @@ MIT (o specificare).
 * [ ] Monta `data/`, `models/`, `state/`.
 * [ ] Avvia container e verifica i log.
 
----
 
-Se vuoi, posso aggiungere un **esempio di `.env`** o le **istruzioni Docker Compose** già pronte.