pchain_compile is a command line tool for reproducibly building Rust code into compact, gas-efficient WebAssembly ParallelChain Mainnet Smart Contracts.
pchain_compile builds the source code in a docker environment. To know more about Docker and install it, refer to the official instructions.
Suppose you have the source code of smart contract in the folder contract under your home directory.
text
/home/
|- user/
|- contract/
|- src/
|- lib.rs
|- Cargo.toml
To build smart contract into WebAssembly bytecode (file extension .wasm), you can simply run the program by specifying the arguments source and destination.
On a Linux Bash Shell:
```sh $ ./pchain_compile build --source /home/user/contract --destination /home/user/result Build process started. This could take several minutes for large contracts.
Finished compiling. ParallelChain Mainnet smart contract(s) ["contract.wasm"] are saved at (/home/user/result). ```
On a Windows Shell: ```powershell $ .pchain_compile.exe build --source 'C:\Users\usercontract' --destination 'C:\Users\user\result' Build process started. This could take several minutes for large contracts.
Finished compiling. ParallelChain Mainnet smart contract(s) ["contract.wasm"] are saved at (C:\Users\user\result). ```
Explanation about the command and its arguments can be displayed by appending "help" or "--help" to pchain_compile.
pchain_compile utilizes a docker_image hosted on a public DockerHub repository of ParallelChain see here for the build process. The docker image utilizes a toolchain whose components are shown below in the following table below:
|Toolchain Component | Utility
|:--- | :--- |
rustc | Compiler for Rust. |
wasm-snip (0.4.0) | WASM utility which removes functions that are never called at runtime. |
wasm-opt (109) | WASM utility to load WebAssembly in text format and run Binaryen IR passes to optimize its size. For more information on Binaryen IR see here. |