Todos os posts
ENGENHARIA

Por que a Stratum usa dados do ledger da Bitfinex

ST
Stratum Engineering
·12 de maio de 2026·8 min de leitura

Quando você pergunta a um bot de lending quanto ganhou no mês passado, o relatório deve ser fácil de reconciliar com os próprios dados de funding da Bitfinex. Isso começa com eventos do ledger, não com a APR de destaque.

Um simples instantâneo do saldo pode ser útil, mas não é suficiente para relatórios prontos para auditoria. Depósitos, transferências, taxas, créditos de juros, o momento da conversão de moeda e estornos, todos afetam o que um credor vê ao longo do tempo.

Por essa razão, a Stratum trata os eventos do ledger da Bitfinex como a fonte dos relatórios. Cada crédito ou taxa pode ser armazenado com o payload original e rastreado posteriormente quando você exporta, revisa ou reconcilia.

"A promessa útil não é uma precisão mágica. É a rastreabilidade: cada linha do relatório deve apontar de volta para os dados da exchange."

A abordagem baseada no ledger

A Stratum sincroniza os dados do ledger de funding da Bitfinex, remove duplicatas pela identidade do evento e mantém o payload bruto da exchange sempre que possível. Isso dá aos relatórios uma trilha estável de volta ao que a Bitfinex retornou no momento.

typescript · ledger-replay.ts
const events = await bitfinex.ledger.list({
  category: 'funding-credit',
  start: lastSyncCursor,
});

for (const e of events) {
  await db.ledger.upsert({
    id: e.id,                          // dedupe key
    timestamp: e.mts,                  // ms since epoch
    currency: e.currency,
    amount: e.amount,                  // signed, native units
    usdAt: await fxAt(e.currency, e.mts),
    raw: e,                            // archive original
  });
}

Esse último campo — raw — é a chave. Manter o payload original torna os relatórios mais fáceis de depurar e explicar depois.

O que isso lhe proporciona

Dúvidas ou comentários sobre este post? Entre na lista de espera da comunidade e abriremos a discussão quando ela for lançada.