From 971ba2281e37edd58fe2beec38c535f5a48e40fc Mon Sep 17 00:00:00 2001 From: pwang200 <354723+pwang200@users.noreply.github.com> Date: Thu, 14 May 2026 20:18:05 -0400 Subject: [PATCH] clarify XLS-0102 host function stability rule (#7146) --- src/libxrpl/tx/wasm/WasmVM.cpp | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/src/libxrpl/tx/wasm/WasmVM.cpp b/src/libxrpl/tx/wasm/WasmVM.cpp index f3a12d0fb9..137b2c9f83 100644 --- a/src/libxrpl/tx/wasm/WasmVM.cpp +++ b/src/libxrpl/tx/wasm/WasmVM.cpp @@ -13,7 +13,13 @@ #include namespace xrpl { - +// WARNING: Per XLS-0102, the host functions registered here form a stable +// ABI. Their name, semantics, parameters, and return types must NEVER be +// changed, as there may always be a program that uses it. New host functions +// may be added and existing gas costs may be adjusted, but every such change +// must be gated by an amendment. +// See XLS-0102 ยง6.5 (Future-Proofing): +// https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0102-wasm-vm#65-future-proofing static void setCommonHostFunctions(HostFunctions* hfs, ImportVec& i) {