Skip to content

Commit 2f5afde

Browse files
nhussein11Copilot
andauthored
[FIX] - Update substrate node to revive dev node (#919)
* Update local development node documentation and configuration to revive-dev-node * Update develop/smart-contracts/local-development-node.md Co-authored-by: Copilot <[email protected]> * Update develop/smart-contracts/local-development-node.md Co-authored-by: Copilot <[email protected]> * Update develop/smart-contracts/local-development-node.md Co-authored-by: Copilot <[email protected]> * fix: llms --------- Co-authored-by: Copilot <[email protected]>
1 parent e9bd77d commit 2f5afde

File tree

6 files changed

+44
-40
lines changed

6 files changed

+44
-40
lines changed

.snippets/code/develop/smart-contracts/local-development-node/local-development-node-1.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<div id="termynal" data-termynal>
2-
<span data-ty="input"><span class="file-path"></span>./target/release/substrate-node --dev</span>
2+
<span data-ty="input"><span class="file-path"></span>./target/release/revive-dev-node --dev</span>
33
<br />
44
<span data-ty>2025-05-29 10:42:35 Substrate Node</span>
55
<span data-ty>2025-05-29 10:42:35 ✌️ version 3.0.0-dev-38b7581fc04</span>

develop/smart-contracts/local-development-node.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Local Development Node
3-
description: Follow this step-by-step guide to install a Substrate node and ETH-RPC adapter for smart contract development in a local environment.
3+
description: Follow this step-by-step guide to install a Revive Dev node and ETH-RPC adapter for smart contract development in a local environment.
44
categories: Smart Contracts
55
---
66

@@ -14,7 +14,7 @@ A local development node provides an isolated blockchain environment where you c
1414

1515
By the end of this guide, you'll have:
1616

17-
- A running Substrate node with smart contract support.
17+
- A running node with smart contract support.
1818
- An ETH-RPC adapter for Ethereum-compatible tooling integration accessible at `http://localhost:8545`.
1919

2020
## Prerequisites
@@ -23,35 +23,36 @@ Before getting started, ensure you have done the following:
2323

2424
- Completed the [Install Polkadot SDK Dependencies](/develop/parachains/install-polkadot-sdk/){target=\_blank} guide and successfully installed [Rust](https://www.rust-lang.org/){target=\_blank} and the required packages to set up your development environment.
2525

26-
## Install the Substrate Node and ETH-RPC Adapter
26+
## Install the Revive Dev Node and ETH-RPC Adapter
2727

28-
The Polkadot SDK repository contains both the [Substrate node](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/bin/node){target=\_blank} implementation and the [ETH-RPC adapter](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive/rpc){target=\_blank} required for Ethereum compatibility. Start by cloning the repository and navigating to the project directory:
28+
The Polkadot SDK repository contains both the [Revive Dev node](https://github.com/paritytech/polkadot-sdk/tree/{{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}/substrate/frame/revive/dev-node){target=\_blank} implementation and the [ETH-RPC adapter](https://github.com/paritytech/polkadot-sdk/tree/{{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}/substrate/frame/revive/rpc){target=\_blank} required for Ethereum compatibility. Start by cloning the repository and navigating to the project directory:
2929

3030
```bash
31-
git clone -b {{dependencies.repositories.polkadot_sdk_contracts_node.version}} https://github.com/paritytech/polkadot-sdk.git
31+
git clone https://github.com/paritytech/polkadot-sdk.git
3232
cd polkadot-sdk
33+
git checkout {{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}
3334
```
3435

3536
Next, you need to compile the two essential components for your development environment. The Substrate node provides the core blockchain runtime with smart contract support, while the ETH-RPC adapter enables Ethereum JSON-RPC compatibility for existing tooling:
3637

3738
```bash
38-
cargo build --bin substrate-node --release
39+
cargo build -p revive-dev-node --bin revive-dev-node --release
3940
cargo build -p pallet-revive-eth-rpc --bin eth-rpc --release
4041
```
4142

4243
The compilation process may take some time depending on your system specifications, potentially up to 30 minutes. Release builds are optimized for performance but take longer to compile than debug builds. After successful compilation, you can verify the binaries are available in the `target/release` directory:
4344

44-
- **Substrate node path**: `polkadot-sdk/target/release/substrate-node`
45+
- **Revive Dev node path**: `polkadot-sdk/target/release/revive-dev-node`
4546
- **ETH-RPC adapter path**: `polkadot-sdk/target/release/eth-rpc`
4647

4748
## Run the Local Node
4849

4950
With the binaries compiled, you can now start your local development environment. The setup requires running two processes.
5051

51-
Start the Substrate node first, which will initialize a local blockchain with the `dev` chain specification. This configuration includes `pallet-revive` for smart contract functionality and uses pre-funded development accounts for testing:
52+
Start the node first, which will initialize a local blockchain with the `dev` chain specification. This configuration includes `pallet-revive` for smart contract functionality and uses pre-funded development accounts for testing:
5253

5354
```bash
54-
./target/release/substrate-node --dev
55+
./target/release/revive-dev-node --dev
5556
```
5657

5758
The node will begin producing blocks immediately and display initialization logs:
@@ -61,10 +62,10 @@ The node will begin producing blocks immediately and display initialization logs
6162
For debugging purposes or to monitor low-level operations, you can enable detailed logging by setting environment variables before running the command:
6263

6364
```bash
64-
RUST_LOG="error,evm=debug,sc_rpc_server=info,runtime::revive=debug" ./target/release/substrate-node --dev
65+
RUST_LOG="error,evm=debug,sc_rpc_server=info,runtime::revive=debug" ./target/release/revive-dev-node --dev
6566
```
6667

67-
Once the Substrate node is running, open a new terminal window and start the ETH-RPC adapter. This component translates Ethereum JSON-RPC calls into Substrate-compatible requests, allowing you to use familiar Ethereum tools like MetaMask, Hardhat, or Ethers.js:
68+
Once the node is running, open a new terminal window and start the ETH-RPC adapter. This component translates Ethereum JSON-RPC calls into Substrate-compatible requests, allowing you to use familiar Ethereum tools like MetaMask, Hardhat, or Ethers.js:
6869

6970
```bash
7071
./target/release/eth-rpc --dev
@@ -74,7 +75,7 @@ You should see logs indicating that the adapter is ready to accept connections:
7475

7576
--8<-- 'code/develop/smart-contracts/local-development-node/local-development-node-2.html'
7677

77-
Similar to the Substrate node, you can enable detailed logging for the ETH-RPC adapter to troubleshoot issues:
78+
Similar to the Revive Dev node, you can enable detailed logging for the ETH-RPC adapter to troubleshoot issues:
7879

7980
```bash
8081
RUST_LOG="info,eth-rpc=debug" ./target/release/eth-rpc --dev

llms-files/llms-smart-contracts.txt

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3408,7 +3408,7 @@ Doc-Content: https://docs.polkadot.com/develop/smart-contracts/local-development
34083408
--- BEGIN CONTENT ---
34093409
---
34103410
title: Local Development Node
3411-
description: Follow this step-by-step guide to install a Substrate node and ETH-RPC adapter for smart contract development in a local environment.
3411+
description: Follow this step-by-step guide to install a Revive Dev node and ETH-RPC adapter for smart contract development in a local environment.
34123412
categories: Smart Contracts
34133413
---
34143414

@@ -3423,7 +3423,7 @@ A local development node provides an isolated blockchain environment where you c
34233423

34243424
By the end of this guide, you'll have:
34253425

3426-
- A running Substrate node with smart contract support.
3426+
- A running node with smart contract support.
34273427
- An ETH-RPC adapter for Ethereum-compatible tooling integration accessible at `http://localhost:8545`.
34283428

34293429
## Prerequisites
@@ -3432,41 +3432,42 @@ Before getting started, ensure you have done the following:
34323432

34333433
- Completed the [Install Polkadot SDK Dependencies](/develop/parachains/install-polkadot-sdk/){target=\_blank} guide and successfully installed [Rust](https://www.rust-lang.org/){target=\_blank} and the required packages to set up your development environment.
34343434

3435-
## Install the Substrate Node and ETH-RPC Adapter
3435+
## Install the Revive Dev Node and ETH-RPC Adapter
34363436

3437-
The Polkadot SDK repository contains both the [Substrate node](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/bin/node){target=\_blank} implementation and the [ETH-RPC adapter](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive/rpc){target=\_blank} required for Ethereum compatibility. Start by cloning the repository and navigating to the project directory:
3437+
The Polkadot SDK repository contains both the [Revive Dev node](https://github.com/paritytech/polkadot-sdk/tree/{{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}/substrate/frame/revive/dev-node){target=\_blank} implementation and the [ETH-RPC adapter](https://github.com/paritytech/polkadot-sdk/tree/{{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}/substrate/frame/revive/rpc){target=\_blank} required for Ethereum compatibility. Start by cloning the repository and navigating to the project directory:
34383438

34393439
```bash
3440-
git clone -b {{dependencies.repositories.polkadot_sdk_contracts_node.version}} https://github.com/paritytech/polkadot-sdk.git
3440+
git clone https://github.com/paritytech/polkadot-sdk.git
34413441
cd polkadot-sdk
3442+
git checkout {{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}
34423443
```
34433444

34443445
Next, you need to compile the two essential components for your development environment. The Substrate node provides the core blockchain runtime with smart contract support, while the ETH-RPC adapter enables Ethereum JSON-RPC compatibility for existing tooling:
34453446

34463447
```bash
3447-
cargo build --bin substrate-node --release
3448+
cargo build -p revive-dev-node --bin revive-dev-node --release
34483449
cargo build -p pallet-revive-eth-rpc --bin eth-rpc --release
34493450
```
34503451

34513452
The compilation process may take some time depending on your system specifications, potentially up to 30 minutes. Release builds are optimized for performance but take longer to compile than debug builds. After successful compilation, you can verify the binaries are available in the `target/release` directory:
34523453

3453-
- **Substrate node path**: `polkadot-sdk/target/release/substrate-node`
3454+
- **Revive Dev node path**: `polkadot-sdk/target/release/revive-dev-node`
34543455
- **ETH-RPC adapter path**: `polkadot-sdk/target/release/eth-rpc`
34553456

34563457
## Run the Local Node
34573458

34583459
With the binaries compiled, you can now start your local development environment. The setup requires running two processes.
34593460

3460-
Start the Substrate node first, which will initialize a local blockchain with the `dev` chain specification. This configuration includes `pallet-revive` for smart contract functionality and uses pre-funded development accounts for testing:
3461+
Start the node first, which will initialize a local blockchain with the `dev` chain specification. This configuration includes `pallet-revive` for smart contract functionality and uses pre-funded development accounts for testing:
34613462

34623463
```bash
3463-
./target/release/substrate-node --dev
3464+
./target/release/revive-dev-node --dev
34643465
```
34653466

34663467
The node will begin producing blocks immediately and display initialization logs:
34673468

34683469
<div id="termynal" data-termynal>
3469-
<span data-ty="input"><span class="file-path"></span>./target/release/substrate-node --dev</span>
3470+
<span data-ty="input"><span class="file-path"></span>./target/release/revive-dev-node --dev</span>
34703471
<br />
34713472
<span data-ty>2025-05-29 10:42:35 Substrate Node</span>
34723473
<span data-ty>2025-05-29 10:42:35 ✌️ version 3.0.0-dev-38b7581fc04</span>
@@ -3506,10 +3507,10 @@ The node will begin producing blocks immediately and display initialization logs
35063507
For debugging purposes or to monitor low-level operations, you can enable detailed logging by setting environment variables before running the command:
35073508

35083509
```bash
3509-
RUST_LOG="error,evm=debug,sc_rpc_server=info,runtime::revive=debug" ./target/release/substrate-node --dev
3510+
RUST_LOG="error,evm=debug,sc_rpc_server=info,runtime::revive=debug" ./target/release/revive-dev-node --dev
35103511
```
35113512

3512-
Once the Substrate node is running, open a new terminal window and start the ETH-RPC adapter. This component translates Ethereum JSON-RPC calls into Substrate-compatible requests, allowing you to use familiar Ethereum tools like MetaMask, Hardhat, or Ethers.js:
3513+
Once the node is running, open a new terminal window and start the ETH-RPC adapter. This component translates Ethereum JSON-RPC calls into Substrate-compatible requests, allowing you to use familiar Ethereum tools like MetaMask, Hardhat, or Ethers.js:
35133514

35143515
```bash
35153516
./target/release/eth-rpc --dev
@@ -3531,7 +3532,7 @@ You should see logs indicating that the adapter is ready to accept connections:
35313532
<span data-ty>2025-05-29 10:48:48 🔌 Subscribing to new blocks (FinalizedBlocks)</span>
35323533
</div>
35333534

3534-
Similar to the Substrate node, you can enable detailed logging for the ETH-RPC adapter to troubleshoot issues:
3535+
Similar to the Revive Dev node, you can enable detailed logging for the ETH-RPC adapter to troubleshoot issues:
35353536

35363537
```bash
35373538
RUST_LOG="info,eth-rpc=debug" ./target/release/eth-rpc --dev

llms-full.txt

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -14220,7 +14220,7 @@ Doc-Content: https://docs.polkadot.com/develop/smart-contracts/local-development
1422014220
--- BEGIN CONTENT ---
1422114221
---
1422214222
title: Local Development Node
14223-
description: Follow this step-by-step guide to install a Substrate node and ETH-RPC adapter for smart contract development in a local environment.
14223+
description: Follow this step-by-step guide to install a Revive Dev node and ETH-RPC adapter for smart contract development in a local environment.
1422414224
categories: Smart Contracts
1422514225
---
1422614226

@@ -14235,7 +14235,7 @@ A local development node provides an isolated blockchain environment where you c
1423514235

1423614236
By the end of this guide, you'll have:
1423714237

14238-
- A running Substrate node with smart contract support.
14238+
- A running node with smart contract support.
1423914239
- An ETH-RPC adapter for Ethereum-compatible tooling integration accessible at `http://localhost:8545`.
1424014240

1424114241
## Prerequisites
@@ -14244,41 +14244,42 @@ Before getting started, ensure you have done the following:
1424414244

1424514245
- Completed the [Install Polkadot SDK Dependencies](/develop/parachains/install-polkadot-sdk/){target=\_blank} guide and successfully installed [Rust](https://www.rust-lang.org/){target=\_blank} and the required packages to set up your development environment.
1424614246

14247-
## Install the Substrate Node and ETH-RPC Adapter
14247+
## Install the Revive Dev Node and ETH-RPC Adapter
1424814248

14249-
The Polkadot SDK repository contains both the [Substrate node](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/bin/node){target=\_blank} implementation and the [ETH-RPC adapter](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame/revive/rpc){target=\_blank} required for Ethereum compatibility. Start by cloning the repository and navigating to the project directory:
14249+
The Polkadot SDK repository contains both the [Revive Dev node](https://github.com/paritytech/polkadot-sdk/tree/{{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}/substrate/frame/revive/dev-node){target=\_blank} implementation and the [ETH-RPC adapter](https://github.com/paritytech/polkadot-sdk/tree/{{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}/substrate/frame/revive/rpc){target=\_blank} required for Ethereum compatibility. Start by cloning the repository and navigating to the project directory:
1425014250

1425114251
```bash
14252-
git clone -b {{dependencies.repositories.polkadot_sdk_contracts_node.version}} https://github.com/paritytech/polkadot-sdk.git
14252+
git clone https://github.com/paritytech/polkadot-sdk.git
1425314253
cd polkadot-sdk
14254+
git checkout {{dependencies.repositories.polkadot_sdk_contracts_node.commit_dev_node}}
1425414255
```
1425514256

1425614257
Next, you need to compile the two essential components for your development environment. The Substrate node provides the core blockchain runtime with smart contract support, while the ETH-RPC adapter enables Ethereum JSON-RPC compatibility for existing tooling:
1425714258

1425814259
```bash
14259-
cargo build --bin substrate-node --release
14260+
cargo build -p revive-dev-node --bin revive-dev-node --release
1426014261
cargo build -p pallet-revive-eth-rpc --bin eth-rpc --release
1426114262
```
1426214263

1426314264
The compilation process may take some time depending on your system specifications, potentially up to 30 minutes. Release builds are optimized for performance but take longer to compile than debug builds. After successful compilation, you can verify the binaries are available in the `target/release` directory:
1426414265

14265-
- **Substrate node path**: `polkadot-sdk/target/release/substrate-node`
14266+
- **Revive Dev node path**: `polkadot-sdk/target/release/revive-dev-node`
1426614267
- **ETH-RPC adapter path**: `polkadot-sdk/target/release/eth-rpc`
1426714268

1426814269
## Run the Local Node
1426914270

1427014271
With the binaries compiled, you can now start your local development environment. The setup requires running two processes.
1427114272

14272-
Start the Substrate node first, which will initialize a local blockchain with the `dev` chain specification. This configuration includes `pallet-revive` for smart contract functionality and uses pre-funded development accounts for testing:
14273+
Start the node first, which will initialize a local blockchain with the `dev` chain specification. This configuration includes `pallet-revive` for smart contract functionality and uses pre-funded development accounts for testing:
1427314274

1427414275
```bash
14275-
./target/release/substrate-node --dev
14276+
./target/release/revive-dev-node --dev
1427614277
```
1427714278

1427814279
The node will begin producing blocks immediately and display initialization logs:
1427914280

1428014281
<div id="termynal" data-termynal>
14281-
<span data-ty="input"><span class="file-path"></span>./target/release/substrate-node --dev</span>
14282+
<span data-ty="input"><span class="file-path"></span>./target/release/revive-dev-node --dev</span>
1428214283
<br />
1428314284
<span data-ty>2025-05-29 10:42:35 Substrate Node</span>
1428414285
<span data-ty>2025-05-29 10:42:35 ✌️ version 3.0.0-dev-38b7581fc04</span>
@@ -14318,10 +14319,10 @@ The node will begin producing blocks immediately and display initialization logs
1431814319
For debugging purposes or to monitor low-level operations, you can enable detailed logging by setting environment variables before running the command:
1431914320

1432014321
```bash
14321-
RUST_LOG="error,evm=debug,sc_rpc_server=info,runtime::revive=debug" ./target/release/substrate-node --dev
14322+
RUST_LOG="error,evm=debug,sc_rpc_server=info,runtime::revive=debug" ./target/release/revive-dev-node --dev
1432214323
```
1432314324

14324-
Once the Substrate node is running, open a new terminal window and start the ETH-RPC adapter. This component translates Ethereum JSON-RPC calls into Substrate-compatible requests, allowing you to use familiar Ethereum tools like MetaMask, Hardhat, or Ethers.js:
14325+
Once the node is running, open a new terminal window and start the ETH-RPC adapter. This component translates Ethereum JSON-RPC calls into Substrate-compatible requests, allowing you to use familiar Ethereum tools like MetaMask, Hardhat, or Ethers.js:
1432514326

1432614327
```bash
1432714328
./target/release/eth-rpc --dev
@@ -14343,7 +14344,7 @@ You should see logs indicating that the adapter is ready to accept connections:
1434314344
<span data-ty>2025-05-29 10:48:48 🔌 Subscribing to new blocks (FinalizedBlocks)</span>
1434414345
</div>
1434514346

14346-
Similar to the Substrate node, you can enable detailed logging for the ETH-RPC adapter to troubleshoot issues:
14347+
Similar to the Revive Dev node, you can enable detailed logging for the ETH-RPC adapter to troubleshoot issues:
1434714348

1434814349
```bash
1434914350
RUST_LOG="info,eth-rpc=debug" ./target/release/eth-rpc --dev

0 commit comments

Comments
 (0)