HugoTrentesaux

Become smithπŸ”—

In Duniter v2 you can only forge blocks if your identity is smith (see glossary). This page guides you to get the smith status. If you previously followed the run a smith node tutorial, you will be able to enable forging blocks. The steps to complete are the following one:

  1. become member of the main web of trust
  2. read and understand the smith licence
  3. request smith membership with the smithsMembership.requestMembership() extrinsic
  4. get enough certifications from other smith
  5. claim membership to the authorities with smithsMembership.claimMembership() extrinsic
  6. set session keys with authorityMembers.set_session_keys() extrinsic
  7. start forging blocks with authorityMembers.goOnline()

This process is detailed below.

Table of contents

  1. Become member of the main web of trust
  2. Read and understand the smith licence
  3. Request smith membership
  4. Get enough certifications from other smith
  5. Claim membership to the authorities
  6. Set session keys
  7. Start forging blocks
  8. Stay smith

Become member of the main web of trustπŸ”—

Duniter is based on human trust without implying peculiary interest. Therefore, there is no need to own a large quantity of currency to take part to the blockchain authoring, only to be part of the main web of trust. This implies having read and accepted the Ğ1 licence and getting certified by other wot members (see g1 documentation). Having a unique digital identity entails you can only have one smith identity.

Read and understand the smith licenceπŸ”—

The smith licence defines the rules to certify a new Duniter smith. These rules aim to garantee a good operation of Duniter blockchain by making sure that the new smith knows the rules applying to this role and that other smiths trust his/her ability to apply them.

Request smith membershipπŸ”—

Before getting smith certifications, you have to declare your wish to become smith by calling the smithsMembership.requestMembership() extrinsic (see runtime calls reference).

The membership request is only valid for one month.

Get enough certifications from other smithπŸ”—

The minimum number of received certifications to become smith depends on the runtime. Currently it is:

A smith is only able to become an authority (see glossary) once he/she get enough certifications before the membership request expiration.

Claim membership to the authoritiesπŸ”—

Call the smithsMembership.claimMembership() extrinsic to get added to the list of authorities.

Set session keysπŸ”—

Once you are member of the smith sub wot, you are allowed to declare session keys with authorityMembers.set_session_keys(). The argument of set_session_keys is a pubkey, make sure your smith node has the corresponding session keys!

You can do it with a client like polkadotjs app (more manual) or Ğcli (has helper commands).

Start forging blocksπŸ”—

Before calling authorityMembers.goOnline(), you can double-check that your validator node actually has the session keys you declared and is syncrhonized to the network. Otherwise you will be unable to add blocks and will generate BABE offenses.


Stay smithπŸ”—

Once you are smith, you must:

Otherwise, you will be excluded from the smith.