
Pembangun XRP Ledger Ripple telah mencadangkan penyelesaian terarah terhadap cara pembayaran pinjaman dibulatkan — perubahan kecil dengan kesan bermakna terhadap peminjam dan pemberi pinjaman di ledger.
Apa yang berubah
Pada 6 Nov, permintaan tarik GitHub memperkenalkan LendingProtocolV1_2, sebuah amendemen protokol yang memperbaiki cara baki pinjaman yang belum dibayar dikira selepas setiap pembayaran. Cadangan ini bertujuan untuk mencegah perbezaan pembundaran kecil daripada bertambah sepanjang ansuran dan meninggalkan pembayaran terakhir satu unit lebih tinggi daripada yang dijangka.
Perubahan sedang dalam tinjauan (PR #8698) dan belum diaktifkan di rangkaian utama.
Mengapa ini penting
- Di bawah logik semasa, setiap angsuran yang dijadualkan dikira secara berasingan. Ralat pembundaran kecil boleh bertambah sepanjang banyak pembayaran, sehingga angsuran terakhir menjadi sedikit lebih besar daripada pembayaran berkala yang dibundarkan yang dijangka oleh peminjam.
- Penyelesaian yang dicadangkan menggunakan pendekatan “teleskopik”: bukannya membiarkan setiap pengiraan ansuran berasingan menambah secara tidak konsisten, buku besar akan mengira semula jadual yang tinggal selepas setiap pembayaran dan menyelaraskan JumlahNilaiYangMasihTinggal dengan baki pembayaran yang tinggal. Dalam amalan, ini mengekalkan setiap ansuran berdekatan dengan pembayaran berkala yang dibundarkan dan memastikan ansuran terakhir sepadan tepat dengan pembayaran berkala yang dibundarkan bagi pinjaman yang mengikuti jadual yang telah diperbaiki.
Ciri-ciri teknikal
- Cadangan ini mengubah kedua-dua LoanSet (penciptaan pinjaman) dan LoanPay (bayaran balik):
- Komit pertama: memindahkan logik nilai yang dijadualkan keluar dari computeLoanProperties ke dalam fungsi scheduledValue baru supaya pengiraan penciptaan pinjaman dan pembayaran menggunakan pembundaran yang konsisten. Refaktor awal ini tidak mengubah tingkah laku.
- Komit kedua: melaksanakan koreksi pembayaran teleskopik di bawah LendingProtocolV1_2. Apabila peminjam membuat pembayaran berlebihan yang diterima, TotalValueOutstanding direset kepada nilai yang dijadualkan berdasarkan PeriodicPayment yang telah disemak semula, supaya ansuran seterusnya mengikuti pelan yang telah disesuaikan.
- Langkah keselamatan disertakan supaya bahagian prinsipal bagi ansuran tidak boleh menjadi negatif. Pinjaman tanpa faedah mendapat perlakuan khas kerana nilai keseluruhan dan pembundaran prinsipal berkelakuan berbeza.
Kod menghadkan penyesuaian pada PeriodicPayment yang dibundarkan dan memastikan nilai setiap angsuran yang dijadualkan sekurang-kurangnya satu unit.
Pengujian dan had
- Pembangun menguji perubahan tersebut melalui pelbagai model perakaunan vault — Legacy, CashBasis dan FixedPrecision — dengan amandemen diaktifkan dan dinonaktifkan. Ujian juga merangkumi pengaktifan amandemen semasa pinjaman masih belum dilunaskan, serta situasi di mana peminjam membayar lebih daripada yang dijadualkan.
- Perbaikan ini membetulkan pengiraan pembayaran balik ke depan tetapi tidak menghapus secara automatik setiap perbezaan pembundaran daripada pinjaman yang sedia ada. Pinjaman yang sudah membawa unit tambahan di atas baki yang dijadualkan akan kekal dengan unit tersebut sehingga peminjam membayar lebih; dalam beberapa kes, ansuran terakhir mungkin masih sama dengan PeriodicPayment yang dibundarkan ditambah satu unit.
Pembayaran berlebihan kecil yang berada dalam had pembulatan yang sedia ada boleh diabaikan: transaksi mungkin kembali berjaya tanpa mencipta pembayaran pinjaman tambahan.
Konteks dalam peminjaman XRP Ledger
Perubahan ini merupakan sebahagian daripada kerja berterusan XRP Ledger untuk menambah pinjaman asli (pinjaman jangka tetap yang dibiayai melalui Single Asset Vaults). Kemas kini sebelum ini dalam versi 3.4.0 (September) memperkenalkan vault berakhir tertutup dan perakaunan berdasarkan tunai di bawah LendingProtocolV1_1.
- Kerangka pinjaman yang dicadangkan menggambarkan aset terkumpul yang membiayai pinjaman, dengan broker mengendalikan penilaian peminjam dan risiko kredit secara luar talian.
- Ulasan Oktober menunjukkan bahawa pindaan pinjaman dan kotak simpanan belum mencapai ambang sokongan validator yang diperlukan untuk pengaktifan. Pindaan penyelenggaraan yang berasingan berjaya diaktifkan pada 4 Nov., tetapi ia menangani isu pemprosesan transaksi dan tidak mengaktifkan protokol pinjaman.
- Di bawah proses pindaan buku besar, sebarang perubahan memerlukan sokongan daripada lebih daripada 80% validator terpercaya selama dua minggu berturut-turut untuk diaktifkan. Tiada tarikh pengaktifan mainnet telah diumumkan untuk LendingProtocolV1_2.
Kesimpulan
Cadangan ini memperbaiki kes tepi yang menjengkelkan dalam perakaian pinjaman yang boleh mempengaruhi pembayaran akhir bagi peminjam. Ia adalah penyesuaian yang cermat dan telah diuji dengan teliti yang meningkatkan konsistensi aritmetik dalam logik peminjaman buku besar — tetapi ia masih memerlukan kelulusan validator dan tidak akan menghapuskan secara surut setiap perbezaan pembundaran yang sedia ada.
Apa yang berubah
Pada 6 Nov, permintaan tarik GitHub memperkenalkan LendingProtocolV1_2, sebuah amendemen protokol yang memperbaiki cara baki pinjaman yang belum dibayar dikira selepas setiap pembayaran. Cadangan ini bertujuan untuk mencegah perbezaan pembundaran kecil daripada bertambah sepanjang ansuran dan meninggalkan pembayaran terakhir satu unit lebih tinggi daripada yang dijangka.
Perubahan sedang dalam tinjauan (PR #8698) dan belum diaktifkan di rangkaian utama.
Mengapa ini penting
- Di bawah logik semasa, setiap angsuran yang dijadualkan dikira secara berasingan. Ralat pembundaran kecil boleh bertambah sepanjang banyak pembayaran, sehingga angsuran terakhir menjadi sedikit lebih besar daripada pembayaran berkala yang dibundarkan yang dijangka oleh peminjam.
- Penyelesaian yang dicadangkan menggunakan pendekatan “teleskopik”: bukannya membiarkan setiap pengiraan ansuran berasingan menambah secara tidak konsisten, buku besar akan mengira semula jadual yang tinggal selepas setiap pembayaran dan menyelaraskan JumlahNilaiYangMasihTinggal dengan baki pembayaran yang tinggal. Dalam amalan, ini mengekalkan setiap ansuran berdekatan dengan pembayaran berkala yang dibundarkan dan memastikan ansuran terakhir sepadan tepat dengan pembayaran berkala yang dibundarkan bagi pinjaman yang mengikuti jadual yang telah diperbaiki.
Ciri-ciri teknikal
- Cadangan ini mengubah kedua-dua LoanSet (penciptaan pinjaman) dan LoanPay (bayaran balik):
- Komit pertama: memindahkan logik nilai yang dijadualkan keluar dari computeLoanProperties ke dalam fungsi scheduledValue baru supaya pengiraan penciptaan pinjaman dan pembayaran menggunakan pembundaran yang konsisten. Refaktor awal ini tidak mengubah tingkah laku.
- Komit kedua: melaksanakan koreksi pembayaran teleskopik di bawah LendingProtocolV1_2. Apabila peminjam membuat pembayaran berlebihan yang diterima, TotalValueOutstanding direset kepada nilai yang dijadualkan berdasarkan PeriodicPayment yang telah disemak semula, supaya ansuran seterusnya mengikuti pelan yang telah disesuaikan.
- Langkah keselamatan disertakan supaya bahagian prinsipal bagi ansuran tidak boleh menjadi negatif. Pinjaman tanpa faedah mendapat perlakuan khas kerana nilai keseluruhan dan pembundaran prinsipal berkelakuan berbeza.
Kod menghadkan penyesuaian pada PeriodicPayment yang dibundarkan dan memastikan nilai setiap angsuran yang dijadualkan sekurang-kurangnya satu unit.
Pengujian dan had
- Pembangun menguji perubahan tersebut melalui pelbagai model perakaunan vault — Legacy, CashBasis dan FixedPrecision — dengan amandemen diaktifkan dan dinonaktifkan. Ujian juga merangkumi pengaktifan amandemen semasa pinjaman masih belum dilunaskan, serta situasi di mana peminjam membayar lebih daripada yang dijadualkan.
- Perbaikan ini membetulkan pengiraan pembayaran balik ke depan tetapi tidak menghapus secara automatik setiap perbezaan pembundaran daripada pinjaman yang sedia ada. Pinjaman yang sudah membawa unit tambahan di atas baki yang dijadualkan akan kekal dengan unit tersebut sehingga peminjam membayar lebih; dalam beberapa kes, ansuran terakhir mungkin masih sama dengan PeriodicPayment yang dibundarkan ditambah satu unit.
Pembayaran berlebihan kecil yang berada dalam had pembulatan yang sedia ada boleh diabaikan: transaksi mungkin kembali berjaya tanpa mencipta pembayaran pinjaman tambahan.
Konteks dalam peminjaman XRP Ledger
Perubahan ini merupakan sebahagian daripada kerja berterusan XRP Ledger untuk menambah pinjaman asli (pinjaman jangka tetap yang dibiayai melalui Single Asset Vaults). Kemas kini sebelum ini dalam versi 3.4.0 (September) memperkenalkan vault berakhir tertutup dan perakaunan berdasarkan tunai di bawah LendingProtocolV1_1.
- Kerangka pinjaman yang dicadangkan menggambarkan aset terkumpul yang membiayai pinjaman, dengan broker mengendalikan penilaian peminjam dan risiko kredit secara luar talian.
- Ulasan Oktober menunjukkan bahawa pindaan pinjaman dan kotak simpanan belum mencapai ambang sokongan validator yang diperlukan untuk pengaktifan. Pindaan penyelenggaraan yang berasingan berjaya diaktifkan pada 4 Nov., tetapi ia menangani isu pemprosesan transaksi dan tidak mengaktifkan protokol pinjaman.
- Di bawah proses pindaan buku besar, sebarang perubahan memerlukan sokongan daripada lebih daripada 80% validator terpercaya selama dua minggu berturut-turut untuk diaktifkan. Tiada tarikh pengaktifan mainnet telah diumumkan untuk LendingProtocolV1_2.
Kesimpulan
Cadangan ini memperbaiki kes tepi yang menjengkelkan dalam perakaian pinjaman yang boleh mempengaruhi pembayaran akhir bagi peminjam. Ia adalah penyesuaian yang cermat dan telah diuji dengan teliti yang meningkatkan konsistensi aritmetik dalam logik peminjaman buku besar — tetapi ia masih memerlukan kelulusan validator dan tidak akan menghapuskan secara surut setiap perbezaan pembundaran yang sedia ada.




