EVM integration

* EVM w/o rpc

* EVM client

* Impl self contaned calls

* Add eth preruntime

* Add balance precompile

* Quick fix

* Set ETH chain id to 1333

* Switch on asset-erc20 precompile

* Chg decimals for erc20

* Add call-permit precompile

* Add batch precompile

* Fix asset id parsing

* Add proxy precompile

* feat: evm assets

* Update precompiles.rs

decimals places 12 for P3Dt in EVM

* Update README.md

EVM interaction

* Update README.md

Validator set description

* Update README.md

spelling

* Update README.md

deterministic finality link

* Update comments

Copyright

* fix: metamask tokens compatibility

* Create README.md

validator set description

* Fake frontier import

* Add evm chain_id in runtime

* fix: evm address into account id

* Remove foreign asset pallet

* Chg decimals for P3D token

* check frontier preruntime

* Fix find preruntime digests

* Check frontier inherents and preruntime

* Stop old nodes

* Accept two preruntime before upgrade

* Chg Erc20 metadata

* Bump spev version (130)

* Cleanup precompiles utils

---------

Co-authored-by: MikhailK <mkornotmk@gmail.com>
Co-authored-by: Mikhail Fedosov <tbs.micle@gmail.com>
Co-authored-by: Paul <107915078+PaulSff@users.noreply.github.com>

Author: 4 people

Cargo.lock

@@ -5,3 +5,5 @@ members = [
 ]
 [profile.release]
 panic = 'unwind'
+
+workspace.resolver = "2"

Cargo.toml

@@ -7,15 +7,19 @@
 
 [Proof of Scan](https://3dpass.org/proof-of-scan) is a hybrid decentralized protocol "[PoW](https://github.com/3Dpass/3DP/wiki/Proof-of-Scan:-PoW-component-(ASIC%E2%80%90resistant)) `ASIC-resistant, CPU-oriented` + [PoA](https://github.com/3Dpass/3DP/wiki/Proof-of-Scan:-PoA-component) (Proof of Authority)", which is based on recognition technology. Every object, transformed by 3DPass, obtains its own unique and sustainable identity ([HASH ID](https://3dpass.org/features#recognition-hash-id)) the object can be recognized by. This will prevent the copying of digital assets and thus open a door for the entire blockchain space to potentially trillions in deals all over the globe.
 
-[Grid2d](https://3dpass.org/grid2d) is 3D shape recognition algorithm, which is utilized as one of hash functions in the Proof of Scan protocol. The implementations of the algorithm are the [pass3d](https://github.com/3Dpass/pass3d) recognition toolkit and its WASM analog [p3d](https://github.com/3Dpass/p3d). 
+[Grid2d](https://3dpass.org/grid2d) is 3D shape recognition algorithm, which is utilized as one of hash functions in the Proof of Scan protocol. The implementations of the algorithm are the [pass3d](https://github.com/3Dpass/pass3d) recognition toolkit and its WASM analog [p3d](https://github.com/3Dpass/p3d).
 
 [3DPRC-2](https://github.com/3Dpass/whitepaper/blob/main/3DPRC-2.md) (3Dpass Request for Comments) is a standard p2p protocol for the tokenization of the User objects operating within “The Ledger of Things”, by which the most useful aspect of the "Proof of Scan" consensus is getting uncovered. 3DPRC-2 provides decentralized [PoScan API](https://github.com/3Dpass/3DP/wiki/3DPRC%E2%80%902-PoScan-API) available for customers.
 
 The scope of potential 3Dpass applications goes way beyond 3D object recognition and not limited to. Being naturally organized and still cultivating this community driven spirit, 3Dpass is here to encourage developers from all around the globe to upgrade the pass3d open source toolkit with new fascinating recognition algorithms and make it even more useful for human civilization. Learn more about the [algorithm requirements](http://localhost:3000/proof-of-scan#object).
 
 [3DPass Coin (P3D)](https://3dpass.org/coin) is a native utility token, operating within "The Ledger of Things" eco-system, which aims to incentivize the efforts of community members maintaining the network infrastructure. Such aspects as: Storage fee, Gas fee, The object authentication fee, Transaction fee, The validator collaterals, Penalties - are all being counted in P3D.
 
+<<<<<<< HEAD
  [AI dev deepWiKi](https://deepwiki.com/3Dpass/3DP) | [Contribution Grant Program](https://3dpass.org/grants)  |  [Contributing guidelines](https://github.com/3Dpass/3DP/blob/main/CONTRIBUTING.md)  |  [Discord](https://discord.gg/u24WkXcwug)
+=======
+[Contribution Grant Program](https://3dpass.org/grants)  |  [Contributing guidelines](https://github.com/3Dpass/3DP/blob/main/CONTRIBUTING.md)  |  [Discord](https://discord.gg/u24WkXcwug)
+>>>>>>> b6e057cb (Update README.md)
 
 ## Getting started with 3Dpass Node
 
@@ -82,7 +86,7 @@ sh keygen_seed.sh
 The keys will be imported into `~/3dp-chain/chains/3dpass/keystore`
 
 #### Manual set up
-- Follow [manual set up guidelines](https://3dpass.org/mainnet#manual), if you'd like to set up your keys manually. 
+- Follow [manual set up guidelines](https://3dpass.org/mainnet#manual), if you'd like to set up your keys manually.
 Learn more about [addresses and keys](https://3dpass.org/mainnet#addresses).
 
 ### Run the Node
@@ -129,19 +133,50 @@ version: "3.9"
           - ADDRESS=PLACE MINER ADDRESS HERE
 
 ```
-You can generate your ADDRESS and MEMO_SEED phrase in the [wallet](https://wallet.3dpass.org/). 
+You can generate your ADDRESS and MEMO_SEED phrase in the [wallet](https://wallet.3dpass.org/).
 Follow this [tutorial](https://3dpass.org/mainnet#docker) for more details.
 
+##  Validator set (Masternodes)
+Validators represent a set of the most reliable Nodes (authorities) eligible to vote for Best chain finalization in accordance with the GRANDPA [deterministic finality](https://github.com/3Dpass/3DP/wiki/Proof-of-Scan:-PoA-component#deterministic-blockchain-finality) protocol rules. The validator set is open to join for any Node that meets the [SLA](https://3dpass.org/mainnet#validator-requirements) requirements. Current members are automatically selected and managed by the validator set module, which exploits a [collateral-based mechanism](https://3dpass.org/mainnet#validator-threshold) to prevent the protocol rules violations. Follow [this](https://3dpass.org/mainnet#validator) tutorial to set up Validator.
 
-## Connect to the wallet Front-end
+## Connect to the web3 wallet Front-end
 Open the wallet page: https://wallet.3dpass.org/. In order to connect your Node to the wallet in local you need to set up your local API endpoint as `ws://127.0.0.1:9944` in the Settings.
 Follow this [guidelines](https://3dpass.org/mainnet#wallet) for more details.
 
-##  Validator set (Masternodes)
-Validators represent a set of the most reliable Nodes (authorities) eligible to vote for Best chain finalization in accordance with the GRANDPA [deterministic finality](https://github.com/3Dpass/3DP/wiki/Proof-of-Scan:-PoA-component#deterministic-blockchain-finality) protocol rules. The validator set is open to join for any Node that meets the [SLA](https://3dpass.org/mainnet#validator-requirements) requirements. Current members are automatically selected and managed by the validator set module, which exploits a [collateral-based mechanism](https://3dpass.org/mainnet#validator-threshold) to prevent the protocol rules violations. Follow [this](https://3dpass.org/mainnet#validator) tutorial to set up Validator.
+## EVM and cross-platform options
+The Node is equipped with EVM compatibility layer comprised of the [EVM pallet](/pallets/evm) (Solidity code executor) as well as eth blockchain emulator with full client on top of the Substrate based master chain.
+
+### Connect to Metamask and Remix in Local
+- Run the Node with the `--rpc-port 9978` flag (any port can be set up)
+- Add a custom chain to the Metamask wallet:
+   - Name: `3dpass - The Ledger of Things (testnet)`
+   - Testnet chain id: `1333`
+   - RPC provider: `https://127.0.0.1:9978`
+- Open [Remix](https://remix.ethereum.org) and connect it through the Metamask to be able to deploy and run Solidity smart contracts
+
+### EVM accounts
+There is a cross-platform mapping in place between the Substrate (H256) and EVM (H160) accounts, which allows for cross
+platfom actions - native token transfers, assets methods, etc. E.g. you can transfer tokens from EVM to any Substrate account and vice versa.
+And every account must have its `H256` version.
+
+- H256 -> H160 (derived by cutting the tail 20 bytes)
+  - e.g. `0xc6006fea43ccce14f9432f8e6b9403113c935cc17160cd438af2e7a02624124c` -> `0xc6006fea43ccce14f9432f8e6b9403113c935cc1`
+- H160 (private key) -> H256 address (mapped, **irreversible**)
+  - e.g. `0xc6006fea43ccce14f9432f8e6b9403113c935cc1` -> `0xceb75620b9f3bc3a039b8e78efed58fa3c7422d18c97f1fd44abf3f2499d0760` (prefix 72: d7fJyRyHivFfDXsDs14oYgtqCt3scfHgaLT5NxHs5f6e5ycsN)
 
-## Assets 
-The [poScan](/pallets/poscan/) module serves as a mean of users' [objects authentication](https://3dpass.org/features#3dprc-2) within The Ledger of Things. 
+Use this [converter](https://hoonsubin.github.io/evm-substrate-address-converter/) to create a cross-platform alias for either Substrate or EVM account (testnet address prefix:`72`).
+
+### Custom precompiles
+Although the EVM exploits the [standard ethereum precompiles](https://github.com/3Dpass/3DP/tree/test/pallets/evm/precompile), there is a buch of
+[custom precompiles](/precompiles/), of which each one serves as a cross-platform `EVM -> Substrate` interface, so that native substrate functions can be called from Solidity.
+
+- Interaction with native token (P3Dt): [balances-erc20](/precompiles/balances-erc20) precompile, Contract address: `0x0000000000000000000000000000000000000802`
+- Interaction with Local assets 3DPRC2 - [assets-erc20](https://github.com/3Dpass/3DP/tree/test/precompiles/assets-erc20) precompile,
+Contract address format: `0xFBFBFBFA + <assetid in hex>`, where the `assetid` is the asset index in [poscanAssets]() runtime module.
+  e.g. You have created an asset with the `assetid 222`. The hex value of `222` is `DE`  . So, the `H160` address to run the contract at is going to be as follows: `0xFBFBFBFA000000000000000000000000000000DE`.
+
+## Assets
+The [poScan](/pallets/poscan/) module serves as a mean of users' [objects authenication](https://3dpass.org/features#3dprc-2) within The Ledger of Things.
 
 Additionally, the Node is equipped with the [poscanAssets](/pallets/poscan-assets/) module, which allows for Real World Objects (RWA) tokenization. Either [3DPRC2](https://3dpass.org/assets#3dprc-2) tokens or conventional [fungible tokens](https://3dpass.org/assets#conventional-assets) and NFTs can be issued.
 
@@ -151,7 +186,7 @@ The [assetConversion](/pallets/asset-conversion) module is a custom version of a
 ## "Ink" smart contracts
 The Node supports native Substrate Smart contract trait using [ink](https://use.ink/), a Rust-based embedded domain specific language (eDSL) for writing [WebAssembly](https://webassembly.org/) smart contracts. Learn [how ink can be compared to Solidity](https://use.ink/ink-vs-solidity/). Follow these [guidelines](https://3dpass.org/assets#smart-contracts) to run your smart contract on LoT.
 
-## Development
+## Development mode
 
 ### Single-Node Development Chain
 
@@ -194,15 +229,18 @@ target/release/poscan-consensus --base-path /tmp/bob --chain local --bob --port
 ```
 # Integration
 
-- NODE - the Node is based on [Substrate](https://substrate.io/) framework and implemented as two-piece design the `Rust native` part and the `Runtime` component ([WASM](https://webassembly.org/)-based), which is upgradable online and allows for multiple useful modules to operate (see more [forkless upgrade](https://3dpass.org/proof-of-scan#forkless-upgrade)). 
+# Integration
+
+- NODE - the Node is based on [Substrate](https://substrate.io/) framework and implemented as two-piece design the `Rust native` part and the `Runtime` component ([WASM](https://webassembly.org/)-based), which is upgradable online and allows for multiple useful modules to operate (see more [forkless upgrade](https://3dpass.org/proof-of-scan#forkless-upgrade)).
 - RPC (remote procedure call) - the capabilities that allow blockchain users to interact with the network. The NODE provides HTTP and [WebSocket](https://github.com/3Dpass/3DP/wiki/Set-up-WSS-for-Remote-Connections) RPC servers.
 - CORE Networking - the [`libp2p`](https://libp2p.io/) is used as as networking stack for the Nodes to communicate with each other.
 - [3Dpass light wallet](https://github.com/3Dpass/wallet) - desktop users and 3D printing labs integration
 - [Pass3d mobile](https://github.com/3Dpass/threedpass) - smartphone and tablets users integration
 
  <img width="719" alt="Node_integration" src="https://github.com/user-attachments/assets/93f186eb-c9db-4fd8-96b7-efc3b451a6b8">
- 
-### Responsibility disclaimer
+
+
+## Responsibility disclaimer
 This is an open source free p2p software. Use it at your own risk. 3dpass platform is non-profit and community-supported.
 
-Copyright (C) 2022-2025 3Dpass
+Copyright (C) 2002-2025 3Dpass https://3dpass.org/

README.md

@@ -0,0 +1,4 @@
+# Changelog for `fc-consensus`
+
+## Unreleased
+* Bump `fc-db` to `2.0.0-dev`

consensus/frontier/CHANGELOG.md

@@ -0,0 +1,29 @@
+[package]
+name = "fc-consensus"
+version = "2.0.0-dev"
+authors = ["Parity Technologies <admin@parity.io>"]
+edition = "2021"
+license = "GPL-3.0-or-later WITH Classpath-exception-2.0"
+description = "Frontier consensus for substrate"
+repository = "https://github.com/paritytech/frontier/"
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[dependencies]
+async-trait = "0.1"
+thiserror = "1.0"
+
+# Substrate
+sc-client-api = { version = "4.0.0-dev", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+sc-consensus = { version = "0.10.0-dev", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+sp-api = { version = "4.0.0-dev", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+sp-block-builder = { version = "4.0.0-dev", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+sp-blockchain = { version = "4.0.0-dev", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+sp-consensus = { version = "0.10.0-dev", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+sp-runtime = { version = "6.0.0", git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+
+# Frontier
+fc-db = { version = "2.0.0-dev", path = "../../frontier/db" }
+fp-consensus = { version = "2.0.0-dev", path = "../../primitives/consensus/evm" }
+fp-rpc = { version = "3.0.0-dev", path = "../../primitives/rpc" }

consensus/frontier/Cargo.toml

@@ -0,0 +1,160 @@
+// This file is part of 3DPass.
+//
+// Copyright (c) 2020-2022 Parity Technologies (UK) Ltd.
+// Copyright (c) 2025 3DPass
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+use std::{collections::HashMap, marker::PhantomData, sync::Arc};
+
+// Substrate
+use sc_client_api::{backend::AuxStore, BlockOf};
+use sc_consensus::{BlockCheckParams, BlockImport, BlockImportParams, ImportResult};
+use sp_api::{ProvideRuntimeApi, BlockId, Core};
+use sp_block_builder::BlockBuilder as BlockBuilderApi;
+use sp_blockchain::{well_known_cache_keys::Id as CacheKeyId, HeaderBackend};
+use sp_consensus::Error as ConsensusError;
+use sp_runtime::traits::{Block as BlockT, Header as HeaderT};
+// Frontier
+use fp_consensus::{ensure_log, FindLogError};
+use fp_rpc::EthereumRuntimeRPCApi;
+
+#[derive(Debug, thiserror::Error)]
+pub enum Error {
+	#[error("Multiple runtime Ethereum blocks, rejecting!")]
+	MultipleRuntimeLogs,
+	#[error("Runtime Ethereum block not found, rejecting!")]
+	NoRuntimeLog,
+	#[error("Cannot access the runtime at genesis, rejecting!")]
+	RuntimeApiCallFailed,
+}
+
+impl From<Error> for String {
+	fn from(error: Error) -> String {
+		error.to_string()
+	}
+}
+
+impl From<FindLogError> for Error {
+	fn from(error: FindLogError) -> Error {
+		match error {
+			FindLogError::NotFound => Error::NoRuntimeLog,
+			FindLogError::MultipleLogs => Error::MultipleRuntimeLogs,
+		}
+	}
+}
+
+impl From<Error> for ConsensusError {
+	fn from(error: Error) -> ConsensusError {
+		ConsensusError::ClientImport(error.to_string())
+	}
+}
+
+pub struct FrontierBlockImport<B: BlockT, I, C> {
+	inner: I,
+	client: Arc<C>,
+	backend: Arc<fc_db::Backend<B>>,
+	_marker: PhantomData<B>,
+}
+
+impl<Block: BlockT, I: Clone + BlockImport<Block>, C> Clone for FrontierBlockImport<Block, I, C> {
+	fn clone(&self) -> Self {
+		FrontierBlockImport {
+			inner: self.inner.clone(),
+			client: self.client.clone(),
+			backend: self.backend.clone(),
+			_marker: PhantomData,
+		}
+	}
+}
+
+impl<B, I, C> FrontierBlockImport<B, I, C>
+where
+	B: BlockT,
+	I: BlockImport<B, Transaction = sp_api::TransactionFor<C, B>> + Send + Sync,
+	I::Error: Into<ConsensusError>,
+	C: ProvideRuntimeApi<B> + Send + Sync + HeaderBackend<B> + AuxStore + BlockOf,
+	C::Api: EthereumRuntimeRPCApi<B>,
+	C::Api: BlockBuilderApi<B>,
+{
+	pub fn new(inner: I, client: Arc<C>, backend: Arc<fc_db::Backend<B>>) -> Self {
+		Self {
+			inner,
+			client,
+			backend,
+			_marker: PhantomData,
+		}
+	}
+}
+
+#[async_trait::async_trait]
+impl<B, I, C> BlockImport<B> for FrontierBlockImport<B, I, C>
+where
+	B: BlockT,
+	I: BlockImport<B, Transaction = sp_api::TransactionFor<C, B>> + Send + Sync,
+	I::Error: Into<ConsensusError>,
+	C: ProvideRuntimeApi<B> + Send + Sync + HeaderBackend<B> + AuxStore + BlockOf,
+	C::Api: EthereumRuntimeRPCApi<B>,
+	C::Api: BlockBuilderApi<B>,
+{
+	type Error = ConsensusError;
+	type Transaction = sp_api::TransactionFor<C, B>;
+
+	async fn check_block(
+		&mut self,
+		block: BlockCheckParams<B>,
+	) -> Result<ImportResult, Self::Error> {
+
+		let parent_id: BlockId<B> = BlockId::hash(block.parent_hash);
+
+		let ver = self.client
+			.runtime_api()
+			.version(&parent_id)
+			.map_err(|_err| Error::RuntimeApiCallFailed)?;
+
+		if ver.spec_version <= 128u32 {
+			return Ok(ImportResult::imported(true))
+		}
+
+		self.inner.check_block(block).await.map_err(Into::into)
+	}
+
+	async fn import_block(
+		&mut self,
+		block: BlockImportParams<B, Self::Transaction>,
+		new_cache: HashMap<CacheKeyId, Vec<u8>>,
+	) -> Result<ImportResult, Self::Error> {
+
+		let parent_id: BlockId<B> = BlockId::hash(*block.header.parent_hash());
+
+		let ver = self.client
+			.runtime_api()
+			.version(&parent_id)
+			.map_err(|_err| Error::RuntimeApiCallFailed)?;
+
+		if ver.spec_version <= 128u32 {
+			return Ok(ImportResult::imported(true))
+		}
+
+		// We validate that there are only one frontier log. No other
+		// actions are needed and mapping syncing is delegated to a separate
+		// worker.
+		ensure_log(block.header.digest()).map_err(Error::from)?;
+
+		self.inner
+			.import_block(block, new_cache)
+			.await
+			.map_err(Into::into)
+	}
+}

consensus/frontier/src/lib.rs

@@ -3,7 +3,7 @@ name = "sc-consensus-poscan"
 version = "0.9.0"
 authors = ["Parity Technologies <admin@parity.io>"]
 description = "PoW consensus algorithm for substrate"
-edition = "2018"
+edition = "2021"
 license = "GPL-3.0-or-later WITH Classpath-exception-2.0"
 homepage = "https://substrate.dev"
 repository = "https://github.com/paritytech/substrate/"
@@ -29,6 +29,7 @@ sp-consensus = { default-features = false, git = "https://github.com/paritytech/
 sp-application-crypto = { default-features = false, git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
 sp-timestamp = { default-features = false, git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
 sp-std = { default-features = false, git = "https://github.com/paritytech/substrate", rev = "b0777b4c7f7" }
+fp-consensus = { version = "2.0.0-dev", path="../../primitives/consensus/evm" }
 async-trait = "0.1.50"
 log = "0.4"
 futures = { version = "0.3", features = ["compat"] }