This is an open-source initiative for providing an easy access to on NEO ecosystem.
In particular, we provide simple interact and didactic interfaces for allowing online compiling for C#, Python, Go and Java.
- Tested with Firefox Quantum - 61.0.1
- Tested with Chromium - Version 73
- https://neocompiler.io, automatically generated from the source code located in this current repository.
- https://ecoservices.neocompiler.io
- C# RPC node with watch-only CN feature;
- https://neoscan.neocompiler.io or http://localhost:4000/ - (disabled as default) - it can be enable/disabled by acessing
.envfile;
- Compile input C#, Python, Go or Java code using reliable and safe servers (backend) compilers;
- Return AVM and ABI codes (more precise of C# compiler);
- Deploy and invoke code to private net, shared privatenet, testnet (unsafe), mainet (unsafe);
- Save your history of activies for testing a given smart contract;
- Tests with different wallets, synced and with able to provide historic data our activity;
- Perform all up-to-date blockchain invocations and RPC calls;
- Runs RPC with all enabled plugins and up-to-date features;
- Provide basic statistical data;
- Use websockets to provide some useful information;
- It can be used on TestNet, or even MainNet (however, this is extremely not recommended).
- Integrate with
neologin/O3wallet/neolinkproject (or any other), to allow secure key management for Test/MainNet - Move towards client-based compiling (more secure, robust and much more scalable).
- Some efforts have been done here already, but many technical challenges are still being dealt with;
- It has not been easy, still, to accomplish all necessary invocations only in the client side. On the other hand, the server has been responding smooth and nice, providing a nice didactic infrastructure to be used by professors, researchers and those interested on NEO's multi-language programming interface.
- Ideas? Collaborations are welcome :) The goal is to be didactic and bring it close to citizens and users: Smart Cities, Smart Governance and Smart Blockchain Technologies :P
We need docker-compose version 1.23.1 (or more), so we recommend the following steps for installation:
- Ubuntu-based distributions guidelines:
sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
echo "export PATH=\$PATH:/usr/local/bin/" >> ~/.bashrc
source ~/.bashrc
Docker technology is essential for sandboxing all compilers in different environments (for different languages).
We DO NOT recommend packages docker.io/docker-engine: sudo apt purge docker docker-engine docker.io.
- Ubuntu-based distributions guidelines:
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common gnupg2
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo apt-key fingerprint 0EBFCD88
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce
- Deepin users can follow Ubuntu instructions and use
bionic(Ubuntu 18.04) repository:sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"
sudo apt install apparmor=2.12-4ubuntu5(the official2.12-4version was denying network access to docker)
Adding user to docker group: sudo usermod -a -G docker $USER
The online command required to create our own NeoCompiler Ecosystem, suitable for private of public blockchain projects.
This will call a docker-compose with NeoCompiler Private Net (Eco) + NeoScan (optional). Furthermore, it will set all available compilers and open the front/backend interface and server, respectively.
./build_everything.sh
Basically, two steps are required: A1 and A2. Both are described below.
This script already builds the compilers and starts the server:
./buildCompilers.sh
- Build list with different versions for a given compiler, such as:
compilers/docker-compiler-csharp/docker_build_list_of_compilers.sh
Http front-end:
cd docker-http-express
docker_build.sh
docker-compose up
Compilers RPC API:
docker-sock-express-compilers/docker-ubuntu-docker-node-express
docker_build.sh
docker-sock-express-compilers/docker-compilers
docker-compose up
Eco Services:
docker-sock-express-compilers/docker-ubuntu-docker-node-express
docker_build.sh
docker-sock-express-compilers/docker-services
docker-compose up
The backend for C# is provided by mono, only two steps are necessary to build and tag image docker-mono-neo-compiler:
cd docker-neo-mono
docker_build.sh
The backend for Python is provided by neo-boa compiler, only two steps are necessary to build and tag image docker-neo-boa:
cd docker-neo-boa
docker_build.sh
The backend for Go is provided by neo-go team, only two steps are necessary to build and tag image docker-neo-go:
cd docker-neo-go
docker_build.sh
The backend for Java is provided by neoj compiler (in mono), only two steps are necessary to build and tag image docker-neo-java-compiler:
cd docker-java
docker_build.sh
Docker-compose is the main tools that acts for the creation of our micro-service.
This script will start all necessary backend functionalities, neo-csharp-nodes and neo-scan (optional, check .env).
In particular, we currently have:
- csharp nodes are with TCP at 2033x and RPC at 3033X, websocket is not being used
- 4 csharp consensus node, two of them are also a RPC as default at port 30333 and 30334;
- 1 csharp pure RPC nodes at 30337;
- optional neoscan full (with images obtained at https://gitlab.com/CityOfZion/neo-scan/container_registry: neoscan-full and postgress container;
Start up the container, checking the messages and following warnings
Simply run runEco_network.sh (integrated with .env file)
or:
cd ./docker-compose-eco-network
docker-compose up
Start up the container in a detached mode
docker-compose up -d
Feel free to take is down
docker-compose down
However, consider stopping and restarting
docker-compose stop
docker-compose start
It is also possible to integrate the Eco Network with lighwallet and explorers.
One could check docker docker-compose.yml, picking up a combination of your choice from docker-compose-eco-network folder.
This can be done for locally modifying some characteristics.
Run build_everything.sh with an additional parameter --no-build and your modified files of the private net will be called.
docker exec -it eco-neo-csharp-node1-running bashscreen -drwill show the screen/opt/run.shwill start a new screen (if you killed the last process);/opt/start_node.shwill start the node directly in the terminal.
-
If you have ideas or issues, you can inform directly at github or contact us directly
- Check the open issues and pull requests for existing discussions.
- Open an issue first, to discuss a new feature or enhancement.
- Write tests, and make sure the test suite passes locally and on CI.
- Open a pull request, and reference the relevant issue(s).
- After receiving feedback, squash your commits and add a great commit message.
- Run
make push-tagafter merging your pull request. - Anyway, you already were part of team... :P
-
Our team is currently formed by researchers/professors, so our time is very constrained... if you feel you can help us, don't hesitate!
-
We created a wallet specially for project donations. That can help us improve our servers and perhaps hire someone for improving graphical interfaces and developing many more interesting features. NEO wallet: AJX1jGfj3qPBbpAKjY527nPbnrnvSx9nCg
LICENSE MIT
This project is part of NeoResearch initiative and it is freely available at NeoCompiler.io. The website is rebooted periodically, in order to keep resource usage low, so that everyone is welcome to use it.
NeoCompiler Eco team @igormcoelho and @vncoelho
Copyleft 2017-2019