// Copyright 2015, 2016 Parity Technologies (UK) Ltd. // This file is part of Parity. // Parity is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Parity is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Parity. If not, see . //! Hash-addressed content resolver & fetcher. use std::{io, fs}; use std::io::Write; use std::sync::Arc; use std::path::PathBuf; use fetch::{Fetch, Response, Error as FetchError, Client as FetchClient}; use futures::Future; use parity_reactor::Remote; use urlhint::{ContractClient, URLHintContract, URLHint, URLHintResult}; use util::{H256, sha3}; /// API for fetching by hash. pub trait HashFetch: Send + Sync + 'static { /// Fetch hash-addressed content. /// Parameters: /// 1. `hash` - content hash /// 2. `on_done` - callback function invoked when the content is ready (or there was error during fetch) /// /// This function may fail immediately when fetch cannot be initialized or content cannot be resolved. fn fetch(&self, hash: H256, on_done: Box) + Send>); } /// Hash-fetching error. #[derive(Debug)] pub enum Error { /// Hash could not be resolved to a valid content address. NoResolution, /// Downloaded content hash does not match. HashMismatch { /// Expected hash expected: H256, /// Computed hash got: H256, }, /// IO Error while validating hash. IO(io::Error), /// Error during fetch. Fetch(FetchError), } impl From for Error { fn from(error: FetchError) -> Self { Error::Fetch(error) } } impl From for Error { fn from(error: io::Error) -> Self { Error::IO(error) } } /// Default Hash-fetching client using on-chain contract to resolve hashes to URLs. pub struct Client { contract: URLHintContract, fetch: F, remote: Remote, } impl Client { /// Creates new instance of the `Client` given on-chain contract client and task runner. pub fn new(contract: Arc, remote: Remote) -> Self { Client::with_fetch(contract, FetchClient::new().unwrap(), remote) } } impl Client { /// Creates new instance of the `Client` given on-chain contract client, fetch service and task runner. pub fn with_fetch(contract: Arc, fetch: F, remote: Remote) -> Self { Client { contract: URLHintContract::new(contract), fetch: fetch, remote: remote, } } } impl HashFetch for Client { fn fetch(&self, hash: H256, on_done: Box) + Send>) { debug!(target: "fetch", "Fetching: {:?}", hash); let url = self.contract.resolve(hash.to_vec()).map(|content| match content { URLHintResult::Dapp(dapp) => { dapp.url() }, URLHintResult::Content(content) => { content.url }, }).ok_or_else(|| Error::NoResolution); debug!(target: "fetch", "Resolved {:?} to {:?}. Fetching...", hash, url); match url { Err(err) => on_done(Err(err)), Ok(url) => { let future = self.fetch.fetch(&url).then(move |result| { fn validate_hash(path: PathBuf, hash: H256, result: Result) -> Result { let response = result?; // Read the response let mut reader = io::BufReader::new(response); let mut writer = io::BufWriter::new(fs::File::create(&path)?); io::copy(&mut reader, &mut writer)?; writer.flush()?; // And validate the hash let mut file_reader = io::BufReader::new(fs::File::open(&path)?); let content_hash = sha3(&mut file_reader)?; if content_hash != hash { Err(Error::HashMismatch{ got: content_hash, expected: hash }) } else { Ok(path) } } debug!(target: "fetch", "Content fetched, validating hash ({:?})", hash); let path = random_temp_path(); let res = validate_hash(path.clone(), hash, result); if let Err(ref err) = res { trace!(target: "fetch", "Error: {:?}", err); // Remove temporary file in case of error let _ = fs::remove_dir_all(&path); } on_done(res); Ok(()) as Result<(), ()> }); self.remote.spawn(self.fetch.process(future)); }, } } } fn random_temp_path() -> PathBuf { use ::rand::Rng; use ::std::env; let mut rng = ::rand::OsRng::new().expect("Reliable random source is required to work."); let file: String = rng.gen_ascii_chars().take(12).collect(); let mut path = env::temp_dir(); path.push(file); path }