go-randomx/README.md
DataHoarder acfff4a4ad
All checks were successful
continuous-integration/drone/push Build is passing
Add hard float support for arm platform, add tests
2024-05-02 04:16:52 +02:00

2.8 KiB

RandomX (Golang Implementation)

RandomX is a proof-of-work (PoW) algorithm that is optimized for general-purpose CPUs. RandomX uses random code execution (hence the name) together with several memory-hard techniques to minimize the efficiency advantage of specialized hardware.


Fork from git.dero.io/DERO_Foundation/RandomX. Also related, their Analysis of RandomX writeup.

Original code failed RandomX testcases and was implemented using big.Float.


This package implements RandomX without CGO, using only Golang code, native float64 ops, some assembly, but with optional soft float purego implementation.

All test cases pass properly.

Supports Full mode and Light mode.

For the C++ implementation and design of RandomX, see github.com/tevador/RandomX

Feature 386 amd64 arm arm64 mips mips64 riscv64 wasm
purego
Full Mode
Float Operations hw hw hw hw soft soft soft soft
AES Operations soft hw soft soft soft soft soft soft
Superscalar Execution interpreter compiler interpreter interpreter interpreter interpreter interpreter interpreter
VM Execution interpreter compiler interpreter interpreter soft soft soft soft

A pure Golang implementation can be used on platforms without hard float support or via the purego build tag manually.

TinyGo is supported under the purego build tag.

Any platform with no hard float support or when enabled manually will use soft float, using softfloat64. This will be very slow.

Full mode is NOT recommended in 32-bit systems and is unsupported, although depending on system it might be able to run. You might want to manually run runtime.GC() if cleaning up dataset to free memory.

Native hard float can be added with supporting rounding mode under asm.

JIT only supported under Unix systems (Linux, *BSD, macOS), and can be hard-disabled via the disable_jit build flag, or at runtime.