12 releases (6 stable)
2.0.0-alpha.2 | Nov 25, 2022 |
---|---|
1.7.6 | Dec 6, 2021 |
1.7.4 | Aug 31, 2021 |
0.9.0 | Mar 11, 2023 |
0.8.0 | Jun 30, 2022 |
#2 in #internet2
570 downloads per month
Used in 43 crates
(2 directly)
44KB
985 lines
Strict encoding library
Deterministic binary serialization for client-side-validation.
This library implements strict encoding standard, defined by LNPBP-7. Strict encoding is a binary conservative encoding extensively used in client-side-validation for deterministic portable (platform-independent) serialization of data with a known internal data structure. Strict encoding is a schema-less encoding.
As a part of strict encoding, crate also includes implementation of network address uniform encoding standard (LNPBP-42), which allows representation of any kind of network address as a fixed-size byte string occupying 37 bytes. This standard is used for the strict encoding of networking addresses.
Client-side-validation is a paradigm for distributed computing, based on top of proof-of-publication/commitment medium layer, which may be a bitcoin blockchain or other type of distributed consensus system.
The development of the library is supported by LNP/BP Standards Association.
The library is designed after Peter Todd concepts of proofmarshall and serialization principles for client-side-validated data and Dr Maxim Orlovsky idea of universal network encodings. Both were shaped into the standards and implemented as a part of this library by Dr Maxim Orlovsky.
Documentation
Detailed developer & API documentation for the library can be accessed at https://docs.rs/strict_encoding/
To learn about the technologies enabled by the library please check slides from our tech presentations and LNP/BP tech talks videos
Usage
To use the library, you just need to reference a latest version, in
[dependencies]
section of your project Cargo.toml
.
strict_encoding = "1.3"
If you are using other client-side-validation libraries, consider importing
just a single client_side_validation
library which re-exports all of them,
including the current one.
Library defines two main traits, StrictEncode
and StrictDecode
,
which should be implemented on each type that requires to be represented
for client-side-validation.
Library exports derivation macros #[derive(StrictEncode, StrictDecode)]
,
which are a part of strict_encoding_derive
sub-crate and controlled by a
default feature derive
. Finally, it implements strict encoding traits for main
data types defined by rust standard library and frequently used crates; the
latter increases the number of dependencies and thus can be controlled with
feature flags:
chrono
(used by default): date & time types fromchrono
crateminiscript
: types defined in bitcoin Miniscriptcrypto
: non-bitcoin cryptographic primitives, which include Ed25519 curve, X25519 signatures fromed25519-dalek
library and pedersen commitments + bulletproofs fromgrin_secp256k1zkp
library. Encodings for other cryptography-related types, such as Secp256k1 and hashes, are always included as a part of the library - see NB below.
This crate requires bitcoin
as an upstream dependency since many of
strict-encoded formats are standardized as using bitcoin consensus
encoding.
Contributing
Contribution guidelines can be found in CONTRIBUTING
Licensing
The libraries are distributed on the terms of Apache 2.0 opensource license. See LICENCE file for the license details.
Dependencies
~2MB
~45K SLoC