// Copyright 2015-2017 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 . //! Parity RPC. #![warn(missing_docs)] #![cfg_attr(feature="dev", feature(plugin))] #![cfg_attr(feature="dev", plugin(clippy))] extern crate ansi_term; extern crate cid; extern crate crypto as rust_crypto; extern crate futures_cpupool; extern crate itertools; extern crate multihash; extern crate order_stat; extern crate parking_lot; extern crate rand; extern crate rustc_hex; extern crate semver; extern crate serde; extern crate serde_json; extern crate time; extern crate tokio_timer; extern crate transient_hashmap; extern crate jsonrpc_core; extern crate jsonrpc_http_server as http; extern crate jsonrpc_ipc_server as ipc; extern crate jsonrpc_pubsub; extern crate ethash; extern crate ethcore; extern crate ethcore_bigint as bigint; extern crate ethcore_bytes as bytes; extern crate ethcore_devtools as devtools; extern crate ethcore_io as io; extern crate ethcore_ipc; extern crate ethcore_light as light; extern crate ethcore_util as util; extern crate ethcrypto as crypto; extern crate ethkey; extern crate ethstore; extern crate ethsync; extern crate ethcore_logger; extern crate vm; extern crate fetch; extern crate node_health; extern crate parity_reactor; extern crate parity_updater as updater; extern crate rlp; extern crate stats; extern crate hash; extern crate hardware_wallet; #[macro_use] extern crate log; #[macro_use] extern crate jsonrpc_macros; #[macro_use] extern crate serde_derive; #[cfg(test)] extern crate ethjson; #[cfg(test)] #[macro_use] extern crate pretty_assertions; #[cfg(test)] #[macro_use] extern crate macros; #[cfg(test)] extern crate kvdb_memorydb; pub extern crate jsonrpc_ws_server as ws; mod authcodes; mod http_common; pub mod v1; pub mod tests; pub use jsonrpc_pubsub::Session as PubSubSession; pub use ipc::{Server as IpcServer, MetaExtractor as IpcMetaExtractor, RequestContext as IpcRequestContext}; pub use http::{ hyper, RequestMiddleware, RequestMiddlewareAction, AccessControlAllowOrigin, Host, DomainsValidation }; pub use v1::{NetworkSettings, Metadata, Origin, informant, dispatch, signer, dapps}; pub use v1::block_import::is_major_importing; pub use v1::extractors::{RpcExtractor, WsExtractor, WsStats, WsDispatcher}; pub use authcodes::{AuthCodes, TimeProvider}; pub use http_common::HttpMetaExtractor; use std::net::SocketAddr; use http::tokio_core; /// RPC HTTP Server instance pub type HttpServer = http::Server; /// RPC HTTP Server error #[derive(Debug)] pub enum HttpServerError { /// IO error Io(::std::io::Error), /// Other hyper error Hyper(hyper::Error), } impl From for HttpServerError { fn from(e: http::Error) -> Self { use self::HttpServerError::*; match e { http::Error::Io(io) => Io(io), http::Error::Other(hyper) => Hyper(hyper), } } } /// Start http server asynchronously and returns result with `Server` handle on success or an error. pub fn start_http( addr: &SocketAddr, cors_domains: http::DomainsValidation, allowed_hosts: http::DomainsValidation, handler: H, remote: tokio_core::reactor::Remote, extractor: T, middleware: Option, threads: usize, ) -> Result where M: jsonrpc_core::Metadata, S: jsonrpc_core::Middleware, H: Into>, T: HttpMetaExtractor, R: RequestMiddleware, { let mut builder = http::ServerBuilder::new(handler) .threads(threads) .event_loop_remote(remote) .meta_extractor(http_common::MetaExtractor::new(extractor)) .cors(cors_domains.into()) .allowed_hosts(allowed_hosts.into()); if let Some(dapps) = middleware { builder = builder.request_middleware(dapps) } Ok(builder.start_http(addr)?) } /// Start ipc server asynchronously and returns result with `Server` handle on success or an error. pub fn start_ipc( addr: &str, handler: H, remote: tokio_core::reactor::Remote, extractor: T, ) -> ::std::io::Result where M: jsonrpc_core::Metadata, S: jsonrpc_core::Middleware, H: Into>, T: IpcMetaExtractor, { ipc::ServerBuilder::new(handler) .event_loop_remote(remote) .session_metadata_extractor(extractor) .start(addr) } /// Start WS server and return `Server` handle. pub fn start_ws( addr: &SocketAddr, handler: H, remote: tokio_core::reactor::Remote, allowed_origins: ws::DomainsValidation, allowed_hosts: ws::DomainsValidation, extractor: T, middleware: V, stats: U, ) -> Result where M: jsonrpc_core::Metadata, S: jsonrpc_core::Middleware, H: Into>, T: ws::MetaExtractor, U: ws::SessionStats, V: ws::RequestMiddleware, { ws::ServerBuilder::new(handler) .event_loop_remote(remote) .request_middleware(middleware) .allowed_origins(allowed_origins) .allowed_hosts(allowed_hosts) .session_meta_extractor(extractor) .session_stats(stats) .start(addr) }