Fantom-foundation/go-opera
Fork: 282 Star: 279 (更新于 2024-10-27 02:11:37)
license: LGPL-3.0
Language: Go .
Opera blockchain protocol secured by the Lachesis consensus algorithm
最后发布版本: v1.1.3-rc.5 ( 2023-10-14 20:15:09)
Opera
EVM-compatible chain secured by the Lachesis consensus algorithm.
Building the source
Building opera
requires both a Go (version 1.14 or later) and a C compiler. You can install
them using your favourite package manager. Once the dependencies are installed, run
make opera
The build output is build/opera
executable.
Running opera
Going through all the possible command line flags is out of scope here,
but we've enumerated a few common parameter combos to get you up to speed quickly
on how you can run your own opera
instance.
Launching a network
You will need a genesis file to join a network, which may be found in https://github.com/Fantom-foundation/lachesis_launch
Launching opera
readonly (non-validator) node for network specified by the genesis file:
$ opera --genesis file.g
Configuration
As an alternative to passing the numerous flags to the opera
binary, you can also pass a
configuration file via:
$ opera --config /path/to/your_config.toml
To get an idea how the file should look like you can use the dumpconfig
subcommand to
export your existing configuration:
$ opera --your-favourite-flags dumpconfig
Validator
New validator private key may be created with opera validator new
command.
To launch a validator, you have to use --validator.id
and --validator.pubkey
flags to enable events emitter.
$ opera --nousb --validator.id YOUR_ID --validator.pubkey 0xYOUR_PUBKEY
opera
will prompt you for a password to decrypt your validator private key. Optionally, you can
specify password with a file using --validator.password
flag.
Participation in discovery
Optionally you can specify your public IP to straighten connectivity of the network. Ensure your TCP/UDP p2p port (5050 by default) isn't blocked by your firewall.
$ opera --nat extip:1.2.3.4
Dev
Running testnet
The network is specified only by its genesis file, so running a testnet node is equivalent to using a testnet genesis file instead of a mainnet genesis file:
$ opera --genesis /path/to/testnet.g # launch node
It may be convenient to use a separate datadir for your testnet node to avoid collisions with other networks:
$ opera --genesis /path/to/testnet.g --datadir /path/to/datadir # launch node
$ opera --datadir /path/to/datadir account new # create new account
$ opera --datadir /path/to/datadir attach # attach to IPC
Testing
Lachesis has extensive unit-testing. Use the Go tool to run tests:
go test ./...
If everything goes well, it should output something along these lines:
ok github.com/Fantom-foundation/go-opera/app 0.033s
? github.com/Fantom-foundation/go-opera/cmd/cmdtest [no test files]
ok github.com/Fantom-foundation/go-opera/cmd/opera 13.890s
? github.com/Fantom-foundation/go-opera/cmd/opera/metrics [no test files]
? github.com/Fantom-foundation/go-opera/cmd/opera/tracing [no test files]
? github.com/Fantom-foundation/go-opera/crypto [no test files]
? github.com/Fantom-foundation/go-opera/debug [no test files]
? github.com/Fantom-foundation/go-opera/ethapi [no test files]
? github.com/Fantom-foundation/go-opera/eventcheck [no test files]
? github.com/Fantom-foundation/go-opera/eventcheck/basiccheck [no test files]
? github.com/Fantom-foundation/go-opera/eventcheck/gaspowercheck [no test files]
? github.com/Fantom-foundation/go-opera/eventcheck/heavycheck [no test files]
? github.com/Fantom-foundation/go-opera/eventcheck/parentscheck [no test files]
ok github.com/Fantom-foundation/go-opera/evmcore 6.322s
? github.com/Fantom-foundation/go-opera/gossip [no test files]
? github.com/Fantom-foundation/go-opera/gossip/emitter [no test files]
ok github.com/Fantom-foundation/go-opera/gossip/filters 1.250s
? github.com/Fantom-foundation/go-opera/gossip/gasprice [no test files]
? github.com/Fantom-foundation/go-opera/gossip/occuredtxs [no test files]
? github.com/Fantom-foundation/go-opera/gossip/piecefunc [no test files]
ok github.com/Fantom-foundation/go-opera/integration 21.640s
Also it is tested with fuzzing.
Operating a private network (fakenet)
Fakenet is a private network optimized for your private testing. It'll generate a genesis containing N validators with equal stakes. To launch a validator in this network, all you need to do is specify a validator ID you're willing to launch.
Pay attention that validator's private keys are deterministically generated in this network, so you must use it only for private testing.
Maintaining your own private network is more involved as a lot of configurations taken for granted in the official networks need to be manually set up.
To run the fakenet with just one validator (which will work practically as a PoA blockchain), use:
$ opera --fakenet 1/1
To run the fakenet with 5 validators, run the command for each validator:
$ opera --fakenet 1/5 # first node, use 2/5 for second node
If you have to launch a non-validator node in fakenet, use 0 as ID:
$ opera --fakenet 0/5
After that, you have to connect your nodes. Either connect them statically or specify a bootnode:
$ opera --fakenet 1/5 --bootnodes "enode://verylonghex@1.2.3.4:5050"
Running the demo
For the testing purposes, the full demo may be launched using:
cd demo/
./start.sh # start the Opera processes
./stop.sh # stop the demo
./clean.sh # erase the chain data
Check README.md in the demo directory for more information.
最近版本更新:(数据更新于 2024-10-30 15:56:23)
2023-10-14 20:15:09 v1.1.3-rc.5
2023-09-20 14:21:34 v1.1.3-rc.4
2023-08-17 15:19:18 v1.1.3-rc.3
2023-08-09 16:16:37 stacktrace
2023-03-14 08:48:55 v1.1.2-rc.6
2023-02-13 19:22:34 v1.1.2-rc.5
2022-08-03 02:47:19 v1.1.1-rc.2
2022-05-24 20:42:30 v1.1.1-rc.1
2022-05-06 01:51:42 v1.1.0-rc.5
2022-03-11 20:34:16 v1.1.0-rc.4
主题(topics):
abft, blockchain-network, byzantine-fault-tolerance, evm, lachesis
Fantom-foundation/go-opera同语言 Go最近更新仓库
2024-11-05 08:55:31 XTLS/Xray-core
2024-11-05 00:03:47 SagerNet/sing-box
2024-11-04 20:34:19 Permify/permify
2024-11-04 15:07:27 containerd/containerd
2024-11-03 20:10:56 flipped-aurora/gin-vue-admin
2024-11-03 00:46:25 dolthub/dolt