You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

152 lines
6.1 KiB

  1. package e2e
  2. import (
  3. "fmt"
  4. "os"
  5. "github.com/BurntSushi/toml"
  6. )
  7. // Manifest represents a TOML testnet manifest.
  8. type Manifest struct {
  9. // IPv6 uses IPv6 networking instead of IPv4. Defaults to IPv4.
  10. IPv6 bool `toml:"ipv6"`
  11. // InitialHeight specifies the initial block height, set in genesis. Defaults to 1.
  12. InitialHeight int64 `toml:"initial_height"`
  13. // InitialState is an initial set of key/value pairs for the application,
  14. // set in genesis. Defaults to nothing.
  15. InitialState map[string]string `toml:"initial_state"`
  16. // Validators is the initial validator set in genesis, given as node names
  17. // and power:
  18. //
  19. // validators = { validator01 = 10; validator02 = 20; validator03 = 30 }
  20. //
  21. // Defaults to all nodes that have mode=validator at power 100. Explicitly
  22. // specifying an empty set will start with no validators in genesis, and
  23. // the application must return the validator set in InitChain via the
  24. // setting validator_update.0 (see below).
  25. Validators *map[string]int64 `toml:"validators"`
  26. // ValidatorUpdates is a map of heights to validator names and their power,
  27. // and will be returned by the ABCI application. For example, the following
  28. // changes the power of validator01 and validator02 at height 1000:
  29. //
  30. // [validator_update.1000]
  31. // validator01 = 20
  32. // validator02 = 10
  33. //
  34. // Specifying height 0 returns the validator update during InitChain. The
  35. // application returns the validator updates as-is, i.e. removing a
  36. // validator must be done by returning it with power 0, and any validators
  37. // not specified are not changed.
  38. ValidatorUpdates map[string]map[string]int64 `toml:"validator_update"`
  39. // Nodes specifies the network nodes. At least one node must be given.
  40. Nodes map[string]*ManifestNode `toml:"node"`
  41. // KeyType sets the curve that will be used by validators.
  42. // Options are ed25519 & secp256k1
  43. KeyType string `toml:"key_type"`
  44. }
  45. // ManifestNode represents a node in a testnet manifest.
  46. type ManifestNode struct {
  47. // Mode specifies the type of node: "validator", "full", or "seed". Defaults to
  48. // "validator". Full nodes do not get a signing key (a dummy key is generated),
  49. // and seed nodes run in seed mode with the PEX reactor enabled.
  50. Mode string `toml:"mode"`
  51. // Seeds is the list of node names to use as P2P seed nodes. Defaults to none.
  52. Seeds []string `toml:"seeds"`
  53. // PersistentPeers is a list of node names to maintain persistent P2P
  54. // connections to. If neither seeds nor persistent peers are specified,
  55. // this defaults to all other nodes in the network.
  56. PersistentPeers []string `toml:"persistent_peers"`
  57. // Database specifies the database backend: "goleveldb", "cleveldb",
  58. // "rocksdb", "boltdb", or "badgerdb". Defaults to goleveldb.
  59. Database string `toml:"database"`
  60. // ABCIProtocol specifies the protocol used to communicate with the ABCI
  61. // application: "unix", "tcp", "grpc", or "builtin". Defaults to unix.
  62. // builtin will build a complete Tendermint node into the application and
  63. // launch it instead of launching a separate Tendermint process.
  64. ABCIProtocol string `toml:"abci_protocol"`
  65. // PrivvalProtocol specifies the protocol used to sign consensus messages:
  66. // "file", "unix", "tcp", or "grpc". Defaults to "file". For tcp and unix, the ABCI
  67. // application will launch a remote signer client in a separate goroutine.
  68. // For grpc the ABCI application will launch a remote signer server.
  69. // Only nodes with mode=validator will actually make use of this.
  70. PrivvalProtocol string `toml:"privval_protocol"`
  71. // StartAt specifies the block height at which the node will be started. The
  72. // runner will wait for the network to reach at least this block height.
  73. StartAt int64 `toml:"start_at"`
  74. // FastSync specifies the fast sync mode: "" (disable), "v0" or "v2".
  75. // Defaults to disabled.
  76. FastSync string `toml:"fast_sync"`
  77. // StateSync enables state sync. The runner automatically configures trusted
  78. // block hashes and RPC servers. At least one node in the network must have
  79. // SnapshotInterval set to non-zero, and the state syncing node must have
  80. // StartAt set to an appropriate height where a snapshot is available.
  81. StateSync bool `toml:"state_sync"`
  82. // PersistInterval specifies the height interval at which the application
  83. // will persist state to disk. Defaults to 1 (every height), setting this to
  84. // 0 disables state persistence.
  85. PersistInterval *uint64 `toml:"persist_interval"`
  86. // SnapshotInterval specifies the height interval at which the application
  87. // will take state sync snapshots. Defaults to 0 (disabled).
  88. SnapshotInterval uint64 `toml:"snapshot_interval"`
  89. // RetainBlocks specifies the number of recent blocks to retain. Defaults to
  90. // 0, which retains all blocks. Must be greater that PersistInterval and
  91. // SnapshotInterval.
  92. RetainBlocks uint64 `toml:"retain_blocks"`
  93. // Perturb lists perturbations to apply to the node after it has been
  94. // started and synced with the network:
  95. //
  96. // disconnect: temporarily disconnects the node from the network
  97. // kill: kills the node with SIGKILL then restarts it
  98. // pause: temporarily pauses (freezes) the node
  99. // restart: restarts the node, shutting it down with SIGTERM
  100. Perturb []string `toml:"perturb"`
  101. // Misbehaviors sets how a validator behaves during consensus at a
  102. // certain height. Multiple misbehaviors at different heights can be used
  103. //
  104. // An example of misbehaviors
  105. // { 10 = "double-prevote", 20 = "double-prevote"}
  106. //
  107. // For more information, look at the readme in the maverick folder.
  108. // A list of all behaviors can be found in ../maverick/consensus/behavior.go
  109. Misbehaviors map[string]string `toml:"misbehaviors"`
  110. }
  111. // Save saves the testnet manifest to a file.
  112. func (m Manifest) Save(file string) error {
  113. f, err := os.Create(file)
  114. if err != nil {
  115. return fmt.Errorf("failed to create manifest file %q: %w", file, err)
  116. }
  117. return toml.NewEncoder(f).Encode(m)
  118. }
  119. // LoadManifest loads a testnet manifest from a file.
  120. func LoadManifest(file string) (Manifest, error) {
  121. manifest := Manifest{}
  122. _, err := toml.DecodeFile(file, &manifest)
  123. if err != nil {
  124. return manifest, fmt.Errorf("failed to load testnet manifest %q: %w", file, err)
  125. }
  126. return manifest, nil
  127. }