JokeRace Eligibility

Tying hat eligibility to the results of a JokeRace Contest


​JokeRace enables communities to make, execute, and reward decisions onchain. By using this module, communities can elect the wearers of a hat through a JokeRace election. More specifically, the eligible wearers are creators of the top voted proposals in the election.
The number of winners of an election, and thus the number of possible wearers made eligible through this integration, is configurable. Additionally, a term period can be set, after which the winners will no longer be eligible to wear the hat.
The module's code is open source and is available here.


Using this module enables the wearers of the "Elected Role" hat to be the winners of a chosen JokeRace election:
Any JokeRace election can be used for any hat, even elections that were held in the past or ones scheduled in the future. Following is the election for the "Elected Role" hat:
The top 5 most voted candidates in the election are the ones eligible for the role, for a term period of 1 year, as defined in the module.

Adding the module to a hat

  • Go to the tree that includes the hat you wish to create the module for
  • Select "Edit Tree"
  • Locate and select the hat
  • Open the "Revocation & Eligibility" section
  • Choose "Automatically" and then choose "Create new Module". This will open the module creation form
  • Choose "JokeRace Eligibility" in the module type
  • Fill in the module-specific parameters
  • Choose "Deploy & Return" to deploy the module and return to the hat edit form. The module address will be automatically updated on the hat's eligibility property in the form. Once you deploy these changes, the hat's eligibility will be updated.

Viewing the hat's eligibility criteria

Once the module is attached to the hat, you can view the hat's updated eligibility criteria:
  • Select the hat
  • In the eligibility section, you can view:
    • The module's public actions
    • The module's general description
    • The module's live parameters
      • Admin Hat ID
      • Jokerace contest address
      • Ending time of the current term
      • Number of wearers that are elected to this role
    • Useful links
      • The module's source code on GitHub

Module's roles

The module has one special roles, which is set at the module's creation. The role is granted to a hat/s, providing its wearers certain authorities in the module:
  • Admin - can set up new terms.


To view or perform the Admin's authorities:
  • Select the admin hat
  • In the Authorities section, locate the Jokerace Admin authority card