Fluxos financeiros entre correntes

(Secção: Ecossistema e Rede)

1) Para que administrar dinheiro entre cadeias

• Segurança e finalização - levar em conta apenas fatos irreversíveis.
• Liquidez e custo: minimizar o custo dos corredores com reservas suficientes.
• Relatório e auditoria: Rastreabilidade completa com notas duplas e proxes.
• Complacência: sanções AML, residência, limites de jurisdição.

2) Tipologia dos fluxos financeiros

1. Depósitos: on-ramp → carteira/conta do usuário (onchain/off).
2. Pagamentos: off-ramp/criptomoedas → endereço externo/PSP.
3. Traduções entre cadeias (bridge): lock/mint, burn/release, mensagem-based.
4. Swaps/Conversão (FX): cross-asset/chain swap com preços de oráculos.
5. Clering e royalties, intercorrências periódicas operator↔studii↔agregatory.
6. Comissão e retenção: network fee, bridge fee, take rate, rebates.
7. Operações do Tesouro (treasury): revalidação de liquidez e hedge.

3) Papéis e caminhos

Ponte/Reler: permite a transferência de estados/ativos e lagoas.
Tesouraria (Treasury): reservas em correntes/moedas, limites, hedging.
PSP/rampas-off: mapas/ARM/bancos/cripto-câmbio local.
Oráculas/cotação: preços de ativos, FX e comissões.
Risco/Complaens: AML/KYC/KYB, sanções, velocidades-limite.
Contabilidade/BI: dupla gravação, relatórios finais, comprimidos.

4) Arquitetura de fluxo (arbitragem)

Ingest (ponte/PSP/nó) → Raw/Bronze (factos de movimento) → Clean/Silver (normalização, dedução, prostração) → Core/Gold (dupla gravação, posições, compromissos) → Marts (finanças, risco, royalties) → Serve/API (relatórios, clínicas, limites).
Propriedades-chave: idempotidade, versionização de circuitos, replay/backfill, late data.

5) Finalização, reorgues e janelas de disputa

Estados: 'observed → confermed (K) → finalizante → invalidated' (+ 'challenged' para pontes optimísticas).

• Confirmação K per chain/asset/montante ('K↑' para grandes transferências).
• Delayed Finalization para somas high-risk e novas pontes.
• Reorg handling: deficiência automática + recalculação de unidades.
• Proof coverage: A proporção de registros com loofs de validade ≥ de 99%.

6) Pricing, comissões e FX

Preços: 'efetive _ amount = amount - (network _ fee + bridge _ fee + fx _ spread)'

Orakuls: cotação mediana, protecção contra outlier, preços time-weighted.
Janela deslizante para o curso em longos corredores; a fixação do curso em 'observed _ at' ou 'event _ at' é uma política de relatório.
Fee buckets: cartões de trânsito de comissões per corridor/asset.

7) Liquidez e limites

Reservas: balanços de destino por circuito/ativo, tampões para picos.
Corredores, limites diurnos, liminares de chamadas do Tesouro.
Rebalance: Rebrijing/market swap, cost-aware (incluindo latency e fee).
Plano de status: ativos/correntes fallback, promoção temporária K/janela de disputa.

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) Contratos de eventos e Idempotação

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

Regra de deduplicação: upsert por 'idempotency _ key' na janela ≥ 72 horas.

9) Dupla gravação e registro (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
);

Tradução intercadeia 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).
As comissões são refletidas por linhas individuais ('Bridge Fee Revenue', 'Network Fee Expense').

10) Confecção e clering

Controle T por correntes, ativos, provedores/pontes, dia.
Proof match: recibos de ambos os lados do corredor (src/dst) e soma (com margem de erro).
Dispute flow: quarentena de anomalias (asset/decimals/amount mismatch).
Clering de royalties: apenas por 'finalized', FX por 'event _ at' ou 'observed _ at' - de acordo com a política.

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) Complaens e residência

AML/KYC/KYB: arquivos, listas de sanções, fontes de fundos.
Residência/localização: Tocinização PII, chaves de criptografia regionais, exportação em listas brancas.
Limites de velocity: per user/org/corridor/day.
Auditoria trailer: registros de acessibilidade imutáveis, assinaturas de eventos.

12) Observabilidade: SLI/SLO e métricas

• Finality p95 per corridor/asset,
• Traduções Sucess Rate,
• Proof Coverage%,
• Queue-Lag p95 (pneu/ponte),
• FX Drivt (divergência de cursos),
• Liquidity Utilization% (carga de reservas),
• Reorg/Challenge Rate,
• Dispute/Quarantine Rate.

• Finality p95: ≤ 3-10 min (pelo corredor), Sucess ≥ 99. 5%,
• Proof Coverage ≥ 99. 0%, Queue-Lag P0 p95 ≤ 2 с,
• Dispute Rate ≤ 0. 2%, FX Drift ≤ 0. 3% da mediana.

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

13) Gerenciamento de alterações

Timelock para alterar K/limites/corredores; registro de soluções.
Versões de diretórios de ativos/decimals (compatibilidade somente «adição»).
A/B inclusão de novas pontes: canary fluxo, limites, elevado K.
Emergency kill-switch corredor para anomalias.

14) Configurações (YAML)

Política de finalização/risco

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

Regras de corredores e comissões

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/assinaturas para 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 incidentes

A. Spike reorg/invalidated

1. Levantar temporariamente 'K', ativar 'finalized-only'; 2) parar voos high-risk;

2. recontagem das unidades; 4) pós-mortem e ajuste político.

B. Queda de Proof Coverage

1. Restauro de merceação/prostração; 2) quarentena de transferências duvidosas;

2. amostra manual das malas; 4) Relatório ao Tesouro/Complência.

C. Falta de liquidez no corredor

1. Incluir rebalance/swap; 2) elevar fee/impor quotas;

2. priorizar pagamentos P0; 4) notificação dos participantes.

D. FX Drivt/anomalias de preços

1. Mudar a origem da cotação; 2) limitar as grandes transações;

2. executar hedge; 4) Contar os relatórios por janela.

E. Sanção/AML desencadeador

1. Unidade de operação imediata; 2) escalação em Compliance;

2. Preservação de artefatos/lagostas; 4) relatórios e ações legais.

16) Folha de cheque de implementação

1. Verifique as fontes de fluxo, corredores e janelas de finalização.
2. Digite os eventos canónicos e a chave de idempotação.
3. Realize dupla entrada e posição, normalização FX e registro de comissões.
4. Configure os limites/reservas e revalente automático.
5. Levante os dashboards SLI/SLO: Finality, Proofs, Liquidity, FX, Compliance.
6. Inclua as sanções AML, residência e auditoria.
7. Faça testes chaos-/DR. (reorg, oracle-drivt, liquidez).
8. Execute procedimentos governance para qualquer alteração de corredor/K/limite.

17) Glossário

Finality - A transação/estado é irreversível.
Reorg - parte da cadeia com cancelamento de blocos.
O Corridor é uma ligação controlada de correntes/ativos para transferir valor.
Proof Coverage é uma proporção de registros com criptodoxias valiosas.
FX Drift - Desviar o curso aplicado da referência.
Duplo-Entry - gravação dupla (débito/crédito) para contabilidade.
Delayed Finalization - adoção adiada em relatórios para quantias high-risk.

Resultado: Gerenciar os fluxos financeiros entre as cadeias não é apenas «traçar ativos», mas sim uma disciplina de finalização, liquidez, contabilidade e complacência. Eventos canônicos, gravação dupla, limites e SLO nos corredores fornecem um sistema verificável, econômico e sustentável, pronto para escala e auditoria em qualquer jurisdição.