This section contains a short tutorial that guides you in configuring the C# development environment for QURAS smart contracts. It also gives you an idea of how to create a smart contract project and how to compile it.
Basic- How to use C# to write a QURAS smart contract
We currently recommend C# for developing smart contracts.
Development Tools
1. Visual Studio 2017
If you have already installed Visual Studio 2017 on your computer and checked for .NET Cross-Platform Development at the time of installation, you can skip this section.
Download and install: Visual Studio download address
The installation process is very simple, just follow the operation prompts step-by-step. It should be noted that you need to check the installation of .NET Core cross-platform development, otherwise you will not be able to open quras-vm project in step #3. The installation takes about ten minutes or up to an hour.
2. QurasContractPlugin
Installation method:
Open Visual Studio 2017, open Tools, click on Extensions and Updates, click on the Online tab on the left side of the window, search QURAS in the search box on the top right corner of the window, download the QurasContractPlugin (this step requires internet access).
3. quras-compiler
Installation and configuration steps:
Download the quras-compiler project on Github, open the solution with Visual Studio 2017, and publish the QURAS project
After the release is successful, the quras-msil-compile.exe file is generated in bin\Release\PublishOutput.
Or you can use the below command to generate quras-msil-compiler.exe
dotnet build --configuration Release
dotnet build --configuration Release --runtime win10-x64
We now need to add this directory to our execution path. The PATH is the system variable that your operating system uses to locate needed executables from the command line or Terminal window.
Windows 10
In Search, search for and then select: System (Control Panel) Click the Advanced system settings link. Click Environment Variables. In the section System Variables, find the PATH environment variable and select it. Click Edit. If the PATH environment variable does not exist, click New. In the Edit System Variable (or New System Variable) window, specify the value of the PATH environment variable. Click OK. Close all remaining windows by clicking OK.
Now run Command or PowerShell, and enter quras-msil-compile.exe. If there is no error and the output shows the version number (as shown), then the environment variable configuration is successful.
Create project
After the above installation configuration is successful, you can create a QurasContract project in Visual Studio 2017.
Compile the project
Everything is now ready to add the entry method that defines the smart contract:
After you compile it successfully you will see Contract1.avm in the bin/Debug directory, which is the file that is generated as the QURAS smart contract.
Everything is now ready to add the entry method that defines the smart contract:
After you compile it successfully you will see Contract1.avm in the bin/Debug directory, which is the file that is generated as the QURAS smart contract.