DUNE v1.0.0 Release Notes
This release introduces DUNE, Docker Utilities for Node Execution. DUNE is a tool to abstract over Leap programs, CDT, and other services/tools to perform the functions of node management, compiling smart contracts, running tests, and several other common tasks required to develop smart contracts on Antelope blockchains.
Read on for details.
Features
The full list of commands for DUNE can be accessed in the DUNE Commands section of the README or by using the -h or --help command inside of DUNE.
Node management
- Start a new node for deploying smart contracts and send actions against
- Stop previously started nodes
- Remove nodes from a system
- List status for all nodes in system including active, running, and the ports for http/p2p/SHiP
- Set previously started nodes as active
- Export nodes as a snapshot and tar ball the state snapshot, blocklog and index and export to desired location
- Import a previously exported node.tgz
- Monitor running nodes
- Multiple node support
- Concurrent multiple node support via allowing custom config.ini files
Wallet management
- Wallet import
- Wallet export
- Import keys into wallet
- Create and build applications
- Start, stop, and purge containers
- List available protocol features
- Activate protocol features
- Bootstrap and preactivate protocol features, set the boot contract and activate all protocol features
- Bootstrap and preactivate protocol features, set the boot contract, activate all protocol features, set the contracts from Reference Contracts and create the correct accounts required
- Services through the docker container are exposed at 8888 for http, 9876 for p2p and 8080 for SHiP for dApp development
Contract development
- Create projects
- Compile projects
- Run project tests
- Debug native tests
- Create accounts
- Deploy smart contracts
- Send actions
- Access table information
Utilize cleos, nodeos, CDT and OS commands when needed
In scenarios where a user needs a specific command not offered in DUNE, the command --
followed by whatever normal cleos
, nodeos
, CDT and OS commands that you need will execute normally.
Building, compatibility, and upgrading
Compatibility
If you have previously used v1.0.0-rc1, the option --set-system-contract
is now --set-core-contract
to use the naming convention we are moving forward with for Reference Contracts.
Upgrading from prior releases
If you have cloned prior release candidates of version 1.0.0, you will need to run the ./bootstrap
script again to update it and run dune --destroy-container
. This will erase the container and start over from the new image, so please export your wallet or nodes that you want to persist.
Further details on changes since last release
Contributors
Special thanks to the contributors that submitted patches for this release:
Full list of changes since last release
PRs
Refer to full list of changes from the following prior releases:
- https://github.com/eosnetworkfoundation/DUNE/releases/tag/v1.0.0-rc1
- https://github.com/AntelopeIO/DUNE/releases/tag/v1.0.0-rc2
- https://github.com/AntelopeIO/DUNE/releases/tag/v1.0.0-rc3
In addition, this release also includes the following PRs:
Full Changelog: 6110892...v1.0.0