Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
Duniter v2S
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container Registry
Model registry
Monitor
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
nodes
rust
Duniter v2S
Commits
1e263062
Commit
1e263062
authored
3 years ago
by
Éloïs
Browse files
Options
Downloads
Patches
Plain Diff
doc(README): precise how to launch local testnet
parent
55e150a7
No related branches found
Branches containing commit
No related tags found
Tags containing commit
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+79
-43
79 additions, 43 deletions
README.md
with
79 additions
and
43 deletions
README.md
+
79
−
43
View file @
1e263062
...
...
@@ -71,6 +71,42 @@ CAUTION: In order for **Polkadot-JS Apps** to be able to fully understand the in
If you want to see the multi-node consensus algorithm in action, refer to
[
our Start a Private Network tutorial
](
https://substrate.dev/docs/en/tutorials/start-a-private-network/
)
.
### Purge previous lacal testnet
```
./target/release/lc-core purge-chain --base-path /tmp/alice --chain local
./target/release/lc-core purge-chain --base-path /tmp/bob --chain local
```
### Start Alice's node
```
bash
./target/release/lc-core
\
--base-path
/tmp/alice
\
--chain
local
\
--alice
\
--port
30333
\
--ws-port
9945
\
--rpc-port
9933
\
--node-key
0000000000000000000000000000000000000000000000000000000000000001
\
--validator
```
### Start Bob's node
```
bash
./target/release/lc-core
\
--base-path
/tmp/bob
\
--chain
local
\
--bob
\
--port
30334
\
--ws-port
9946
\
--rpc-port
9934
\
--validator
\
--bootnodes
/ip4/127.0.0.1/tcp/30333/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp
```
## Project Structure
A Substrate project such as this consists of a number of components that are spread across a few
...
...
@@ -81,34 +117,34 @@ directories.
A blockchain node is an application that allows users to participate in a blockchain network.
Substrate-based blockchain nodes expose a number of capabilities:
-
Networking: Substrate nodes use the
[
`libp2p`
](
https://libp2p.io/
)
networking stack to allow the
nodes in the network to communicate with one another.
-
Consensus: Blockchains must have a way to come to
[
consensus
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus
)
on the state of the
network. Substrate makes it possible to supply custom consensus engines and also ships with
several consensus mechanisms that have been built on top of
[
Web3 Foundation research
](
https://research.web3.foundation/en/latest/polkadot/NPoS/index.html
)
.
-
RPC Server: A remote procedure call (RPC) server is used to interact with Substrate nodes.
-
Networking: Substrate nodes use the
[
`libp2p`
](
https://libp2p.io/
)
networking stack to allow the
nodes in the network to communicate with one another.
-
Consensus: Blockchains must have a way to come to
[
consensus
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus
)
on the state of the
network. Substrate makes it possible to supply custom consensus engines and also ships with
several consensus mechanisms that have been built on top of
[
Web3 Foundation research
](
https://research.web3.foundation/en/latest/polkadot/NPoS/index.html
)
.
-
RPC Server: A remote procedure call (RPC) server is used to interact with Substrate nodes.
There are several files in the
`node`
directory - take special note of the following:
-
[
`chain_spec.rs`
](
./node/src/chain_spec.rs
)
: A
[
chain specification
](
https://substrate.dev/docs/en/knowledgebase/integrate/chain-spec
)
is a
source code file that defines a Substrate chain's initial (genesis) state. Chain specifications
are useful for development and testing, and critical when architecting the launch of a
production chain. Take note of the
`development_c
onfig
`
and
`testnet_genesis`
functions, which
are used to define the genesis state for the local development chain configuration. These
functions identify some
[
well-known accounts
](
https://substrate.dev/docs/en/knowledgebase/integrate/subkey#well-known-keys
)
and use them to configure the blockchain's initial state.
-
[
`service.rs`
](
./node/src/service.rs
)
: This file defines the node implementation. Take note of
the libraries that this file imports and the names of the functions it invokes. In particular,
there are references to consensus-related topics, such as the
[
longest chain rule
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus#longest-chain-rule
)
,
the
[
Aura
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus#aura
)
block authoring
mechanism and the
[
GRANDPA
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus#grandpa
)
finality
gadget.
-
[
`chain_spec.rs`
](
./node/src/chain_spec.rs
)
: A
[
chain specification
](
https://substrate.dev/docs/en/knowledgebase/integrate/chain-spec
)
is a
source code file that defines a Substrate chain's initial (genesis) state. Chain specifications
are useful for development and testing, and critical when architecting the launch of a
production chain. Take note of the
`development_c
hain_spec
`
and
`testnet_genesis`
functions, which
are used to define the genesis state for the local development chain configuration. These
functions identify some
[
well-known accounts
](
https://substrate.dev/docs/en/knowledgebase/integrate/subkey#well-known-keys
)
and use them to configure the blockchain's initial state.
-
[
`service.rs`
](
./node/src/service.rs
)
: This file defines the node implementation. Take note of
the libraries that this file imports and the names of the functions it invokes. In particular,
there are references to consensus-related topics, such as the
[
longest chain rule
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus#longest-chain-rule
)
,
the
[
Aura
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus#aura
)
block authoring
mechanism and the
[
GRANDPA
](
https://substrate.dev/docs/en/knowledgebase/advanced/consensus#grandpa
)
finality
gadget.
After the node has been
[
built
](
#build
)
, refer to the embedded documentation to learn more about the
capabilities and configuration parameters that it exposes:
...
...
@@ -134,13 +170,13 @@ create pallets and flexibly compose them to create blockchains that can address
Review the
[
FRAME runtime implementation
](
./runtime/src/lib.rs
)
included in this template and note
the following:
-
This file configures several pallets to include in the runtime. Each pallet configuration is
defined by a code block that begins with
`impl $PALLET_NAME::Config for Runtime`
.
-
The pallets are composed into a single runtime by way of the
[
`construct_runtime!`
](
https://crates.parity.io/frame_support/macro.construct_runtime.html
)
macro, which is part of the core
[
FRAME Support
](
https://substrate.dev/docs/en/knowledgebase/runtime/frame#support-library
)
library.
-
This file configures several pallets to include in the runtime. Each pallet configuration is
defined by a code block that begins with
`impl $PALLET_NAME::Config for Runtime`
.
-
The pallets are composed into a single runtime by way of the
[
`construct_runtime!`
](
https://crates.parity.io/frame_support/macro.construct_runtime.html
)
macro, which is part of the core
[
FRAME Support
](
https://substrate.dev/docs/en/knowledgebase/runtime/frame#support-library
)
library.
### Pallets
...
...
@@ -150,17 +186,17 @@ template pallet that is [defined in the `pallets`](./pallets/template/src/lib.rs
A FRAME pallet is compromised of a number of blockchain primitives:
-
Storage: FRAME defines a rich set of powerful
[
storage abstractions
](
https://substrate.dev/docs/en/knowledgebase/runtime/storage
)
that makes
it easy to use Substrate's efficient key-value database to manage the evolving state of a
blockchain.
-
Dispatchables: FRAME pallets define special types of functions that can be invoked (dispatched)
from outside of the runtime in order to update its state.
-
Events: Substrate uses
[
events
](
https://substrate.dev/docs/en/knowledgebase/runtime/events
)
to
notify users of important changes in the runtime.
-
Errors: When a dispatchable fails, it returns an error.
-
Config: The
`Config`
configuration interface is used to define the types and parameters upon
which a FRAME pallet depends.
-
Storage: FRAME defines a rich set of powerful
[
storage abstractions
](
https://substrate.dev/docs/en/knowledgebase/runtime/storage
)
that makes
it easy to use Substrate's efficient key-value database to manage the evolving state of a
blockchain.
-
Dispatchables: FRAME pallets define special types of functions that can be invoked (dispatched)
from outside of the runtime in order to update its state.
-
Events: Substrate uses
[
events
](
https://substrate.dev/docs/en/knowledgebase/runtime/events
)
to
notify users of important changes in the runtime.
-
Errors: When a dispatchable fails, it returns an error.
-
Config: The
`Config`
configuration interface is used to define the types and parameters upon
which a FRAME pallet depends.
## Run in Docker
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment