871150bd61
Build, sync, query, wallet, Core service integration. 36 actions listed by group. REST + RPC examples. Co-Authored-By: Charon <charon@lethean.io>
67 lines
1.5 KiB
Markdown
67 lines
1.5 KiB
Markdown
# go-blockchain Quickstart
|
|
|
|
## Build
|
|
|
|
```bash
|
|
cd ~/Code/core/go-blockchain
|
|
GOWORK=off go build -o core-chain ./cmd/core-chain/
|
|
```
|
|
|
|
## Sync the testnet (3 minutes)
|
|
|
|
```bash
|
|
./core-chain chain serve --testnet --seed 10.69.69.165:46942 --rpc-port 47941
|
|
```
|
|
|
|
## Query the chain
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
./core-chain wallet create
|
|
# Address: iTHN...
|
|
# Seed: 25 words
|
|
|
|
./core-chain wallet restore --seed "word1 word2 ..."
|
|
```
|
|
|
|
## Use as Core service
|
|
|
|
```go
|
|
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 |
|