
Os desenvolvedores do XRP Ledger da Ripple propuseram uma correção direcionada para a forma como os reembolsos de empréstimos são arredondados — uma pequena alteração com consequências significativas para mutuários e credores no ledger.
O que está mudando
- Em 6 de novembro, um pull request no GitHub introduziu o LendingProtocolV1_2, uma alteração no protocolo que corrige como os saldos de empréstimos pendentes são calculados após cada pagamento. A proposta visa evitar que pequenas diferenças de arredondamento se acumulem ao longo das parcelas e deixem o último pagamento uma unidade acima do esperado.
- A variação está sob revisão (PR #8698) e ainda não foi ativada no mainnet.
Por que isso importa
- Sob a lógica atual, cada parcela programada é calculada separadamente. Pequenos erros de arredondamento podem se acumular ao longo de múltiplos pagamentos, fazendo com que a última parcela fique ligeiramente maior do que o pagamento periódico arredondado que os mutuários foram informados esperar.
A correção proposta utiliza uma abordagem de “telescopia”: em vez de permitir que os cálculos separados de cada parcela se acumulem de forma inconsistente, o livro-razão recalcula o cronograma restante após cada pagamento e alinha o ValorTotalPendente com o restante dos pagamentos. Na prática, isso mantém cada parcela próxima ao pagamento periódico arredondado e faz com que a última parcela corresponda exatamente ao pagamento periódico arredondado para empréstimos que seguem o cronograma corrigido.
Destaques técnicos
- A proposta altera tanto o LoanSet (criação de empréstimo) quanto o LoanPay (pagamentos):
- Primeiro commit: move a lógica de scheduled-value de computeLoanProperties para uma nova função scheduledValue, para que os cálculos de criação e reembolso de empréstimos usem arredondamento consistente. Este refatoramento inicial não altera o comportamento.
- Segundo commit: implementa a correção de reembolso telescópico sob o LendingProtocolV1_2. Quando os mutuários realizam pagamentos excedentes aceitos, o TotalValueOutstanding é redefinido para um valor programado com base no PeriodicPayment revisado, para que as parcelas subsequentes sigam o plano ajustado.
- São incluídas salvaguardas para que a porção do principal das parcelas não possa ficar negativa. Empréstimos sem juros recebem tratamento especial, pois o arredondamento do valor total e do principal se comportam de forma diferente.
- O código limita os ajustes ao PeriodicPayment arredondado e garante que o valor de cada prestação programada seja pelo menos uma unidade.
Testes e limites
- Os desenvolvedores testaram as alterações em diversos modelos de contabilidade de vaults — Legacy, CashBasis e FixedPrecision — com a emenda ativada e desativada. Os testes também cobrem a ativação da emenda enquanto empréstimos permanecem em aberto e situações em que mutuários pagam mais do que o programado.
- A correção ajusta os cálculos de reembolso a partir de agora, mas não remove automaticamente todas as diferenças de arredondamento dos empréstimos existentes. Empréstimos que já apresentam uma unidade adicional acima do saldo programado manterão essa diferença até que o mutuário pague a mais; em alguns casos, uma parcela final ainda pode ser igual ao PeriodicPayment arredondado mais uma unidade.
Pagamentos ligeiramente superiores que estejam dentro dos limites de arredondamento existentes podem ser ignorados: a transação pode retornar sucesso sem criar um pagamento adicional de empréstimo.
Contexto dentro do empréstimo no XRP Ledger
Essas alterações fazem parte do trabalho contínuo do XRP Ledger para adicionar empréstimos nativos (empréstimos de prazo fixo financiados por Single Asset Vaults). Atualizações anteriores na versão 3.4.0 (setembro) introduziram vaults de prazo fechado e contabilidade de caixa sob LendingProtocolV1_1.
- O framework de empréstimo proposto prevê ativos em pool financiando empréstimos, com brokers responsáveis pela avaliação do mutuário e pelo risco de crédito fora da cadeia.
Uma revisão de outubro mostrou que as alterações de empréstimo e vault ainda não atingiram o limiar de suporte dos validadores necessário para ativação. Uma alteração de manutenção separada foi ativada em 4 de novembro, mas abordou problemas de processamento de transações e não ativou o protocolo de empréstimo.
- Sob o processo de alteração do ledger, qualquer mudança precisa do apoio de mais de 80% dos validadores confiáveis por duas semanas consecutivas para ser ativada. Nenhuma data de ativação no mainnet foi anunciada para o LendingProtocolV1_2.
Linha de fundo
Esta proposta corrige um caso extremo irritante na contabilidade de empréstimos que poderia afetar os pagamentos finais dos mutuários. É um ajuste cuidadoso e bem testado que melhora a consistência aritmética na lógica de empréstimos do livro-razão — mas ainda precisa da aprovação dos validadores e não apagará retroativamente todas as discrepâncias de arredondamento existentes.
O que está mudando
- Em 6 de novembro, um pull request no GitHub introduziu o LendingProtocolV1_2, uma alteração no protocolo que corrige como os saldos de empréstimos pendentes são calculados após cada pagamento. A proposta visa evitar que pequenas diferenças de arredondamento se acumulem ao longo das parcelas e deixem o último pagamento uma unidade acima do esperado.
- A variação está sob revisão (PR #8698) e ainda não foi ativada no mainnet.
Por que isso importa
- Sob a lógica atual, cada parcela programada é calculada separadamente. Pequenos erros de arredondamento podem se acumular ao longo de múltiplos pagamentos, fazendo com que a última parcela fique ligeiramente maior do que o pagamento periódico arredondado que os mutuários foram informados esperar.
A correção proposta utiliza uma abordagem de “telescopia”: em vez de permitir que os cálculos separados de cada parcela se acumulem de forma inconsistente, o livro-razão recalcula o cronograma restante após cada pagamento e alinha o ValorTotalPendente com o restante dos pagamentos. Na prática, isso mantém cada parcela próxima ao pagamento periódico arredondado e faz com que a última parcela corresponda exatamente ao pagamento periódico arredondado para empréstimos que seguem o cronograma corrigido.
Destaques técnicos
- A proposta altera tanto o LoanSet (criação de empréstimo) quanto o LoanPay (pagamentos):
- Primeiro commit: move a lógica de scheduled-value de computeLoanProperties para uma nova função scheduledValue, para que os cálculos de criação e reembolso de empréstimos usem arredondamento consistente. Este refatoramento inicial não altera o comportamento.
- Segundo commit: implementa a correção de reembolso telescópico sob o LendingProtocolV1_2. Quando os mutuários realizam pagamentos excedentes aceitos, o TotalValueOutstanding é redefinido para um valor programado com base no PeriodicPayment revisado, para que as parcelas subsequentes sigam o plano ajustado.
- São incluídas salvaguardas para que a porção do principal das parcelas não possa ficar negativa. Empréstimos sem juros recebem tratamento especial, pois o arredondamento do valor total e do principal se comportam de forma diferente.
- O código limita os ajustes ao PeriodicPayment arredondado e garante que o valor de cada prestação programada seja pelo menos uma unidade.
Testes e limites
- Os desenvolvedores testaram as alterações em diversos modelos de contabilidade de vaults — Legacy, CashBasis e FixedPrecision — com a emenda ativada e desativada. Os testes também cobrem a ativação da emenda enquanto empréstimos permanecem em aberto e situações em que mutuários pagam mais do que o programado.
- A correção ajusta os cálculos de reembolso a partir de agora, mas não remove automaticamente todas as diferenças de arredondamento dos empréstimos existentes. Empréstimos que já apresentam uma unidade adicional acima do saldo programado manterão essa diferença até que o mutuário pague a mais; em alguns casos, uma parcela final ainda pode ser igual ao PeriodicPayment arredondado mais uma unidade.
Pagamentos ligeiramente superiores que estejam dentro dos limites de arredondamento existentes podem ser ignorados: a transação pode retornar sucesso sem criar um pagamento adicional de empréstimo.
Contexto dentro do empréstimo no XRP Ledger
Essas alterações fazem parte do trabalho contínuo do XRP Ledger para adicionar empréstimos nativos (empréstimos de prazo fixo financiados por Single Asset Vaults). Atualizações anteriores na versão 3.4.0 (setembro) introduziram vaults de prazo fechado e contabilidade de caixa sob LendingProtocolV1_1.
- O framework de empréstimo proposto prevê ativos em pool financiando empréstimos, com brokers responsáveis pela avaliação do mutuário e pelo risco de crédito fora da cadeia.
Uma revisão de outubro mostrou que as alterações de empréstimo e vault ainda não atingiram o limiar de suporte dos validadores necessário para ativação. Uma alteração de manutenção separada foi ativada em 4 de novembro, mas abordou problemas de processamento de transações e não ativou o protocolo de empréstimo.
- Sob o processo de alteração do ledger, qualquer mudança precisa do apoio de mais de 80% dos validadores confiáveis por duas semanas consecutivas para ser ativada. Nenhuma data de ativação no mainnet foi anunciada para o LendingProtocolV1_2.
Linha de fundo
Esta proposta corrige um caso extremo irritante na contabilidade de empréstimos que poderia afetar os pagamentos finais dos mutuários. É um ajuste cuidadoso e bem testado que melhora a consistência aritmética na lógica de empréstimos do livro-razão — mas ainda precisa da aprovação dos validadores e não apagará retroativamente todas as discrepâncias de arredondamento existentes.




