go-blockchain/docs/quickstart.md
Claude 871150bd61
Some checks failed
Security Scan / security (push) Successful in 12s
Test / Test (push) Failing after 38s
docs: add quickstart guide for developers
Build, sync, query, wallet, Core service integration.
36 actions listed by group. REST + RPC examples.

Co-Authored-By: Charon <charon@lethean.io>
2026-04-02 04:33:15 +01:00

1.5 KiB

go-blockchain Quickstart

Build

cd ~/Code/core/go-blockchain
GOWORK=off go build -o core-chain ./cmd/core-chain/

Sync the testnet (3 minutes)

./core-chain chain serve --testnet --seed 10.69.69.165:46942 --rpc-port 47941

Query the chain

# JSON-RPC
curl -X POST http://127.0.0.1:47941/json_rpc \
  -d '{"jsonrpc":"2.0","id":"0","method":"getinfo"}'

# REST API  
curl http://127.0.0.1:47941/api/info
curl http://127.0.0.1:47941/api/aliases
curl http://127.0.0.1:47941/health

# Self-documentation
curl http://127.0.0.1:47941/openapi

Create a wallet

./core-chain wallet create
# Address: iTHN...
# Seed: 25 words

./core-chain wallet restore --seed "word1 word2 ..."

Use as Core service

c := core.New()
blockchain.RegisterAllActions(c, chain, hsdURL, hsdKey)

// Now available as CLI + MCP + API:
result := c.Action("blockchain.chain.height").Run(ctx, opts)
result := c.Action("blockchain.wallet.create").Run(ctx, opts)
result := c.Action("blockchain.dns.resolve").Run(ctx, opts)

36 Core Actions

Group Actions
chain height, info, block, synced, hardforks, stats, search
alias list, get, capabilities
network gateways, topology, vpn, dns
supply total, hashrate
wallet create, address, seed
crypto hash, generate_keys, check_key, validate_address
asset info, list, deploy
forge release, issue, build, event
hsd info, resolve, height
dns resolve, names, discover