How to Create Your First Hats

Heard about Hats but not sure how to get started?

Go from idea to deployed Hats in minutes.

Here's how:

Visit the Hats App at app.hatsprotocol.xyz.

Once you’re there:

• Connect your wallet

• Click "Create a new tree" (hats are organized in trees)

• Add an image, name, and description for your new tree as seen in the image below

• Click "Create"

You're now the proud wearer of your very own top hat! This top hat is the first hat you will create; you can think of it as the superadmin of the entire hats tree.

You can now build out the rest of your tree with Edit Mode...

Edit mode lets you create whatever role structure you can dream up. To use edit mode:

• Select "Edit Tree"

• Create new hats

• Add images and details to those hats, as seen in the image below (don't forget to click "Save" after you’re done editing each hat)

Once you're done building out your tree, click "Deploy". Your hats tree is now onchain!

You can also export a .json of the tree changes or copy an executable hex code to execute the changes via a multisig or share your proposed changes with others.

You can now connect your hats with authorities by plugging them into token-gates.

Hat (1155 token) + gate = token-gated authority.

1. Safe multisig signing authority

2. Snapshot proposal creation & voting

3. DELV council voting authority

4. Coordinape circle access

5. Discord roles & channels via Collab.Land and Guild

6. Telegram groups via Collab.Land and Guild

7. Charmverse read/comment/write permissions

8. Wonderverse read/comment/write permissions

9. Google docs, sheets, and slides read/comment/write permissions via Guild

10. EOA wallet ownership (yes, hat-controlled wallets)

11. Many more web2 permissions via Lit Protocol

12. Literally anything that's token-gateable!

See the docs for a full list of hat-gateable authorities and setup guides.

Lastly, you can mint your hats to wearers!

Add addresses individually or via a CSV, and select "Mint Hats", as seen in the image below. Hats tokens can be held (or “worn”, as we say) by any address including an EOA, multisig, or contract.

That's it, you've now created your very first Hats tree and brought your roles onchain! 🥳

You can always continue to add to your tree or invite others to build out the tree with you, as wearers can create additional child hats to delegate responsibility further.

You can now add eligibility criteria (e.g., wallet holdings, staking, or election results) to dynamically determine which addresses are eligible to wear a hat & to revoke the hat if the wearer is no longer eligible.

Eligibility criteria you may use to determine which addresses are and are not eligible to wear a given hat include:

• Assets such as tokens, badges, and/or POAPs held by a given wallet address

• Staking requirements that specify an address must stake a minimum amount of a given token

• Active subscription, verifying whether or not an address is paying an ongoing fee (e.g., using Unlock Protocol)

• Election results specifying only the top N vote-getters of an election are eligible to wear a designated Hat

• Delegated tokens or votes that reach and/or stay above a given threshold

• Contributions and attestations such as those represented by Govrn contributions, Quests NFTs, or EAS attestations

• Humanistic eligibility based on specified criteria (e.g., an arbitration council or stewardship council rules on Hat eligibility according to predetermined rules)

• Any custom logic you can imagine that can be represented onchain

See the docs for a full list of eligibility criteria you can add to your hats.

Create your hats tree for free at app.hatsprotocol.xyz

For guides on all the above and more see the docs at docs.hatsprotocol.xyz

And if you need help getting started, book a demo call here

Happy hatting! 🧢