Releases: AntelopeIO/DUNES
DUNE v1.1.2 Release Notes
This release introduces the latest update to 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.
Fixes
Upgrade reference-contract to the newest version
After new CDT 4.0.0 was released, it was not possible to bootstrap new DUNE docker image.
Now it has been fixed by getting the latest reference-contract.
Upgrading
Upgrading from prior releases
To upgrade DUNE to the latest version, you should download below binaries and install them using steps from README.
There is no change in underlying DUNE image from version 1.1.0.
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
Full Changelog: v1.1.1...v1.1.2
Contributors
Assets 5
DUNE v1.1.1 Release Notes
This release introduces the latest update to 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.
Fixes
Port forwarding - accessing nodeos from outside of the container
In previous versions the Port forwarding/exposing of the ports 8888 (http), 9876 (p2p), 8080 (SHiP) and 8000 (webapp) were broken.
These latest fixes should resolve those problems and allow you to access those ports as needed for DApp development.
Better Backwards Compatibility
Before when users would use the latest LEAP version (v4.x) it would fail to run because it needed a new default config option present, if we have simply changed the base config.ini to support this option, then we broke compatibility with previous versions of LEAP as an unrecognized option.
So, a solution was put in place to dynamically generate the 'default' config.ini used for node startup (unless one is passed via the command to it, which will just use that one). This allowed for more fine grained control over parameters and allowed us to actively select better options based on the user's underlying system.
Upgrading
Upgrading from prior releases
To upgrade DUNE to the latest version, you should download below binaries and install them using steps from README.
There is no change in underlying DUNE image from version 1.1.0.
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
In addition, this release also includes the following PRs:
Full Changelog: v1.1.0...v1.1.1
Contributors
Assets 5
DUNE v1.1.0 Release Notes
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.
| 📝 | Please note that there are pending reviews for Chocolately and Brew support that will be available in the coming weeks. For now, packages have been attached within the release. |
|---|
Read on for details.
Features
DUNE plug-in extension
DUNE plugins are Python scripts that allow users to customize and add new functionality to DUNE. They can be used to add new command-line options, interact with DUNE's internals, or perform other tasks related to cleos / nodeos.
They need to be placed in the subdirectory of ../src/plugin/ and define three functions: add_parsing, set_dune, and handle_args. Examples of plugins can be found in the plugin_example directory.
Installation on Windows
DUNE is now available as a Chocolatey package (*.nupkg attached to the release) and can be installed on Windows. Steps which are needed to install DUNE using Chocolatey have been updated in the documentation.
Packaging
DUNE can now be packaged as an RPM or DEB package. The documentation for installing DUNE on Linux has been updated.
DUNE image
DUNE now uses pre-built Docker image for running DUNE. The image is automatically downloaded during the first usage, so there's no need to build it from scratch.
Dynamic updates
DUNE now supports dynamic updates. Users can upgrade DUNE image to the latest version with the command dune --upgrade. Note: To upgrade DUNE python scripts you still need to install latest DUNE version from release page / Chocolatey repository.
Leap/CDT versioning
DUNE is allowing users to change the CDT and leap versions. This can be done by running the command dune --cdt <version> or dune --leap <version>. To build an image with specific versions, users can run the script bootstrap.sh with the appropriate arguments.
Functional tests
Users can validate DUNE by running functional tests using command pytest tests in the DUNE directory.
Building, compatibility, and upgrading
Upgrading from prior releases
If you have previously cloned DUNE, you may still have an older version of the Docker image. To upgrade to the latest version of DUNE, you can run the command dune --upgrade, which will download the most recent version of the image from GitHub Packages.
Alternatively, you can remove the old image by running the command dune --destroy-container followed by docker image rm -f dune:latest. Please note that upgrading or removing the old image will delete the associated container and image. Before proceeding, be sure to export any wallets or nodes that you want to keep.
To confirm the upgrade was successfull the command dune --version-all should give you following output:
DUNE v1.1.0
WARNING: apt does not have a stable CLI interface. Use with caution in scripts.
Listing...
leap/now 3.2.1 amd64 [installed,local]
WARNING: apt does not have a stable CLI interface. Use with caution in scripts.
Listing...
cdt/now 3.1.0-1 amd64 [installed,local]
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
- (30)Add extra title to section on bootstrapping
- (27)fix bootstrap error
- (34)Fix cause of issues with shared files
- (40)triage new issues by adding label & assigning to project
- (35)New command --debug is added
- (47)Fix of issue #5
- (44)The DUNE installation description has been updated in
- (42)The code has been reformatted according to PEP8 style guide
- (43)A call of Pylint has been added to GitHub Actions
- (52).pylintrc file moved to the project root to config pylint a globally
- (53)Move work dir to app dir
- (59)Fix exception capture exit
- (58)Fix start option
- (67)Config restart fix
- (71)--gdb flag description corrected
- (72)Description for command -- is added
- (73)Fixes for import and export of nodes.
- (77)Correct column widths in
--listnode display to be aesthetically pleasing. - (50)Fix error when starting up DUNE: tail: cannot open '&>'
- (82)Added a memo describes details of work with Docker
- (88)Fix failing test_project.py - merge to functional-tests branch
- (79)Functional tests
- (84)Several errata fixes in the description of DUNE.
- (75)Leap/CDT versioning, dynamic updates and packages
- (89)Run functional tests
- (94)Added creating rpm and Chocolatey packages
- (96)Easy install of DUNE on Windows (publishing DUNE to Chocolatey repository)
- (93)Fixed bootstrap sequence
- (105)DUNE plugin proposal
Full Changelog: v1.0.0...v1.1.0
Contributors
Assets 5
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
Contributors
Assets 2
DUNE v1.0.0-rc3
spoonincode
Matt Witherspoon
DUNE v1.0.0-rc3 Release Notes
This is a RELEASE CANDIDATE for version 1.0.0.
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.
This release is a version dependency bump to accommodate the latest CDT 3.0.0 RC3 and Leap 3.1.0 stable releases.
Read on for details.
Upgrading from previous versions
If you have cloned prior to v1.0.0-rc3 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.
If you have used v1.0.0-rc1 or prior, the option --set-system-contract is now --set-core-contract to use the naming convention we are moving forward with for EOS system contracts.
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.
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
Full Changelog: v1.0.0-rc2...v1.0.0-rc3
Contributors
Assets 2
DUNE v1.0.0-rc2 Release Notes
This is a RELEASE CANDIDATE for version 1.0.0.
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.
Upgrading from previous versions
If you have cloned prior to v1.0.0-rc2 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.
If you have used v1.0.0-rc1 or prior, the option --set-system-contract is now --set-core-contract to use the naming convention we are moving forward with for EOS system contracts.
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.
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
Full Changelog: 71991a7...v1.0.0-rc2