subspace_networking/utils/
multihash.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
//! Defines multihash codes for Subspace DSN.

use std::error::Error;
use subspace_core_primitives::pieces::PieceIndex;

/// Type alias for libp2p Multihash. Constant 64 was copied from libp2p protocols.
pub type Multihash = libp2p::multihash::Multihash<64>;

/// Start of Subspace Network multicodec namespace
/// https://github.com/multiformats/multicodec/blob/master/table.csv
const SUBSPACE_MULTICODEC_NAMESPACE_START: u64 = 0xb39910;

/// Subspace Network multihash codes.
#[derive(Debug, Clone, PartialEq)]
#[repr(u64)]
pub enum MultihashCode {
    /// Piece index code.
    PieceIndex = SUBSPACE_MULTICODEC_NAMESPACE_START,
}

impl From<MultihashCode> for u64 {
    #[inline]
    fn from(code: MultihashCode) -> Self {
        code as u64
    }
}

impl TryFrom<u64> for MultihashCode {
    type Error = Box<dyn Error>;

    #[inline]
    fn try_from(value: u64) -> Result<Self, Self::Error> {
        match value {
            x if x == MultihashCode::PieceIndex as u64 => Ok(MultihashCode::PieceIndex),
            _ => Err("Unexpected multihash code".into()),
        }
    }
}

/// Helper trait for converting to multihash.
pub trait ToMultihash {
    /// Convert to multihash by the default multihash code.
    fn to_multihash(&self) -> Multihash;
    /// Convert to multihash by the specified multihash code.
    fn to_multihash_by_code(&self, code: MultihashCode) -> Multihash;
}

impl ToMultihash for PieceIndex {
    fn to_multihash(&self) -> Multihash {
        self.to_multihash_by_code(MultihashCode::PieceIndex)
    }

    fn to_multihash_by_code(&self, code: MultihashCode) -> Multihash {
        Multihash::wrap(u64::from(code), &self.to_bytes())
            .expect("Input never exceeds allocated size; qed")
    }
}