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

// Copyright 2015-2019 Parity Technologies (UK) Ltd.
// This file is part of Parity Ethereum.

// Parity Ethereum 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 Ethereum 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 Ethereum.  If not, see <http://www.gnu.org/licenses/>.

//! Request Provenance

use cfx_types::H256;
use serde::{Deserialize, Serialize};
use std::{fmt, net::SocketAddr};

/// RPC request origin
#[derive(Clone, Debug, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
#[serde(rename_all = "kebab-case")]
pub enum Origin {
    /// RPC server (includes request origin)
    Rpc(String),
    /// TCP server (includes peer address)
    Tcp(SocketAddr),
    /// WS server
    Ws {
        /// Session id
        session: H256,
    },
    /// Signer (authorized WS server)
    Signer {
        /// Session id
        session: H256,
    },
    /// From the C API
    CApi,
    /// Unknown
    Unknown,
}

impl Default for Origin {
    fn default() -> Self { Origin::Unknown }
}

impl fmt::Display for Origin {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            Origin::Rpc(ref origin) => write!(f, "{} via RPC", origin),
            Origin::Tcp(ref address) => write!(f, "TCP (address: {})", address),
            Origin::Ws { ref session } => {
                write!(f, "WebSocket (session: {})", session)
            }
            Origin::Signer { ref session } => {
                write!(f, "Secure Session (session: {})", session)
            }
            Origin::CApi => write!(f, "C API"),
            Origin::Unknown => write!(f, "unknown origin"),
        }
    }
}