Spaces on Bitcoin
  • Spaces on Bitcoin
  • Getting Started
    • Quick start
    • Fabric DHT
    • Auctions
    • Name resolution
    • Subspaces
    • Explorer
  • Deep dive
    • Spec
    • Paper
  • Spaces Daemon
    • Configuration
    • Server API
    • Wallet API
Powered by GitBook
On this page
  • Install Bitcoin Core
  • Install Spaces
  • Run Spaces
  • Create a wallet
  • Auction process
  • Opening an auction
  • Placing a bid
  • Check status of your Spaces
  • Claiming a space
  • Publish records

Was this helpful?

Edit on GitHub
  1. Getting Started

Quick start

Setup spaces on mainnet

PreviousSpaces on BitcoinNextFabric DHT

Last updated 2 months ago

Was this helpful?

Install Bitcoin Core

  1. Install Bitcoin Core from .

  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

Opening an auction

space-cli open bitcoin

Placing a bid

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

Publish records

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 .

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

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

You may also watch the status of auctions on the

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

bitcoin.org/en/download
learn more
explorer
currently in auction
explorer
Fabric DHT
Page cover image