reweb3 0.2.4

Client-side protocol(Web3) for ethereum and other EVM-based chains rewritten in rust
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

#![cfg_attr(docsrs, feature(doc_cfg))]

#[cfg(feature = "abi")]
#[cfg_attr(docsrs, doc(cfg(feature = "abi")))]
pub mod abi;

pub mod eip;

pub mod errors;

pub mod primitives;

#[cfg(feature = "signer")]
#[cfg_attr(docsrs, doc(cfg(feature = "signer")))]
pub mod signer;

#[cfg(feature = "wallet")]
#[cfg_attr(docsrs, doc(cfg(feature = "wallet")))]
pub mod wallet;

#[cfg(feature = "clients")]
#[cfg_attr(docsrs, doc(cfg(feature = "clients")))]
pub mod clients;

#[cfg(feature = "rlp")]
#[cfg_attr(docsrs, doc(cfg(feature = "rlp")))]
pub mod rlp;

#[cfg(feature = "hardhat")]
#[cfg_attr(docsrs, doc(cfg(feature = "hardhat")))]
pub mod hardhat;

#[cfg(feature = "macros")]
#[doc(hidden)]
pub mod macros;

/// Reexport runtimes types.
pub mod prelude {
    pub use super::primitives::{balance::TransferOptions, *};

    #[cfg(feature = "abi")]
    pub use super::abi::{from_abi, to_abi};

    #[cfg(feature = "signer")]
    pub use super::signer::SignerWithProvider;

    #[cfg(feature = "clients")]
    pub use super::clients::*;

    pub use super::errors::*;
}

#[cfg(feature = "bind")]
#[cfg_attr(docsrs, doc(cfg(feature = "bind")))]
pub mod bind {
    use std::{fs, path::Path};

    use ethbind::{
        binder::BinderContext,
        mapping::BinderTypeMapping,
        rustgen::write_file,
        typedef::{AbiField, HardhatArtifact},
    };
    use heck::ToSnekCase;
    use quote::{format_ident, quote};

    pub fn bind_hardhat_artifacts<'a, A: IntoIterator<Item = &'a str>, T: AsRef<Path>>(
        artifacts: A,
        output_dir: T,
    ) -> std::io::Result<()> {
        let mut mods = vec![];

        for artifact in artifacts {
            let contract_name = format_ident!(
                "{}",
                bind_hardhat_artifact(artifact, output_dir.as_ref())?.to_snek_case()
            );

            mods.push(quote! {
                pub mod #contract_name;
            });
        }

        fs::write(
            output_dir.as_ref().join("mod.rs"),
            quote! {
                #(#mods)*
            }
            .to_string(),
        )
    }

    /// Create contract mod from hardhat artifact file.
    pub fn bind_hardhat_artifact<T: AsRef<Path>>(
        artifact: &str,
        output_dir: T,
    ) -> std::io::Result<String> {
        let hardhat: HardhatArtifact = serde_json::from_str(artifact).unwrap();

        let cx = BinderContext::new(
            &hardhat.contract_name,
            &hardhat.abi,
            Some(&hardhat.bytecode),
        );

        let mapping: BinderTypeMapping =
            serde_json::from_str(include_str!("../../macros/src/mapping.json")).unwrap();

        if !output_dir.as_ref().exists() {
            fs::create_dir_all(output_dir.as_ref())?;
        }

        let target = output_dir
            .as_ref()
            .join(hardhat.contract_name.to_snek_case() + ".rs");

        write_file(cx, mapping, target)?;

        Ok(hardhat.contract_name)
    }

    /// Create contract mod from solidity abi file.
    pub fn bind_contract<H: AsRef<Path>, M: AsRef<Path>, T: AsRef<Path>>(
        contract_name: &str,
        artifact_path: H,
        output_dir: T,
    ) -> std::io::Result<()> {
        let abi: Vec<AbiField> =
            serde_json::from_slice(fs::read(artifact_path.as_ref())?.as_slice()).unwrap();

        let cx = BinderContext::new(&contract_name, &abi, None);

        let mapping: BinderTypeMapping =
            serde_json::from_str(include_str!("../../macros/src/mapping.json")).unwrap();

        if !output_dir.as_ref().exists() {
            fs::create_dir_all(output_dir.as_ref())?;
        }

        let target = output_dir
            .as_ref()
            .join(contract_name.to_snek_case() + ".rs");

        write_file(cx, mapping, target)
    }
}