Configuration

The Spaces daemon listens on the following ports by default:

NetworkPort
Mainnet7225
Testnet47224
Regtest7218

Options

All arguments can be specified as environment variables with SPACED_ prefix and UPPER_SNAKE_CASE.

OptionDescriptionDefault
--chainNetwork to use: mainnet, testnet4, regtestmainnet
--data-dirCustom data directory to store spaced statePlatform default
--bitcoin-rpc-urlBitcoin RPC URLBased on --chain e.g. http://127.0.0.1:8332 for mainnet
--bitcoin-rpc-cookieBitcoin RPC cookie file pathNone
--bitcoin-rpc-userBitcoin RPC userNone
--bitcoin-rpc-passwordBitcoin RPC passwordNone
--bitcoin-rpc-lightBitcoin RPC is a light clientfalse
--rpc-bindBind address for JSON-RPC connections127.0.0.1, ::1
--rpc-portPort for JSON-RPC connectionsBased on --chain
--rpc-userSpaced RPC username (requires --rpc-password)None
--rpc-passwordSpaced RPC passwordNone
--block-indexEnable block indexingfalse
--block-index-fullIndex full transaction datafalse
--jobsNumber of concurrent workers during sync8
--num-anchorsNumber of root anchors to calculate600
--skip-anchorsSkip maintaining historical root anchorsfalse
--configPath to a configuration fileNone

Default Bitcoin RPC URLs

NetworkURL
Mainnethttp://127.0.0.1:8332
Testnet4http://127.0.0.1:48332
Regtesthttp://127.0.0.1:18443

Authentication

The daemon supports cookie-based and username/password authentication for both Bitcoin Core RPC and its own RPC interface.

Bitcoin Core auth - use either --bitcoin-rpc-cookie or the --bitcoin-rpc-user / --bitcoin-rpc-password pair.

Spaced RPC auth - use --rpc-user / --rpc-password to require authentication for clients connecting to the spaced client. When set, a cookie file is written to {data-dir}/.cookie.

Data Directory

By default, data is stored in the platform-specific application data directory:

  • macOS: ~/Library/Application Support/spaced/{chain}/
  • Linux: ~/.local/share/spaced/{chain}/