如何创建一个 IPFS 兼容的多重哈希

Question

我正在尝试创建一个 IPFS 兼容的 mutihash，但它不匹配。我在这里问是因为我还没有找到一个从散列到最终结果的例子。

echo -n multihash > multihash.txt


ipfs add multihash.txt
added QmZLXzjiZU39eN8QirMZ2CGXjMLiuEkQriRu7a7FeSB4fg multihash.txt


sha256sum multihash.txt
9cbc07c3f991725836a3aa2a581ca2029198aa420b9d99bc0e131d9f3e2cbe47  multihash.txt

node

> var bs58=require('bs58')
bs58.encode(new Buffer('9cbc07c3f991725836a3aa2a581ca2029198aa420b9d99bc0e131d9f3e2cbe47','hex'))
'BYptxaTgpcBrqZx9tghNCWFfUuYBcGfLydEvDjXqBV7k'

> var mh=require('multihashes')
mh.toB58String(mh.encode(new Buffer('9cbc07c3f991725836a3aa2a581ca2029198aa420b9d99bc0e131d9f3e2cbe47','hex'), 'sha2-256'))
'QmYtUc4iTCbbfVSDNKvtQqrfyezPPnFvE33wFmutw9PBBk'

目的是使用 multihashes 包重新创建 IPFS 路径 QmZLXzjiZU39eN8QirMZ2CGXjMLiuEkQriRu7a7FeSB4fg。

我能够创建相同的散列 QmYtUc...9PBBk，如示例所示：https://github.com/multiformats/multihash#example

Answer 1

IPFS 中的文件 'transformed' 到 Unixfs 文件中，这是 DAG 中文件的表示，在您的示例中，您直接使用 sha2-256 散列 multihash.txt，但是IPFS 内部发生的事情是：

文件被分成 256KiB 块
每个块进入 Unixfs protobuf 内的 DAG 节点 https://github.com/ipfs/js-ipfs-unixfs
创建了一个包含指向所有块的链接的 dag。

Answer 2

IPFS 使用 multihash 格式如下：

base58(<varint hash function code><varint digest size in bytes><hash function output>)

哈希函数代码列表可以在this table.

中找到

这是使用 SHA2-256 作为散列函数的过程的一些伪代码。

sha2-256   size  sha2-256("hello world")
0x12       0x20  0xb94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

连接这三个项目将产生

1220b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

然后将其编码为 base58

QmaozNR7DZHQK1ZcU9p7QdrshMvXqWK6gpu5rmrkPdT3L4

下面是一个如何在 JavaScript 中实现 multihash 的示例：


    const crypto = require('crypto')
    const bs58 = require('bs58')
    
    const data = 'hello world'
    
    const hashFunction = Buffer.from('12', 'hex') // 0x20
    
    const digest = crypto.createHash('sha256').update(data).digest()
    
    console.log(digest.toString('hex')) // b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
    
    const digestSize = Buffer.from(digest.byteLength.toString(16), 'hex')
    
    console.log(digestSize.toString('hex')) // 20
    
    const combined = Buffer.concat([hashFunction, digestSize, digest])
    
    console.log(combined.toString('hex')) // 1220b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
    
    const multihash = bs58.encode(combined)
    
    console.log(multihash.toString()) // QmaozNR7DZHQK1ZcU9p7QdrshMvXqWK6gpu5rmrkPdT3L4

有一个 CLI 可以用来生成多重哈希：

    $ go get github.com/multiformats/go-multihash/multihash
    $ echo -n "hello world" | multihash -a sha2-256
    QmaozNR7DZHQK1ZcU9p7QdrshMvXqWK6gpu5rmrkPdT3L4

正如@David 所说，IPFS 中的文件被“转换”为 Unixfs“文件”，这是 DAG 中文件的表示。因此，当您使用 add 将文件上传到 IPFS 时，数据具有元数据包装器，当您对它进行多重哈希处理时，它会给您不同的结果。

例如：

    $ echo -n "hello world" | ipfs add -Q
    Qmf412jQZiuVUtdgnB36FXFX7xg5V6KEbSJ4dpQuhkLyfD

Node.js 中有一个示例，说明如何生成与 ipfs add 完全相同的多重哈希：

    const Unixfs = require('ipfs-unixfs')
    const {DAGNode} = require('ipld-dag-pb')
    
    const data = Buffer.from('hello world', 'ascii')
    const unixFs = new Unixfs('file', data)
    
    DAGNode.create(unixFs.marshal(), (err, dagNode) => {
      if (err) return console.error(err)
    
      console.log(dagNode.toJSON().multihash) // Qmf412jQZiuVUtdgnB36FXFX7xg5V6KEbSJ4dpQuhkLyfD
    })

Answer 3

const { randomBytes } = require('crypto')
const multihash = require('multihashes')

const buffer = Buffer.from(randomBytes(32), 'hex')
const encoded = multihash.encode(buffer, 'sha2-256')
const hash = multihash.toB58String(encoded)
console.log(hash)

Answer 4

目前最简单的方法就是直接使用ipfs-http-client。此线程中的所有上述解决方案不再适用于我。

import ipfsClient from "ipfs-http-client";
const ipfs = ipfsClient(IPFS_PROVIDER, "5001", { protocol: "https" });

// onlyHash: true only generates the hash and doesn't upload the file
const hash = (await ipfs.add(new Buffer(vuln), { onlyHash: true }))[0].hash

Answer 5

其他一些答案已过时。这对我有用：

const { UnixFS } = require('ipfs-unixfs') // @4.0.3
const { DAGNode } = require('ipld-dag-pb') // @0.22.2

const data = Buffer.from("Hello World\n")
const file = new UnixFS({data})
const node = new DAGNode(file.marshal())

const link = await node.toDAGLink()
const cid = link.Hash
console.log(cid.toV0().toString())
// Qmf412jQZiuVUtdgnB36FXFX7xg5V6KEbSJ4dpQuhkLyfD

如何创建一个 IPFS 兼容的多重哈希

How to create an IPFS compatible multihash

ipfs