Przepływy finansowe między łańcuchami

(Sekcja: Ekosystem i sieć)

1) Dlaczego zarządzać pieniędzmi między łańcuchami

• Bezpieczeństwo i finalizacja: uwzględniać tylko nieodwracalne fakty.
• Płynność i koszt: zminimalizować koszt korytarzy z wystarczającymi rezerwami.
• Sprawozdawczość i audyt: pełna identyfikowalność z podwójnym wejściem i dowodami.
• Zgodność: AML/sankcje, miejsce zamieszkania, ograniczenia według jurysdykcji.

2) Typologia przepływów finansowych

1. Depozyty: na rampie → portfel/konto użytkownika (online/offchain).
2. Płatności: płatności poza rampą/płatności kryptograficzne → adres zewnętrzny/PSP.
3. Most: blokada/mięta, oparzenie/zwolnienie, na podstawie wiadomości.
4. Swaps/conversion (FX): cross-asset/chain swap z cenami wyroczni.

5. Rozliczenia i opłaty licencyjne: operator rozliczeń okresowych,

6. Opłaty i potrącenia: opłata sieciowa, opłata pomostowa, stawka, rabaty.
7. Operacje skarbowe: przywrócenie płynności finansowej i zabezpieczenie.

3) Role i kontury

Most/kolej: zapewnia transfer stanów/aktywów i dowodów.
Skarb państwa: rezerwy łańcuchowe/walutowe, limity, zabezpieczenie.
PSP/It-off-ramps: karty/local AWP/banks/crypto-exchange.
Wyrocznie/notowania: ceny aktywów, FX i opłaty.
Ryzyko/zgodność: AML/KYC/KYB, sankcje, ograniczenia prędkości.
Rachunkowość/BI: podwójny wpis, sprawozdawczość końcowa, uzgodnienia.

4) Architektura przepływu (odniesienie)

Połknięcie (most/PSP/węzeł) → Surowy/Brąz (fakty ruchowe) → Czysty/Srebrny (normalizacja, dedup, dowód) → Rdzeń/Złoto (podwójny wpis, pozycje, obowiązki) → Marts (finanse, ryzyko, opłaty licencyjne) → Obsługa/API (raporty, rozliczenie, limity).
Kluczowe właściwości: idempotencja, wersioning schematu, powtórka/zasypka, późne dane.

5) Finalizacja, reorgs i okna sporów

Statusy: 'observed → confirmed (K) → finalized → invalid (reorg)' (+ 'challenged' for optymistic bridges).

• K-potwierdzenia na łańcuch/składnik aktywów/kwotę („K” dla dużych transferów).
• Opóźniona finalizacja dla kwot wysokiego ryzyka i nowych mostów.
• Obsługa Reorg: automatyczna niepełnosprawność + ponowne obliczenie kruszyw.
• Zakres dowodu: docelowy odsetek rekordów z ważnym dowodem ≥ 99%.

6) Ustalanie cen, prowizje i FX

Ustalanie cen: „efektywna _ kwota = kwota − (network_fee + bridge_fee + fx_spread)”

Wyrocznie: mediana notowań, ochrona obcych, ceny ważone czasem.
Okno przesuwne do kursu z długimi korytarzami; ustalanie kursu na 'observed _ at' lub 'event _ at' - zgodnie z polityką raportu.
Wiadra opłat: mapy drogowe prowizji na korytarz/składnik aktywów.

7) Płynność i limity

Rezerwy: salda docelowe według łańcucha/aktywów, bufory dla szczytów.
Korytarze: dzienne limity, progi wywoławcze skarbu państwa.
Przywrócenie równowagi: Rebridging/swapy rynkowe, świadomość kosztów (w tym opóźnienie i opłata).
Plan warunków skrajnych: aktywa/łańcuchy awaryjne, tymczasowy wzrost okna K/sporu.

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) Umowy na imprezy i idempotencja

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" }

Reguła deduplikacji jest podtrzymywana przez 'idempotence _ key' w oknie ≥ 72 godziny.

9) Podwójny wpis i księgowość (księgowość podstawowa)

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
);

Example Posting - USDC Chain Transfer (blokada → 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 (zakończona).
Prowizje znajdują odzwierciedlenie w odrębnych liniach („Przychody z opłat pomostowych”, „Koszty opłat sieciowych”).

10) Pojednanie i rozliczenie

T-pojednanie: łańcuchy, aktywa, dostawcy/mosty, dzień.
Dopasowanie dowodu: pokwitowania obu stron korytarza (src/dst) i kwot (z tolerancją).
Przepływ sporów: anomalia kwarantanny (aktywa/przecinki/niedopasowanie kwot).
Rozliczenie opłat licencyjnych: tylko na 'sfinalizowanym', FX na 'event _ at' lub 'observed _ at' - zgodnie z polityką.

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) Zgodność i miejsce zamieszkania

AML/KYC/KYB: punktacja, listy sankcji, źródła funduszy.
Rezydencja/lokalizacja: tokenizacja PII, regionalne klucze szyfrujące, eksport whitelisting.
Ograniczenia prędkości: na użytkownika/org/korytarz/dzień.
Ścieżka audytu: niezmienne dzienniki dostępu, podpisy pod wydarzeniami.

12) Obserwowalność: SLI/SLO i mierniki

• Finalność p95 na korytarz/składnik aktywów,
• Tłumaczenia wskaźnika sukcesu,
• Zakres dowodu%,
• Kolejka-Lag p95 (autobus/most),
• FX Drift
• Wykorzystanie płynności% (obciążenie rezerwowe),
• Wskaźnik Reorg/Challenge,
• Wskaźnik sporu/kwarantanny.

• Finalność p95: ≤ 3-10 min (wzdłuż korytarza), sukces ≥ 99. 5%,
• Zasięg dowodu ≥ 99. 0%, kolejka-Lag P0 p95 ≤ 2 ",
• Wskaźnik sporów ≤ 0. 2%, FX Drift ≤ 0. 3% mediany.

Даборна: Flows Core, Finality & Proofs, Treasury & Liquidity, FX & Opłaty, Zgodność.

13) Zarządzanie zmianami

Timelock do zmiany Zakresy/granice/korytarze; dziennik decyzji.
Wersje/dziesiętne katalogu aktywów (tylko kompatybilność „dodaj”).
A/B-włączenie nowych mostów: przepływ kanaryjski, granice, zwiększona K.
Awaryjny korytarz na wypadek anomalii.

14) Konfiguracje (YAML)

Finalizacja/polityka ryzyka

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

Zasady korytarzy i prowizji

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

Hak/Podpisy rozliczeniowe

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) Incydenty Playbook

A. Spike reorg/unieważniony

1. tymczasowo podnieść „K”, włączyć „sfinalizowane tylko”; 2) zatrzymać loty wysokiego ryzyka;

2. ponowne obliczenie kruszyw; 4) pośmiertne i dostosowanie polityki.

B. Spadek zasięgu dowodu

1. Restart Merklizacji/Provers; 2) kwarantanna wątpliwych transferów;

2. ręczne pobieranie próbek przypadków; 4) Zgłoś się do skarbu/zgodności.

C. Brak płynności w korytarzu

1. Uwzględnij przywrócenie równowagi/zamianę; 2) podwyższenie opłat/wprowadzenie kwot;

2. Priorytet płatności P0 4) powiadomienie uczestników.

D. FX Drift/anomalie cenowe

1. Przełącz źródło notowań; 2) ograniczenie dużych transakcji;

2. wykonać zabezpieczenie; 4) przeliczyć raporty za okno.

E. Sankcje/Spust AML

1. Natychmiastowy blok operacyjny; 2) eskalacja zgodności;

2. zachowanie artefaktów/dowodów; 4) sprawozdania i działań prawnych.

16) Lista kontrolna wdrażania

1. Przechwytywanie źródeł strumienia, korytarzy i okien finalizacyjnych.
2. Wprowadź wydarzenia kanoniczne i klucz idempotencji.
3. Wdrożenie podwójnego wejścia i pozycji, normalizacji FX i rachunkowości prowizji.
4. Ustaw limity/rezerwy i automatyczne przywracanie równowagi.
5. Podnieś deski rozdzielcze SLI/SLO: Finalność, Dowody, Płynność, FX, Zgodność.
6. Obejmuje AML/sankcje, pobyt i ścieżki audytu.
7. Przeprowadzić testy chaosu/DR (reorg, wyrocznia-dryf, płynność).
8. Rozpocząć procedury zarządzania dla wszelkich zmian w korytarzach/C/limitach.

17) Słownik

Finalność - nieodwracalność transakcji/państwa.
Reorg - ponowna instalacja części łańcucha z anulowaniem bloków.
Korytarz jest możliwym do zarządzania pakietem łańcuchów/aktywów do przeniesienia wartości.
Coverage Proof - udział zapisów z ważnymi dowodami kryptograficznymi.
FX Drift - odchylenie zastosowanej pozycji od odniesienia.
Podwójny wpis - podwójny wpis (debet/kredyt) do celów księgowych.
Opóźniona finalizacja - odroczona akceptacja w sprawozdaniach dotyczących kwot wysokiego ryzyka.

Najważniejsze: zarządzanie przepływami finansowymi między łańcuchami to nie tylko „aktywa pomostowe”, ale dyscyplina finalizacji, płynności, rachunkowości i zgodności. Wydarzenia kanoniczne, podwójne wejście, limity i korytarze SLO zapewniają weryfikowalny, opłacalny i zrównoważony system gotowy do skali i audytu w każdej jurysdykcji.