5 releases
0.2.0 | Mar 23, 2023 |
---|---|
0.1.3 | Oct 22, 2022 |
0.1.2 | Oct 7, 2022 |
0.1.1 | Oct 5, 2022 |
0.1.0 | Oct 4, 2022 |
#4 in #bitcoin-cash
164 downloads per month
Used in crypto-addr
46KB
624 lines
Overview
A library crate providing a dependency-free†, pure rust implementation of the cashaddr codec. Allows for transcoding between hashes and cashaddr strings.
† This Crate is only dependency-free if no optional crate features are enabled: enabling crate features can introduce third-party dependencies.
Features
- Generalized interface supporting all standard and many non-standard use-cases
- Non-standard hash types (type bits)
- Arbitrary human-readable prefixes
- Case-insensitive parsing
- Elided prefix
- Comprehensive error detection in decoder
- Convenience methods for succinct expression of common conversion parameters
Feature Flags
All crate features are disabled by default. The following optional crate features can be enabled to provide additional functionality:
convert
enables theconvert
module which provides functions for converting between cashaddr addresses and legacy Bitcoin addresses.
Limitations
Does not support Forward Error Correction. The BCH Codes used in the cashaddr codec technically allow for forward error correction, but using FEC in Bitcoin Cash addresses is dangerous and strongly discouraged.
About the Codec
Cashaddr is a base32-based encoding scheme designed to encode a hash
digest and hash type, which
describes the use case for the hash, as a string. A cashaddr string consists of
2 distinct parts separated by a colon (:
) in the following order:
- An arbitrary user-defined prefix, sometimes referred to as the "human-readable prefix", the semantics of which are up to the application using cashaddr
- A binary payload which is encoded as a
base32 string using a specific
alphabet. This payload contains the following fields:
- Hash type: one of 16 values which describe the intended use-case for the
hash. see
HashType
- Hash length: one of 8 numeric values which describe the length of the hash. Used in verifying cashaddr string
- The hash itself, which is an arbitrary sequence of 20, 24, 28, 32, 40, 48, 56, or 64 bytes
- A 40-bit checksum which checks the entire cashaddr, including the user-defined prefix.
- Hash type: one of 16 values which describe the intended use-case for the
hash. see
Together with the length field, the checksum provides extremely strong assurance that a received cashaddr string was not corrupted in transmission.
Currently, the only widespread use of cashaddr is for encoding Bitcoin Cash addresses, but its design features make it an attractive choice for a general-purpose text codec for hashes.
For details, see the cashaddr spec
Attribution
Most of the codec algorithm logic was based on
bitcoincash-addr
.
This crate seeks to improve on bitcoincash-addr
by providing a more
generalized and ergonomic user interface, adding support for arbitrary
prefixes, and reducing scope to only matters directly related the cashaddr
codec itself (base58check codec removed from scope).
Dependencies
~91KB