Crate coins_core[][src]

Expand description

coins-core is an abstract description of UTXO transactions. It provides a collection of traits that provide consistent interfaces to UTXO transaction construction. Coins’s traits ensure that types are consistent across all steps in the tx construction process, and allow for code reuse when building transactions on multiple chains (e.g. Bitcoin Mainnet and Bitcoin Testnet).

Many concepts familiar to UTXO chain developers have been genericized. Transactions are modeled as a collection of Inputs and Outputs. Rather than addresses or scripts, the Output trait has an associated RecipientIdentifier. Similarly, rather than an outpoint, the Input trait has an associated TXOIdentfier.

Support for other chains may be added by implementing these traits. We have provided an implementation suitable for Bitcoin chains (mainnet, testnet, and signet) in the bitcoins crate.


pub use prelude::*;


The builder module defines an abstract TxBuilder trait. A concrete implementation for Bitcoin can be found in the bitcoin crate

Holds generalized encoding tools. This includes an AddressEncoder and bech32 encoding and decoding functionality.

Holds utilites for working with cryptographic digests, and disambiguating digests via marker traits.

Useful macros for implementing new chains

The nets module defines an abstract Network. The Network trait is a highly-abstracted representation of the relationships between types in a UTXO network. Concrete implementations for various Bitcoin networks are found in the bitcoin crate.

Re-exports of common types.

A simple trait for binary (de)Serialization using std Read and Write traits.

Holds generic types useful describing transactions. The Transaction trait conceptualizes UTXO transactions as a list of inputs and outputs, and allows implementations to define what those are precisely.


Implement serde::Serialize and serde::Deserialize by passing through to the hex

Implement conversion between script types by passing via as_ref().into()

Instantiate a new marked digest. Wraps the output of some type that implemented digest::Digest

Wrap a prefixed vector of bytes (u8) in a newtype, and implement convenience functions for it.