ChainstateManagerOptions

Builder for constructing a ChainstateManager — configures data paths, worker-thread count, reindex behavior, and in-memory-database flags.

final class ChainstateManagerOptions

Mentioned In

Getting Started with BitcoinKernel

Overview

Instantiate with a context and a data directory, tune with the setters, then pass to init(options:). On Apple platforms, place the data directory inside Application Support with isExcludedFromBackup = true — chainstate is reproducible from the network and doesn’t belong in iCloud backups.

Wraps the opaque btck_ChainstateManagerOptions type; deinit calls btck_chainstate_manager_options_destroy when the last Swift reference drops.

Topics

Initializers

init(context: Context, dataDirectory: String, blocksDirectory: String?) throws
Creates chainstate manager options.

Instance Methods

func setBlockTreeDBInMemory(Bool)
Keeps the block-index database in RAM instead of on disk.
func setChainstateDBInMemory(Bool)
Keeps the chainstate (UTXO) database in RAM instead of on disk.
func setWipeDBs(blockTreeDB: Bool, chainstateDB: Bool) -> Bool
Configures database wiping for reindex operations.
func setWorkerThreads(Int32)
Sets the number of worker threads for parallel script verification.