neo3-boa 1.1.0

A Python compiler for the Neo3 Virtual Machine

• Overview

  • Product Strategy

• Quickstart

  • Compiling your Smart Contract

• Docs

• Reference Examples

• License

Overview

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.

Product Strategy

Pure Python

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.

Neo Python Framework

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.

Testing against Neo VM

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.

Maintenance

Create a product that is easy to maintain and upgrade. Use Unit tests, typed and documented code to ensure its maintainability.

Quickstart

Installation requires Python 3.10 or later.

Compiling your Smart Contract

Using CLI

$ 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.

Using Python Script

from boa3.boa3 import Boa3

Boa3.compile_and_save('path/to/your/file.py')

Docs

You can read the docs here. Please check our examples for reference.

Reference Examples

For an extensive collection of examples:

• Smart contract examples

• Features tests

License

• Open-source Apache 2.0.