From 92e3a927fce68c227456423c5e765f54a6461539 Mon Sep 17 00:00:00 2001 From: tequ Date: Thu, 9 Oct 2025 19:02:14 +0900 Subject: [PATCH 1/7] refactor KEYLET_LINE in utils_keylet (#502) Fixes the use of high and low in variable names, as these are determined by ripple::keylet::line processing. Co-authored-by: RichardAH --- src/ripple/app/hook/impl/applyHook.cpp | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/ripple/app/hook/impl/applyHook.cpp b/src/ripple/app/hook/impl/applyHook.cpp index 0616ccf5f..5b5f28cf2 100644 --- a/src/ripple/app/hook/impl/applyHook.cpp +++ b/src/ripple/app/hook/impl/applyHook.cpp @@ -3150,15 +3150,15 @@ DEFINE_HOOK_FUNCTION( if (a == 0 || b == 0 || c == 0 || d == 0 || e == 0 || f == 0) return INVALID_ARGUMENT; - uint32_t hi_ptr = a, hi_len = b, lo_ptr = c, lo_len = d, + uint32_t acc1_ptr = a, acc1_len = b, acc2_ptr = c, acc2_len = d, cu_ptr = e, cu_len = f; - if (NOT_IN_BOUNDS(hi_ptr, hi_len, memory_length) || - NOT_IN_BOUNDS(lo_ptr, lo_len, memory_length) || + if (NOT_IN_BOUNDS(acc1_ptr, acc1_len, memory_length) || + NOT_IN_BOUNDS(acc2_ptr, acc2_len, memory_length) || NOT_IN_BOUNDS(cu_ptr, cu_len, memory_length)) return OUT_OF_BOUNDS; - if (hi_len != 20 || lo_len != 20) + if (acc1_len != 20 || acc2_len != 20) return INVALID_ARGUMENT; std::optional cur = @@ -3167,8 +3167,8 @@ DEFINE_HOOK_FUNCTION( return INVALID_ARGUMENT; auto kl = ripple::keylet::line( - AccountID::fromVoid(memory + hi_ptr), - AccountID::fromVoid(memory + lo_ptr), + AccountID::fromVoid(memory + acc1_ptr), + AccountID::fromVoid(memory + acc2_ptr), *cur); return serialize_keylet(kl, memory, write_ptr, write_len); } From fa1b93bfd879f93e0b8fcf369b86fb18d39390b4 Mon Sep 17 00:00:00 2001 From: Niq Dudfield Date: Fri, 10 Oct 2025 10:57:46 +0700 Subject: [PATCH 2/7] build: migrate to conan 2 (#585) Migrates the build system from Conan 1 to Conan 2 --- .github/actions/xahau-ga-build/action.yml | 4 + .../actions/xahau-ga-dependencies/action.yml | 5 +- .github/workflows/xahau-ga-macos.yml | 52 +++++++-- .github/workflows/xahau-ga-nix.yml | 36 ++++-- BUILD.md | 72 ++++++++---- build-core.sh | 27 ++++- conanfile.py | 103 ++++++++++-------- external/wasmedge/conanfile.py | 11 +- release-builder.sh | 60 +++++++--- 9 files changed, 256 insertions(+), 114 deletions(-) diff --git a/.github/actions/xahau-ga-build/action.yml b/.github/actions/xahau-ga-build/action.yml index 3387f0391..66fe45d62 100644 --- a/.github/actions/xahau-ga-build/action.yml +++ b/.github/actions/xahau-ga-build/action.yml @@ -94,6 +94,10 @@ runs: fi # Run CMake configure + # Note: conanfile.py hardcodes 'build/generators' as the output path. + # If we're in a 'build' folder, Conan detects this and uses just 'generators/' + # If we're in '.build' (non-standard), Conan adds the full 'build/generators/' + # So we get: .build/build/generators/ with our non-standard folder name cmake .. \ -G "${{ inputs.generator }}" \ $CCACHE_ARGS \ diff --git a/.github/actions/xahau-ga-dependencies/action.yml b/.github/actions/xahau-ga-dependencies/action.yml index d295e20eb..cb14e4e57 100644 --- a/.github/actions/xahau-ga-dependencies/action.yml +++ b/.github/actions/xahau-ga-dependencies/action.yml @@ -78,8 +78,9 @@ runs: - name: Export custom recipes shell: bash run: | - conan export external/snappy snappy/1.1.10@xahaud/stable - conan export external/soci soci/4.0.3@xahaud/stable + conan export external/snappy --version 1.1.10 --user xahaud --channel stable + conan export external/soci --version 4.0.3 --user xahaud --channel stable + conan export external/wasmedge --version 0.11.2 --user xahaud --channel stable - name: Install dependencies shell: bash diff --git a/.github/workflows/xahau-ga-macos.yml b/.github/workflows/xahau-ga-macos.yml index efb1a2001..66c7e6877 100644 --- a/.github/workflows/xahau-ga-macos.yml +++ b/.github/workflows/xahau-ga-macos.yml @@ -32,9 +32,9 @@ jobs: - name: Install Conan run: | - brew install conan@1 - # Add Conan 1 to the PATH for this job - echo "$(brew --prefix conan@1)/bin" >> $GITHUB_PATH + brew install conan + # Verify Conan 2 is installed + conan --version - name: Install Coreutils run: | @@ -60,12 +60,20 @@ jobs: - name: Install CMake run: | - if which cmake > /dev/null 2>&1; then - echo "cmake executable exists" - cmake --version - else - brew install cmake - fi + # Install CMake 3.x to match local dev environments + # With Conan 2 and the policy args passed to CMake, newer versions + # can have issues with dependencies that require cmake_minimum_required < 3.5 + brew uninstall cmake --ignore-dependencies 2>/dev/null || true + + # Download and install CMake 3.31.7 directly + curl -L https://github.com/Kitware/CMake/releases/download/v3.31.7/cmake-3.31.7-macos-universal.tar.gz -o cmake.tar.gz + tar -xzf cmake.tar.gz + + # Move the entire CMake.app to /Applications + sudo mv cmake-3.31.7-macos-universal/CMake.app /Applications/ + + echo "/Applications/CMake.app/Contents/bin" >> $GITHUB_PATH + /Applications/CMake.app/Contents/bin/cmake --version - name: Install ccache run: brew install ccache @@ -92,8 +100,30 @@ jobs: - name: Configure Conan run: | - conan profile new default --detect || true # Ignore error if profile exists - conan profile update settings.compiler.cppstd=20 default + # Create the default profile directory if it doesn't exist + mkdir -p ~/.conan2/profiles + + # Detect compiler version + COMPILER_VERSION=$(clang --version | grep -oE 'version [0-9]+' | grep -oE '[0-9]+') + + # Create profile with our specific settings + cat > ~/.conan2/profiles/default <=2.0" - name: Configure ccache uses: ./.github/actions/xahau-configure-ccache @@ -54,18 +54,30 @@ jobs: - name: Configure Conan run: | - conan profile new default --detect || true # Ignore error if profile exists - conan profile update settings.compiler.cppstd=20 default - conan profile update settings.compiler=${{ matrix.compiler }} default - conan profile update settings.compiler.libcxx=libstdc++11 default - conan profile update env.CC=/usr/bin/${{ matrix.cc }} default - conan profile update env.CXX=/usr/bin/${{ matrix.cxx }} default - conan profile update conf.tools.build:compiler_executables='{"c": "/usr/bin/${{ matrix.cc }}", "cpp": "/usr/bin/${{ matrix.cxx }}"}' default + # Create the default profile directory if it doesn't exist + mkdir -p ~/.conan2/profiles + + # Create profile with our specific settings + cat > ~/.conan2/profiles/default <` header. @@ -65,13 +65,24 @@ can't build earlier Boost versions. 1. (Optional) If you've never used Conan, use autodetect to set up a default profile. ``` - conan profile new default --detect + conan profile detect --force ``` 2. Update the compiler settings. + For Conan 2, you can edit the profile directly at `~/.conan2/profiles/default`, + or use the Conan CLI. Ensure C++20 is set: + ``` - conan profile update settings.compiler.cppstd=20 default + conan profile show + ``` + + Look for `compiler.cppstd=20` in the output. If it's not set, edit the profile: + + ``` + # Edit ~/.conan2/profiles/default and ensure these settings exist: + [settings] + compiler.cppstd=20 ``` Linux developers will commonly have a default Conan [profile][] that compiles @@ -80,7 +91,9 @@ can't build earlier Boost versions. then you will need to choose the `libstdc++11` ABI. ``` - conan profile update settings.compiler.libcxx=libstdc++11 default + # In ~/.conan2/profiles/default, ensure: + [settings] + compiler.libcxx=libstdc++11 ``` On Windows, you should use the x64 native build tools. @@ -91,7 +104,9 @@ can't build earlier Boost versions. architecture. ``` - conan profile update settings.arch=x86_64 default + # In ~/.conan2/profiles/default, ensure: + [settings] + arch=x86_64 ``` 3. (Optional) If you have multiple compilers installed on your platform, @@ -100,16 +115,18 @@ can't build earlier Boost versions. in the generated CMake toolchain file. ``` - conan profile update 'conf.tools.build:compiler_executables={"c": "", "cpp": ""}' default + # In ~/.conan2/profiles/default, add under [conf] section: + [conf] + tools.build:compiler_executables={"c": "", "cpp": ""} ``` - It should choose the compiler for dependencies as well, - but not all of them have a Conan recipe that respects this setting (yet). - For the rest, you can set these environment variables: + For setting environment variables for dependencies: ``` - conan profile update env.CC= default - conan profile update env.CXX= default + # In ~/.conan2/profiles/default, add under [buildenv] section: + [buildenv] + CC= + CXX= ``` 4. Export our [Conan recipe for Snappy](./external/snappy). @@ -117,14 +134,20 @@ can't build earlier Boost versions. which allows you to statically link it with GCC, if you want. ``` - conan export external/snappy snappy/1.1.10@xahaud/stable + conan export external/snappy --version 1.1.10 --user xahaud --channel stable ``` 5. Export our [Conan recipe for SOCI](./external/soci). It patches their CMake to correctly import its dependencies. ``` - conan export external/soci soci/4.0.3@xahaud/stable + conan export external/soci --version 4.0.3 --user xahaud --channel stable + ``` + +6. Export our [Conan recipe for WasmEdge](./external/wasmedge). + + ``` + conan export external/wasmedge --version 0.11.2 --user xahaud --channel stable ``` ### Build and Test @@ -259,23 +282,26 @@ and can be helpful for detecting `#include` omissions. If you have trouble building dependencies after changing Conan settings, try removing the Conan cache. +For Conan 2: ``` -rm -rf ~/.conan/data +rm -rf ~/.conan2/p +``` + +Or clear the entire Conan 2 cache: +``` +conan cache clean "*" ``` -### no std::result_of +### macOS compilation with Apple Clang 17+ -If your compiler version is recent enough to have removed `std::result_of` as -part of C++20, e.g. Apple Clang 15.0, then you might need to add a preprocessor -definition to your build. +If you're on macOS with Apple Clang 17 or newer, you need to add a compiler flag to work around a compilation error in gRPC dependencies. + +Edit `~/.conan2/profiles/default` and add under the `[conf]` section: ``` -conan profile update 'options.boost:extra_b2_flags="define=BOOST_ASIO_HAS_STD_INVOKE_RESULT"' default -conan profile update 'env.CFLAGS="-DBOOST_ASIO_HAS_STD_INVOKE_RESULT"' default -conan profile update 'env.CXXFLAGS="-DBOOST_ASIO_HAS_STD_INVOKE_RESULT"' default -conan profile update 'conf.tools.build:cflags+=["-DBOOST_ASIO_HAS_STD_INVOKE_RESULT"]' default -conan profile update 'conf.tools.build:cxxflags+=["-DBOOST_ASIO_HAS_STD_INVOKE_RESULT"]' default +[conf] +tools.build:cxxflags=["-Wno-missing-template-arg-list-after-template-kw"] ``` diff --git a/build-core.sh b/build-core.sh index 7b1eb78dc..ce78c7625 100755 --- a/build-core.sh +++ b/build-core.sh @@ -12,6 +12,13 @@ echo "-- GITHUB_REPOSITORY: $1" echo "-- GITHUB_SHA: $2" echo "-- GITHUB_RUN_NUMBER: $4" +# Use mounted filesystem for temp files to avoid container space limits +export TMPDIR=/io/tmp +export TEMP=/io/tmp +export TMP=/io/tmp +mkdir -p /io/tmp +echo "=== Using temp directory: /io/tmp ===" + umask 0000; cd /io/ && @@ -43,10 +50,17 @@ export LDFLAGS="-static-libstdc++" git config --global --add safe.directory /io && git checkout src/ripple/protocol/impl/BuildInfo.cpp && sed -i s/\"0.0.0\"/\"$(date +%Y).$(date +%-m).$(date +%-d)-$(git rev-parse --abbrev-ref HEAD)$(if [ -n "$4" ]; then echo "+$4"; fi)\"/g src/ripple/protocol/impl/BuildInfo.cpp && -conan export external/snappy snappy/1.1.10@xahaud/stable && -conan export external/soci soci/4.0.3@xahaud/stable && +conan export external/snappy --version 1.1.10 --user xahaud --channel stable && +conan export external/soci --version 4.0.3 --user xahaud --channel stable && +conan export external/wasmedge --version 0.11.2 --user xahaud --channel stable && cd release-build && -conan install .. --output-folder . --build missing --settings build_type=$BUILD_TYPE && +# Install dependencies - tool_requires in conanfile.py handles glibc 2.28 compatibility +# for build tools (protoc, grpc plugins, b2) in HBB environment +# The tool_requires('b2/5.3.2') in conanfile.py should force b2 to build from source +# with the correct toolchain, avoiding the GLIBCXX_3.4.29 issue +echo "=== Installing dependencies ===" && +conan install .. --output-folder . --build missing --settings build_type=$BUILD_TYPE \ + -o with_wasmedge=False -o tool_requires_b2=True && cmake .. -G Ninja \ -DCMAKE_BUILD_TYPE=$BUILD_TYPE \ -DCMAKE_TOOLCHAIN_FILE:FILEPATH=build/generators/conan_toolchain.cmake \ @@ -56,10 +70,13 @@ cmake .. -G Ninja \ -Dxrpld=TRUE \ -Dtests=TRUE && ccache -z && -ninja -j $3 && +ninja -j $3 && echo "=== Re-running final link with verbose output ===" && rm -f rippled && ninja -v rippled && ccache -s && -strip -s rippled && +strip -s rippled && mv rippled xahaud && +echo "=== Full ldd output ===" && +ldd xahaud && +echo "=== Running libcheck ===" && libcheck xahaud && echo "Build host: `hostname`" > release.info && echo "Build date: `date`" >> release.info && diff --git a/conanfile.py b/conanfile.py index 0a5bc0b4a..4b98b84db 100644 --- a/conanfile.py +++ b/conanfile.py @@ -21,22 +21,20 @@ class Xrpl(ConanFile): 'static': [True, False], 'tests': [True, False], 'unity': [True, False], + 'with_wasmedge': [True, False], + 'tool_requires_b2': [True, False], } requires = [ - 'boost/1.86.0', 'date/3.0.1', 'libarchive/3.6.0', - 'lz4/1.9.3', + 'lz4/1.9.4', 'grpc/1.50.1', 'nudb/2.0.8', 'openssl/1.1.1u', - 'protobuf/3.21.9', - 'snappy/1.1.10@xahaud/stable', + 'protobuf/3.21.12', 'soci/4.0.3@xahaud/stable', - 'sqlite3/3.42.0', - 'zlib/1.2.13', - 'wasmedge/0.11.2', + 'zlib/1.3.1', ] default_options = { @@ -50,42 +48,44 @@ class Xrpl(ConanFile): 'static': True, 'tests': True, 'unity': False, + 'with_wasmedge': True, + 'tool_requires_b2': False, - 'cassandra-cpp-driver:shared': False, - 'date:header_only': True, - 'grpc:shared': False, - 'grpc:secure': True, - 'libarchive:shared': False, - 'libarchive:with_acl': False, - 'libarchive:with_bzip2': False, - 'libarchive:with_cng': False, - 'libarchive:with_expat': False, - 'libarchive:with_iconv': False, - 'libarchive:with_libxml2': False, - 'libarchive:with_lz4': True, - 'libarchive:with_lzma': False, - 'libarchive:with_lzo': False, - 'libarchive:with_nettle': False, - 'libarchive:with_openssl': False, - 'libarchive:with_pcreposix': False, - 'libarchive:with_xattr': False, - 'libarchive:with_zlib': False, - 'libpq:shared': False, - 'lz4:shared': False, - 'openssl:shared': False, - 'protobuf:shared': False, - 'protobuf:with_zlib': True, - 'rocksdb:enable_sse': False, - 'rocksdb:lite': False, - 'rocksdb:shared': False, - 'rocksdb:use_rtti': True, - 'rocksdb:with_jemalloc': False, - 'rocksdb:with_lz4': True, - 'rocksdb:with_snappy': True, - 'snappy:shared': False, - 'soci:shared': False, - 'soci:with_sqlite3': True, - 'soci:with_boost': True, + 'cassandra-cpp-driver/*:shared': False, + 'date/*:header_only': True, + 'grpc/*:shared': False, + 'grpc/*:secure': True, + 'libarchive/*:shared': False, + 'libarchive/*:with_acl': False, + 'libarchive/*:with_bzip2': False, + 'libarchive/*:with_cng': False, + 'libarchive/*:with_expat': False, + 'libarchive/*:with_iconv': False, + 'libarchive/*:with_libxml2': False, + 'libarchive/*:with_lz4': True, + 'libarchive/*:with_lzma': False, + 'libarchive/*:with_lzo': False, + 'libarchive/*:with_nettle': False, + 'libarchive/*:with_openssl': False, + 'libarchive/*:with_pcreposix': False, + 'libarchive/*:with_xattr': False, + 'libarchive/*:with_zlib': False, + 'libpq/*:shared': False, + 'lz4/*:shared': False, + 'openssl/*:shared': False, + 'protobuf/*:shared': False, + 'protobuf/*:with_zlib': True, + 'rocksdb/*:enable_sse': False, + 'rocksdb/*:lite': False, + 'rocksdb/*:shared': False, + 'rocksdb/*:use_rtti': True, + 'rocksdb/*:with_jemalloc': False, + 'rocksdb/*:with_lz4': True, + 'rocksdb/*:with_snappy': True, + 'snappy/*:shared': False, + 'soci/*:shared': False, + 'soci/*:with_sqlite3': True, + 'soci/*:with_boost': True, } def set_version(self): @@ -96,11 +96,28 @@ class Xrpl(ConanFile): match = next(m for m in matches if m) self.version = match.group(1) + def build_requirements(self): + # These provide build tools (protoc, grpc plugins) that run during build + self.tool_requires('protobuf/3.21.12') + self.tool_requires('grpc/1.50.1') + # Explicitly require b2 (e.g. for building from source for glibc compatibility) + if self.options.tool_requires_b2: + self.tool_requires('b2/5.3.2') + def configure(self): if self.settings.compiler == 'apple-clang': - self.options['boost'].visibility = 'global' + self.options['boost/*'].visibility = 'global' def requirements(self): + # Force sqlite3 version to avoid conflicts with soci + self.requires('sqlite3/3.42.0', override=True) + # Force our custom snappy build for all dependencies + self.requires('snappy/1.1.10@xahaud/stable', override=True) + # Force boost version for all dependencies to avoid conflicts + self.requires('boost/1.86.0', override=True) + + if self.options.with_wasmedge: + self.requires('wasmedge/0.11.2@xahaud/stable') if self.options.jemalloc: self.requires('jemalloc/5.2.1') if self.options.reporting: diff --git a/external/wasmedge/conanfile.py b/external/wasmedge/conanfile.py index 4b7c42050..cefda286d 100644 --- a/external/wasmedge/conanfile.py +++ b/external/wasmedge/conanfile.py @@ -38,8 +38,15 @@ class WasmedgeConan(ConanFile): raise ConanInvalidConfiguration("Binaries for this combination of version/os/arch/compiler are not available") def package_id(self): - del self.info.settings.compiler.version - self.info.settings.compiler = self._compiler_alias + # Make binary compatible across compiler versions (since we're downloading prebuilt) + self.info.settings.rm_safe("compiler.version") + # Group compilers by their binary compatibility + # Note: We must use self.info.settings here, not self.settings (forbidden in Conan 2) + compiler_name = str(self.info.settings.compiler) + if compiler_name in ["Visual Studio", "msvc"]: + self.info.settings.compiler = "Visual Studio" + else: + self.info.settings.compiler = "gcc" def build(self): # This is packaging binaries so the download needs to be in build diff --git a/release-builder.sh b/release-builder.sh index f2a64a673..672e68042 100755 --- a/release-builder.sh +++ b/release-builder.sh @@ -1,9 +1,11 @@ -#!/bin/bash +#!/bin/bash # We use set -e and bash with -u to bail on first non zero exit code of any # processes launched or upon any unbound variable. # We use set -x to print commands before running them to help with # debugging. +set -ex + echo "START BUILDING (HOST)" echo "Cleaning previously built binary" @@ -90,29 +92,37 @@ RUN /hbb_exe/activate-exec bash -c "dnf install -y epel-release && \ llvm14-static llvm14-devel && \ dnf clean all" -# Install Conan and CMake -RUN /hbb_exe/activate-exec pip3 install "conan==1.66.0" && \ +# Install Conan 2 and CMake +RUN /hbb_exe/activate-exec pip3 install "conan>=2.0,<3.0" && \ /hbb_exe/activate-exec wget -q https://github.com/Kitware/CMake/releases/download/v3.23.1/cmake-3.23.1-linux-x86_64.tar.gz -O cmake.tar.gz && \ mkdir cmake && \ tar -xzf cmake.tar.gz --strip-components=1 -C cmake && \ rm cmake.tar.gz -# Install Boost 1.86.0 -RUN /hbb_exe/activate-exec bash -c "cd /tmp && \ +# Dual Boost configuration in HBB environment: +# - Manual Boost in /usr/local (minimal: for WasmEdge which is pre-built in Docker) +# - Conan Boost (full: for the application and all dependencies via toolchain) +# +# Install minimal Boost 1.86.0 for WasmEdge only (filesystem and its dependencies) +# The main application will use Conan-provided Boost for all other components +# IMPORTANT: Understanding Boost linking options: +# - link=static: Creates static Boost libraries (.a files) instead of shared (.so files) +# - runtime-link=shared: Links Boost libraries against shared libc (glibc) +# WasmEdge only needs boost::filesystem and boost::system +RUN /hbb_exe/activate-exec bash -c "echo 'Boost cache bust: v5-minimal' && \ + rm -rf /usr/local/lib/libboost* /usr/local/include/boost && \ + cd /tmp && \ wget -q https://archives.boost.io/release/1.86.0/source/boost_1_86_0.tar.gz -O boost.tar.gz && \ mkdir boost && \ tar -xzf boost.tar.gz --strip-components=1 -C boost && \ cd boost && \ ./bootstrap.sh && \ - ./b2 link=static -j${BUILD_CORES} && \ - ./b2 install && \ + ./b2 install \ + link=static runtime-link=shared -j${BUILD_CORES} \ + --with-filesystem --with-system && \ cd /tmp && \ rm -rf boost boost.tar.gz" -ENV BOOST_ROOT=/usr/local/src/boost_1_86_0 -ENV Boost_LIBRARY_DIRS=/usr/local/lib -ENV BOOST_INCLUDEDIR=/usr/local/src/boost_1_86_0 - ENV CMAKE_EXE_LINKER_FLAGS="-static-libstdc++" ENV LLVM_DIR=/usr/lib64/llvm14/lib/cmake/llvm @@ -155,6 +165,10 @@ RUN cd /tmp && \ cd build && \ /hbb_exe/activate-exec bash -c "source /opt/rh/gcc-toolset-11/enable && \ ln -sf /opt/rh/gcc-toolset-11/root/usr/bin/ar /usr/bin/ar && \ + ln -sf /opt/rh/gcc-toolset-11/root/usr/bin/ranlib /usr/bin/ranlib && \ + echo '=== Binutils version check ===' && \ + ar --version | head -1 && \ + ranlib --version | head -1 && \ cmake .. \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_INSTALL_PREFIX=/usr/local \ @@ -176,14 +190,28 @@ RUN cd /tmp && \ # Set environment variables ENV PATH=/usr/local/bin:$PATH -# Configure ccache and Conan +# Configure ccache and Conan 2 +# NOTE: Using echo commands instead of heredocs because heredocs in Docker RUN commands are finnicky RUN /hbb_exe/activate-exec bash -c "ccache -M 10G && \ ccache -o cache_dir=/cache/ccache && \ ccache -o compiler_check=content && \ - conan config set storage.path=/cache/conan && \ - (conan profile new default --detect || true) && \ - conan profile update settings.compiler.libcxx=libstdc++11 default && \ - conan profile update settings.compiler.cppstd=20 default" + mkdir -p ~/.conan2 /cache/conan2 /cache/conan2_download /cache/conan2_sources && \ + echo 'core.cache:storage_path=/cache/conan2' > ~/.conan2/global.conf && \ + echo 'core.download:download_cache=/cache/conan2_download' >> ~/.conan2/global.conf && \ + echo 'core.sources:download_cache=/cache/conan2_sources' >> ~/.conan2/global.conf && \ + conan profile detect --force && \ + echo '[settings]' > ~/.conan2/profiles/default && \ + echo 'arch=x86_64' >> ~/.conan2/profiles/default && \ + echo 'build_type=Release' >> ~/.conan2/profiles/default && \ + echo 'compiler=gcc' >> ~/.conan2/profiles/default && \ + echo 'compiler.cppstd=20' >> ~/.conan2/profiles/default && \ + echo 'compiler.libcxx=libstdc++11' >> ~/.conan2/profiles/default && \ + echo 'compiler.version=11' >> ~/.conan2/profiles/default && \ + echo 'os=Linux' >> ~/.conan2/profiles/default && \ + echo '' >> ~/.conan2/profiles/default && \ + echo '[conf]' >> ~/.conan2/profiles/default && \ + echo '# Force building from source for packages with binary compatibility issues' >> ~/.conan2/profiles/default && \ + echo '*:tools.system.package_manager:mode=build' >> ~/.conan2/profiles/default" DOCKERFILE_EOF ) From b3e6a902cb594738b8f654f5c3dcc46d8c1fbd85 Mon Sep 17 00:00:00 2001 From: "J. Scott Branson" <18340247+jscottbranson@users.noreply.github.com> Date: Thu, 9 Oct 2025 23:59:39 -0400 Subject: [PATCH 3/7] Update Sample Configuration Files in /cfg for Congruence with xahaud (#584) --- README.md | 6 +- cfg/validators-example.txt | 49 ++-- ...rippled-example.cfg => xahaud-example.cfg} | 207 +++++++++-------- ...led-reporting.cfg => xahaud-reporting.cfg} | 209 +++++++++--------- ...d-standalone.cfg => xahaud-standalone.cfg} | 9 +- 5 files changed, 238 insertions(+), 242 deletions(-) rename cfg/{rippled-example.cfg => xahaud-example.cfg} (90%) rename cfg/{rippled-reporting.cfg => xahaud-reporting.cfg} (90%) rename cfg/{rippled-standalone.cfg => xahaud-standalone.cfg} (97%) mode change 100755 => 100644 diff --git a/README.md b/README.md index c9335cfc1..0a7e17ddd 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ **Note:** Throughout this README, references to "we" or "our" pertain to the community and contributors involved in the Xahau network. It does not imply a legal entity or a specific collection of individuals. -[Xahau](https://xahau.network/) is a decentralized cryptographic ledger that builds upon the robust foundation of the XRP Ledger. It inherits the XRP Ledger's Byzantine Fault Tolerant consensus algorithm and enhances it with additional features and functionalities. Developers and users familiar with the XRP Ledger will find that most documentation and tutorials available on [xrpl.org](https://xrpl.org) are relevant and applicable to Xahau, including those related to running validators and managing validator keys. For Xahau specific documentation you can visit our [documentation](https://docs.xahau.network/) +[Xahau](https://xahau.network/) is a decentralized cryptographic ledger that builds upon the robust foundation of the XRP Ledger. It inherits the XRP Ledger's Byzantine Fault Tolerant consensus algorithm and enhances it with additional features and functionalities. Developers and users familiar with the XRP Ledger will find that most documentation and tutorials available on [xrpl.org](https://xrpl.org) are relevant and applicable to Xahau, including those related to running validators and managing validator keys. For Xahau specific documentation you can visit our [documentation](https://xahau.network/) ## XAH XAH is the public, counterparty-free asset native to Xahau and functions primarily as network gas. Transactions submitted to the Xahau network must supply an appropriate amount of XAH, to be burnt by the network as a fee, in order to be successfully included in a validated ledger. In addition, XAH also acts as a bridge currency within the Xahau DEX. XAH is traded on the open-market and is available for anyone to access. Xahau was created in 2023 with a supply of 600 million units of XAH. @@ -12,7 +12,7 @@ The server software that powers Xahau is called `xahaud` and is available in thi ### Build from Source -* [Read the build instructions in our documentation](https://docs.xahau.network/infrastructure/building-xahau) +* [Read the build instructions in our documentation](https://xahau.network/infrastructure/building-xahau) * If you encounter any issues, please [open an issue](https://github.com/xahau/xahaud/issues) ## Highlights of Xahau @@ -58,7 +58,7 @@ git-subtree. See those directories' README files for more details. - **Documentation**: Documentation for XRPL, Xahau and Hooks. - [Xrpl Documentation](https://xrpl.org) - - [Xahau Documentation](https://docs.xahau.network/) + - [Xahau Documentation](https://xahau.network/) - [Hooks Technical Documentation](https://xrpl-hooks.readme.io/) - **Explorers**: Explore the Xahau ledger using various explorers: - [xahauexplorer.com](https://xahauexplorer.com) diff --git a/cfg/validators-example.txt b/cfg/validators-example.txt index 6c2314ebd..11ab76c2a 100644 --- a/cfg/validators-example.txt +++ b/cfg/validators-example.txt @@ -1,7 +1,7 @@ # # Default validators.txt # -# This file is located in the same folder as your rippled.cfg file +# This file is located in the same folder as your xahaud.cfg file # and defines which validators your server trusts not to collude. # # This file is UTF-8 with DOS, UNIX, or Mac style line endings. @@ -17,18 +17,17 @@ # See validator_list_sites and validator_list_keys below. # # Examples: -# n9KorY8QtTdRx7TVDpwnG9NvyxsDwHUKUEeDLY3AkiGncVaSXZi5 -# n9MqiExBcoG19UXwoLjBJnhsxEhAZMuWwJDRdkyDz1EkEkwzQTNt +# n9L3GdotB8a3AqtsvS7NXt4BUTQSAYyJUr9xtFj2qXJjfbZsawKY +# n9M7G6eLwQtUjfCthWUmTN8L4oEZn1sNr46yvKrpsq58K1C6LAxz # # [validator_list_sites] # # List of URIs serving lists of recommended validators. # # Examples: -# https://vl.ripple.com -# https://vl.xrplf.org +# https://vl.xahau.org # http://127.0.0.1:8000 -# file:///etc/opt/ripple/vl.txt +# file:///etc/opt/xahaud/vl.txt # # [validator_list_keys] # @@ -39,50 +38,48 @@ # Validator list keys should be hex-encoded. # # Examples: -# ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 -# ED307A760EE34F2D0CAA103377B1969117C38B8AA0AA1E2A24DAC1F32FC97087ED +# EDA46E9C39B1389894E690E58914DC1029602870370A0993E5B87C4A24EAF4A8E8 # # [import_vl_keys] # # This section is used to import the public keys of trusted validator list publishers. # The keys are used to authenticate and accept new lists of trusted validators. -# In this example, the key for the publisher "vl.xrplf.org" is imported. # Each key is represented as a hexadecimal string. # # Examples: -# ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 +# ED45D1840EE724BE327ABE9146503D5848EFD5F38B6D5FEDE71E80ACCE5E6E738B +# ED42AEC58B701EEBB77356FFFEC26F83C1F0407263530F068C7C73D392C7E06FD1 +# ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 -# The default validator list publishers that the rippled instance +# The default validator list publishers that the xahaud instance # trusts. # -# WARNING: Changing these values can cause your rippled instance to see a -# validated ledger that contradicts other rippled instances' +# WARNING: Changing these values can cause your xahaud instance to see a +# validated ledger that contradicts other xahaud instances' # validated ledgers (aka a ledger fork) if your validator list(s) # do not sufficiently overlap with the list(s) used by others. # See: https://arxiv.org/pdf/1802.07242.pdf [validator_list_sites] -https://vl.ripple.com -https://vl.xrplf.org +https://vl.xahau.org [validator_list_keys] -#vl.ripple.com -ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 -# vl.xrplf.org -ED45D1840EE724BE327ABE9146503D5848EFD5F38B6D5FEDE71E80ACCE5E6E738B +# vl.xahau.org +EDA46E9C39B1389894E690E58914DC1029602870370A0993E5B87C4A24EAF4A8E8 [import_vl_keys] -# vl.xrplf.org +ED45D1840EE724BE327ABE9146503D5848EFD5F38B6D5FEDE71E80ACCE5E6E738B +ED42AEC58B701EEBB77356FFFEC26F83C1F0407263530F068C7C73D392C7E06FD1 ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 -# To use the test network (see https://xrpl.org/connect-your-rippled-to-the-xrp-test-net.html), +# To use the test network (see https://xahau.network/docs/infrastructure/installing-xahaud), # use the following configuration instead: # -# [validator_list_sites] -# https://vl.altnet.rippletest.net -# -# [validator_list_keys] -# ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 +# [validators] +# nHBoJCE3wPgkTcrNPMHyTJFQ2t77EyCAqcBRspFCpL6JhwCm94VZ +# nHUVv4g47bFMySAZFUKVaXUYEmfiUExSoY4FzwXULNwJRzju4XnQ +# nHBvr8avSFTz4TFxZvvi4rEJZZtyqE3J6KAAcVWVtifsE7edPM7q +# nHUH3Z8TRU57zetHbEPr1ynyrJhxQCwrJvNjr4j1SMjYADyW1WWe # # [import_vl_keys] # ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860 diff --git a/cfg/rippled-example.cfg b/cfg/xahaud-example.cfg similarity index 90% rename from cfg/rippled-example.cfg rename to cfg/xahaud-example.cfg index 80ec0a980..85520f93f 100644 --- a/cfg/rippled-example.cfg +++ b/cfg/xahaud-example.cfg @@ -9,7 +9,7 @@ # # 2. Peer Protocol # -# 3. Ripple Protocol +# 3. XRPL Protocol # # 4. HTTPS Client # @@ -29,18 +29,17 @@ # # Purpose # -# This file documents and provides examples of all rippled server process -# configuration options. When the rippled server instance is launched, it +# This file documents and provides examples of all xahaud server process +# configuration options. When the xahaud server instance is launched, it # looks for a file with the following name: # -# rippled.cfg +# xahaud.cfg # -# For more information on where the rippled server instance searches for the -# file, visit: +# To run xahaud with a custom configuration file, use the "--conf {file}" flag. +# By default, xahaud will look in the local working directory or the home directory. # -# https://xrpl.org/commandline-usage.html#generic-options # -# This file should be named rippled.cfg. This file is UTF-8 with DOS, UNIX, +# This file should be named xahaud.cfg. This file is UTF-8 with DOS, UNIX, # or Mac style end of lines. Blank lines and lines beginning with '#' are # ignored. Undefined sections are reserved. No escapes are currently defined. # @@ -89,8 +88,8 @@ # # # -# rippled offers various server protocols to clients making inbound -# connections. The listening ports rippled uses are "universal" ports +# xahaud offers various server protocols to clients making inbound +# connections. The listening ports xahaud uses are "universal" ports # which may be configured to handshake in one or more of the available # supported protocols. These universal ports simplify administration: # A single open port can be used for multiple protocols. @@ -103,7 +102,7 @@ # # A list of port names and key/value pairs. A port name must start with a # letter and contain only letters and numbers. The name is not case-sensitive. -# For each name in this list, rippled will look for a configuration file +# For each name in this list, xahaud will look for a configuration file # section with the same name and use it to create a listening port. The # name is informational only; the choice of name does not affect the function # of the listening port. @@ -134,7 +133,7 @@ # ip = 127.0.0.1 # protocol = http # -# When rippled is used as a command line client (for example, issuing a +# When xahaud is used as a command line client (for example, issuing a # server stop command), the first port advertising the http or https # protocol will be used to make the connection. # @@ -175,7 +174,7 @@ # same time. It is possible have both Websockets and Secure Websockets # together in one port. # -# NOTE If no ports support the peer protocol, rippled cannot +# NOTE If no ports support the peer protocol, xahaud cannot # receive incoming peer connections or become a superpeer. # # limit = @@ -194,7 +193,7 @@ # required. IP address restrictions, if any, will be checked in addition # to the credentials specified here. # -# When acting in the client role, rippled will supply these credentials +# When acting in the client role, xahaud will supply these credentials # using HTTP's Basic Authentication headers when making outbound HTTP/S # requests. # @@ -237,7 +236,7 @@ # WS, or WSS protocol interfaces. If administrative commands are # disabled for a port, these credentials have no effect. # -# When acting in the client role, rippled will supply these credentials +# When acting in the client role, xahaud will supply these credentials # in the submitted JSON for any administrative command requests when # invoking JSON-RPC commands on remote servers. # @@ -258,7 +257,7 @@ # resource controls will default to those for non-administrative users. # # The secure_gateway IP addresses are intended to represent -# proxies. Since rippled trusts these hosts, they must be +# proxies. Since xahaud trusts these hosts, they must be # responsible for properly authenticating the remote user. # # If some IP addresses are included for both "admin" and @@ -272,7 +271,7 @@ # Use the specified files when configuring SSL on the port. # # NOTE If no files are specified and secure protocols are selected, -# rippled will generate an internal self-signed certificate. +# xahaud will generate an internal self-signed certificate. # # The files have these meanings: # @@ -295,12 +294,12 @@ # Control the ciphers which the server will support over SSL on the port, # specified using the OpenSSL "cipher list format". # -# NOTE If unspecified, rippled will automatically configure a modern +# NOTE If unspecified, xahaud will automatically configure a modern # cipher suite. This default suite should be widely supported. # # You should not modify this string unless you have a specific # reason and cryptographic expertise. Incorrect modification may -# keep rippled from connecting to other instances of rippled or +# keep xahaud from connecting to other instances of xahaud or # prevent RPC and WebSocket clients from connecting. # # send_queue_limit = [1..65535] @@ -351,7 +350,7 @@ # # Examples: # { "command" : "server_info" } -# { "command" : "log_level", "partition" : "ripplecalc", "severity" : "trace" } +# { "command" : "log_level", "partition" : "xahaudcalc", "severity" : "trace" } # # # @@ -380,16 +379,15 @@ #----------------- # # These settings control security and access attributes of the Peer to Peer -# server section of the rippled process. Peer Protocol implements the -# Ripple Payment protocol. It is over peer connections that transactions -# and validations are passed from to machine to machine, to determine the -# contents of validated ledgers. +# server section of the xahaud process. It is over peer connections that +# transactions and validations are passed from to machine to machine, to +# determine the contents of validated ledgers. # # # # [ips] # -# List of hostnames or ips where the Ripple protocol is served. A default +# List of hostnames or ips where the XRPL protocol is served. A default # starter list is included in the code and used if no other hostnames are # available. # @@ -398,24 +396,23 @@ # does not generally matter. # # The default list of entries is: -# - r.ripple.com 51235 -# - zaphod.alloy.ee 51235 -# - sahyadri.isrdc.in 51235 +# - hubs.xahau.as16089.net 21337 +# - bacab.alloy.ee 21337 # # Examples: # # [ips] # 192.168.0.1 -# 192.168.0.1 2459 -# r.ripple.com 51235 +# 192.168.0.1 21337 +# bacab.alloy.ee 21337 # # # [ips_fixed] # -# List of IP addresses or hostnames to which rippled should always attempt to +# List of IP addresses or hostnames to which xahaud should always attempt to # maintain peer connections with. This is useful for manually forming private # networks, for example to configure a validation server that connects to the -# Ripple network through a public-facing server, or for building a set +# Xahau Network through a public-facing server, or for building a set # of cluster peers. # # One address or domain names per line is allowed. A port must be specified @@ -465,7 +462,7 @@ # # IP address or domain of NTP servers to use for time synchronization. # -# These NTP servers are suitable for rippled servers located in the United +# These NTP servers are suitable for xahaud servers located in the United # States: # time.windows.com # time.apple.com @@ -566,7 +563,7 @@ # # minimum_txn_in_ledger_standalone = # -# Like minimum_txn_in_ledger when rippled is running in standalone +# Like minimum_txn_in_ledger when xahaud is running in standalone # mode. Default: 1000. # # target_txn_in_ledger = @@ -703,7 +700,7 @@ # # [validator_token] # -# This is an alternative to [validation_seed] that allows rippled to perform +# This is an alternative to [validation_seed] that allows xahaud to perform # validation without having to store the validator keys on the network # connected server. The field should contain a single token in the form of a # base64-encoded blob. @@ -738,19 +735,18 @@ # # Specify the file by its name or path. # Unless an absolute path is specified, it will be considered relative to -# the folder in which the rippled.cfg file is located. +# the folder in which the xahaud.cfg file is located. # # Examples: -# /home/ripple/validators.txt -# C:/home/ripple/validators.txt +# /home/xahaud/validators.txt +# C:/home/xahaud/validators.txt # # Example content: # [validators] -# n949f75evCHwgyP4fPVgaHqNHxUVN15PsJEZ3B3HnXPcPjcZAoy7 -# n9MD5h24qrQqiyBC8aeqqCWvpiBiYQ3jxSr91uiDvmrkyHRdYLUj -# n9L81uNCaPgtUJfaHh89gmdvXKAmSt5Gdsw2g1iPWaPkAHW5Nm4C -# n9KiYM9CgngLvtRCQHZwgC2gjpdaZcCcbt3VboxiNFcKuwFVujzS -# n9LdgEtkmGB9E2h3K4Vp7iGUaKuq23Zr32ehxiU8FWY7xoxbWTSA +# n9L3GdotB8a3AqtsvS7NXt4BUTQSAYyJUr9xtFj2qXJjfbZsawKY +# n9LQDHLWyFuAn5BXJuW2ow5J9uGqpmSjRYS2cFRpxf6uJbxwDzvM +# n9MCWyKVUkiatXVJTKUrAESB5kBFP8R3hm43jGHtg8WBnjv3iDfb +# n9KWXCLRhjpajuZtULTXsy6R5xbisA6ozGxM4zdEJFq6uHiFZDvW # # # @@ -833,7 +829,7 @@ # # 0: Disable the ledger replay feature [default] # 1: Enable the ledger replay feature. With this feature enabled, when -# acquiring a ledger from the network, a rippled node only downloads +# acquiring a ledger from the network, a xahaud node only downloads # the ledger header and the transactions instead of the whole ledger. # And the ledger is built by applying the transactions to the parent # ledger. @@ -844,10 +840,9 @@ # #---------------- # -# The rippled server instance uses HTTPS GET requests in a variety of +# The xahaud server instance uses HTTPS GET requests in a variety of # circumstances, including but not limited to contacting trusted domains to -# fetch information such as mapping an email address to a Ripple Payment -# Network address. +# fetch information such as mapping an email address to a user's r address. # # [ssl_verify] # @@ -884,15 +879,15 @@ # #------------ # -# rippled has an optional operating mode called Reporting Mode. In Reporting -# Mode, rippled does not connect to the peer to peer network. Instead, rippled -# will continuously extract data from one or more rippled servers that are +# xahaud has an optional operating mode called Reporting Mode. In Reporting +# Mode, xahaud does not connect to the peer to peer network. Instead, xahaud +# will continuously extract data from one or more xahaud servers that are # connected to the peer to peer network (referred to as an ETL source). # Reporting mode servers will forward RPC requests that require access to the # peer to peer network (submit, fee, etc) to an ETL source. # # [reporting] Settings for Reporting Mode. If and only if this section is -# present, rippled will start in reporting mode. This section +# present, xahaud will start in reporting mode. This section # contains a list of ETL source names, and key-value pairs. The # ETL source names each correspond to a configuration file # section; the names must match exactly. The key-value pairs are @@ -997,16 +992,16 @@ # #------------ # -# rippled creates 4 SQLite database to hold bookkeeping information +# xahaud creates 4 SQLite database to hold bookkeeping information # about transactions, local credentials, and various other things. # It also creates the NodeDB, which holds all the objects that -# make up the current and historical ledgers. In Reporting Mode, rippled +# make up the current and historical ledgers. In Reporting Mode, xahauad # uses a Postgres database instead of SQLite. # # The simplest way to work with Postgres is to install it locally. # When it is running, execute the initdb.sh script in the current # directory as: sudo -u postgres ./initdb.sh -# This will create the rippled user and an empty database of the same name. +# This will create the xahaud user and an empty database of the same name. # # The size of the NodeDB grows in proportion to the amount of new data and the # amount of historical data (a configurable setting) so the performance of the @@ -1014,7 +1009,7 @@ # the performance of the server. # # Partial pathnames will be considered relative to the location of -# the rippled.cfg file. +# the xahaud.cfg file. # # [node_db] Settings for the Node Database (required) # @@ -1025,18 +1020,18 @@ # # Example: # type=nudb -# path=db/nudb +# path=/opt/xahaud/db/nudb # # The "type" field must be present and controls the choice of backend: # # type = NuDB # # NuDB is a high-performance database written by Ripple Labs and optimized -# for rippled and solid-state drives. +# for and solid-state drives. # # NuDB maintains its high speed regardless of the amount of history # stored. Online delete may be selected, but is not required. NuDB is -# available on all platforms that rippled runs on. +# available on all platforms that xahaud runs on. # # type = RocksDB # @@ -1124,7 +1119,7 @@ # # Optional keys for NuDB and RocksDB: # -# earliest_seq The default is 32570 to match the XRP ledger +# earliest_seq The default is 32570 to match the XRP Ledger's # network's earliest allowed sequence. Alternate # networks may set this value. Minimum value of 1. # If a [shard_db] section is defined, and this @@ -1166,7 +1161,7 @@ # # recovery_wait_seconds # The online delete process checks periodically -# that rippled is still in sync with the network, +# that xahaud is still in sync with the network, # and that the validated ledger is less than # 'age_threshold_seconds' old. If not, then continue # sleeping for this number of seconds and @@ -1205,8 +1200,8 @@ # The server creates and maintains 4 to 5 bookkeeping SQLite databases in # the 'database_path' location. If you omit this configuration setting, # the server creates a directory called "db" located in the same place as -# your rippled.cfg file. -# Partial pathnames are relative to the location of the rippled executable. +# your xahaud.cfg file. +# Partial pathnames are relative to the location of the xahaud executable. # # [shard_db] Settings for the Shard Database (optional) # @@ -1282,7 +1277,7 @@ # The default is "wal", which uses a write-ahead # log to implement database transactions. # Alternately, "memory" saves disk I/O, but if -# rippled crashes during a transaction, the +# xahaud crashes during a transaction, the # database is likely to be corrupted. # See https://www.sqlite.org/pragma.html#pragma_journal_mode # for more details about the available options. @@ -1292,7 +1287,7 @@ # synchronous Valid values: off, normal, full, extra # The default is "normal", which works well with # the "wal" journal mode. Alternatively, "off" -# allows rippled to continue as soon as data is +# allows xahaud to continue as soon as data is # passed to the OS, which can significantly # increase speed, but risks data corruption if # the host computer crashes before writing that @@ -1306,7 +1301,7 @@ # The default is "file", which will use files # for temporary database tables and indices. # Alternatively, "memory" may save I/O, but -# rippled does not currently use many, if any, +# xahaud does not currently use many, if any, # of these temporary objects. # See https://www.sqlite.org/pragma.html#pragma_temp_store # for more details about the available options. @@ -1318,9 +1313,9 @@ # conninfo Info for connecting to Postgres. Format is # postgres://[username]:[password]@[ip]/[database]. # The database and user must already exist. If this -# section is missing and rippled is running in -# Reporting Mode, rippled will connect as the -# user running rippled to a database with the +# section is missing and xahaud is running in +# Reporting Mode, xahaud will connect as the +# user running xahaud to a database with the # same name. On Linux and Mac OS X, the connection # will take place using the server's UNIX domain # socket. On Windows, through the localhost IP @@ -1329,7 +1324,7 @@ # use_tx_tables Valid values: 1, 0 # The default is 1 (true). Determines whether to use # the SQLite transaction database. If set to 0, -# rippled will not write to the transaction database, +# xahaud will not write to the transaction database, # and will reject tx, account_tx and tx_history RPCs. # In Reporting Mode, this setting is ignored. # @@ -1357,7 +1352,7 @@ # # These settings are designed to help server administrators diagnose # problems, and obtain detailed information about the activities being -# performed by the rippled process. +# performed by the xahaud process. # # # @@ -1374,7 +1369,7 @@ # # Configuration parameters for the Beast. Insight stats collection module. # -# Insight is a module that collects information from the areas of rippled +# Insight is a module that collects information from the areas of xahaud # that have instrumentation. The configuration parameters control where the # collection metrics are sent. The parameters are expressed as key = value # pairs with no white space. The main parameter is the choice of server: @@ -1383,7 +1378,7 @@ # # Choice of server to send metrics to. Currently the only choice is # "statsd" which sends UDP packets to a StatsD daemon, which must be -# running while rippled is running. More information on StatsD is +# running while xahaud is running. More information on StatsD is # available here: # https://github.com/b/statsd_spec # @@ -1393,7 +1388,7 @@ # in the format, n.n.n.n:port. # # "prefix" A string prepended to each collected metric. This is used -# to distinguish between different running instances of rippled. +# to distinguish between different running instances of xahaud. # # If this section is missing, or the server type is unspecified or unknown, # statistics are not collected or reported. @@ -1420,7 +1415,7 @@ # # Example: # [perf] -# perf_log=/var/log/rippled/perf.log +# perf_log=/var/log/xahaud/perf.log # log_interval=2 # #------------------------------------------------------------------------------- @@ -1429,8 +1424,8 @@ # #---------- # -# The vote settings configure settings for the entire Ripple network. -# While a single instance of rippled cannot unilaterally enforce network-wide +# The vote settings configure settings for the entire Xahau Network. +# While a single instance of xahaud cannot unilaterally enforce network-wide # settings, these choices become part of the instance's vote during the # consensus process for each voting ledger. # @@ -1442,9 +1437,9 @@ # # The cost of the reference transaction fee, specified in drops. # The reference transaction is the simplest form of transaction. -# It represents an XRP payment between two parties. +# It represents an XAH payment between two parties. # -# If this parameter is unspecified, rippled will use an internal +# If this parameter is unspecified, xahaud will use an internal # default. Don't change this without understanding the consequences. # # Example: @@ -1453,26 +1448,26 @@ # account_reserve = # # The account reserve requirement is specified in drops. The portion of an -# account's XRP balance that is at or below the reserve may only be +# account's XAH balance that is at or below the reserve may only be # spent on transaction fees, and not transferred out of the account. # -# If this parameter is unspecified, rippled will use an internal +# If this parameter is unspecified, xahaud will use an internal # default. Don't change this without understanding the consequences. # # Example: -# account_reserve = 10000000 # 10 XRP +# account_reserve = 10000000 # 10 XAH # # owner_reserve = # -# The owner reserve is the amount of XRP reserved in the account for +# The owner reserve is the amount of XAH reserved in the account for # each ledger item owned by the account. Ledger items an account may # own include trust lines, open orders, and tickets. # -# If this parameter is unspecified, rippled will use an internal +# If this parameter is unspecified, xahaud will use an internal # default. Don't change this without understanding the consequences. # # Example: -# owner_reserve = 2000000 # 2 XRP +# owner_reserve = 2000000 # 2 XAH # #------------------------------------------------------------------------------- # @@ -1510,7 +1505,7 @@ # tool instead. # # This flag has no effect on the "sign" and "sign_for" command line options -# that rippled makes available. +# that xahaud makes available. # # The default value of this field is "false" # @@ -1589,7 +1584,7 @@ #-------------------- # # Administrators can use these values as a starting point for configuring -# their instance of rippled, but each value should be checked to make sure +# their instance of xahaud, but each value should be checked to make sure # it meets the business requirements for the organization. # # Server @@ -1599,7 +1594,7 @@ # "peer" # # Peer protocol open to everyone. This is required to accept -# incoming rippled connections. This does not affect automatic +# incoming xahaud connections. This does not affect automatic # or manual outgoing Peer protocol connections. # # "rpc" @@ -1627,8 +1622,8 @@ # NOTE # # To accept connections on well known ports such as 80 (HTTP) or -# 443 (HTTPS), most operating systems will require rippled to -# run with administrator privileges, or else rippled will not start. +# 443 (HTTPS), most operating systems will require xahaud to +# run with administrator privileges, or else xahaud will not start. [server] port_rpc_admin_local @@ -1639,20 +1634,20 @@ port_ws_admin_local #ssl_cert = /etc/ssl/certs/server.crt [port_rpc_admin_local] -port = 5005 +port = 5009 ip = 127.0.0.1 admin = 127.0.0.1 protocol = http [port_peer] -port = 51235 +port = 21337 ip = 0.0.0.0 # alternatively, to accept connections on IPv4 + IPv6, use: #ip = :: protocol = peer [port_ws_admin_local] -port = 6006 +port = 6009 ip = 127.0.0.1 admin = 127.0.0.1 protocol = ws @@ -1663,15 +1658,15 @@ ip = 127.0.0.1 secure_gateway = 127.0.0.1 #[port_ws_public] -#port = 6005 +#port = 6008 #ip = 127.0.0.1 #protocol = wss #------------------------------------------------------------------------------- -# This is primary persistent datastore for rippled. This includes transaction +# This is primary persistent datastore for xahaud. This includes transaction # metadata, account states, and ledger headers. Helpful information can be -# found at https://xrpl.org/capacity-planning.html#node-db-type +# found at https://xahau.network/docs/infrastructure/system-requirements # type=NuDB is recommended for non-validators with fast SSDs. Validators or # slow / spinning disks should use RocksDB. Caution: Spinning disks are # not recommended. They do not perform well enough to consistently remain @@ -1684,16 +1679,16 @@ secure_gateway = 127.0.0.1 # deletion. [node_db] type=NuDB -path=/var/lib/rippled/db/nudb +path=/opt/xahaud/db/nudb online_delete=512 advisory_delete=0 # This is the persistent datastore for shards. It is important for the health -# of the ripple network that rippled operators shard as much as practical. +# of the Xahau Network that xahaud operators shard as much as practical. # NuDB requires SSD storage. Helpful information can be found at # https://xrpl.org/history-sharding.html #[shard_db] -#path=/var/lib/rippled/db/shards/nudb +#path=/opt/xahaud/db/shards/nudb #max_historical_shards=50 # # This optional section can be configured with a list @@ -1704,7 +1699,7 @@ advisory_delete=0 #/path/2 [database_path] -/var/lib/rippled/db +/opt/xahaud/db # To use Postgres, uncomment this section and fill in the appropriate connection @@ -1719,7 +1714,7 @@ advisory_delete=0 # This needs to be an absolute directory reference, not a relative one. # Modify this value as required. [debug_logfile] -/var/log/rippled/debug.log +/var/log/xahaud/debug.log [sntp_servers] time.windows.com @@ -1727,15 +1722,19 @@ time.apple.com time.nist.gov pool.ntp.org -# To use the XRP test network -# (see https://xrpl.org/connect-your-rippled-to-the-xrp-test-net.html), +# To use the Xahau Test Network +# (see https://xahau.network/docs/infrastructure/installing-xahaud), # use the following [ips] section: # [ips] -# r.altnet.rippletest.net 51235 +# 79.110.60.121 21338 +# 79.110.60.122 21338 +# 79.110.60.124 21338 +# 79.110.60.125 21338 + # File containing trusted validator keys or validator list publishers. # Unless an absolute path is specified, it will be considered relative to the -# folder in which the rippled.cfg file is located. +# folder in which the xahaud.cfg file is located. [validators_file] validators.txt diff --git a/cfg/rippled-reporting.cfg b/cfg/xahaud-reporting.cfg similarity index 90% rename from cfg/rippled-reporting.cfg rename to cfg/xahaud-reporting.cfg index dbafdd497..03ac0f33e 100644 --- a/cfg/rippled-reporting.cfg +++ b/cfg/xahaud-reporting.cfg @@ -9,7 +9,7 @@ # # 2. Peer Protocol # -# 3. Ripple Protocol +# 3. XRPL Protocol # # 4. HTTPS Client # @@ -29,18 +29,16 @@ # # Purpose # -# This file documents and provides examples of all rippled server process -# configuration options. When the rippled server instance is launched, it +# This file documents and provides examples of all xahaud server process +# configuration options. When the xahaud server instance is launched, it # looks for a file with the following name: # -# rippled.cfg +# xahaud.cfg # -# For more information on where the rippled server instance searches for the -# file, visit: +# To run xahaud with a custom configuration file, use the "--conf {file}" flag. +# By default, xahaud will look in the local working directory or the home directory # -# https://xrpl.org/commandline-usage.html#generic-options -# -# This file should be named rippled.cfg. This file is UTF-8 with DOS, UNIX, +# This file should be named xahaud.cfg. This file is UTF-8 with DOS, UNIX, # or Mac style end of lines. Blank lines and lines beginning with '#' are # ignored. Undefined sections are reserved. No escapes are currently defined. # @@ -89,8 +87,8 @@ # # # -# rippled offers various server protocols to clients making inbound -# connections. The listening ports rippled uses are "universal" ports +# xahaud offers various server protocols to clients making inbound +# connections. The listening ports xahaud uses are "universal" ports # which may be configured to handshake in one or more of the available # supported protocols. These universal ports simplify administration: # A single open port can be used for multiple protocols. @@ -103,7 +101,7 @@ # # A list of port names and key/value pairs. A port name must start with a # letter and contain only letters and numbers. The name is not case-sensitive. -# For each name in this list, rippled will look for a configuration file +# For each name in this list, xahaud will look for a configuration file # section with the same name and use it to create a listening port. The # name is informational only; the choice of name does not affect the function # of the listening port. @@ -134,7 +132,7 @@ # ip = 127.0.0.1 # protocol = http # -# When rippled is used as a command line client (for example, issuing a +# When xahaud is used as a command line client (for example, issuing a # server stop command), the first port advertising the http or https # protocol will be used to make the connection. # @@ -175,7 +173,7 @@ # same time. It is possible have both Websockets and Secure Websockets # together in one port. # -# NOTE If no ports support the peer protocol, rippled cannot +# NOTE If no ports support the peer protocol, xahaud cannot # receive incoming peer connections or become a superpeer. # # limit = @@ -194,7 +192,7 @@ # required. IP address restrictions, if any, will be checked in addition # to the credentials specified here. # -# When acting in the client role, rippled will supply these credentials +# When acting in the client role, xahaud will supply these credentials # using HTTP's Basic Authentication headers when making outbound HTTP/S # requests. # @@ -227,7 +225,7 @@ # WS, or WSS protocol interfaces. If administrative commands are # disabled for a port, these credentials have no effect. # -# When acting in the client role, rippled will supply these credentials +# When acting in the client role, xahaud will supply these credentials # in the submitted JSON for any administrative command requests when # invoking JSON-RPC commands on remote servers. # @@ -247,11 +245,11 @@ # resource controls will default to those for non-administrative users. # # The secure_gateway IP addresses are intended to represent -# proxies. Since rippled trusts these hosts, they must be +# proxies. Since xahaud trusts these hosts, they must be # responsible for properly authenticating the remote user. # # The same IP address cannot be used in both "admin" and "secure_gateway" -# lists for the same port. In this case, rippled will abort with an error +# lists for the same port. In this case, xahaud will abort with an error # message to the console shortly after startup # # ssl_key = @@ -261,7 +259,7 @@ # Use the specified files when configuring SSL on the port. # # NOTE If no files are specified and secure protocols are selected, -# rippled will generate an internal self-signed certificate. +# xahaud will generate an internal self-signed certificate. # # The files have these meanings: # @@ -284,12 +282,12 @@ # Control the ciphers which the server will support over SSL on the port, # specified using the OpenSSL "cipher list format". # -# NOTE If unspecified, rippled will automatically configure a modern +# NOTE If unspecified, xahaud will automatically configure a modern # cipher suite. This default suite should be widely supported. # # You should not modify this string unless you have a specific # reason and cryptographic expertise. Incorrect modification may -# keep rippled from connecting to other instances of rippled or +# keep xahaud from connecting to other instances of xahaud or # prevent RPC and WebSocket clients from connecting. # # send_queue_limit = [1..65535] @@ -340,7 +338,7 @@ # # Examples: # { "command" : "server_info" } -# { "command" : "log_level", "partition" : "ripplecalc", "severity" : "trace" } +# { "command" : "log_level", "partition" : "xahaucalc", "severity" : "trace" } # # # @@ -369,8 +367,8 @@ #----------------- # # These settings control security and access attributes of the Peer to Peer -# server section of the rippled process. Peer Protocol implements the -# Ripple Payment protocol. It is over peer connections that transactions +# server section of the xahaud process. Peer Protocol implements the +# XRPL Payment protocol. It is over peer connections that transactions # and validations are passed from to machine to machine, to determine the # contents of validated ledgers. # @@ -378,7 +376,7 @@ # # [ips] # -# List of hostnames or ips where the Ripple protocol is served. A default +# List of hostnames or ips where the XRPL protocol is served. A default # starter list is included in the code and used if no other hostnames are # available. # @@ -387,24 +385,23 @@ # does not generally matter. # # The default list of entries is: -# - r.ripple.com 51235 -# - zaphod.alloy.ee 51235 -# - sahyadri.isrdc.in 51235 +# - bacab.alloy.ee 21337 +# - hubs.xahau.as16089.net 21337 # # Examples: # # [ips] # 192.168.0.1 -# 192.168.0.1 2459 -# r.ripple.com 51235 +# 192.168.0.1 21337 +# bacab.alloy.ee 21337 # # # [ips_fixed] # -# List of IP addresses or hostnames to which rippled should always attempt to +# List of IP addresses or hostnames to which xahaud should always attempt to # maintain peer connections with. This is useful for manually forming private # networks, for example to configure a validation server that connects to the -# Ripple network through a public-facing server, or for building a set +# Xahau Network through a public-facing server, or for building a set # of cluster peers. # # One address or domain names per line is allowed. A port must be specified @@ -454,7 +451,7 @@ # # IP address or domain of NTP servers to use for time synchronization. # -# These NTP servers are suitable for rippled servers located in the United +# These NTP servers are suitable for xahaud servers located in the United # States: # time.windows.com # time.apple.com @@ -555,7 +552,7 @@ # # minimum_txn_in_ledger_standalone = # -# Like minimum_txn_in_ledger when rippled is running in standalone +# Like minimum_txn_in_ledger when xahaud is running in standalone # mode. Default: 1000. # # target_txn_in_ledger = @@ -682,7 +679,7 @@ # # [validator_token] # -# This is an alternative to [validation_seed] that allows rippled to perform +# This is an alternative to [validation_seed] that allows xahaud to perform # validation without having to store the validator keys on the network # connected server. The field should contain a single token in the form of a # base64-encoded blob. @@ -717,22 +714,21 @@ # # Specify the file by its name or path. # Unless an absolute path is specified, it will be considered relative to -# the folder in which the rippled.cfg file is located. +# the folder in which the xahaud.cfg file is located. # # Examples: -# /home/ripple/validators.txt -# C:/home/ripple/validators.txt +# /home/xahaud/validators.txt +# C:/home/xahaud/validators.txt # # Example content: # [validators] -# n949f75evCHwgyP4fPVgaHqNHxUVN15PsJEZ3B3HnXPcPjcZAoy7 -# n9MD5h24qrQqiyBC8aeqqCWvpiBiYQ3jxSr91uiDvmrkyHRdYLUj -# n9L81uNCaPgtUJfaHh89gmdvXKAmSt5Gdsw2g1iPWaPkAHW5Nm4C -# n9KiYM9CgngLvtRCQHZwgC2gjpdaZcCcbt3VboxiNFcKuwFVujzS -# n9LdgEtkmGB9E2h3K4Vp7iGUaKuq23Zr32ehxiU8FWY7xoxbWTSA -# -# -# +# n9L3GdotB8a3AqtsvS7NXt4BUTQSAYyJUr9xtFj2qXJjfbZsawKY +# n9LQDHLWyFuAn5BXJuW2ow5J9uGqpmSjRYS2cFRpxf6uJbxwDzvM +# n9MCWyKVUkiatXVJTKUrAESB5kBFP8R3hm43jGHtg8WBnjv3iDfb +# n9KWXCLRhjpajuZtULTXsy6R5xbisA6ozGxM4zdEJFq6uHiFZDvW + + + # [path_search] # When searching for paths, the default search aggressiveness. This can take # exponentially more resources as the size is increased. @@ -795,7 +791,7 @@ # # 0: Disable the ledger replay feature [default] # 1: Enable the ledger replay feature. With this feature enabled, when -# acquiring a ledger from the network, a rippled node only downloads +# acquiring a ledger from the network, a xahaud node only downloads # the ledger header and the transactions instead of the whole ledger. # And the ledger is built by applying the transactions to the parent # ledger. @@ -806,9 +802,9 @@ # #---------------- # -# The rippled server instance uses HTTPS GET requests in a variety of +# The xahaud server instance uses HTTPS GET requests in a variety of # circumstances, including but not limited to contacting trusted domains to -# fetch information such as mapping an email address to a Ripple Payment +# fetch information such as mapping an email address to a XRPL Payment # Network address. # # [ssl_verify] @@ -846,15 +842,15 @@ # #------------ # -# rippled has an optional operating mode called Reporting Mode. In Reporting -# Mode, rippled does not connect to the peer to peer network. Instead, rippled -# will continuously extract data from one or more rippled servers that are +# xahaud has an optional operating mode called Reporting Mode. In Reporting +# Mode, xahaud does not connect to the peer to peer network. Instead, xahaud +# will continuously extract data from one or more xahaud servers that are # connected to the peer to peer network (referred to as an ETL source). # Reporting mode servers will forward RPC requests that require access to the # peer to peer network (submit, fee, etc) to an ETL source. # # [reporting] Settings for Reporting Mode. If and only if this section is -# present, rippled will start in reporting mode. This section +# present, xahaud will start in reporting mode. This section # contains a list of ETL source names, and key-value pairs. The # ETL source names each correspond to a configuration file # section; the names must match exactly. The key-value pairs are @@ -959,16 +955,16 @@ # #------------ # -# rippled creates 4 SQLite database to hold bookkeeping information +# xahaud creates 4 SQLite database to hold bookkeeping information # about transactions, local credentials, and various other things. # It also creates the NodeDB, which holds all the objects that -# make up the current and historical ledgers. In Reporting Mode, rippled +# make up the current and historical ledgers. In Reporting Mode, xahaud # uses a Postgres database instead of SQLite. # # The simplest way to work with Postgres is to install it locally. # When it is running, execute the initdb.sh script in the current # directory as: sudo -u postgres ./initdb.sh -# This will create the rippled user and an empty database of the same name. +# This will create the xahaud user and an empty database of the same name. # # The size of the NodeDB grows in proportion to the amount of new data and the # amount of historical data (a configurable setting) so the performance of the @@ -976,7 +972,7 @@ # the performance of the server. # # Partial pathnames will be considered relative to the location of -# the rippled.cfg file. +# the xahaud.cfg file. # # [node_db] Settings for the Node Database (required) # @@ -994,11 +990,11 @@ # type = NuDB # # NuDB is a high-performance database written by Ripple Labs and optimized -# for rippled and solid-state drives. +# for solid-state drives. # # NuDB maintains its high speed regardless of the amount of history # stored. Online delete may be selected, but is not required. NuDB is -# available on all platforms that rippled runs on. +# available on all platforms that xahaud runs on. # # type = RocksDB # @@ -1103,14 +1099,14 @@ # # recovery_wait_seconds # The online delete process checks periodically -# that rippled is still in sync with the network, +# that xahaud is still in sync with the network, # and that the validated ledger is less than # 'age_threshold_seconds' old. By default, if it # is not the online delete process aborts and # tries again later. If 'recovery_wait_seconds' -# is set and rippled is out of sync, but likely to +# is set and xahaud is out of sync, but likely to # recover quickly, then online delete will wait -# this number of seconds for rippled to get back +# this number of seconds for xahaud to get back # into sync before it aborts. # Set this value if the node is otherwise staying # in sync, or recovering quickly, but the online @@ -1146,8 +1142,8 @@ # The server creates and maintains 4 to 5 bookkeeping SQLite databases in # the 'database_path' location. If you omit this configuration setting, # the server creates a directory called "db" located in the same place as -# your rippled.cfg file. -# Partial pathnames are relative to the location of the rippled executable. +# your xahaud.cfg file. +# Partial pathnames are relative to the location of the xahaud executable. # # [shard_db] Settings for the Shard Database (optional) # @@ -1223,7 +1219,7 @@ # The default is "wal", which uses a write-ahead # log to implement database transactions. # Alternately, "memory" saves disk I/O, but if -# rippled crashes during a transaction, the +# xahaud crashes during a transaction, the # database is likely to be corrupted. # See https://www.sqlite.org/pragma.html#pragma_journal_mode # for more details about the available options. @@ -1233,7 +1229,7 @@ # synchronous Valid values: off, normal, full, extra # The default is "normal", which works well with # the "wal" journal mode. Alternatively, "off" -# allows rippled to continue as soon as data is +# allows xahaud to continue as soon as data is # passed to the OS, which can significantly # increase speed, but risks data corruption if # the host computer crashes before writing that @@ -1247,7 +1243,7 @@ # The default is "file", which will use files # for temporary database tables and indices. # Alternatively, "memory" may save I/O, but -# rippled does not currently use many, if any, +# xahaud does not currently use many, if any, # of these temporary objects. # See https://www.sqlite.org/pragma.html#pragma_temp_store # for more details about the available options. @@ -1259,9 +1255,9 @@ # conninfo Info for connecting to Postgres. Format is # postgres://[username]:[password]@[ip]/[database]. # The database and user must already exist. If this -# section is missing and rippled is running in -# Reporting Mode, rippled will connect as the -# user running rippled to a database with the +# section is missing and xahaud is running in +# Reporting Mode, xahaud will connect as the +# user running xahaud to a database with the # same name. On Linux and Mac OS X, the connection # will take place using the server's UNIX domain # socket. On Windows, through the localhost IP @@ -1270,7 +1266,7 @@ # use_tx_tables Valid values: 1, 0 # The default is 1 (true). Determines whether to use # the SQLite transaction database. If set to 0, -# rippled will not write to the transaction database, +# xahaud will not write to the transaction database, # and will reject tx, account_tx and tx_history RPCs. # In Reporting Mode, this setting is ignored. # @@ -1298,7 +1294,7 @@ # # These settings are designed to help server administrators diagnose # problems, and obtain detailed information about the activities being -# performed by the rippled process. +# performed by the xahaud process. # # # @@ -1315,7 +1311,7 @@ # # Configuration parameters for the Beast. Insight stats collection module. # -# Insight is a module that collects information from the areas of rippled +# Insight is a module that collects information from the areas of xahaud # that have instrumentation. The configuration parameters control where the # collection metrics are sent. The parameters are expressed as key = value # pairs with no white space. The main parameter is the choice of server: @@ -1324,7 +1320,7 @@ # # Choice of server to send metrics to. Currently the only choice is # "statsd" which sends UDP packets to a StatsD daemon, which must be -# running while rippled is running. More information on StatsD is +# running while xahaud is running. More information on StatsD is # available here: # https://github.com/b/statsd_spec # @@ -1334,7 +1330,7 @@ # in the format, n.n.n.n:port. # # "prefix" A string prepended to each collected metric. This is used -# to distinguish between different running instances of rippled. +# to distinguish between different running instances of xahaud. # # If this section is missing, or the server type is unspecified or unknown, # statistics are not collected or reported. @@ -1361,7 +1357,7 @@ # # Example: # [perf] -# perf_log=/var/log/rippled/perf.log +# perf_log=/var/log/xahaud/perf.log # log_interval=2 # #------------------------------------------------------------------------------- @@ -1370,8 +1366,8 @@ # #---------- # -# The vote settings configure settings for the entire Ripple network. -# While a single instance of rippled cannot unilaterally enforce network-wide +# The vote settings configure settings for the entire Xahau Network. +# While a single instance of xahaud cannot unilaterally enforce network-wide # settings, these choices become part of the instance's vote during the # consensus process for each voting ledger. # @@ -1383,9 +1379,9 @@ # # The cost of the reference transaction fee, specified in drops. # The reference transaction is the simplest form of transaction. -# It represents an XRP payment between two parties. +# It represents an XAH payment between two parties. # -# If this parameter is unspecified, rippled will use an internal +# If this parameter is unspecified, xahaud will use an internal # default. Don't change this without understanding the consequences. # # Example: @@ -1394,26 +1390,26 @@ # account_reserve = # # The account reserve requirement is specified in drops. The portion of an -# account's XRP balance that is at or below the reserve may only be +# account's XAH balance that is at or below the reserve may only be # spent on transaction fees, and not transferred out of the account. # -# If this parameter is unspecified, rippled will use an internal +# If this parameter is unspecified, xahaud will use an internal # default. Don't change this without understanding the consequences. # # Example: -# account_reserve = 10000000 # 10 XRP +# account_reserve = 10000000 # 10 XAH # # owner_reserve = # -# The owner reserve is the amount of XRP reserved in the account for +# The owner reserve is the amount of XAH reserved in the account for # each ledger item owned by the account. Ledger items an account may # own include trust lines, open orders, and tickets. # -# If this parameter is unspecified, rippled will use an internal +# If this parameter is unspecified, xahaud will use an internal # default. Don't change this without understanding the consequences. # # Example: -# owner_reserve = 2000000 # 2 XRP +# owner_reserve = 2000000 # 2 XAH # #------------------------------------------------------------------------------- # @@ -1451,7 +1447,7 @@ # tool instead. # # This flag has no effect on the "sign" and "sign_for" command line options -# that rippled makes available. +# that xahaud makes available. # # The default value of this field is "false" # @@ -1530,7 +1526,7 @@ #-------------------- # # Administrators can use these values as a starting point for configuring -# their instance of rippled, but each value should be checked to make sure +# their instance of xahaud, but each value should be checked to make sure # it meets the business requirements for the organization. # # Server @@ -1540,7 +1536,7 @@ # "peer" # # Peer protocol open to everyone. This is required to accept -# incoming rippled connections. This does not affect automatic +# incoming xahaud connections. This does not affect automatic # or manual outgoing Peer protocol connections. # # "rpc" @@ -1568,8 +1564,8 @@ # NOTE # # To accept connections on well known ports such as 80 (HTTP) or -# 443 (HTTPS), most operating systems will require rippled to -# run with administrator privileges, or else rippled will not start. +# 443 (HTTPS), most operating systems will require xahaud to +# run with administrator privileges, or else xahaud will not start. [server] port_rpc_admin_local @@ -1587,7 +1583,7 @@ admin = 127.0.0.1 protocol = http [port_peer] -port = 51235 +port = 21337 ip = 0.0.0.0 # alternatively, to accept connections on IPv4 + IPv6, use: #ip = :: @@ -1611,9 +1607,9 @@ protocol = ws #------------------------------------------------------------------------------- -# This is primary persistent datastore for rippled. This includes transaction +# This is primary persistent datastore for xahaud. This includes transaction # metadata, account states, and ledger headers. Helpful information can be -# found at https://xrpl.org/capacity-planning.html#node-db-type +# found at https://xahau.network/docs/infrastructure/system-requirements # type=NuDB is recommended for non-validators with fast SSDs. Validators or # slow / spinning disks should use RocksDB. Caution: Spinning disks are # not recommended. They do not perform well enough to consistently remain @@ -1626,16 +1622,16 @@ protocol = ws # deletion. [node_db] type=NuDB -path=/var/lib/rippled-reporting/db/nudb +path=/opt/xahaud-reporting/db/nudb # online_delete=512 # advisory_delete=0 # This is the persistent datastore for shards. It is important for the health -# of the ripple network that rippled operators shard as much as practical. +# of the Xahau Network that xahaud operators shard as much as practical. # NuDB requires SSD storage. Helpful information can be found at # https://xrpl.org/history-sharding.html #[shard_db] -#path=/var/lib/rippled/db/shards/nudb +#path=/opt/xahaud-reporting/db/shards/nudb #max_historical_shards=50 # # This optional section can be configured with a list @@ -1646,7 +1642,7 @@ advisory_delete=0 #/path/2 [database_path] -/var/lib/rippled-reporting/db +/opt/xahaud-reporting/db # To use Postgres, uncomment this section and fill in the appropriate connection # info. Postgres can only be used in Reporting Mode. @@ -1660,7 +1656,7 @@ advisory_delete=0 # This needs to be an absolute directory reference, not a relative one. # Modify this value as required. [debug_logfile] -/var/log/rippled-reporting/debug.log +/var/log/xahaud-reporting/debug.log [sntp_servers] time.windows.com @@ -1668,17 +1664,20 @@ time.apple.com time.nist.gov pool.ntp.org -# To use the XRP test network -# (see https://xrpl.org/connect-your-rippled-to-the-xrp-test-net.html), +# To use the Xahau Test Network +# (see https://xahau.network/docs/infrastructure/installing-xahaud), # use the following [ips] section: # [ips] -# r.altnet.rippletest.net 51235 +# 79.110.60.121 21338 +# 79.110.60.122 21338 +# 79.110.60.124 21338 +# 79.110.60.125 21338 # File containing trusted validator keys or validator list publishers. # Unless an absolute path is specified, it will be considered relative to the -# folder in which the rippled.cfg file is located. +# folder in which the xahaud.cfg file is located. [validators_file] -/opt/rippled-reporting/etc/validators.txt +/opt/xahaud-reporting/etc/validators.txt # Turn down default logging to save disk space in the long run. # Valid values here are trace, debug, info, warning, error, and fatal @@ -1699,5 +1698,5 @@ etl_source [etl_source] source_grpc_port=50051 -source_ws_port=6005 +source_ws_port=6008 source_ip=127.0.0.1 diff --git a/cfg/rippled-standalone.cfg b/cfg/xahaud-standalone.cfg old mode 100755 new mode 100644 similarity index 97% rename from cfg/rippled-standalone.cfg rename to cfg/xahaud-standalone.cfg index 3301299ca..3933b4ba8 --- a/cfg/rippled-standalone.cfg +++ b/cfg/xahaud-standalone.cfg @@ -1,4 +1,4 @@ -# standalone: ./rippled -a --ledgerfile config/genesis.json --conf config/rippled-standalone.cfg +# standalone: ./xahaud -a --ledgerfile config/genesis.json --conf config/xahaud-standalone.cfg [server] port_rpc_admin_local port_ws_public @@ -21,7 +21,7 @@ ip = 0.0.0.0 protocol = ws # [port_peer] -# port = 51235 +# port = 21337 # ip = 0.0.0.0 # protocol = peer @@ -69,7 +69,8 @@ time.nist.gov pool.ntp.org [ips] -r.ripple.com 51235 +bacab.alloy.ee 21337 +hubs.xahau.as16089.net 21337 [validators_file] validators-example.txt @@ -94,7 +95,7 @@ validators-example.txt 1000000 [network_id] -21338 +21337 [amendments] 740352F2412A9909880C23A559FCECEDA3BE2126FED62FC7660D628A06927F11 Flow From 39d1c439015883e26135e8d149c47a5142e36556 Mon Sep 17 00:00:00 2001 From: Niq Dudfield Date: Fri, 10 Oct 2025 16:53:35 +0700 Subject: [PATCH 4/7] build: upgrade openssl from 1.1.1u to 3.6.0 (#587) Updates OpenSSL dependency to the latest 3.x series available on Conan Center. --- conanfile.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conanfile.py b/conanfile.py index 4b98b84db..e29a880d8 100644 --- a/conanfile.py +++ b/conanfile.py @@ -31,7 +31,7 @@ class Xrpl(ConanFile): 'lz4/1.9.4', 'grpc/1.50.1', 'nudb/2.0.8', - 'openssl/1.1.1u', + 'openssl/3.6.0', 'protobuf/3.21.12', 'soci/4.0.3@xahaud/stable', 'zlib/1.3.1', From 094f011006f6a7501cf721f90aedfb7464292d1c Mon Sep 17 00:00:00 2001 From: tequ Date: Sat, 11 Oct 2025 10:43:09 +0900 Subject: [PATCH 5/7] Fix `emit` Hook API testcase name (#580) --- src/test/app/SetHook_test.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/app/SetHook_test.cpp b/src/test/app/SetHook_test.cpp index c3b336d05..3fb16176b 100644 --- a/src/test/app/SetHook_test.cpp +++ b/src/test/app/SetHook_test.cpp @@ -2434,7 +2434,7 @@ public: void test_emit(FeatureBitset features) { - testcase("Test float_emit"); + testcase("Test emit"); using namespace jtx; Env env{*this, features}; From e580f7cfc0c02986132360f1669e82b6df2f9599 Mon Sep 17 00:00:00 2001 From: tequ Date: Sat, 11 Oct 2025 10:43:50 +0900 Subject: [PATCH 6/7] chore(vscode): enable format on save in settings.json (#578) --- .vscode/settings.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.vscode/settings.json b/.vscode/settings.json index 1642d6324..313281c33 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -8,6 +8,6 @@ "editor.semanticHighlighting.enabled": true, "editor.tabSize": 4, "editor.defaultFormatter": "xaver.clang-format", - "editor.formatOnSave": false + "editor.formatOnSave": true } } From ad0531ad6c7f970d03423e688d27472babf55cf7 Mon Sep 17 00:00:00 2001 From: Niq Dudfield Date: Sat, 11 Oct 2025 08:47:13 +0700 Subject: [PATCH 7/7] chore: fix warnings (#509) Co-authored-by: Denis Angell Co-authored-by: RichardAH --- src/ripple/app/rdb/backend/RWDBDatabase.h | 3 ++- src/ripple/overlay/impl/Handshake.cpp | 12 +++++------- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/src/ripple/app/rdb/backend/RWDBDatabase.h b/src/ripple/app/rdb/backend/RWDBDatabase.h index f91e50cda..308c4366f 100644 --- a/src/ripple/app/rdb/backend/RWDBDatabase.h +++ b/src/ripple/app/rdb/backend/RWDBDatabase.h @@ -221,7 +221,8 @@ public: if (!ledger->info().accountHash.isNonZero()) { - JLOG(j.fatal()) << "AH is zero: " << getJson({*ledger, {}}); + JLOG(j.fatal()) + << "AH is zero: " << getJson({*ledger, {}}).asString(); assert(false); } diff --git a/src/ripple/overlay/impl/Handshake.cpp b/src/ripple/overlay/impl/Handshake.cpp index 11b75e28d..73d40e6c5 100644 --- a/src/ripple/overlay/impl/Handshake.cpp +++ b/src/ripple/overlay/impl/Handshake.cpp @@ -239,19 +239,17 @@ verifyHandshake( throw std::runtime_error("Invalid server domain"); } - // Check the network. Omitting Network-ID (on either side ours, or theirs) - // means NID=0 + // Check network ID, treating absent/empty as default network 0 { - uint32_t peer_nid = 0; + std::uint32_t nid{0}; + if (auto const iter = headers.find("Network-ID"); iter != headers.end()) { - if (!beast::lexicalCastChecked( - peer_nid, std::string(iter->value()))) + if (!beast::lexicalCastChecked(nid, std::string(iter->value()))) throw std::runtime_error("Invalid peer network identifier"); } - uint32_t our_nid = networkID ? *networkID : 0; - if (peer_nid != our_nid) + if (networkID.value_or(0) != nid) throw std::runtime_error("Peer is on a different network"); }