safe_nd/
utils.rs

1// Copyright 2019 MaidSafe.net limited.
2//
3// This SAFE Network Software is licensed to you under the MIT license <LICENSE-MIT
4// https://opensource.org/licenses/MIT> or the Modified BSD license <LICENSE-BSD
5// https://opensource.org/licenses/BSD-3-Clause>, at your option. This file may not be copied,
6// modified, or distributed except according to those terms. Please review the Licences for the
7// specific language governing permissions and limitations relating to use of the SAFE Network
8// Software.
9
10use crate::{Error, Message, MessageId, PublicKey, Result, Signature};
11use multibase::{self, Base};
12use serde::{de::DeserializeOwned, Serialize};
13use unwrap::unwrap;
14
15/// Verify that a signature is valid for a given `Request` + `MessageId` combination.
16pub fn verify_signature(
17    signature: &Signature,
18    public_key: &PublicKey,
19    request: &Message,
20    message_id: &MessageId,
21) -> Result<()> {
22    let message = serialise(&(request, *message_id));
23    public_key.verify(signature, message)
24}
25
26/// Wrapper for raw bincode::serialize.
27pub(crate) fn serialise<T: Serialize>(data: &T) -> Vec<u8> {
28    unwrap!(bincode::serialize(data))
29}
30
31/// Wrapper for z-Base-32 multibase::encode.
32pub(crate) fn encode<T: Serialize>(data: &T) -> String {
33    let serialised = serialise(&data);
34    multibase::encode(Base::Base32Z, &serialised)
35}
36
37/// Wrapper for z-Base-32 multibase::decode.
38pub(crate) fn decode<I: AsRef<str>, O: DeserializeOwned>(encoded: I) -> Result<O> {
39    let (base, decoded) =
40        multibase::decode(encoded).map_err(|e| Error::FailedToParse(e.to_string()))?;
41    if base != Base::Base32Z {
42        return Err(Error::FailedToParse(format!(
43            "Expected z-base-32 encoding, but got {:?}",
44            base
45        )));
46    }
47    Ok(bincode::deserialize(&decoded).map_err(|e| Error::FailedToParse(e.to_string()))?)
48}