Skip to main content
Version: 2.0.3

Using graffiti-file flag

--graffiti-file flag for the validator client enables the wonderful feature where validators could use different graffiti for different validators running in the same running process.

Reasons may include:

  • Privacy (same graffiti may link validators)
  • Fun (graffiti wall, etc)

Usages#

The validator flag: --graffiti-file=/path/to/graffitis.yaml

It supports yaml and the following scalar and collections. We will go through each of them in detail below.

  • Specific
  • Ordered
  • Random
  • Default

Specific usage#

Specific chooses the graffiti based on the validator ID. When validator ID is not specified, a graffiti will be chosen from another list. This takes precedent over ordered, random and default.

Example:

specific:  163: "validator 163 was here"  914: "validator 914 was here"  546: "validator 536 was here"  237: "validator 237 was here"random:  - "Mr A was here"  - "Mr B was here"  - "Mr C was here"default: "Mr F was here"

Example output: image

Ordered#

Ordered chooses each entry of graffiti in order from the list. The validator will start again from the top of the list each time the graffiti file is updated. Once the list is finished, the random or default graffiti will be used. This takes precedent over both random and default.

Example:

ordered:  - "Mr A was here"  - "Mr B was here"  - "Mr C was here"default: "Mr F was here"

Example output:

INFO validator: Submitted new block blockRoot=0x00000 graffiti="Mr A was here"INFO validator: Submitted new block blockRoot=0x00000 graffiti="Mr B was here"INFO validator: Submitted new block blockRoot=0x00000 graffiti="Mr C was here"INFO validator: Submitted new block blockRoot=0x00000 graffiti="Mr F was here"INFO validator: Submitted new block blockRoot=0x00000 graffiti="Mr F was here"

Random#

Random chooses a random graffiti from the list. If random is not specified, the default graffiti will be used. This takes precedent over default.

Example:

#specific:#  163: "validator 163 was here"#  914: "validator 914 was here"#  546: "validator 536 was here"#  237: "validator 237 was here"random:  - "Mr A was here"  - "Mr B was here"  - "Mr C was here"default: "Mr F was here"

Example output: image

Default#

Default specifies the graffiti to be used by all the keys under validator client.

Example:

#specific:#  163: "validator 163 was here"#  914: "validator 914 was here"#  546: "validator 536 was here"#  237: "validator 237 was here"#random:#  - "Mr A was here"#  - "Mr B was here"#  - "Mr C was here"default: "Mr F was here"

Example output: image