Flussi finanziari tra catene

(Sezione Ecosistema e Rete)

1) Perché gestire il denaro intercorrente

• Sicurezza e finalizzazione: tenere conto solo di fatti irreversibili.
• Liquidità e costi: ridurre al minimo il costo dei corridoi con riserve sufficienti.
• Rapporti e verifiche: tracciabilità completa con doppi appunti e prati.
• Compilation: AML/sanzioni, residenza, limiti di giurisdizione.

2) Tipologia dei flussi finanziari

1. Depositi: on-ramp portafoglio/conto utente (onchain/offshain).
2. Pagamenti: off-ramp/criptovalute, indirizzo esterno/PSP.
3. Traduzioni a catena (bridge): lock/mint, burn/release, messaggistica-based.
4. Swap/Conversione (FX): cross-asset/chain swap con prezzo degli oracoli.
5. Clearing e royalties, rapporti periodici.
6. Commissione e contenimento: network fee, bridge fee, take rate, rebates.
7. Operazioni del Tesoro (treasury): ricalance della liquidità e hedge.

3) Ruoli e tracciati

Ponte/Releer - Consente il trasferimento di stati/risorse e laghetti.
Tesoro (Treasury): riserve per catene/valute, limiti, hedge.
PSP/Lui-off-rampe - mappe/ARM/banche/crypto-scambio locale.
Oracoli/quotazioni: prezzi degli asset, FX e commissioni.
Rischio/Complaens: AML/KYC/KYB, sanzioni, limiti velocity.
Contabilità/BI: doppia voce, rapporti finali, controlli.

4) Architettura di flusso

Ingest (ponte/PSP/nodo) → Raw/Bronze (dati di movimento) → Clean/Silver (normalizzazione, deducibilità, laghetti) → Core/Gold (doppia voce, posizioni, obblighi) → Marts (finanza, rischio, royalties) → Serve/API (rapporti, clearing, limiti).
Proprietà chiave: idempotenza, versioning degli schemi, replay/backfill, late data.

5) Finalizzazione, riorghi e finestre di discussione

States: «osserved confirmed (K)» finalization «invalidated» (+ «challenged» per i ponti ottimistici).

• Conferme K per chain/asset/importo ('K↑' per grandi traduzioni).
• Delayed Finalization per importi high-risk e nuovi ponti.
• Reorg handling: disabilità automatica + riconteggio aggregazioni.
• Proof coverage: la percentuale di record con laghi validi è del 99%.

6) Pricing, commissioni e FX

Prezzo: 'effettiva _ amount = amount - (network _ fee + bridge _ fee + fx _ spread)'

Oracoli: quotazione mediana, protezione da outlier, prezzi time-weighted.
Finestra scivolante per il corso a lunghi corridoi; fissa il tasso di cambio in «osserved _ at» o «event _ at», per il criterio del report.
Fee buckets - mappe stradali delle commissioni per corridor/asset.

7) Liquidità e limiti

Riserve: bilanci target per catene/asset, buffer per picchi.
Corridoi, limiti diurni, soglie di chiamata del Tesoro.
Rebalance: Rebriging/market swap, cost-aware (inclusi latency e fee).
Piano Stress: falback asset/catene, temporaneo aumento K/finestra del contenzioso.

yaml treasury:
corridors:
"eth->polygon:USDC": { daily_usd: 1_000_000, k: 20, alert_at_pct: 80 }
"polygon->eth:USDC": { daily_usd: 800_000, k: 24, alert_at_pct: 75 }
reserves:
eth:   { usdc_min: 300_000, native_gas_min_usd: 25_000 }
polygon: { usdc_min: 250_000, native_gas_min_usd: 10_000 }

8) Contratti di eventi e idemotia

yaml event:
id: uuid type: bridge. lock    bridge. mint    payout. requested    payout. finalized    deposit. settled ts: 2025-10-31T19:00:00Z chain_id: "eth-mainnet"
asset: "USDC"
amount: "123. 45"
src: "0x..." # address/organization dst: "0x..."    iban    wallet_id status: observed    confirmed    finalized    invalidated proof_ref: "merkle:..."
idempotency_key: "${chain}    ${block}    ${tx}    ${log}    ${type}"
fx: { base: "USD", rate: "1. 00", source: "oracle:v2" }
fees: { network: "1. 23", bridge: "0. 50" }

Regola di deduplicazione upsert per «idempotency _ key» nella finestra ≥ 72 ore.

9) Doppio record e contabilità (Core Ledger)

sql
CREATE TABLE ledger_entries (
id UUID PRIMARY KEY,
ts TIMESTAMPTZ,
account_dr TEXT, -- debit account_cr TEXT, -- credit amount NUMERIC (38.9),
currency TEXT, -- canonical accounting currency (for example, USD)
ref_event_id UUID,
meta JSONB
);

CREATE TABLE positions (
account TEXT PRIMARY KEY,
balance NUMERIC(38,9),
currency TEXT
);

Esempio di cablaggio: traduzione intercorrente USDC (lock→mint)

`Dr Bridge Receivable (dst_chain:USDC)` / `Cr Cash (src_chain:USDC)` — при lock.
`Dr Cash (dst_chain:USDC)` / `Cr Bridge Receivable (dst_chain:USDC)` — при mint(finalized).
Le commissioni vengono riflesse con linee singole ('Bridge Fee Revenue', 'Network Fee Expense').

10) Crocifissione e clearing

Incrocio T per catene, asset, provider/ponti, giorno.
Proof match: ricevute di entrambi i lati del corridoio (src/dst) e importi (con margine di errore).
Dispute flow: quarantena di anomalie (asset/decimals/amount mismatch).
Clearing royalties: solo per «finalization», FX per «event _ at» o «observed _ at», secondo il criterio.

sql
-- Lock/mint bundle
SELECT l. tx_hash AS src_tx, m. tx_hash AS dst_tx, l. amount, m. amount
FROM core_events l
JOIN core_events m ON m. type='bridge. mint' AND m. proof_ref = l. proof_ref
WHERE l. type='bridge. lock' AND l. status='finalized' AND m. status='finalized';

-- Daily reconciliation by asset/chain
SELECT chain_id, asset,
SUM(CASE WHEN direction='in' THEN amount ELSE 0 END) AS inflow,
SUM(CASE WHEN direction='out' THEN amount ELSE 0 END) AS outflow
FROM flows
WHERE ts::date = CURRENT_DATE - INTERVAL '1 day'
GROUP BY chain_id, asset;

11) Complaence e residenza

AML/KYC/KYB: compilazioni, liste di sanzioni, fonti di fondi.
Residenza/localizzazione: tornizzazione PII, chiavi di crittografia regionali, esportazione in elenchi bianchi.
I limiti velocity sono per user/org/corridor/day.
Controllo trail - Registri di accesso invariati, firma eventi.

12) Osservabilità: SLI/SLO e metriche

• Finality p95 per corridor/asset,
• Traduzioni Success Rate,
• Proof Coverage%,
• Queue-Lag p95 (bus/ponte),
• Soluzione dei corsi FX,
• Liquidity Utilization% (carico di riserva),
• Reorg/Challenge Rate,
• Dispute/Quarantine Rate.

• Finality p95: 3-10 min (in corridoio), s-99. 5%,
• Proof Coverage ≥ 99. 0%, Queue-Lag P0 p95 ≤ 2 с,
• Dispute Rate ≤ 0. 2%, FX Drift ≤ 0. Il 3% della mediana.

Дашборды: Flows Core, Finality & Proofs, Treasury & Liquidity, FX & Fees, Compliance.

13) Gestione delle modifiche

Timelock per la modifica di K/limiti/corridoi; Registro delle soluzioni.
Versioni delle directory asset/decimals (compatibilità solo «aggiunta»).
A/B-inclusione di nuovi ponti: canary flusso, limiti, aumento K.
Emergency kill-switch corridoio in caso di anomalie.

14) Configurazioni (YAML)

Criteri di finalizzazione/rischio

yaml finality_policy:
eth-mainnet: { k: 12, delayed_for_usd_gt: 100000 }
polygon:   { k: 256 }
optimistic: { k: 0, challenge_minutes: 20, delayed_for_usd_gt: 50000 }
risk:
large_transfer_alert_usd: 25000 sanction_check: true

Regole per corridoi e commissioni

yaml corridors:
- id: "eth->polygon:USDC"
fee_bps: 25 fx_source: "oracle:v2"
daily_limit_usd: 1_000_000 slo:
finality_p95_min: 6 success_pct: 99. 6

Webhook/firma per il clearing

yaml webhooks:
clearing:
signature: { alg: "HMAC-SHA256", header: "X-Signature", ts_header: "X-Timestamp" }
retry: { attempts: 5, backoff_ms: [200,800,1600,3200,6400], jitter: true }

15) Playbook incidenti

A. Spike reorg/invalidated

1. Sollevare temporaneamente «K», attivare «finalized-only»; 2) interrompere i voli high-risk;

2. ricalcolare le unità 4) post mortem e aggiustamento della politica.

B. Caduta di Proof Coverage

1. Restart di merceologia/laghetti; 2) quarantena di traduzioni discutibili;

2. campionamento manuale delle valigette; 4) Rapporto al Tesoro/Compilation.

C. Mancanza di liquidità nel corridoio

1. Abilita rebalance/swap; 2) alzare fee/immettere quote;

2. Priorità dei pagamenti P0; 4) notifica ai partecipanti.

D. FX Drivt/anomalie dei prezzi

1. Cambiare l'origine della quotazione; 2) limitare le grandi transazioni;

2. eseguire hedge; 4) Conteggia i rapporti per finestra.

E. Trigger sanzione/AML

1. Blocco di operazione immediato; 2) escalation in Compliance;

2. Conservazione di manufatti/laghetti 4) report e azioni legali.

16) Assegno-foglio di implementazione

1. Fissare le fonti di flusso, i corridoi e le finestre di finalizzazione.
2. Inserisci gli eventi canonici e la chiave di idempotenza.
3. Implementare la doppia voce e le posizioni, la normalizzazione FX e la registrazione delle commissioni.
4. Regolare i limiti/riserve e la ricalance automatica.
5. Sollevare i dashboard SLI/SLO: Finality, Proofs, Liquidità, FX, Compliance.
6. Attivare AML/sanzioni, residence e trailer.
7. Eseguire test chaos/DR (reorg, oracle-drivt, liquidità).
8. Avvia procedure governance per eventuali modifiche ai corridoi/K/limiti.

17) Glossario

Finality - Irreversibilità transazione/stato.
Reorg è l'intersezione di una parte della catena con l'annullamento dei blocchi.
Corridor è una catena/asset controllata per la traduzione del valore.
Proof Coverage è una quota di record con crittodozie validi.
FX Draft - Deviazione del corso applicato dal riferimento.
Doppio-Entry - doppia voce (debito/credito) per la contabilità.
Delayed Finalization - Accezione posticipata per gli importi high-risk.

Il risultato è che la gestione dei flussi finanziari tra le catene non è un semplice passaggio di asset, ma una disciplina di finalizzazione, liquidità, contabilità e compliance. Eventi canonici, doppia registrazione, limiti e SLO attraverso i corridoi offrono un sistema collaudabile, economico e sostenibile, pronto per la scalabilità e la verifica in qualsiasi giurisdizione.