#multi-hash #codec #hashing #decoding #secure #data #ipfs

no-std multihash-codetable

Default multihash code-table with cryptographically secure hash implementations

3 releases

0.1.2 Feb 23, 2024
0.1.1 Oct 30, 2023
0.1.0 Jun 6, 2023

#405 in Cryptography

Download history 19008/week @ 2023-12-14 11768/week @ 2023-12-21 8450/week @ 2023-12-28 17267/week @ 2024-01-04 18738/week @ 2024-01-11 23927/week @ 2024-01-18 22698/week @ 2024-01-25 17391/week @ 2024-02-01 24905/week @ 2024-02-08 27941/week @ 2024-02-15 28536/week @ 2024-02-22 23698/week @ 2024-02-29 21351/week @ 2024-03-07 22843/week @ 2024-03-14 28658/week @ 2024-03-21 21819/week @ 2024-03-28

99,365 downloads per month
Used in 57 crates (4 directly)

MIT license

440 lines


Build Status Crates.io License Documentation Dependency Status Coverage Status

multihash implementation in Rust.

Table of Contents


First add this to your Cargo.toml

multihash = "*"

Then run cargo build.


The minimum supported Rust version for this library is 1.64.0. This is only guaranteed without additional features activated.


The multihash crate exposes a basic data structure for encoding and decoding multihash. It does not provide any hashing functionality itself. Multihash uses const-generics to define the internal buffer size. You should set this to the maximum size of the digest you want to support.

use multihash::Multihash;

const SHA2_256: u64 = 0x12;

fn main() {
	let hash = Multihash::<64>::wrap(SHA2_256, b"my digest");
	println!("{:?}", hash);

Using a custom code table

You can derive your own application specific code table using the multihash-derive crate. The multihash-codetable provides predefined hasher implementations if you don't want to implement your own.

use multihash_derive::MultihashDigest;

#[derive(Clone, Copy, Debug, Eq, MultihashDigest, PartialEq)]
#[mh(alloc_size = 64)]
pub enum Code {
    #[mh(code = 0x01, hasher = multihash_codetable::Sha2_256)]
    #[mh(code = 0x02, hasher = multihash_codetable::Sha2_512)]

fn main() {
    let hash = Code::Foo.digest(b"my hash");
    println!("{:02x?}", hash);

Supported Hash Types

  • SHA1
  • SHA2-256
  • SHA2-512
  • SHA3/Keccak
  • Blake2b-256/Blake2b-512/Blake2s-128/Blake2s-256
  • Blake3
  • Strobe


Captain: @dignifiedquire.


Contributions welcome. Please check out the issues.

Check out our contributing document for more information on how we work, and about contributing in general. Please be aware that all interactions related to multiformats are subject to the IPFS Code of Conduct.

Small note: If editing the README, please conform to the standard-readme specification.




A batteries-included code table of multihashes.

Whilst the multihash crate itself only defines the data structure, this crate defines a codetable via multihash_derive for several hashers. Although convenient, depending on this crate will increase the dependency footprint of your project.

It is only recommended as a getting-started-quickly solution. For production, you should either define your own codetable or rely only on the multihash crate itself.


~99K SLoC