• This repository has been archived on 15/Nov/2021
  • Stars
    star
    315
  • Rank 132,951 (Top 3 %)
  • Language
    Python
  • License
    MIT License
  • Created over 7 years ago
  • Updated about 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Python Node and SDK for the NEO 2.x blockchain. For NEO 3.x go to our successor project neo-mamba

CoZ logo

Deprecated

Neo-python was for version 2.x of the NEO Network. neo-mamba is its successor for NEO 3.x and beyond.

neo-python

Python Node and SDK for the NEO blockchain.

Pypi Travis CI ReadTheDocs Coveralls

Overview

What does it currently do

  • This project aims to be an alternative implementation for the original C# NEO project
  • Run a Python based P2P node
  • Interactive CLI for configuring node and inspecting blockchain
  • Compile, test, deploy and run Smart Contracts written in Python or any smart contract in the .avm format
  • Runs smart contracts on the blockchain in a Python virtual machine
  • Very basic Wallet functionality (not fully tested, please do not use on mainnet)
  • NEP2 and NEP5 compliant wallet functionality
  • NEP-7 and NEP-8 support
  • RPC Client
  • RPC server
  • Notification Server ( for viewing transfers of NEP5 tokens )
  • Runtime.Log and Runtime.Notify event monitoring

What will it do

  • Consensus nodes
  • More robust smart contract debugging and inspection

Documentation

The full documentation on how to install, configure and use neo-python can be found at Read The Docs.

Get help or give help

  • Open a new issue if you encounter a problem.
  • Or ping @ixje on the NEO Discord.
  • Pull requests welcome. Have a look at the issue list for ideas. You can help with wallet functionality, writing tests or documentation, or on any other feature you deem awesome.

Getting started

neo-python has two System dependencies (everything else is covered with pip):

We have published a Youtube video to help get you started. There are many more videos under the CityOfZion Youtube channel, check them out.

Docker

Using Docker is another option to run neo-python. There are example Dockerfiles provided in the /docker folder, and we have an image on Docker hub, tagged after the neo-python releases: https://hub.docker.com/r/cityofzion/neo-python/

Native installation

Instructions on the system setup for neo-python:

LevelDB

OSX
brew install leveldb
Ubuntu/Debian 18.04+

At the time of writing this message Ubuntu's package manager only lists Python 3.7.0. Variously memory leaks have been addressed since and it is recommended to run Python 3.7.3 or newer. Read this Ubuntu guide on how to add an alternative PPA to your sources list to install from or how to compile the latest version manually.

Centos/Redhat/Fedora

Note: - Not tested -

Please correct the REAMDE if there are issues. Install Python 3.7.3 following this CentOS guide.

Windows

Currently, you should use the Linux subsystem with Ubuntu, or a Virtual Machine with Linux. You can find more information and a guide for setting up the Linux subsystem here.

Installing "Ubuntu" from Microsoft Store installs Ubuntu 16.04. You should install Ubuntu 18.04 from Microsoft Store found here: https://www.microsoft.com/en-us/p/ubuntu-1804/9n9tngvndl3q?activetab=pivot%3aoverviewtab

Help needed for running natively. Installing the Python package plyvel seems to require C++ compiler support tied to Visual Studio and libraries. Refer to documentation.

Python 3.7+

neo-python is compatible with Python 3.7 and later.

On *nix systems, install Python Python 3.7 via your package manager, or download an installation package from the official homepage.

Install

It is recommended to put all project dependencies into its own virtual environment, this way we don't pollute the global installation which could lead to version conflicts.

  1. Install from Github:
git clone https://github.com/CityOfZion/neo-python.git
cd neo-python

# if you want to use the development branch, switch now
git checkout development

# create virtual environment using Python 3.7 and activate or skip to the next step for Python 3.6
python3.7 -m venv venv
source venv/bin/activate

# install the package in an editable form
(venv) pip install wheel -e .
  1. Install from PyPi
# create project dir
mkdir myproject
cd myproject

# create virtual environment using Python 3.7 and activate or skip to the next step for Python 3.6
python3.7 -m venv venv
source venv/bin/activate

(venv) pip install wheel neo-python

Running

After installing requirements and activating the environment, there is an easy to use CLI (np-prompt) that starts the node and allows some basic interactivity.

np-prompt
NEO cli. Type 'help' to get started

neo> show state
Progress: 10926 / 11145
Block-cache length 0
Blocks since program start 0
Time elapsed 0.02598465 mins
Blocks per min 0
TPS: 0

neo>

By default, the CLI connects to the TestNet (see below how to switch to MainNet or PrivNet).

Let's query for a block in the current server by hash or by block index:

np-prompt
NEO cli. Type 'help' to get started

neo> show block 122235
{
    "hash": "0xf9d7bc6f337a6cbe124b92b90ad7b29e2628e78202ea2daa19ed93fdc779c0e6",
    "size": 686,
    "version": 0,
    "previousblockhash": "0x1f262a0979d6da0eabaaf54252fb2508564a99fee642a77ff0773671fe5fddb9",
    "merkleroot": "0x5d4f86734c2a53187aa96751b9180d69f85f9bd7875f2eb83a27666ad052ea1e",
    "time": 1496920870,
    "index": 122235,
    "nonce": "7847dea9df7571c1",
    "nextconsensus": "AdyQbbn6ENjqWDa5JNYMwN3ikNcA4JeZdk",
    "script": {
        "invocation": "40e5a7d23cb065308412d769ca2ba6dd974aa453d0c915c25a7d951488eaa6c4eff5bbe251f01725b959fb89e7dd631f7f41efd50897c466d75e8359154f6137bf402f690a98a44e5ecb22e7f20bb75bac40cac89f4805f4706ec9daf8e6ccc15def216d667423bb148e78db9461e288d7363f699741a0efb4c7c6c6dc902250cf3f4023ba2eb464aa8841cb2230c0f9f016a47c1e54e1f809da550743c33b0529b5996f4c5993a38bb73887e0b3fd7a093f6abd00d136048169a99cf34373560b8956408e816d0a0b018c348070da63f513b5b3332ef31914c420203b792f25048c1b8b397bc4bd47315be44491f7182be8aeca39035a2cd51a20da034820e5e1b5c0644052ce1cb6769e9dc9375ea96db8d538e6b2210a093c555f759ccf1d908f8c2fe3cf6236c4dade54ebca825a36e81049c7f4b149c1458c30b37460fc22581201f2",
        "verification": "55210209e7fd41dfb5c2f8dc72eb30358ac100ea8c72da18847befe06eade68cebfcb9210327da12b5c40200e9f65569476bbff2218da4f32548ff43b6387ec1416a231ee821034ff5ceeac41acf22cd5ed2da17a6df4dd8358fcb2bfb1a43208ad0feaab2746b21026ce35b29147ad09e4afe4ec4a7319095f08198fa8babbe3c56e970b143528d2221038dddc06ce687677a53d54f096d2591ba2302068cf123c1f2d75c2dddc542557921039dafd8571a641058ccc832c5e2111ea39b09c0bde36050914384f7a48bce9bf92102d02b1873a0863cd042cc717da31cea0d7cf9db32b74d4c72c01b0011503e2e2257ae"
    },
    "tx": [
        {
            "txid": "0x5d4f86734c2a53187aa96751b9180d69f85f9bd7875f2eb83a27666ad052ea1e",
            "size": 10,
            "type": "MinerTransaction",
            "version": 0,
            "attributes": [],
            "vout": [],
            "vin": [],
            "sys_fee": "0",
            "net_fee": "0",
            "scripts": [],
            "nonce": 3749016001
        }
    ]
}
neo>

Bootstrapping the Blockchain

If you use neo-python for the first time, you need to synchronize the blockchain, which may take a long time. Included in this project is the script np-bootstrap to automatically download a chain directory for you.

np-bootstrap Usage
$ np-bootstrap -h
usage: np-bootstrap [-h] [-m] [-c CONFIG] [-n] [-s] [--datadir DATADIR]

optional arguments:
  -h, --help            show this help message and exit
  -m, --mainnet         use MainNet instead of the default TestNet
  -c CONFIG, --config CONFIG
                        Use a specific config file
  -n, --notifications   Bootstrap notification database
  -s, --skipconfirm     Bypass warning about overwriting data in Chains
  -k, --keep-bootstrap-file
                        Keep the downloaded bootstrap file
  --datadir DATADIR     Absolute path to use for database directories
Bootrapping Testnet

To bootstrap the testnet blockchain, run np-bootstrap, get a cup of coffee and wait. Then, bootstrap the testnet notifications database with np-bootstrap -n.

Bootstrapping Mainnet

To bootstrap the mainnet blockchain, run np-bootstrap -m and get 8 cups of coffee (9+ GB file). Then, bootstrap the mainnet notifications database with np-bootstrap -m -n.

Important: do not use the chain files from https://github.com/CityOfZion/awesome-neo.git, they will not work with neo-python.

Basic Wallet commands

wallet create {wallet_path}
wallet open {wallet_path}
wallet close

wallet (verbose)
wallet rebuild (start block)

wallet import wif {wif}
wallet export wif {address}

wallet send {args}       # (NEO/GAS)
wallet token send {args} # NEP5

For a complete list of commands use help.

Running on MainNet

To run the prompt on MainNet, you can use the CLI argument -m (eg. np-prompt -m), for running on PrivNet you can use -p. Be sure to check out the details of the parameters:

$ np-prompt -h
usage: np-prompt [-h] [-m | -p [host] | --coznet | -c CONFIG]
                 [-t {dark,light}] [-v] [--datadir DATADIR] [--version]

optional arguments:
  -h, --help            show this help message and exit
  -m, --mainnet         Use MainNet instead of the default TestNet
  -p [host], --privnet [host]
                        Use a private net instead of the default TestNet,
                        optionally using a custom host (default: 127.0.0.1)
  --coznet              Use the CoZ network instead of the default TestNet
  -c CONFIG, --config CONFIG
                        Use a specific config file
  -t {dark,light}, --set-default-theme {dark,light}
                        Set the default theme to be loaded from the config
                        file. Default: 'dark'
  -v, --verbose         Show smart-contract events by default
  --datadir DATADIR     Absolute path to use for database directories
  --maxpeers MAXPEERS   Max peers to use for P2P Joining
  --version             show program's version number and exit

Logging

Currently, np-prompt logs to prompt.log

Tests

Note we make use of a Blockchain fixture database (~15 MB). This file is not kept in the repo, but is downloaded the first time the tests are run, this can take some time (depending on the internet connection), but happens only once.

Useful commands

make lint
make test
make coverage
make docs


# run only neo-python tests
python -m unittest discover neo

# run only neo-boa tests
python -m unittest discover boa_test

Updating the version number and releasing new versions of neo-python

This is a checklist for releasing a new version, which for now means:

  1. Merging the changes from development into master
  2. Setting the version from eg. 0.4.6-dev to 0.4.6 (which automatically created a tag/release)
  3. On the dev branch, setting the version to the next patch, eg. 0.4.7-dev
  4. Pushing master, development and the tags to GitHub

Make sure you are on the development branch and have all changes merged that you want to publish. Then follow these steps:

# Only in case you want to increase the version number again (eg. scope changed from patch to minor):
# bumpversion --no-tag minor|major

# Update CHANGELOG.rst: make sure all changes are there and remove `-dev` from the version number
vi CHANGELOG.rst
git commit -m "Updated changelog for release" CHANGELOG.rst

# Merge development branch into master
git checkout master
git merge development

# Set the release version number and create the tag
bumpversion release

# Switch back into the development branch
git checkout development

# Increase patch number and add `-dev`
bumpversion --no-tag patch

# Push to GitHub, which also updates the PyPI package and Docker Hub image
git push origin master development --tags

Troubleshooting

If you run into problems, check these things before ripping out your hair:

  • Double-check that you are using Python 3.7.x
  • Update the project dependencies (pip install -e .)
  • If you encounter any problems, please take a look at the installation section in the docs, and if that doesn't help open an issue. We'll try to help.
  • You can reach us on the NEO Discord, or simply file a GitHub issue.

License

Donations

Accepted at ATEMNPSjRVvsXmaJW4ZYJBSVuJ6uR2mjQU

More Repositories

1

neon-wallet

Light wallet for the NEO blockchain
JavaScript
1,026
star
2

awesome-neo

Resources for working with the NEO blockchain
252
star
3

neon-js

Javascript libraries that allow the applications to interact with NEO blockchain
TypeScript
183
star
4

python-smart-contract-workshop

Workshop for programming smart contracts with Python
Python
72
star
5

neo-js

Running NEO blockchain full node with Node.js and MongoDB.
TypeScript
70
star
6

neo-scan

Blockchain explorer for NEO
Elixir
70
star
7

neo-boa

Python compiler for the Neo2 Virtual Machine, see neo3-boa for NEO3
Python
69
star
8

neo-swift

Swift Wrapper for Neo Blockchain API
Swift
55
star
9

neo-privatenet-docker

Private blockchain network for NEO development in a single Docker container
Python
54
star
10

neo-local

Personal blockchain for NEO dApp development!
Python
52
star
11

neo3-boa

Write smart contracts for Neo3 in python
Python
38
star
12

OzoneWalletIOS

The main repo for the O3 wallet on iOS
Swift
38
star
13

neo-storm

Smart contract framework for the NEO smart economy written in the Go programming language.
Go
38
star
14

neo-go-sdk

Golang SDK for the NEO blockchain
Go
36
star
15

neo-sharp

Neo-sharp is a new core and node implementation of NEO focused on modular design, best coding practices and testability.
C#
35
star
16

neon-wallet-db

Serves neo blockchain data to light wallets
Python
28
star
17

neo-python-rpc

A Python RPC Client for the NEO2 Blockchain, see neo-mamba for NEO3
Python
25
star
18

neo-mamba

Python SDK for the NEO3 blockchain
Python
22
star
19

neo-api-js

JavaScript API for connecting to a NEO Network
JavaScript
21
star
20

neo-python-core

Outdated - use updated code integrated in neo-python instead
Python
18
star
21

neo-gui-developer

neo-gui with features for developers
C#
18
star
22

neo-smart-contract-examples

Python
15
star
23

neo-php

A php wrapper for the neo blockchain
PHP
14
star
24

neo-gql

A GraphQL Blockchain Explorer for Neo.
Ruby
13
star
25

neo-ruby

Ruby library for interacting with the NEO blockchain
Ruby
13
star
26

standards

CoZ standards for everything.
Shell
12
star
27

neon-wallet-react-native

JavaScript
12
star
28

wallet-connect-sdk

A Wallet Connect SDK for ecosystem tools
TypeScript
11
star
29

neo-mon

Neo Network Status Monitor
JavaScript
11
star
30

dora

TypeScript
11
star
31

neo-tokens

A list of NEP5 tokens on MainNet
JavaScript
11
star
32

cpm

Contract Package Manager
Go
10
star
33

dAppTemplate_MEAN

This template is designed to accelerate dApp development on the neo blockchain by providing a full-stack scaffold that runs and interfaces with fullnodes
JavaScript
9
star
34

cityofzion.github.io

Our spartan simple homepage.
HTML
8
star
35

neo-java

Java
7
star
36

neo-toolbox

Toolbox of functions handy for NEO development
Vue
7
star
37

neo-js-compiler

a javascript to bytecode compiler for the neo platform
JavaScript
6
star
38

neo-plugins-coz

Community-built plugins for neo-cli
C#
6
star
39

neo-java-sdk

Java SDK for the NEO blockchain.
6
star
40

coz-slack-ico-management-platform

JavaScript
6
star
41

governance

Rules of Zion
6
star
42

neo-node-ansible-scripts

Ansible playbooks for securing and setting up Ubuntu servers as NEO nodes
Shell
6
star
43

neo-discord-bot

JavaScript
6
star
44

neo-ruby-sdk

A Ruby SDK for smart contract development on the Neo blockchain.
6
star
45

neon-wallet-website

https://neonwallet.com
JavaScript
6
star
46

neo-hypervm

neo-hypervm aims to be a virtual machine in C ++ 100% compatible with the NEO standard.
C
6
star
47

cityofzion-website

New website source for cityofzion.io
JavaScript
6
star
48

neo-slack-bot

JavaScript
6
star
49

neon-wallet-desktop

Your self-custodial, open-source blockchain wallet
TypeScript
6
star
50

phishing

A list of phishing sites and NEO addresses to be blocked
5
star
51

dora-sdk-ts

a typescript sdk for dora
TypeScript
5
star
52

neo3-preview

A block explorer and preview of the NEO 3.0 ecosystem
JavaScript
5
star
53

props

Ecosystem props than can be used to enhance project functionality
TypeScript
5
star
54

neo-compiler-docker

Compile NEO smart contracts using Docker
Makefile
4
star
55

mithackton

MIT hackton rules
4
star
56

neochat

Elixir
4
star
57

neo3-invoker

A declarative SmartContract Invocation Spec.
HTML
3
star
58

neosign

Utility for signing arbitrary messages with NEP2 Keypairs or WIF
Python
3
star
59

visual-identity

This is a repository for common styles, images and icons
JavaScript
3
star
60

neo-tools

Composable command line tools for exchanges, price lookup, Neo APIs, and reference implementations for Neo Smart Economy function primitives
JavaScript
3
star
61

smart-contract-examples-csharp

example smart contracts to be used with c# implementation of NEO
C#
3
star
62

tokens

A list of NEP5 tokens on the NEO blockchain
Python
3
star
63

website-deprecated

Repo for the uncompiled version of cityofzion.io
CSS
3
star
64

inbox

End-to-end encrypted message on Neo blockchain
JavaScript
3
star
65

BigIntegerCpp

C++ port of the C# BigInteger class
C++
2
star
66

neofs-demo

JavaScript
2
star
67

neon-dappkit

Neon-DappKit is the easiest way to build a dApp on Neo3. Suitable to connect Web Applications, Off-chain JS Servers and React-Native Apps to the Neo3 Blockchain.
TypeScript
2
star
68

neo-local-faucet

Node faucet for neo-local
JavaScript
2
star
69

ledger-app-neo3

Nano S/X app for NEO3, has moved to the official ledger repo https://github.com/LedgerHQ/app-neo3
C
2
star
70

Neodius

PHP
2
star
71

neon-wallet-tokens

Serves a curated and up to date list of token hashes.
HTML
2
star
72

progress-summary

Summary tool for neo-project, neo-ngd, CityOfZion, NewEconoLab and NeoResearch
TypeScript
2
star
73

coz-neo-mobile-wallet

JavaScript
2
star
74

Poseidon-SDK

Go
2
star
75

neoscan-status-reporter

JavaScript
2
star
76

neo3crypto

Native NEO3 cryptographic functions for Python
C++
2
star
77

coz-slack-anti-reminder

JavaScript
1
star
78

neo3-explorer-api

REST API for the Neo3 block explorer
Python
1
star
79

neo-fast-download

Elixir
1
star
80

ICO-Templates

A curated collection of ICO templates for the NEO Blockchain
1
star
81

NEO-git-activity

http://cityofzion.io/NEO-git-activity/
JavaScript
1
star
82

blockchain-services

TypeScript
1
star
83

dora_docs

1
star
84

util

support utilities for the city of zion project
Python
1
star
85

developer-portal

JavaScript
1
star
86

neo3vm

C++ port of the NEO3 VM
1
star
87

neo-admin-portal

JavaScript
1
star