book: leva_tetto unica per cuscino USDE e giornale (#28)
La leva lorda massima del libro era ridichiarata con tre formule diverse: usde.frazione_cuscino (N_ASSET fisso, senza scala), la regola `leva` del giornale (senza scala) e journal.movimenti_capitale (con scala). A scala 1,25 il cuscino USDC risultava 0,30 dell'equity invece di 0,375. Nuova src/live/book.leva_tetto(cfg) = len(ASSETS) x min(WEIGHT, frac) x scala, al piu' LEVA_LORDA_MAX; su ScalaNonAutorizzata non solleva, ritorna il tetto di codice (cuscino_watch non deve morire sulla config sbagliata). usde.frazione_cuscino e la regola `leva` del giornale ora la derivano; movimenti_capitale idem, nel suo try/except esistente. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -136,6 +136,42 @@ def _scala(real_equity: float | None = None, eq_fallback: str | None = None,
|
||||
return s
|
||||
|
||||
|
||||
def leva_tetto(cfg: dict | None = None) -> tuple[float, str]:
|
||||
"""Leva lorda massima che il libro PUO' prendere. UNA formula, non tre (#28): prima era
|
||||
ridichiarata in `usde.frazione_cuscino` (N_ASSET fisso, senza scala) e nella regola `leva` del
|
||||
giornale (senza scala) -> a scala 1,25 il cuscino USDC risultava 0,30 dell'equity invece di
|
||||
0,375, e la regola `leva` mostrava un tetto diverso da quello che il libro rispetta davvero.
|
||||
|
||||
leva = len(ASSETS) x min(WEIGHT, frac) x scala, al piu' LEVA_LORDA_MAX. -> (leva, come).
|
||||
- frac = cfg["max_notional_per_asset_frac"] se presente, altrimenti WEIGHT. Il min(WEIGHT, frac)
|
||||
viene dal fatto che `book_net_target` non supera mai weight*equity*(W_TP01+W_SKH) =
|
||||
weight*equity (i due pesi sommano a 1): |raw| <= weight*equity, quindi |net_target| <=
|
||||
scala*min(cap, weight*equity) -- un frac oltre WEIGHT alza il cap nominale ma non la leva
|
||||
REALE che il libro puo' esprimere.
|
||||
- scala = la scala DICHIARATA (`_scala(real_equity=1.0, cfg=cfg)`, gia' validata): un tetto
|
||||
descrive quanto la config AUTORIZZA, non quanto un giro con equity illeggibile ha preso.
|
||||
- Su `ScalaNonAutorizzata` (config fuori scaletta o fuori tetto) NON si solleva: un
|
||||
sorvegliante (`cuscino_watch`) non deve morire proprio quando la config e' sbagliata
|
||||
(verifica fable B5) -> si ritorna il tetto di CODICE, dichiarando l'anomalia in `come`.
|
||||
"""
|
||||
if cfg is None:
|
||||
cfg = json.loads(CONFIG.read_text()) if CONFIG.exists() else {}
|
||||
try:
|
||||
scala = _scala(real_equity=1.0, cfg=cfg)
|
||||
except ScalaNonAutorizzata as e:
|
||||
breve = str(e).splitlines()[0]
|
||||
breve = breve if len(breve) <= 80 else breve[:77] + "..."
|
||||
return LEVA_LORDA_MAX, (f"config fuori scaletta/tetto ({breve}): "
|
||||
f"tetto di codice LEVA_LORDA_MAX")
|
||||
raw_frac = cfg.get("max_notional_per_asset_frac")
|
||||
frac = float(raw_frac) if raw_frac is not None else WEIGHT
|
||||
frac_eff = min(WEIGHT, frac)
|
||||
leva = len(ASSETS) * frac_eff * scala
|
||||
base = f"{len(ASSETS)} asset x frac {frac_eff} x scala {scala} = {leva:.2f}x"
|
||||
if leva > LEVA_LORDA_MAX + 1e-12:
|
||||
return LEVA_LORDA_MAX, f"{base}, troncato al tetto di codice {LEVA_LORDA_MAX}x"
|
||||
return leva, base
|
||||
|
||||
|
||||
def _read_watermark() -> float | None:
|
||||
"""Ultima equity REALE osservata sul conto. None se mai vista o file illeggibile."""
|
||||
|
||||
+12
-14
@@ -192,12 +192,10 @@ def movimenti_capitale(con, fino_ts: str, rows=None) -> dict:
|
||||
return dict(eventi=[], certi=0.0, ambigui=0.0, soglia=soglia, avvisi=avvisi)
|
||||
try:
|
||||
cfg = json.loads((PROJECT_ROOT / "config" / "live.json").read_text())
|
||||
# la leva lorda massima che il libro puo' tenere: frac x n_asset x scala, mai oltre il
|
||||
# tetto di CODICE (P1: derivata da `book`, non ridichiarata — la chiave di scala del
|
||||
# 01/09 entra qui da sola)
|
||||
scala = float(cfg.get("book_scale_k") or 1.0)
|
||||
leva_tetto = min(float(cfg["max_notional_per_asset_frac"]) * len(ASSETS) * scala,
|
||||
float(_book.LEVA_LORDA_MAX))
|
||||
# la leva lorda massima che il libro puo' tenere: UNA sola formula, in `book.leva_tetto`
|
||||
# (P1: derivata da `book`, non ridichiarata — #28 ne aveva tre diverse fra qui,
|
||||
# usde.frazione_cuscino e la regola `leva` sotto, e non tornavano)
|
||||
leva_tetto = _book.leva_tetto(cfg)[0]
|
||||
except Exception:
|
||||
leva_tetto = float(_book.LEVA_LORDA_MAX) # config illeggibile: il tetto di codice
|
||||
px = {a: _px_1h(a) for a in ASSETS} if candidati else {}
|
||||
@@ -567,17 +565,17 @@ def lettura(con, voce: dict) -> list[dict]:
|
||||
# --- quanto capitale e' esposto ----------------------------------------------------------
|
||||
lv = lb.get("leva_lorda")
|
||||
if lv is not None:
|
||||
# Il tetto si LEGGE da config/live.json. Ridichiararlo qui e' lo schema che questo
|
||||
# progetto ha gia' pagato quattro volte (fee_watch, test di guardia sul cap, taratura
|
||||
# venue_watch, indice del namespace): un sorvegliante che ridichiara il proprio
|
||||
# bersaglio continua a passare il giorno che il bersaglio cambia.
|
||||
# Il tetto si LEGGE da `book.leva_tetto`, non ridichiarato qui. Ridichiararlo e' lo schema
|
||||
# che questo progetto ha gia' pagato quattro volte (fee_watch, test di guardia sul cap,
|
||||
# taratura venue_watch, indice del namespace) — e una quinta, con una formula diversa da
|
||||
# quella di `movimenti_capitale` e di `usde.frazione_cuscino`, e' quella corretta da #28.
|
||||
from src.live import book as _book # lazy: prende il tetto vivo, anche monkeypatchato
|
||||
try:
|
||||
cfg = json.loads((PROJECT_ROOT / "config" / "live.json").read_text())
|
||||
cap_frac = float(cfg["max_notional_per_asset_frac"])
|
||||
tetto = cap_frac * len(lb["asset"])
|
||||
tetto, come = _book.leva_tetto(cfg)
|
||||
dire("leva", f"Leva lorda **{lv:.2f}x** su un tetto di {tetto:.2f}x "
|
||||
f"(`max_notional_per_asset_frac` {cap_frac:.2f} x {len(lb['asset'])} "
|
||||
f"asset, letto da `config/live.json`): margine {tetto - lv:.2f}x.")
|
||||
f"({come}, da `config/live.json` e `book.leva_tetto`): "
|
||||
f"margine {tetto - lv:.2f}x.")
|
||||
except Exception as e:
|
||||
dire("leva", f"Leva lorda **{lv:.2f}x**; tetto non verificabile "
|
||||
f"({type(e).__name__} su config/live.json).", "attenzione")
|
||||
|
||||
+6
-6
@@ -104,12 +104,12 @@ def valuta(eq_usde: float, px: float | None) -> tuple[float, str]:
|
||||
# il saldo USDC va negativo alla prima perdita del libro e Deribit lo finanzia allo 0,05%/GIORNO
|
||||
# (KB "Cross collateral specifications": 18,25%/anno, 4,3x la resa USDE). Il cuscino richiesto e'
|
||||
# il disaster-SL sulla MASSIMA esposizione lorda che il libro puo' prendere:
|
||||
# n_asset x frac x disaster_sl_pct x equity_totale
|
||||
# book.leva_tetto() x disaster_sl_pct x equity_totale
|
||||
# tutto letto da config/live.json e src/live/book.py, MAI ridichiarato (P1). Prima del 10/09 la
|
||||
# formula viveva in scripts/live/usde_convert.py; il sorvegliante cuscino_watch la deriva da qui,
|
||||
# e usde_convert pure — due lettori, una formula.
|
||||
|
||||
N_ASSET = 2
|
||||
# e usde_convert pure — due lettori, una formula. ⚠️ Fino al #28 la leva lorda era RIDICHIARATA
|
||||
# qui (N_ASSET fisso x WEIGHT, senza scala): a scala 1,25 dava 0,30 invece di 0,375. Ora la stessa
|
||||
# `book.leva_tetto` che usa anche il giornale (src/live/journal.py).
|
||||
|
||||
|
||||
def frazione_cuscino() -> tuple[float, str]:
|
||||
@@ -117,8 +117,8 @@ def frazione_cuscino() -> tuple[float, str]:
|
||||
cfg = json.loads(CFG_PATH.read_text())
|
||||
sl = float(cfg["disaster_sl_pct"])
|
||||
from src.live import book as B # lazy: book importa shadow, che importa questo modulo
|
||||
frac = float(B.WEIGHT)
|
||||
return N_ASSET * frac * sl, f"{N_ASSET} asset x frac {frac} x SL {sl:.0%}"
|
||||
leva, come_leva = B.leva_tetto(cfg)
|
||||
return leva * sl, f"{come_leva} x SL {sl:.0%}"
|
||||
|
||||
|
||||
def cuscino_richiesto_usd(equity_tot: float) -> tuple[float, str]:
|
||||
|
||||
Reference in New Issue
Block a user