https://github.com/polkadot-evm/frontier

Ethereum compatibility layer for Substrate.
https://github.com/polkadot-evm/frontier

Last synced: 6 days ago
JSON representation

Ethereum compatibility layer for Substrate.

• Host: GitHub
• URL: https://github.com/polkadot-evm/frontier
• Owner: polkadot-evm
• License: apache-2.0
• Created: 2018-11-08T13:10:57.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-04-13T13:08:44.000Z (7 months ago)
• Last Synced: 2024-04-13T18:20:50.020Z (7 months ago)
• Language: Rust
• Homepage:
• Size: 68 MB
• Stars: 525
• Watchers: 21
• Forks: 424
• Open Issues: 122
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE2
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

• best-of-crypto - GitHub - 41% open · ⏱️ 31.05.2024): (Smart Contract Platforms)

README

        
# Polkadot Frontier

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/polkadot-evm/frontier/test.yml)](https://github.com/polkadot-evm/frontier/actions)

[![Matrix](https://img.shields.io/matrix/frontier:matrix.org)](https://matrix.to/#/#frontier:matrix.org)

Frontier is the EVM backbone of Polkadot.

## Features

Frontier provides a compatibility layer of EVM, so that you can run any Ethereum dapps on Polkadot, unmodified.

Using Frontier, you get access to all the Ethereum RPC APIs you are already familiar with, and therefore you can continue to develop your dapps in your favourite Ethereum developer tools.

As a bonus, you can even run many Ethereum L2s inside Frontier!

For those looking to become acquainted with Frontier, consult the documentation provided [here](./docs).

Additionally, a [template node](./template/README.md) is available to facilitate a more comprehensive technical exploration.

Frontier is also a migration framework.

Besides the common strategy of direct state export/import and transaction-level replays, Frontier's Pre-Log Wrapper Block feature provides a possible method for a zero-downtime live migration.

## Development workflow

### Pull request

All changes (except new releases) are handled through pull requests.

### Versioning

Frontier follows [Semantic Versioning](https://semver.org/).

An unreleased crate in the repository will have the `-dev` suffix in the end, and we do rolling releases.

When you make a pull request against this repository, please also update the affected crates' versions, using the following rules.

Note that the rules should be applied recursively -- if a change modifies any upper crate's dependency (even just the `Cargo.toml` file),

then the upper crate will also need to apply those rules.

Additionally, if your change is notable, then you should also modify the corresponding `CHANGELOG.md` file, in the "Unreleased" section.

If the affected crate already has `-dev` suffix:

* If your change is a patch, then you do not have to update any versions.

* If your change introduces a new feature, please check if the local version already had its minor version bumped, if not, bump it.

* If your change modifies the current interface, please check if the local version already had its major version bumped, if not, bump it.

If the affected crate does not yet have `-dev` suffix:

* If your change is a patch, then bump the patch version, and add `-dev` suffix.

* If your change introduces a new feature, then bump the minor version, and add `-dev` suffix.

* If your change modifies the current interface, then bump the major version, and add `-dev` suffix.

If your pull request introduces a new crate, please set its version to `1.0.0-dev`.