Neo3-Boa is a tool for creating Neo Smart Contracts using Python. It compiles .py files to .nef and .manifest.json formats for usage in the Neo Virtual Machine which is used to execute contracts on the Neo Blockchain.
Neo-boa is part of the Neo Python Framework, aimed to allow the full development of dApps using Python alone.
We want Python developers to feel comfortable when trying Neo3-Boa for the first time. It should look and behave like regular Python. For this reason we decided to avoid adding new keywords, but use decorators and helper functions instead.
In the real world, simply coding a smart contract is not enough. Developers need to debug, deploy and invoke it. Therefore, it’s important for this tool to be part of a bigger Python framework. To help the developers and avoid a bad user experience, we need to use logs and inform errors with details.
We need to ensure that the code works as expected, and the only way to do that is to run our tests against the official Neo 3 VM. Neo repository already contains a class called TestEngine that is capable of running tests using C# smart-contracts. It will be adjusted to support compiled smart-contracts.
Create a product that is easy to maintain and upgrade. Use Unit tests, typed and documented code to ensure its maintainability.
Installation requires Python 3.11 or later.
$ neo3-boa compile path/to/your/file.py
Note
When resolving compilation errors it is recommended to resolve the first reported error and try to compile again. An error can have a cascading effect and throw more errors all caused by the first.
from boa3.boa3 import Boa3
Boa3.compile_and_save('path/to/your/file.py')
You can read the docs here. Please check our examples for reference.
For an extensive collection of examples:
- Open-source Apache 2.0.