revive-solc-json-interface 1.1.0

Rust bindings for the solc standard JSON and combined JSON interface
Documentation 
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! The `solc --combined-json` expected output selection flag.

use std::str::FromStr;

use serde::{Deserialize, Serialize};

/// The solc `--combind-json` invalid selector message.
pub const MESSAGE_SELECTOR_INVALID: &str = "Invalid option to --combined-json";

/// The `solc --combined-json` expected output selection flag.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum Selector {
    /// The ABI JSON.
    #[serde(rename = "abi")]
    ABI,
    /// The function signature hashes JSON.
    #[serde(rename = "hashes")]
    Hashes,
    /// The metadata.
    #[serde(rename = "metadata")]
    Metadata,
    /// The developer documentation.
    #[serde(rename = "devdoc")]
    Devdoc,
    /// The user documentation.
    #[serde(rename = "userdoc")]
    Userdoc,
    /// The storage layout.
    #[serde(rename = "storage-layout")]
    StorageLayout,
    /// The transient storage layout.
    #[serde(rename = "transient-storage-layout")]
    TransientStorageLayout,
    /// The AST JSON.
    #[serde(rename = "ast")]
    AST,
    /// The EVM assembly.
    #[serde(rename = "asm")]
    ASM,

    /// The assembly.
    #[serde(rename = "assembly", skip_serializing)]
    Assembly,

    /// The deploy bytecode.
    #[serde(rename = "bin", skip_serializing)]
    Bytecode,
    /// The runtime bytecode.
    #[serde(rename = "bin-runtime", skip_serializing)]
    BytecodeRuntime,
}

impl Selector {
    /// Converts the comma-separated CLI argument into an array of flags.
    pub fn from_cli(format: &str) -> Vec<anyhow::Result<Self>> {
        format
            .split(',')
            .map(|flag| Self::from_str(flag.trim()))
            .collect()
    }

    /// Whether the selector is available in `solc`.
    pub fn is_source_solc(&self) -> bool {
        !matches!(
            self,
            Self::Assembly | Self::Bytecode | Self::BytecodeRuntime
        )
    }
}

impl FromStr for Selector {
    type Err = anyhow::Error;

    fn from_str(string: &str) -> Result<Self, Self::Err> {
        match string {
            "abi" => Ok(Self::ABI),
            "hashes" => Ok(Self::Hashes),
            "metadata" => Ok(Self::Metadata),
            "devdoc" => Ok(Self::Devdoc),
            "userdoc" => Ok(Self::Userdoc),
            "storage-layout" => Ok(Self::StorageLayout),
            "transient-storage-layout" => Ok(Self::TransientStorageLayout),
            "ast" => Ok(Self::AST),
            "asm" => Ok(Self::ASM),

            "bin" => Ok(Self::Bytecode),
            "bin-runtime" => Ok(Self::BytecodeRuntime),

            "assembly" => Ok(Self::Assembly),

            selector => anyhow::bail!("{MESSAGE_SELECTOR_INVALID}: {selector}"),
        }
    }
}

impl std::fmt::Display for Selector {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        match self {
            Self::ABI => write!(f, "abi"),
            Self::Hashes => write!(f, "hashes"),
            Self::Metadata => write!(f, "metadata"),
            Self::Devdoc => write!(f, "devdoc"),
            Self::Userdoc => write!(f, "userdoc"),
            Self::StorageLayout => write!(f, "storage-layout"),
            Self::TransientStorageLayout => write!(f, "transient-storage-layout"),
            Self::AST => write!(f, "ast"),
            Self::ASM => write!(f, "asm"),

            Self::Bytecode => write!(f, "bin"),
            Self::BytecodeRuntime => write!(f, "bin-runtime"),

            Self::Assembly => write!(f, "assembly"),
        }
    }
}