oxen-io
/
oxen-core
mirror of https://github.com/oxen-io/oxen-core.git
2
1
Fork 0
Code Issues Projects Releases Wiki Activity
oxen-core/src/blockchain_utilities
History
Jason Rhinelander 186db9ab07
Fix compiler warning about sign mismatch 		2023-04-28 16:20:17 -03:00
..
CMakeLists.txt Add garbage to make it work on a garbage OS 2022-10-17 13:45:24 -03:00
README.md executable names changed 2021-01-04 14:19:42 +11:00
blockchain_ancestry.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_blackball.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_depth.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_export.cpp Manual reformatting and post-formatting fixes 2023-04-13 17:15:12 -03:00
blockchain_import.cpp Fix compiler warning about sign mismatch 2023-04-28 16:20:17 -03:00
blockchain_objects.h run clang format 2023-04-13 17:15:12 -03:00
blockchain_prune.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_prune_known_spent_data.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_stats.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_usage.cpp run clang format 2023-04-13 17:15:12 -03:00
blockchain_utilities.h Manual reformatting and post-formatting fixes 2023-04-13 17:15:12 -03:00
blocksdat_file.cpp Manual reformatting and post-formatting fixes 2023-04-13 17:15:12 -03:00
blocksdat_file.h run clang format 2023-04-13 17:15:12 -03:00
bootstrap_file.cpp Manual reformatting and post-formatting fixes 2023-04-13 17:15:12 -03:00
bootstrap_file.h run clang format 2023-04-13 17:15:12 -03:00
bootstrap_serialization.h run clang format 2023-04-13 17:15:12 -03:00
sn_key_tool.cpp run clang format 2023-04-13 17:15:12 -03:00

README.md

Oxen Blockchain Utilities

Copyright (c) 2014-2019, The Monero Project Copyright (c) 2018, The Loki Project

Introduction

The blockchain utilities allow one to import and export the blockchain.

Usage:

See also each utility's "--help" option.

Export an existing blockchain database

$ oxen-blockchain-export

This loads the existing blockchain and exports it to $OXEN_DATA_DIR/export/blockchain.raw

Import the exported file

$ oxen-blockchain-import

This imports blocks from $OXEN_DATA_DIR/export/blockchain.raw (exported using the oxen-blockchain-export tool as described above) into the current database.

Defaults: --batch on, --batch size 20000, --verify on

Batch size refers to number of blocks and can be adjusted for performance based on available RAM.

Verification should only be turned off if importing from a trusted blockchain.

If you encounter an error like "resizing not supported in batch mode", you can just re-run the oxen-blockchain-import command again, and it will restart from where it left off.

## use default settings to import blockchain.raw into database
$ oxen-blockchain-import

## fast import with large batch size, database mode "fastest", verification off
$ oxen-blockchain-import --batch-size 20000 --database lmdb#fastest --verify off

Import options

--input-file specifies input file path for importing

default: <data-dir>/export/blockchain.raw

--output-file specifies output file path to export to

default: <data-dir>/export/blockchain.raw

--block-stop stop at block number

--database <database type>

--database <database type>#<flag(s)>

database type: lmdb, memory

flags:

The flag after the # is interpreted as a composite mode/flag if there's only one (no comma separated arguments).

The composite mode represents multiple DB flags and support different database types:

safe, fast, fastest

Database-specific flags can be set instead.

LMDB flags (more than one may be specified):

nosync, nometasync, writemap, mapasync, nordahead

Examples:

$ oxen-blockchain-import --database lmdb#fastest

$ oxen-blockchain-import --database lmdb#nosync

$ oxen-blockchain-import --database lmdb#nosync,nometasync