Files
netrunner/engines/avalanche/engine.go
T
Zach Kelling 4e2a4e432e chore: remove local replace directives and update dependencies
- Update github.com/luxfi/keys v1.0.5 → v1.0.6
- Update github.com/luxfi/genesis v1.5.18 → v1.5.19
- Remove local replace directives for keys and genesis
- Use published package versions for reproducible builds
2026-01-03 07:05:17 -08:00

395 lines
8.9 KiB
Go

// Copyright (C) 2025, Lux Industries Inc. All rights reserved.
// SPDX-License-Identifier: BSD-3-Clause
package lux
import (
"bytes"
"context"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
"os/exec"
"path/filepath"
"time"
"github.com/luxfi/ids"
"github.com/luxfi/netrunner/engines"
)
func init() {
engines.Register(engines.EngineLux, NewLuxEngine)
}
// LuxEngine wraps luxd node management
type LuxEngine struct {
name string
binary string
dataDir string
config *engines.NodeConfig
process *exec.Cmd
httpClient *http.Client
rpcEndpoint string
startTime time.Time
// Cached info
networkID uint32
chainID ids.ID
}
// NewLuxEngine creates a new Lux engine
func NewLuxEngine(name string, binary string) (engines.Engine, error) {
if binary == "" {
binary = "luxd"
}
return &LuxEngine{
name: name,
binary: binary,
}, nil
}
func (e *LuxEngine) Name() string { return e.name }
func (e *LuxEngine) Type() engines.EngineType { return engines.EngineLux }
func (e *LuxEngine) NetworkID() uint32 { return e.networkID }
func (e *LuxEngine) ChainID() ids.ID { return e.chainID }
func (e *LuxEngine) ParentChain() *engines.ChainInfo { return nil } // L1
func (e *LuxEngine) Start(ctx context.Context, config *engines.NodeConfig) error {
e.config = config
e.networkID = config.NetworkID
// Setup data directory
if config.DataDir == "" {
config.DataDir = filepath.Join(os.TempDir(), "lux", e.name)
}
e.dataDir = config.DataDir
if err := os.MkdirAll(e.dataDir, 0755); err != nil {
return fmt.Errorf("failed to create data dir: %w", err)
}
// Build command arguments
args := []string{
fmt.Sprintf("--network-id=%s", getLuxNetwork(config.NetworkID)),
fmt.Sprintf("--http-port=%d", config.HTTPPort),
fmt.Sprintf("--staking-port=%d", config.StakingPort),
fmt.Sprintf("--data-dir=%s", e.dataDir),
fmt.Sprintf("--log-level=%s", config.LogLevel),
"--http-host=0.0.0.0",
"--http-allowed-hosts=*",
"--http-allowed-origins=*",
}
// Add bootstrap nodes if custom network
if len(config.BootstrapIPs) > 0 {
for _, ip := range config.BootstrapIPs {
args = append(args, fmt.Sprintf("--bootstrap-ips=%s", ip))
}
}
// Add extra configs
for k, v := range config.Extra {
args = append(args, fmt.Sprintf("--%s=%v", k, v))
}
// Start the process
e.process = exec.CommandContext(ctx, e.binary, args...)
e.process.Dir = e.dataDir
// Setup logs
logFile, err := os.Create(filepath.Join(e.dataDir, "node.log"))
if err != nil {
return fmt.Errorf("failed to create log file: %w", err)
}
e.process.Stdout = logFile
e.process.Stderr = logFile
if err := e.process.Start(); err != nil {
return fmt.Errorf("failed to start luxd: %w", err)
}
e.startTime = time.Now()
e.rpcEndpoint = e.RPCEndpoint()
e.httpClient = &http.Client{Timeout: 10 * time.Second}
// Wait for node to be responsive
ticker := time.NewTicker(500 * time.Millisecond)
defer ticker.Stop()
timeout := time.After(60 * time.Second) // Lux can take longer
for {
select {
case <-ticker.C:
if nodeID, err := e.getNodeID(ctx); err == nil && nodeID != "" {
// Cache C-Chain ID
if cid, err := e.getBlockchainID(ctx, "C"); err == nil {
e.chainID = cid
}
return nil
}
case <-timeout:
return fmt.Errorf("luxd failed to start within 60 seconds")
case <-ctx.Done():
return ctx.Err()
}
}
}
func (e *LuxEngine) Stop(ctx context.Context) error {
if e.process == nil || e.process.Process == nil {
return nil
}
// Try graceful shutdown first
if err := e.process.Process.Signal(os.Interrupt); err != nil {
return e.process.Process.Kill()
}
done := make(chan error, 1)
go func() {
done <- e.process.Wait()
}()
select {
case <-done:
return nil
case <-time.After(10 * time.Second):
return e.process.Process.Kill()
case <-ctx.Done():
return e.process.Process.Kill()
}
}
func (e *LuxEngine) Restart(ctx context.Context) error {
if err := e.Stop(ctx); err != nil {
return err
}
time.Sleep(2 * time.Second) // Give ports time to release
return e.Start(ctx, e.config)
}
func (e *LuxEngine) Health(ctx context.Context) (*engines.HealthStatus, error) {
if e.httpClient == nil {
return &engines.HealthStatus{Healthy: false}, nil
}
// Get node health
healthy, err := e.getHealth(ctx)
if err != nil {
return &engines.HealthStatus{Healthy: false}, nil
}
// Get peers
peerCount, _ := e.getPeerCount(ctx)
// Get version
version, _ := e.getNodeVersion(ctx)
return &engines.HealthStatus{
Healthy: healthy,
PeerCount: peerCount,
Version: version,
// BlockHeight from C-Chain would require eth client
}, nil
}
func (e *LuxEngine) IsRunning() bool {
return e.process != nil && e.process.Process != nil
}
func (e *LuxEngine) Uptime() time.Duration {
if !e.IsRunning() {
return 0
}
return time.Since(e.startTime)
}
func (e *LuxEngine) RPCEndpoint() string {
if e.config == nil {
return ""
}
return fmt.Sprintf("http://localhost:%d", e.config.HTTPPort)
}
func (e *LuxEngine) WSEndpoint() string {
if e.config == nil {
return ""
}
// Lux uses same port for HTTP and WS
return fmt.Sprintf("ws://localhost:%d/ext/bc/C/ws", e.config.HTTPPort)
}
func (e *LuxEngine) P2PEndpoint() string {
if e.config == nil {
return ""
}
return fmt.Sprintf("localhost:%d", e.config.StakingPort)
}
func (e *LuxEngine) Metrics() map[string]interface{} {
return map[string]interface{}{
"uptime_seconds": e.Uptime().Seconds(),
"running": e.IsRunning(),
"network_id": e.networkID,
"chain_id": e.chainID.String(),
}
}
// getLuxNetwork converts network ID to lux network name
func getLuxNetwork(networkID uint32) string {
switch networkID {
case 1:
return "mainnet"
case 5:
return "fuji"
case 43114:
return "mainnet" // C-Chain ID
case 43113:
return "fuji" // Fuji C-Chain
default:
return fmt.Sprintf("%d", networkID)
}
}
// Helper methods for RPC calls
func (e *LuxEngine) callRPC(ctx context.Context, endpoint string, method string, params interface{}) (json.RawMessage, error) {
reqBody := map[string]interface{}{
"jsonrpc": "2.0",
"id": 1,
"method": method,
"params": params,
}
data, err := json.Marshal(reqBody)
if err != nil {
return nil, err
}
req, err := http.NewRequestWithContext(ctx, "POST", e.rpcEndpoint+endpoint, bytes.NewReader(data))
if err != nil {
return nil, err
}
req.Header.Set("Content-Type", "application/json")
resp, err := e.httpClient.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
return nil, err
}
var result struct {
Result json.RawMessage `json:"result"`
Error *struct {
Code int `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.Unmarshal(body, &result); err != nil {
return nil, err
}
if result.Error != nil {
return nil, fmt.Errorf("RPC error %d: %s", result.Error.Code, result.Error.Message)
}
return result.Result, nil
}
func (e *LuxEngine) getNodeID(ctx context.Context) (string, error) {
result, err := e.callRPC(ctx, "/ext/info", "info.getNodeID", struct{}{})
if err != nil {
return "", err
}
var resp struct {
NodeID string `json:"nodeID"`
}
if err := json.Unmarshal(result, &resp); err != nil {
return "", err
}
return resp.NodeID, nil
}
func (e *LuxEngine) getBlockchainID(ctx context.Context, alias string) (ids.ID, error) {
result, err := e.callRPC(ctx, "/ext/info", "info.getBlockchainID", map[string]string{"alias": alias})
if err != nil {
return ids.Empty, err
}
var resp struct {
BlockchainID string `json:"blockchainID"`
}
if err := json.Unmarshal(result, &resp); err != nil {
return ids.Empty, err
}
return ids.FromString(resp.BlockchainID)
}
func (e *LuxEngine) getHealth(ctx context.Context) (bool, error) {
result, err := e.callRPC(ctx, "/ext/health", "health.health", struct{}{})
if err != nil {
return false, err
}
var resp struct {
Healthy bool `json:"healthy"`
}
if err := json.Unmarshal(result, &resp); err != nil {
return false, err
}
return resp.Healthy, nil
}
func (e *LuxEngine) getPeerCount(ctx context.Context) (int, error) {
result, err := e.callRPC(ctx, "/ext/info", "info.peers", struct{}{})
if err != nil {
return 0, err
}
var resp struct {
NumPeers int `json:"numPeers"`
Peers []interface{} `json:"peers"`
}
if err := json.Unmarshal(result, &resp); err != nil {
// Try counting peers array
var peers []interface{}
if err := json.Unmarshal(result, &peers); err != nil {
return 0, err
}
return len(peers), nil
}
if resp.NumPeers > 0 {
return resp.NumPeers, nil
}
return len(resp.Peers), nil
}
func (e *LuxEngine) getNodeVersion(ctx context.Context) (string, error) {
result, err := e.callRPC(ctx, "/ext/info", "info.getNodeVersion", struct{}{})
if err != nil {
return "", err
}
var resp struct {
Version string `json:"version"`
}
if err := json.Unmarshal(result, &resp); err != nil {
return "", err
}
return resp.Version, nil
}