mirror of
https://github.com/0glabs/0g-chain.git
synced 2024-12-26 00:05:18 +00:00
112 lines
3.4 KiB
Go
112 lines
3.4 KiB
Go
package runner
|
|
|
|
import (
|
|
"fmt"
|
|
"log"
|
|
"os"
|
|
"os/exec"
|
|
)
|
|
|
|
type KvtoolRunnerConfig struct {
|
|
ZgChainConfigTemplate string
|
|
|
|
ImageTag string
|
|
IncludeIBC bool
|
|
|
|
EnableAutomatedUpgrade bool
|
|
ZgChainUpgradeName string
|
|
ZgChainUpgradeHeight int64
|
|
ZgChainUpgradeBaseImageTag string
|
|
|
|
SkipShutdown bool
|
|
}
|
|
|
|
// KvtoolRunner implements a NodeRunner that spins up local chains with kvtool.
|
|
// It has support for the following:
|
|
// - running a ZgChain node
|
|
// - optionally, running an IBC node with a channel opened to the ZgChain node
|
|
// - optionally, start the ZgChain node on one version and upgrade to another
|
|
type KvtoolRunner struct {
|
|
config KvtoolRunnerConfig
|
|
}
|
|
|
|
var _ NodeRunner = &KvtoolRunner{}
|
|
|
|
// NewKvtoolRunner creates a new KvtoolRunner.
|
|
func NewKvtoolRunner(config KvtoolRunnerConfig) *KvtoolRunner {
|
|
return &KvtoolRunner{
|
|
config: config,
|
|
}
|
|
}
|
|
|
|
// StartChains implements NodeRunner.
|
|
// For KvtoolRunner, it sets up, runs, and connects to a local chain via kvtool.
|
|
func (k *KvtoolRunner) StartChains() Chains {
|
|
// install kvtool if not already installed
|
|
installKvtoolCmd := exec.Command("./scripts/install-kvtool.sh")
|
|
installKvtoolCmd.Stdout = os.Stdout
|
|
installKvtoolCmd.Stderr = os.Stderr
|
|
if err := installKvtoolCmd.Run(); err != nil {
|
|
panic(fmt.Sprintf("failed to install kvtool: %s", err.Error()))
|
|
}
|
|
|
|
// start local test network with kvtool
|
|
log.Println("starting 0gchain node")
|
|
kvtoolArgs := []string{"testnet", "bootstrap", "--0gchain.configTemplate", k.config.ZgChainConfigTemplate}
|
|
// include an ibc chain if desired
|
|
if k.config.IncludeIBC {
|
|
kvtoolArgs = append(kvtoolArgs, "--ibc")
|
|
}
|
|
// handle automated upgrade functionality, if defined
|
|
if k.config.EnableAutomatedUpgrade {
|
|
kvtoolArgs = append(kvtoolArgs,
|
|
"--upgrade-name", k.config.ZgChainUpgradeName,
|
|
"--upgrade-height", fmt.Sprint(k.config.ZgChainUpgradeHeight),
|
|
"--upgrade-base-image-tag", k.config.ZgChainUpgradeBaseImageTag,
|
|
)
|
|
}
|
|
// start the chain
|
|
startZgChainCmd := exec.Command("kvtool", kvtoolArgs...)
|
|
startZgChainCmd.Env = os.Environ()
|
|
startZgChainCmd.Env = append(startZgChainCmd.Env, fmt.Sprintf("0GCHAIN_TAG=%s", k.config.ImageTag))
|
|
startZgChainCmd.Stdout = os.Stdout
|
|
startZgChainCmd.Stderr = os.Stderr
|
|
log.Println(startZgChainCmd.String())
|
|
if err := startZgChainCmd.Run(); err != nil {
|
|
panic(fmt.Sprintf("failed to start 0gchain: %s", err.Error()))
|
|
}
|
|
|
|
// wait for chain to be live.
|
|
// if an upgrade is defined, this waits for the upgrade to be completed.
|
|
if err := waitForChainStart(kvtoolZgChainChain); err != nil {
|
|
k.Shutdown()
|
|
panic(err)
|
|
}
|
|
log.Println("0gchain is started!")
|
|
|
|
chains := NewChains()
|
|
chains.Register("0gchain", &kvtoolZgChainChain)
|
|
if k.config.IncludeIBC {
|
|
chains.Register("ibc", &kvtoolIbcChain)
|
|
}
|
|
return chains
|
|
}
|
|
|
|
// Shutdown implements NodeRunner.
|
|
// For KvtoolRunner, it shuts down the local kvtool network.
|
|
// To prevent shutting down the chain (eg. to preserve logs or examine post-test state)
|
|
// use the `SkipShutdown` option on the config.
|
|
func (k *KvtoolRunner) Shutdown() {
|
|
if k.config.SkipShutdown {
|
|
log.Printf("would shut down but SkipShutdown is true")
|
|
return
|
|
}
|
|
log.Println("shutting down 0gchain node")
|
|
shutdownZgChainCmd := exec.Command("kvtool", "testnet", "down")
|
|
shutdownZgChainCmd.Stdout = os.Stdout
|
|
shutdownZgChainCmd.Stderr = os.Stderr
|
|
if err := shutdownZgChainCmd.Run(); err != nil {
|
|
panic(fmt.Sprintf("failed to shutdown kvtool: %s", err.Error()))
|
|
}
|
|
}
|