Library with support for encoding/decoding Monero base58 strings, with and without checksum verification.
Monero base58 is not like Bitcoin base58, bytes are converted in 8-byte blocks. The last block can
have less than 8 bytes, but at least 1 byte. Eight bytes converts to 11 or less Base58 characters;
if a particular block converts to <11 characters, the conversion pads it with "1"s (1 is 0
in Base58). Likewise, the final block can convert to 11 or less Base58 digits.
Due to the conditional padding, the 69-byte string, like Monero addresses, will always convert to 95
Base58 characters (8 * 11 + 7); where 7 is length of the last block of 5 bytes.
The alphabet is composed of 58 characters visually not similar to avoid confusion, e.g. both 1 and
l are not part of the alphabet together, only 1 is present. The full alphabet is composed of:
123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz
By default only the std feature is enabled. If you want to opt-out remove default features
features in your project:
[dependencies.base58-monero]
version = "2"
default-features = falseDisable this feature if you want to build in a no_std environment. This feature is required when steam
is enabled.
Enables encode_check and decode_check functions. By default check feature is disabled.
This feature is not extensively tested and have performance issues, use it at your own risk!
Enables encode_stream and decode_stream functions. By default stream feature is not enable. This
feature enables async stream for encoding/decoding bytes. This should be used when encoding larger
amount of data or in asyncronous environment. stream can be used with check to enable
encode_stream_check and decode_stream_check. To use stream feature you can add in your Cargo.toml:
[dependencies.base58-monero]
version = "2"
features = ["stream"]This feature enables the std feature.
Doctests needs stream feature to run, run tests with all features:
cargo test --all-features
Results obtained on an Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz with a standard Monero address as data source. Performances are shown in nanosecond per iteration of compute, the smaller the better:
| Operation | Regular | _check |
|---|---|---|
encode |
652 ns (+/- 107) | 1,272 ns (+/- 760) |
decode |
612 ns (+/- 82) | 1,187 ns (+/- 541) |
Check versions compute or verify the checksum while encoding or decoding the data.
Benchmarks can be found under /benches and run with
cargo +nightly bench --all-features
See CHANGELOG.md and RELEASING.md.
This started as a research project sponsored by TrueLevel SA. It is now maintained by community members.
The code in this project is licensed under the MIT License