본문으로 건너뛰기

Quickstart

Get a BTX node running in five minutes.

업데이트: 2026-03-30 GitHub에서 편집 Markdown으로 보기
Mine 맥락

이 참고 문서는 BTX 운영 전개의 일부입니다.

Mine 마이크로사이트로 돌아가면 이 가이드를 운영 논지, AI 인프라 관점, 채굴 시작 키트 속에서 다시 볼 수 있습니다.

현재 경로

Mine으로 돌아가기

이 가이드를 둘러싼 운영 키트와 상위 채굴 내러티브로 돌아갑니다.

Mine 열기 인접 경로

Develop도 보기

BTX에는 에이전트 앱, 챌린지 흐름, 포스트퀀텀 신원을 위한 경로도 있습니다.

Develop 열기

This page walks you from zero to a running BTX mainnet node in the fewest steps possible. See Installation for full dependency and build-option details.

1. Build

Install dependencies for your platform (see Installation), then:

git clone https://github.com/btxchain/btx.git && cd btx
cmake -B build-btx
cmake --build build-btx -j$(nproc)

On macOS, replace $(nproc) with $(sysctl -n hw.ncpu).

2. Start the Node

Launch btxd in daemon mode on mainnet:

./build-btx/bin/btxd -daemon -server

The node begins syncing the blockchain immediately. Data is stored in:

  • Linux: ~/.btx/
  • macOS: ~/Library/Application Support/BTX/

Default network ports:

PortPurpose
19335P2P (peer connections)
19334JSON-RPC

3. Check Sync Status

Use btx-cli to query the running node:

./build-btx/bin/btx-cli getblockchaininfo

Key fields to watch:

  • blocks — current chain height your node has validated
  • headers — highest header seen from peers
  • verificationprogress — approaches 1.0 when fully synced

For just the block count:

./build-btx/bin/btx-cli getblockcount

4. Create a Wallet

Create a new descriptor wallet:

./build-btx/bin/btx-cli createwallet "mywallet"

5. Get a Receiving Address

./build-btx/bin/btx-cli getnewaddress

This returns a new BTX address you can share to receive funds.

6. Check Mining Info

View current mining and difficulty state:

./build-btx/bin/btx-cli getmininginfo

Key fields:

  • blocks — current chain height
  • difficulty — current MatMul PoW difficulty
  • networkhashps — estimated network hash rate

7. Stopping the Node

Gracefully shut down the daemon:

./build-btx/bin/btx-cli stop

Next Steps