Spaces client

If you just want a handle, you don't need any of this - the Nacho app buys and manages handles on iOS and Android, no node and no account required.

CLI

Install Bitcoin Core

Install Bitcoin Core from bitcoin.org/en/download and let it sync.

Install Spaces

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

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

Verify installation:

spaced --version
space-cli --version

Run Spaces

Once Bitcoin Core is fully synced, start the Spaces daemon:

spaced

It will automatically read Bitcoin Core's cookie file for authentication.

Get your trust anchor

Once spaced has caught up, print the Trust ID your node computed and scan it into any app that supports Spaces:

space-cli trust

Create a wallet

space-cli createwallet
space-cli getnewaddress

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

space-cli balance

Auction process

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.

Opening an auction

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

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 certrelay network without adding any on-chain bloat!