Build, sync, query, wallet, Core service integration. 36 actions listed by group. REST + RPC examples. Co-Authored-By: Charon <charon@lethean.io>
1.5 KiB
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 |