mirror of
https://github.com/pezkuwichain/revive.git
synced 2026-04-22 13:48:08 +00:00
Cyrill Leutwiler
7f81f37e0c
Pre-eliminary support for LLVM releases and resolc binary releases by streamlining the build process for all supported hosts platforms. - Introduce the revive-llvm-builder crate with the revive-llvm builder utilty. - Do not rely on the LLVM dependency in $PATH to decouple the system LLVM installation from the LLVM host dependency. - Fix the emscripten build by decoupling the host and native LLVM dependencies. Thus allowing a single LLVM emscripten release that can be used on any host platform. - An example Dockerfile building an alpine container with a fully statically linked resolc ELF binary. - Remove the Debian builder utilities and workflow.
78 lines
3.4 KiB
Markdown
78 lines
3.4 KiB
Markdown
|
|
[](https://contracts.polkadot.io)
|
|
|
|
# revive
|
|
|
|
YUL and EVM assembly recompiler to LLVM, targetting RISC-V on [PolkaVM](https://github.com/koute/polkavm).
|
|
|
|
Visit [contracts.polkadot.io](https://contracts.polkadot.io) to learn more about contracts on Polkadot!
|
|
|
|
## Status
|
|
|
|
This is experimental software in active development and not ready just yet for production usage. Please do report any compiler related issues or missing features that are [not yet known to us](https://contracts.polkadot.io/known_issues/) here.
|
|
|
|
Discussion around the development is hosted on the [Polkadot Forum](https://forum.polkadot.network/t/contracts-update-solidity-on-polkavm/6949#a-new-solidity-compiler-1).
|
|
|
|
## Installation
|
|
|
|
`resolc` depends on the [solc](https://github.com/ethereum/solidity) binary installed on your system.
|
|
|
|
Building from source requires a compatible LLVM build.
|
|
|
|
### LLVM
|
|
|
|
`revive` requires a build of LLVM v18.1.8 with the RISC-V _embedded_ target, including `compiler-rt`. Use the provided [revive-llvm](crates/llvm-builder/README.md) utility to compile a compatible LLVM build locally and point `$LLVM_SYS_181_PREFIX` to the installation directory afterwards.
|
|
|
|
### The `resolc` Solidity frontend
|
|
|
|
To install the `resolc` Solidity frontend executable:
|
|
|
|
```bash
|
|
# Build the host LLVM dependency with PolkaVM target support
|
|
make install-llvm
|
|
export LLVM_SYS_181_PREFIX=${PWD}/target-llvm/gnu/target-final
|
|
|
|
# Build the resolc frontend executable
|
|
make install-bin
|
|
resolc --version
|
|
```
|
|
|
|
### Cross-compilation to WASM
|
|
|
|
Cross-compile resolc.js frontend executable to Wasm for running it in a Node.js or browser environment. The `REVIVE_LLVM_TARGET_PREFIX` environment variable is used to control the target environment LLVM dependency.
|
|
|
|
```bash
|
|
# Build the host LLVM dependency with PolkaVM target support
|
|
make install-llvm
|
|
export LLVM_SYS_181_PREFIX=${PWD}/target-llvm/gnu/target-final
|
|
|
|
# Build the target LLVM dependency with PolkaVM target support
|
|
revive-llvm --target-env emscripten clone
|
|
source emsdk/emsdk_env.sh
|
|
revive-llvm --target-env emscripten build
|
|
export REVIVE_LLVM_TARGET_PREFIX=${PWD}/target-llvm/emscripten/target-final
|
|
|
|
# Build the resolc frontend executable
|
|
make install-wasm
|
|
make test-wasm
|
|
```
|
|
|
|
### Development
|
|
|
|
Please consult the [Makefile](Makefile) targets to learn how to run tests and benchmarks.
|
|
Ensure that your branch passes `make test` locally when submitting a pull request.
|
|
|
|
## Design overview
|
|
|
|
`revive` uses [solc](https://github.com/ethereum/solidity/), the Ethereum Solidity compiler, as the [Solidity frontend](crates/solidity/src/lib.rs) to process smart contracts written in Solidity. The YUL IR code (or legacy EVM assembly as a fallback for older `solc` versions) emitted by `solc` is then translated to LLVM IR, targetting [Polkadots `revive` pallet](https://docs.rs/pallet-revive/latest/pallet_revive/trait.SyscallDoc.html).
|
|
[Frontend](https://github.com/matter-labs/era-compiler-solidity) and [code generator](https://github.com/matter-labs/era-compiler-llvm-context) are based of ZKSync `zksolc`.
|
|
|
|
## Tests
|
|
|
|
Before running the tests, ensure that Geth (Go Ethereum) is installed on your system. Follow the installation guide here: [Installing Geth](https://geth.ethereum.org/docs/getting-started/installing-geth).
|
|
Once Geth is installed, you can run the tests using the following command:
|
|
|
|
```bash
|
|
make test
|
|
```
|