Struct NodeBuilder 

pub struct NodeBuilder {

    rng_seed: [u8; 32],
    custom_initial_time: Option<Timestamp>,
    genesis_config: Arc<GenesisConfig>,
    p2p: P2pConfig,
    p2p_sec_key: Option<SecretKey>,
    p2p_is_seed: bool,
    p2p_is_started: bool,
    block_producer: Option<BlockProducerConfig>,
    archive: Option<ArchiveConfig>,
    snarker: Option<SnarkerConfig>,
    service: NodeServiceBuilder,
    verifier_srs: Option<Arc<VerifierSRS>>,
    block_verifier_index: Option<BlockVerifier>,
    work_verifier_index: Option<TransactionVerifier>,
    http_port: Option<u16>,
    daemon_conf: Daemon,
    chain_id_override: Option<ChainId>,
    skip_proof_verification: bool,
}

Builder for constructing a native Mina node with fluent API.

Fields

rng_seed: [u8; 32]

Seed for RNG, used in Node::new() for replay. If None in constructor, a random seed is generated.

custom_initial_time: Option<Timestamp>

If Some, overrides system time (for testing). If None, uses real time.

genesis_config: Arc<GenesisConfig>

Genesis block configuration.

p2p: P2pConfig

P2P networking configuration.

p2p_sec_key: Option<SecretKey>

If Some, uses provided key. If None, P2pSecretKey::rand() in build().

p2p_is_seed: bool

If true, node acts as seed (no initial peers needed).

p2p_is_started: bool

If true, P2P service already spawned via custom task spawner.

block_producer: Option<BlockProducerConfig>

If Some, enables block production. If None, node is non-producing.

archive: Option<ArchiveConfig>

If Some, enables archive mode. If None, no archiving.

snarker: Option<SnarkerConfig>

If Some, enables SNARK worker. If None, no SNARK work.

service: NodeServiceBuilder

Service builder for I/O components.

verifier_srs: Option<Arc<VerifierSRS>>

If Some, uses provided SRS. If None, get_srs() in build().

block_verifier_index: Option<BlockVerifier>

If Some, uses provided index. If None, BlockVerifier::make() in build().

work_verifier_index: Option<TransactionVerifier>

If Some, uses provided. If None, TransactionVerifier::make() in build().

http_port: Option<u16>

If Some, starts HTTP RPC server on port. If None, no RPC server.

daemon_conf: Daemon

Daemon JSON configuration.

chain_id_override: Option<ChainId>

If Some, overrides computed chain ID (for interop testing).

skip_proof_verification: bool

If true, skips SNARK proof verification (for interop testing).

Implementations

impl NodeBuilder

pub fn new( custom_rng_seed: Option<[u8; 32]>, daemon_conf: Daemon, genesis_config: Arc<GenesisConfig>, ) -> Self

pub fn chain_id_override(&mut self, chain_id: ChainId) -> &mut Self

Override chain ID for P2P networking (interop testing).

pub fn skip_proof_verification(&mut self, skip: bool) -> &mut Self

Skip SNARK proof verification (interop testing).

pub fn custom_initial_time(&mut self, time: Timestamp) -> &mut Self

Set custom initial time. Used for testing.

pub fn p2p_sec_key(&mut self, key: P2pSecretKey) -> &mut Self

If not called, random one will be generated and used instead.

pub fn p2p_libp2p_port(&mut self, port: u16) -> &mut Self

pub fn p2p_seed_node(&mut self) -> &mut Self

Set up node as a seed node.

pub fn p2p_no_discovery(&mut self) -> &mut Self

pub fn initial_peers( &mut self, peers: impl IntoIterator<Item = P2pConnectionOutgoingInitOpts>, ) -> &mut Self

Extend p2p initial peers from an iterable.

pub fn external_addrs(&mut self, v: impl Iterator<Item = IpAddr>) -> &mut Self

pub fn initial_peers_from_file( &mut self, path: impl AsRef<Path>, ) -> Result<&mut Self>

Extend p2p initial peers from file.

pub fn initial_peers_from_url(&mut self, url: impl IntoUrl) -> Result<&mut Self>

Extend p2p initial peers by opening the url.

pub fn p2p_max_peers(&mut self, limit: usize) -> &mut Self

pub fn p2p_custom_task_spawner( &mut self, spawner: impl TaskSpawner, ) -> Result<&mut Self>

Override default p2p task spawner.

pub fn block_producer( &mut self, key: AccountSecretKey, provers: Option<BlockProver>, ) -> &mut Self

Set up block producer.

pub fn block_producer_from_file( &mut self, path: impl AsRef<Path>, password: &str, provers: Option<BlockProver>, ) -> Result<&mut Self>

Set up block producer using keys from file.

pub fn archive( &mut self, options: ArchiveStorageOptions, work_dir: String, ) -> &mut Self

pub fn custom_coinbase_receiver( &mut self, addr: NonZeroCurvePoint, ) -> Result<&mut Self>

Receive block producer’s coinbase reward to another account.

pub fn custom_block_producer_config( &mut self, config: BlockProducerConfig, ) -> Result<&mut Self>

pub fn snarker( &mut self, sec_key: AccountSecretKey, fee: u64, strategy: SnarkerStrategy, ) -> &mut Self

pub fn verifier_srs(&mut self, srs: Arc<VerifierSRS>) -> &mut Self

Set verifier srs. If not set, default will be used.

pub fn block_verifier_index(&mut self, index: BlockVerifier) -> &mut Self

pub fn work_verifier_index(&mut self, index: TransactionVerifier) -> &mut Self

pub fn gather_stats(&mut self) -> &mut Self

pub fn record(&mut self, recorder: Recorder) -> &mut Self

pub fn http_server(&mut self, port: u16) -> &mut Self

pub fn build(self) -> Result<Node>