     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
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79

    // 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 <http://www.gnu.org/licenses/>.

    use std::sync::{Arc, Mutex};
    use hyper;

    use ethcore_rpc::{Metadata, Origin};
    use jsonrpc_core::reactor::RpcHandler;
    use jsonrpc_http_server::{Rpc, ServerHandler, PanicHandler, AccessControlAllowOrigin, HttpMetaExtractor};
    use endpoint::{Endpoint, EndpointPath, Handler};

    pub fn rpc(handler: RpcHandler<Metadata>, panic_handler: Arc<Mutex<Option<Box<Fn() -> () + Send>>>>) -> Box<Endpoint> {
    	Box::new(RpcEndpoint {
    		handler: handler,
    		meta_extractor: Arc::new(MetadataExtractor),
    		panic_handler: panic_handler,
    		cors_domain: None,
    		// NOTE [ToDr] We don't need to do any hosts validation here. It's already done in router.
    		allowed_hosts: None,
    	})
    }

    struct RpcEndpoint {
    	handler: RpcHandler<Metadata>,
    	meta_extractor: Arc<HttpMetaExtractor<Metadata>>,
    	panic_handler: Arc<Mutex<Option<Box<Fn() -> () + Send>>>>,
    	cors_domain: Option<Vec<AccessControlAllowOrigin>>,
    	allowed_hosts: Option<Vec<String>>,
    }

    impl Endpoint for RpcEndpoint {
    	fn to_async_handler(&self, _path: EndpointPath, control: hyper::Control) -> Box<Handler> {
    		let panic_handler = PanicHandler { handler: self.panic_handler.clone() };
    		Box::new(ServerHandler::new(
    				Rpc::new(self.handler.clone(), self.meta_extractor.clone()),
    				self.cors_domain.clone(),
    				self.allowed_hosts.clone(),
    				panic_handler,
    				control,
    		))
    	}
    }

    struct MetadataExtractor;
    impl HttpMetaExtractor<Metadata> for MetadataExtractor {
    	fn read_metadata(&self, request: &hyper::server::Request<hyper::net::HttpStream>) -> Metadata {
    		let dapp_id = request.headers().get::<hyper::header::Origin>()
    			.map(|origin| format!("{}://{}", origin.scheme, origin.host))
    			.or_else(|| {
    				// fallback to custom header, but only if origin is null
    				request.headers().get_raw("origin")
    					.and_then(|raw| raw.one())
    					.and_then(|raw| if raw == "null".as_bytes() {
    						request.headers().get_raw("x-parity-origin")
    							.and_then(|raw| raw.one())
    							.map(|raw| String::from_utf8_lossy(raw).into_owned())
    					} else {
    						None
    					})
    			});
    		Metadata {
    			dapp_id: dapp_id,
    			origin: Origin::Dapps,
    		}
    	}
    }

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)