Saltar al contenido principal

Ledger

El Ledger es el libro mayor de partida doble que es la fuente oficial y única de verdad sobre todo saldo de la plataforma. Ningún saldo se modifica directamente — todo cambio es consecuencia de un Ledger Entry.

Por qué partida doble​

Un Ledger Account es la subcuenta que acumula asientos para un titular específico (una Account de negocio, la Treasury, o los ingresos de la plataforma). Cada Ledger Entry es un registro individual e inmutable de débito o crédito, siempre parte de un asiento balanceado — la suma de todos los asientos de una operación siempre es cero. Una vez consolidado, un Ledger Entry nunca se edita ni se elimina; las correcciones usan nuevos asientos compensatorios.

Esta disciplina — nunca escribir un valor de saldo directamente, siempre a través de un asiento rastreable — es lo que hace que todo saldo sea auditable de principio a fin.

Ejemplo​

Reservar 100 USDT para una Transaction genera dos asientos que suman cero: -100 USDT en el saldo disponible de la Account de origen, +100 USDT en el saldo reservado de la misma Account. Ningún valor se "mueve" — se crean dos registros contables, siempre juntos.

Más allá de Available/Pending/Reserved​

Existen dos naturalezas de asiento más, específicas para Payout: Payable (un monto que un beneficiario tiene por cobrar pero aún no se le ha pagado — consultable vía getPayableSummary, una obligación económica, nunca un saldo on-chain) y Delivered (historial acumulado de lo que realmente se pagó — bajo Self-Custody, esto es lo que produce la confirmación de la leg de un beneficiario, no un crédito a Available; vea Transaction, Settlement, Split y Refund). Nunca confunda ninguno de los dos con Available — un beneficiario puede tener un total Delivered real y creciente mientras su saldo Available en este Ledger permanece exactamente en 0, porque el dinero ya salió por completo de la custodia de la plataforma.

Rutas​