🏠Organizations

Organizations are self-contained units of onchain logic that unlock the power of secure blockchain access.

At the top layer of Badger exist Organizations. With an Organization, you can create Badges to group and control Members, Managers, and Hooks.

Organizations are at the core of Badger - they enable groups of people to work together in a decentralized and secure way. Like traditional organizations, they have a structure of managers and members, but they operate entirely on the blockchain, providing transparency and immutability plus all the features of blockchain interoperability.

Badger Organizations are flexible and customizable:

• You can create an Organization with specific permissions and roles that suit your needs.

• You can issue Badges, manage Members, and add built-in or custom Hooks to automate processes and add functionality to your Organization.

• You can create Organizations that other Organizations manage.

One of the key benefits of using Badger Organizations is that they can be completely decentralized, meaning that no single entity has control over the organization. This enables a wide range of use cases, from managing open-source projects to creating decentralized autonomous organizations (DAOs) that run on community governance.

This documentation will guide you through creating and managing Badger Organizations, from setting up managers and members to issuing badges and integrating hooks. Whether you want to create a small team to work on a project or a large decentralized community, Badger Organizations provide a secure and flexible way to work together on the blockchain.

Creating an Organization

✅ Permissions required: Anyone -- Badger Organization creation is permissionless!

Creating an Organization is a simple process that only requires a few clicks.

To get started, you'll need to provide some basic information to help define and identify your Organization within the Badger UI and onchain.

To get started:

• Go to your "Dashboard" page in the Badger web application.

• Connect your Ethereum-compatible wallet.

  • Rainbow

  • MetaMask

  • Coinbase Wallet

• Click "Create Organization" to visit the Organization creation form.

Submitting the Organization Form:

• Name* You can make it anything!

• Description* A short text description.

• Image* If a profile picture is not provided, one is automatically generated.

• Tags Category-driven tagging that powers filtering and search in Discovery.

All Organization and Badge access data is stored onchain, providing a secure and transparent way to manage credentials while descriptive metadata is stored on IPFS. As soon as an Organization is deployed, an Organization is displayed on popular NFT aggregators, such as OpenSea and Rarible, without any manual setup.

Using an Organization

✅ Permissions required: Anyone can integrate Badge credentials into external tools even if they are not a Member of that Organization or Badge.

In the world of Web3, there are many powerful tools that you will want to connect your Organization to, and doing so is very simple!

Deployed as an ERC1155 smart contract, every Organization has an Ethereum Address representing the location of the Organization like: 0x74539714796c0facc5ea32fb180f7cb04c71e97f.

You can connect to popular tools like the ones explored in our Integration Tutorials using the Ethereum Address of your Organization.

To find the address of your Organization:

• Select the Organization you want to connect to the outside world.

• Click the "Clipboard" icon in the navigation bar, and the address will be copied so that you can paste it anywhere you like.

• Or you can click the "Arrow" icon in the navigation bar, which takes you to the block explorer on which your Organization is deployed.

Editing an Organization

🛑 Permissions required: Owner or Organization Manager.

If you need to change your Organization's information, you can do so easily by editing the fields in your Organization settings.

To make changes:

• Go to the "Settings" page for your Organization.

• Make changes to the fields you want to update.

• Click "Save" to apply your changes and run the confirmation transaction.

Some fields, such as the Organization name and description, are required and cannot be deleted. Any changes you make to your Organization will be updated on the blockchain and displayed on aggregators. Remember to make changes when necessary and verify that your changes are accurate before saving.

Archiving an Organization

🛑 Permissions required: Owner or Organization Manager.

Not everything is permanent, and digital Organizations are no exception. You can archive it if you no longer need an Organization or want to close it.

If you ever need to unarchive an Organization after being archived, return to the "Settings" page and run the transaction; Badger will do the rest behind the scenes.

Doing so will prevent the Organization from being displayed on the Badger web application.

To (un)archive a Badge:

• Select the Organization you want to archive.

• Go to the "Settings" page for the Organization.

• Click "Archive" (or "Unarchive") and run the confirmation transaction.

It is important to note that archiving an Organization is only an interface change and does not prevent the actions of Managers or revoke already distributed Badges.