Skip to content

saurfang/ipfs-multihash-on-solidity

Repository files navigation

Build Status

IPFS hash (multihash) with Solidity and web3.js

Example of using Solidity and web3.js to store and retrieve IPFS hash and more generally multihash.

IPFS hash is often represented using 46 character long Base58 encoding(e.g. QmahqCsAUAw7zMv6P6Ae8PjCTck7taQA6FgGQLnWdKG7U8). It might be attempting to store IPFS hash using bytes or string which are dynamically sized byte array since it cannot fit in the largest fixed-size byte arrays bytes32.

However this can be both expensive and challenging to use IPFS hashes in arrays. Luckily as one might notice that IPFS hashes commonly start with Qm, they in fact follow the multihash self describing hash format:

 <varint hash function code><varint digest size in bytes><hash function output>

This makes it possible to break down IPFS hash into a struct like so:

  struct Multihash {
    bytes32 digest;
    uint8 hashFunction;
    uint8 size;
  }

This repository gives an end-to-end example on how to store IPFS hash in Solidity as well as how to call the smart contract using web3.js to get and set IPFS hash.

IPFSStorage.sol is a smart contract that stores IPFS hash in a mapping from address key to Multihash struct. Because web3.js ABI doesn't support passing tuple as parameter and return type, additional care is taken to normalize the function interface to be web3.js friendly.

multihash.js contains the Javascript code that converts base58 encoded multihash string to and from smart contract friendly arguments and responses.

Refer to test cases for additional example code how to interact with the contract.

Reference

Multihash Format: https://github.com/multiformats/multihash

zeppelin-solidity for project setup and test helpers.

Previous discussions and examples:

How to store IPFS hash using bytes?

A practical guide to cheap IPFS hash storage in an Ethereum smart contract

OriginProtocol Demo Code

About

Example on Solidity and web3.js to store IPFS hash

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published