Inside Bitcoin

1##
2## bitcoin.conf configuration file.
3## Generated by contrib/devtools/gen-bitcoin-conf.sh.
4##
5## Lines beginning with # are comments.
6## All possible configuration options are provided. To use, copy this file
7## to your data directory (default or specified by -datadir), uncomment
8## options you would like to change, and save the file.
9##
10
11
12### Options
13
14
15# Execute command when an alert is raised (%s in cmd is replaced by
16# message)
17#alertnotify=<cmd>
18
19# For backwards compatibility, treat an unused bitcoin.conf file in the
20# datadir as a warning, not an error.
21#allowignoredconf=1
22
23# If this block is in the chain assume that it and its ancestors are valid
24# and potentially skip their script verification (0 to verify all,
25# default:
26# 00000000000000000000748969ec33043c0e52a763c6dd5193861f559f2c72e3,
27# testnet3:
28# 00000000b318a3703d14a844c55ef507f4c2fc8f8766e24271fd43c180c51637,
29# testnet4:
30# 0000000021df65b91665a342e26ceb05e54826ad7d8fcd40316230058fa3b865,
31# signet:
32# 00000002a5e0ba0498f1e9f4591af0b66b63c654665efe65206fd0ae7bbaf923)
33#assumevalid=<hex>
34
35# Maintain an index of compact filters by block (default: 0, values:
36# basic). If <type> is not supplied or if <type> = 1, indexes for
37# all known types are enabled.
38#blockfilterindex=<type>
39
40# Execute command when the best block changes (%s in cmd is replaced by
41# block hash). Not run for blocks connected during initial block
42# download or reindexing.
43#blocknotify=<cmd>
44
45# Extra transactions to keep in memory for compact block reconstructions
46# (default: 100)
47#blockreconstructionextratxn=<n>
48
49# Specify directory to hold blocks subdirectory for *.dat files (default:
50# <datadir>)
51#blocksdir=<dir>
52
53# Whether to reject transactions from network peers. Disables automatic
54# broadcast and rebroadcast of transactions, unless the source peer
55# has the 'forcerelay' permission. RPC transactions are not
56# affected. (default: 0)
57#blocksonly=1
58
59# Whether an XOR-key applies to blocksdir *.dat files. The created XOR-key
60# will be zeros for an existing blocksdir or when `-blocksxor=0` is
61# set, and random for a freshly initialized blocksdir. (default: 1)
62#blocksxor=1
63
64# Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0)
65#coinstatsindex=1
66
67# Specify path to read-only configuration file. Relative paths will be
68# prefixed by datadir location (only useable from command line, not
69# configuration file) (default: bitcoin.conf)
70#conf=<file>
71
72# Run in the background as a daemon and accept commands (default: 0)
73#daemon=1
74
75# Wait for initialization to be finished before exiting. This implies
76# -daemon (default: 0)
77#daemonwait=1
78
79# Specify data directory
80#datadir=<dir>
81
82# Maximum database cache size <n> MiB (minimum 4, default: 1024). Make
83# sure you have enough RAM. In addition, unused memory allocated to
84# the mempool is shared with this cache (see -maxmempool).
85#dbcache=<n>
86
87# Specify location of debug log file (default: debug.log). Relative paths
88# will be prefixed by a net-specific datadir location. Pass
89# -nodebuglogfile to disable writing the log to a file.
90#debuglogfile=<file>
91
92# Specify additional configuration file, relative to the -datadir path
93# (only useable from configuration file, not command line)
94#includeconf=<file>
95
96# Imports blocks from an external file on startup. Obfuscated blocks are
97# not supported.
98#loadblock=<file>
99
100# Keep the transaction memory pool below <n> megabytes (default: 300)
101#maxmempool=<n>
102
103# Do not keep transactions in the mempool longer than <n> hours (default:
104# 336)
105#mempoolexpiry=<n>
106
107# Set the number of script verification threads (0 = auto, up to 15, <0 =
108# leave that many cores free, default: 0)
109#par=<n>
110
111# Whether to save the mempool on shutdown and load on restart (default: 1)
112#persistmempool=1
113
114# Whether a mempool.dat file created by -persistmempool or the savemempool
115# RPC will be written in the legacy format (version 1) or the
116# current format (version 2). This temporary option will be removed
117# in the future. (default: 0)
118#persistmempoolv1=1
119
120# Specify pid file. Relative paths will be prefixed by a net-specific
121# datadir location. (default: bitcoind.pid)
122#pid=<file>
123
124# Set the number of threads used to prefetch block input prevouts from the
125# chainstate database (0 disables, up to 16, default: 8). Negative
126# values are rejected.
127#prevoutfetchthreads=<n>
128
129# Reduce storage requirements by enabling pruning (deleting) of old
130# blocks. This allows the pruneblockchain RPC to be called to
131# delete specific blocks and enables automatic pruning of old
132# blocks if a target size in MiB is provided. This mode is
133# incompatible with -txindex. Warning: Reverting this setting
134# requires re-downloading the entire blockchain. Wallets and
135# indexes should be loaded at startup and kept active while pruning
136# is enabled so they stay synchronized before old block data is
137# deleted; wallets or indexes that fall behind pruned data may
138# require a reindex. (default: 0 = disable pruning blocks, 1 =
139# allow manual pruning via RPC, >=550 = automatically prune block
140# files to stay under the specified target size in MiB)
141#prune=<n>
142
143# If enabled, wipe chain state and block index, and rebuild them from
144# blk*.dat files on disk. Also wipe and rebuild other optional
145# indexes that are active. If an assumeutxo snapshot was loaded,
146# its chainstate will be wiped as well. The snapshot can then be
147# reloaded via RPC.
148#reindex=1
149
150# If enabled, wipe chain state, and rebuild it from blk*.dat files on
151# disk. If an assumeutxo snapshot was loaded, its chainstate will
152# be wiped as well. The snapshot can then be reloaded via RPC.
153#reindex-chainstate=1
154
155# Specify path to dynamic settings data file. Can be disabled with
156# -nosettings. File is written at runtime and not meant to be
157# edited by users (use bitcoin.conf instead for custom settings).
158# Relative paths will be prefixed by datadir location. (default:
159# settings.json)
160#settings=<file>
161
162# Execute command immediately before beginning shutdown. The need for
163# shutdown may be urgent, so be careful not to delay it long (if
164# the command doesn't require interaction with the server, consider
165# having it fork into the background).
166#shutdownnotify=<cmd>
167
168# Execute command on startup.
169#startupnotify=<cmd>
170
171# Maintain a full transaction index, used by the getrawtransaction rpc
172# call (default: 0)
173#txindex=1
174
175# Maintain a transaction output spender index, used by the
176# gettxspendingprevout rpc call (default: 0)
177#txospenderindex=1
178
179# Print version and exit
180#version=1
181
182
183### Connection options
184
185
186# Add a node to connect to and attempt to keep the connection open (see
187# the addnode RPC help for more info). This option can be specified
188# multiple times to add multiple nodes; connections are limited to
189# 8 at a time and are counted separately from the -maxconnections
190# limit.
191#addnode=<ip>
192
193# Specify asn mapping used for bucketing of the peers. Relative paths will
194# be prefixed by the net-specific datadir location. If a bool arg
195# is given (-asmap or -asmap=1), the embedded mapping data in the
196# binary will be used.
197#asmap=<file>
198
199# Default duration (in seconds) of manually configured bans (default:
200# 86400)
201#bantime=<n>
202
203# Bind to given address and always listen on it (default: 0.0.0.0). Use
204# [host]:port notation for IPv6. Append =onion to tag any incoming
205# connections to that address and port as incoming Tor connections
206# (default: 127.0.0.1:8334=onion, testnet3: 127.0.0.1:18334=onion,
207# testnet4: 127.0.0.1:48334=onion, signet: 127.0.0.1:38334=onion,
208# regtest: 127.0.0.1:18445=onion)
209#bind=<addr>[:<port>][=onion]
210
211# If set, then this host is configured for CJDNS (connecting to fc00::/8
212# addresses would lead us to the CJDNS network, see doc/cjdns.md)
213# (default: 0)
214#cjdnsreachable=1
215
216# Connect only to the specified node; -noconnect disables automatic
217# connections (the rules for this peer are the same as for
218# -addnode). This option can be specified multiple times to connect
219# to multiple nodes.
220#connect=<ip>
221
222# Discover own IP addresses (default: 1 when listening and no -externalip
223# or -proxy)
224#discover=1
225
226# Allow DNS lookups for -addnode, -seednode and -connect (default: 1)
227#dns=1
228
229# Query for peer addresses via DNS lookup, if low on addresses (default: 1
230# unless -connect used or -maxconnections=0)
231#dnsseed=1
232
233# Specify your own public address
234#externalip=<ip>
235
236# Allow fixed seeds if DNS seeds don't provide peers (default: 1)
237#fixedseeds=1
238
239# Always query for peer addresses via DNS lookup (default: 0)
240#forcednsseed=1
241
242# Whether to accept inbound I2P connections (default: 1). Ignored if
243# -i2psam is not set. Listening for inbound I2P connections is done
244# through the SAM proxy, not by binding to a local address and
245# port.
246#i2pacceptincoming=1
247
248# I2P SAM proxy to reach I2P peers and accept I2P connections
249#i2psam=<ip:port>
250