Struct Geth 

pub struct Geth { /* private fields */ }

Available on crate feature node-bindings only.

Builder for launching geth.

Panics

If spawn is called without geth being available in the user’s $PATH

Example

use alloy_node_bindings::Geth;

let port = 8545u16;
let url = format!("http://localhost:{}", port).to_string();

let geth = Geth::new().port(port).block_time(5000u64).spawn();

drop(geth); // this will kill the instance

Implementations

impl Geth

pub fn new() -> Geth

Creates an empty Geth builder.

pub fn at(path: impl Into<PathBuf>) -> Geth

Creates a Geth builder which will execute geth at the given path.

Example

use alloy_node_bindings::Geth;
let geth = Geth::at("../go-ethereum/build/bin/geth").spawn();

println!("Geth running at `{}`", geth.endpoint());

pub fn path<T>(self, path: T) -> Geth

where T: Into<PathBuf>,

Sets the path to the geth executable

By default, it’s expected that geth is in $PATH, see also std::process::Command::new()

pub fn dev(self) -> Geth

Puts the geth instance in dev mode.

pub const fn is_clique(&self) -> bool

Returns whether the node is launched in Clique consensus mode.

pub fn clique_address(&self) -> Option<Address>

Calculates the address of the Clique consensus address.

pub fn set_clique_private_key<T>(self, private_key: T) -> Geth

where T: Into<SigningKey<Secp256k1>>,

👎Deprecated: clique support was removed in geth >=1.14

Sets the Clique Private Key to the geth executable, which will be later loaded on the node.

The address derived from this private key will be used to set the miner.etherbase field on the node.

pub fn port<T>(self, port: T) -> Geth

where T: Into<u16>,

Sets the port which will be used when the geth-cli instance is launched.

If port is 0 then the OS will choose a random port. GethInstance::port will return the port that was chosen.

pub fn host<T>(self, host: T) -> Geth

where T: Into<String>,

Sets the host which will be used when the geth instance is launched.

Defaults to localhost.

pub fn p2p_port(self, port: u16) -> Geth

Sets the port which will be used for incoming p2p connections.

This will put the geth instance into non-dev mode, discarding any previously set dev-mode options.

pub const fn block_time(self, block_time: u64) -> Geth

Sets the block-time which will be used when the geth-cli instance is launched.

This will put the geth instance in dev mode, discarding any previously set options that cannot be used in dev mode.

pub const fn chain_id(self, chain_id: u64) -> Geth

Sets the chain id for the geth instance.

pub const fn insecure_unlock(self) -> Geth

Allow geth to unlock accounts when rpc apis are open.

pub const fn enable_ipc(self) -> Geth

Enable IPC for the geth instance.

pub fn disable_discovery(self) -> Geth

Disable discovery for the geth instance.

This will put the geth instance into non-dev mode, discarding any previously set dev-mode options.

pub fn ipc_path<T>(self, path: T) -> Geth

where T: Into<PathBuf>,

Sets the IPC path for the socket.

pub fn data_dir<T>(self, path: T) -> Geth

where T: Into<PathBuf>,

Sets the data directory for geth.

pub fn genesis(self, genesis: Genesis) -> Geth

Sets the genesis.json for the geth instance.

If this is set, geth will be initialized with geth init and the --datadir option will be set to the same value as data_dir.

This is destructive and will overwrite any existing data in the data directory.

pub const fn authrpc_port(self, port: u16) -> Geth

Sets the port for authenticated RPC connections.

pub const fn keep_stderr(self) -> Geth

Keep the handle to geth’s stderr in order to read from it.

Caution: if the stderr handle isn’t used, this can end up blocking.

pub fn push_arg<T>(&mut self, arg: T)

where T: Into<OsString>,

Adds an argument to pass to the geth.

pub fn extend_args<I, S>(&mut self, args: I)

where I: IntoIterator<Item = S>, S: Into<OsString>,

Adds multiple arguments to pass to the geth.

pub fn arg<T>(self, arg: T) -> Geth

where T: Into<OsString>,

Adds an argument to pass to geth.

Pass any arg that is not supported by the builder.

pub fn args<I, S>(self, args: I) -> Geth

where I: IntoIterator<Item = S>, S: Into<OsString>,

Adds multiple arguments to pass to geth.

Pass any args that is not supported by the builder.

pub fn spawn(self) -> GethInstance

Consumes the builder and spawns geth.

Panics

If spawning the instance fails at any point.

pub fn try_spawn(self) -> Result<GethInstance, NodeError>

Consumes the builder and spawns geth. If spawning fails, returns an error.

Trait Implementations

impl Clone for Geth

fn clone(&self) -> Geth

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Geth

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Geth

fn default() -> Geth

Returns the “default value” for a type.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1152 bytes