Pular para o conteúdo principal

Ledger

O Ledger é o livro-razão de partidas dobradas que é a fonte oficial e única da verdade sobre todo saldo da plataforma. Nenhum saldo é alterado diretamente — toda mudança é consequência de um Ledger Entry.

Por que partida dobrada​

Um Ledger Account é a subconta que acumula lançamentos para um titular específico (uma Account de negócio, a Treasury, ou a receita da plataforma). Cada Ledger Entry é um registro individual e imutável de débito ou crédito, sempre parte de um lançamento balanceado — a soma de todos os lançamentos de uma operação é sempre zero. Depois de consolidado, um Ledger Entry nunca é editado nem removido; correções usam novos lançamentos compensatórios.

Essa disciplina — nunca escrever um valor de saldo diretamente, sempre através de um lançamento rastreável — é o que torna todo saldo auditável de ponta a ponta.

Exemplo​

Uma reserva de 100 USDT para uma Transaction gera dois lançamentos que somam zero: -100 USDT no saldo disponível da Account de origem, +100 USDT no saldo reservado da mesma Account. Nenhum valor é "movido" — dois registros contábeis são criados, sempre juntos.

Além de Available/Pending/Reserved​

Duas outras naturezas de lançamento existem especificamente para Payout: Payable (um valor que um beneficiário tem a receber mas ainda não foi pago — consultável via getPayableSummary, uma obrigação econômica, nunca um saldo on-chain) e Delivered (histórico acumulado do que foi de fato pago — sob Self-Custody, é isso que a confirmação da leg de um beneficiário produz, não um crédito em Available; ver Transaction, Settlement, Split e Refund). Nunca confunda nenhum dos dois com Available — um beneficiário pode ter um total Delivered real e crescente enquanto seu saldo Available neste Ledger permanece exatamente em 0, porque o dinheiro já saiu inteiramente da custódia da plataforma.

Rotas​