NOTE: This project was experimental and is no longer updated. You might be interested in checking out Brownie or Ape.
Development tools for creating Ethereum smart contracts.
Curious what a Solidbyte project looks like? Check out the solidbyte-test-project repository.
- Local accounts - Solidbyte can use the local accounts stored as Ethereum secretstore files located at
~/.ethereum/keystore
. You do not need to trust the node you are using to handle your private keys and risk opening your account withpersonal.unlock
. - Python! - Deploy scripts and tests are written using Python.
- EthPM support - Well, it's in progress and not usable yet, but... it probably will be at some point.
- Vyper and Solidity support - Contracts written in either language can co-exist side by side with eachother in your project.
- Interactive python console - Solidbyte provides a console with an insantiated Web3 object and your deployed contract instances. Have I mentioned Python yet?
- Projcet templates - You can initialize a project template with a single command that includes example deploy scripts, tests, and contracts. Right now only 'bare' and 'erc20' templates are available, but I hope to add more.
- Contract testing with pytest - Pytest is used for contract testing with some provided fixtures. Something something Python.
- eth_tester support for testing - It's super fast and really useful for first-pass testing.
NOTE: Solidbyte has only been tested on Linux. If you use another OS, please consider testing and submit an issue for any bugs you find.
See the roadmap.
Here's a brief demo (as of 2019-03-25) creating a new ERC20 token named MyToken:
Solidbyte requires some system-level libraries to be installed first. Make sure openssl/libssl and libffi headers are installed before proceeding. For more information, see the longer installation docs.
First, install solidbyte. The easiest way to do that is from PyPi
with pip
.
pip install solidbyte
To get your project going, create a directory for your project and change to it.
Most sb
commands need to be run from the root of your project directory.
mkdir myproject && cd myproject
sb init
Now, all you should have a bare project structure created. You could also
init
with an available template,
but for the purposes of this doc, we're just going to create a bare structure.
Your contracts should be in the contracts
directory. Your Solidity or Vyper
contracts can be in any directory under it.
The deploy
directory will hold your deployment scripts.
And tests
will contain your contract unit tests.
The build
directory probably doesn't exist yet. This will be created by
solidbyte when necessary.
You can also create scripts to be run by Solidbyte in the scripts
directory.
They must be implemented according to the documentation.