EOSFactory Release Notes - v2.0

Compatibility

EOSFactory v2.0 is compatible with EOS v1.2.0 (or higher).

Features available in previous releases

  • Launch a single-node private testnet and fully control it: stop it and then continue running it or completely reset it.
  • Initialize a testnet with the bios contract and several test accounts (available as sess.alice, sess.bob and sess.carol).
  • Create additional test accounts (their keys are automatically imported into the wallet).
  • Manage the wallet (locking, unlocking etc).
  • Have an easy access to demo contracts stored in the contracts folder of the EOSIO source code (you can instantiate them in EOSFactory by passing their folder name in the Contract class constructor).
  • Compile a contract, both ABI & WAST (but please note that the ABI compiler has an experimental status in EOSIO repository).
  • Create a new contract from a pre-defined template (this includes the creation of its CMake files).
  • Deploy a contract (the account holding the contract is created behind the scenes).
  • Interact with a contract by pushing actions to it.
  • Extract data from a contract’s table.
  • Integration with Python UnitTest standard library.
  • User-defined workspace for smart-contract storage.
  • Support for debugging via logger output containing file name & line number.
  • Preliminary code verification with CLANG.
  • Visual Studio Code integration, including CMake builds and automated tasks.
  • Color differentiation in console output.
  • Support for keosd, the official wallet management tool.

New features available in v2.0

  • Full compatibility with production version of EOS (v1.2.0 or higher).
  • Seamless integration with public testnets (e.g. Jungle Testnet or Kylin Testnet).
  • The entire wallet management migrated to keosd, as for security reasons this feature is no longer supported by nodeos.
  • Radically improved mechanism for mapping random account names to human-friendly aliases, including symbolic translation of EOS logger messages.
  • New mechanism for caching public testnet settings.
  • Developer API reduced to less than 20 basic commands and classes.
  • Radially improved logger messaging, including highly customizable verbosity.

Current limitations

  • Whereas the nodeos process runs in the background on MacOS, on other platforms (Windows & Ubuntu) it requires launching a separate terminal window (it’s done automatically though). This might be a limitation for GUI-less systems like Ubuntu Server edition.
  • The Contract class push_action() and show_action methods accept only verbose input, i.e. all action’s parameters must be named in the JSON syntax.