Mining/pkg/node/lethean.go
Claude 6aea40d90c
ax(node): replace GoDoc prose+code-block comments with AX usage examples in lethean.go
RFC-CORE-008 Principle 2: comments show HOW with real values, not WHAT the
function does in prose. Removed GoDoc-style blank-line indented blocks and
replaced with inline concrete call examples on every type and function.

Co-Authored-By: Charon <charon@lethean.io>
2026-04-02 10:36:31 +01:00

150 lines
4.4 KiB
Go

// Copyright (c) 2017-2026 Lethean (https://lt.hn)
// SPDX-License-Identifier: EUPL-1.2
package node
import (
"encoding/json"
"fmt"
"io"
"net/http"
"strings"
)
// LetheanDefaults for chain connectivity.
const (
LetheanTestnetDaemon = "http://127.0.0.1:46941"
LetheanMainnetDaemon = "http://127.0.0.1:36941"
LetheanTestnetPool = "stratum+tcp://pool.lthn.io:5555"
LetheanMainnetPool = "stratum+tcp://pool.lthn.io:3333"
)
// info, err := node.GetChainInfo("http://127.0.0.1:46941")
// if info.Synced { log("height:", info.Height) }
type ChainInfo struct {
Height uint64 `json:"height"`
Aliases int `json:"alias_count"`
Synced bool `json:"synced"`
PoolSize int `json:"tx_pool_size"`
Difficulty uint64 `json:"difficulty"`
}
// pools := node.DiscoverPools("http://127.0.0.1:46941")
// for _, pool := range pools { log(pool.Name, pool.Endpoint) }
type PoolGateway struct {
Name string `json:"name"`
Address string `json:"address"`
Caps string `json:"caps"`
Endpoint string `json:"endpoint"`
}
// info, err := node.GetChainInfo("http://127.0.0.1:46941")
// if err == nil && info.Synced { log("chain height:", info.Height) }
func GetChainInfo(daemonURL string) (*ChainInfo, error) {
body := `{"jsonrpc":"2.0","id":"0","method":"getinfo","params":{}}`
response, err := http.Post(daemonURL+"/json_rpc", "application/json", strings.NewReader(body))
if err != nil {
return nil, fmt.Errorf("daemon RPC failed: %w", err)
}
defer response.Body.Close()
responseBody, _ := io.ReadAll(response.Body)
var result struct {
Result ChainInfo `json:"result"`
}
if err := json.Unmarshal(responseBody, &result); err != nil {
return nil, fmt.Errorf("parse getinfo: %w", err)
}
result.Result.Synced = result.Result.Height > 0
return &result.Result, nil
}
// pools := node.DiscoverPools("http://127.0.0.1:46941")
// for _, pool := range pools { log(pool.Name, pool.Endpoint) }
func DiscoverPools(daemonURL string) []PoolGateway {
body := `{"jsonrpc":"2.0","id":"0","method":"get_all_alias_details","params":{}}`
response, err := http.Post(daemonURL+"/json_rpc", "application/json", strings.NewReader(body))
if err != nil {
return nil
}
defer response.Body.Close()
responseBody, _ := io.ReadAll(response.Body)
var result struct {
Result struct {
Aliases []struct {
Alias string `json:"alias"`
Address string `json:"address"`
Comment string `json:"comment"`
} `json:"aliases"`
} `json:"result"`
}
json.Unmarshal(responseBody, &result)
var pools []PoolGateway
for _, alias := range result.Result.Aliases {
if !strings.Contains(alias.Comment, "pool") {
continue
}
parsed := parseComment(alias.Comment)
pools = append(pools, PoolGateway{
Name: alias.Alias,
Address: alias.Address,
Caps: parsed["cap"],
Endpoint: fmt.Sprintf("stratum+tcp://%s.lthn:5555", alias.Alias),
})
}
return pools
}
// gateways := node.DiscoverGateways("http://127.0.0.1:46941")
// for _, gw := range gateways { log(gw.Name, gw.Endpoint) }
func DiscoverGateways(daemonURL string) []PoolGateway {
body := `{"jsonrpc":"2.0","id":"0","method":"get_all_alias_details","params":{}}`
response, err := http.Post(daemonURL+"/json_rpc", "application/json", strings.NewReader(body))
if err != nil {
return nil
}
defer response.Body.Close()
responseBody, _ := io.ReadAll(response.Body)
var result struct {
Result struct {
Aliases []struct {
Alias string `json:"alias"`
Address string `json:"address"`
Comment string `json:"comment"`
} `json:"aliases"`
} `json:"result"`
}
json.Unmarshal(responseBody, &result)
var gateways []PoolGateway
for _, alias := range result.Result.Aliases {
if !strings.Contains(alias.Comment, "type=gateway") {
continue
}
parsed := parseComment(alias.Comment)
gateways = append(gateways, PoolGateway{
Name: alias.Alias,
Address: alias.Address,
Caps: parsed["cap"],
Endpoint: fmt.Sprintf("%s.lthn", alias.Alias),
})
}
return gateways
}
// parsed := parseComment("cap=pool;endpoint=stratum+tcp://pool.lthn.io:3333")
// parsed["cap"] // "pool"
// parsed["endpoint"] // "stratum+tcp://pool.lthn.io:3333"
func parseComment(comment string) map[string]string {
result := make(map[string]string)
for _, part := range strings.Split(comment, ";") {
separatorIndex := strings.IndexByte(part, '=')
if separatorIndex > 0 {
result[part[:separatorIndex]] = part[separatorIndex+1:]
}
}
return result
}