Smith operations in Ğcli

This page describes smith operations in Ǧcli.

Help

You can see the help with gcli smith --help:

> gcli smith --help
Smith (certify, go-online, go-offline...)

Usage: gcli smith <COMMAND>

Commands:
  go-online         go online
  go-offline        go offline
  update-keys       Rotate and set session keys
  set-session-keys  Set session keys
  show-expire       List upcoming expirations that require an action
  show-online       List online authorities
  invite            Invite identity to become smith
  accept            Accept invitation
  certify           Certify smith
  help              Print this message or the help of the given subcommand(s)

Smith web of trust

These are the smith web of trust commands:

# invite a member to join the smith web of trust
gcli smith invite <pseudo>
# then he has to accept your invitation
gcli smith accept
# once accepted, people can start certifying
gcli smith cert <pseudo>
# when enough certifications are collected, the identity becomes member of the smith wor
gcli identity get -u <pseudo>
# [see smith status in output]

Smith node management

You smith node must own session keys. If you generated them from another tool, you can use gcli smith set-session-keys <hexadecimal> but there is the all-in-one command update-keys which makes things simpler.

# connect with a ssh tunel to your smith node unsafe API (or use a vpn, or use gcli on the same machine)
ssh -NL 9944:localhost:9944 smith_node
# call update keys
gcli --url ws://localhost:9944 smith update-keys

The "update key" command does two things:

• call "rotate_keys" unsafe RPC methods which generates session keys on your node and returns the public part
• call "set_session_keys" extrinsic wich informs the onchain storage of your smith node's session keys

⚠️ the command does not print anything on success for the moment, this should be changed in gcli

Ğcli does not yet have the capability to check if published session keys are actually present on the node, this could be added, please contribute ;)