Quick start

Setup spaces on mainnet

Install Bitcoin Core

1. Install Bitcoin Core from bitcoin.org/en/download.

2. Edit bitcoin.conf in ~/Library/Application Support/Bitcoin/ (macOS) or ~/.bitcoin/ (Linux).

3. Add these lines to bitcoin.confto configure RPC auth:

rpcuser=<your-username>
rpcpassword=<your-password>

Install Spaces

spaced is a tiny layer that connects to Bitcoin Core over RPC and scans transactions relevant to the protocol.

1. Install the latest version:

curl --proto '=https' --tlsv1.2 -sSf https://install.spacesprotocol.org | sh

1. Verify installation

spaced --version
space-cli --version

Run Spaces

1. Ensure Bitcoin Core is fully synced

2. Start Spaces daemon

spaced --bitcoin-rpc-user <your-rpc-user> --bitcoin-rpc-password <your-rpc-password>

Create a wallet

Create the default wallet and get an address to receive coins

space-cli createwallet
space-cli getnewaddress

Send some BTC to the address you get and check your balance

space-cli balance

Auction process

In short, top level spaces are community identifiers limited to ~3600 spaces a year. Every day, the top 10 highest-bid spaces advance from pre-auctions to auctions learn more.

Opening an auction

You can check the explorer for currently open auctions . For example to open an auction for the space @bitcion

space-cli open bitcoin

Placing a bid

Find one of the spaces currently in auction and place a bid (amount is in sats)

space-cli bid nostr 1500

Check status of your Spaces

space-cli listspaces

This will list all spaces you own and spaces currently in auction.

Claiming a space

If you're currently winning and the space entered the claim period, you can register it!

space-cli register bitcoin

You may also watch the status of auctions on the explorer

Publish records

Once you register a space, you can publish records over the Fabric DHT without adding any on-chain bloat!