dart_multihash 0.1.0

A dart-lang implementation of the Multihash protocol.

dart_multihash

This is an implementation of the Multihash standard in Dart. This package provides an extensible representation of cryptographic hashes.

Install

To install dart_multihash, simply run the following command, depending on the preferred platform.

flutter pub add dart_multihash
dart pub add dart_multihash

Usage

This package simply encodes and decodes hashes with the Multihash standard. This is a low-level library. So bring your own digest. To create hashes, you will most likely need to use a package like crypto to hash a given input.

Here's the standard use of dart_multihash, using the encode() and decode() functions.

import 'package:crypto/crypto.dart';

// String we want to hash and encode with Multihash.
String input = "Hello World";

// Converting the input string to an array of bytes
List<int> bytes = utf8.encode(input);

// Hashing the string using the SHA-256 algorithm using the `crypto` package
Digest digest = sha256.convert(bytes);
Uint8List inputByteArray = Uint8List.fromList(digest.bytes);

// Encoding the hash digest with the Multihash standard.
Uint8List encoded_with_multihash_array = encode('sha2-256', inputByteArray);

// If we want to decode a Multihash-encoded hash, simply use `decode`.
MultihashInfo decodedObj = decode(encodedObj);

If we were to inspect the decodedObj, we would get access to the following info.

{
    "code": 0x12, 
    "length": 32,
    "digest": [165, 145, 166, 212, 11, 244, 32, 64, 74, 1, 23, 51, 207, 183, 177, 144, 214, 44, 101, 191, 11, 205, 163, 43, 87, 178, 119, 217, 173, 159, 20, 110],
    "name": "sha2-256",
}

This is the info that follows the Multihash format standard.

Supported Algorithms

The list of canonical algorithms can be found on the multiformat's multicodec repo. This package tries to support as many hash functions as possible. If you want to check how many are currently supported, do check the lib/src/constants.dart file for a list of these.

Contribute

If you have any questions or have suggestions on how to improve this package, don't hesitate and open an issue.

Recommended reading

If you are wanting to know more about Multihashing why it is needed and how the format works, check the official guidelines https://multiformats.io/multihash/

If you are looking for a visual example of how Multihash formatting works, check the following https://github.com/multiformats/multihash#visual-examples

License

The library is available under the terms of the MIT License.