Comment on page

BitBadges Overview

Here, you will find documentation about BitBadges, how it works, how to interact, and how to contribute!


Digital tokens (badges) are simply something that you can own digitally and prove ownership of it. You probably already use and own many digital tokens: verification checkmarks, a movie streaming subscription, concert tickets, etc. These tokens can be used for many use cases, each potentially offering you different utility and value. Some may have real-world use cases (e.g. entry to a concert), and some may be purely digital (e.g. verification checkmark).
When combined with blockchain technology, they become even more secure and more powerful, due to the unique properties of the blockchain. However, the existing infrastructure and technology is not nearly good enough to realize the vast potential of digital blockchain tokens. Notably, existing state-of-the-art is not scalable, lacks consistency, and is limited to a single blockchain ecosystem at a time (e.g. only Ethereum users or only Cosmos users).
BitBadges can be described as tokenization-as-a-service. We offer an open-source, multi-chain, state-of-the-art, community-driven suite of tools that enable you to create, customize, verify, and integrate with digital blockchain tokens for any use case you desire.
The BitBadges ecosystem aims to offer the full-stack of tools and services you may need from the required storage (blockchain, data indexing, off-chain data storage) to authentication to distribution to offline-first verification tools (in-person verification, website gated sign-ins) to communicating with your badge holders and more!
The BitBadges app ( allows you to show off your badges and build your digital identity as you collect more over time! On the flip side, you can browse others' badges to get a sense of their digital identity (e.g. are they a scammer or trustworthy?). This app has a social media feel but is also the all-in-one site to learn about the identity of a user.

Use Cases

Because you can create a badge for anything, there are infinitely many possible use cases for BitBadges! As you collect more badges, your portfolio grows, and you can show it off to others.
Below are some of our favorite use cases:
  • Attendance Badges - Mint an attendance badge for an event, trip, etc as a souvenir!
  • Memberships/Subscriptions/Premium Content - Badges are all time-based, so you can offer time-dependent memberships / subscriptions and offer the utility only to those who own the badge at a certain time!
  • Access Tokens - Use badges as access tokens. This can be digital (websites, Discord servers, etc) or in-person (tickets, event entry, etc).
  • Recognition of Achievement or Completion - Job certifications, awards, athletic accomplishments, completing a class, etc.
  • Authentication / Tiered Services - Companies can outsource their authentication to Web3 / Blockin and verify ownership through tiered services badges (family plan badge vs normal user badge). Cheaper, more secure, and less work!
  • See more use cases here!

Why are we better?

What makes our product better than competitors?


Supports users from multiple blockchain ecosystems instead of just one! We currently support Cosmos, Solana, and Ethereum users.
  • Imagine if a sporting event was limited to only Android users because the ticketing technology only worked on Android! This is the current state of infrastructure.
  • Currently, token standards are limited to one blockchain ecosystem (e.g. only Ethereum users or only Solana users). This is a HUGE problem because most companies do not belong to a specific blockchain ecosystem, so it greatly restricts their potential audience!


We keep decentralization as a core principle, as opposed to some of our competitors who rely on more centralized architectures and censoring.


Instead of relying on a rigid token standard that is not adaptable to new features, we iterate fast and constantly add new features.


By being open-source and developer friendly, we aim to facilitate an ecosystem of community-driven projects, tools, and more built on top of BitBadges. See Ecosystem.

Scalability, Security, and Ease of Use:

Our product is more scalable, easier to use, and more secure than competitors (see here) .

Newly Innovated Features

In addition to the standard features of existing token standards (mint, transfer, approve, etc), we expand and offer the following functionality:
  • Time-Based Balances: Badge balances are all time-dependent which allow you to, for example, transfer only a specific period of time (e.g. subscription token for a month), clearly define token unlock schedules, or approve a transfer only for a specific period of time.
  • Off-Chain Balances: New ways to store and track balances, in addition to the standard on-chain storage of balances. Storing balances off-chain can offer over 1000x better scalability and much better user experience because users never need to transact with the blockchain. Badges are auto assigned to their wallets.
  • Fine-Grained Transferability and Approvals Customization: Simply abstracting transferability to "transferable" or "non-transferable" is too simple for many use cases. We recognize that transferability is a complex protocol of who can transfer to who? at what times? what badges? how many? revokable? freezable? etc.
    • Example: Only those who own the verified checkmark badge can transfer the badge IDs 1-5 to each other from Monday to Tuesday 12PM, but badges will be revokable by the manager after that.
    • Must Own Badges: Restrict sending and receiving badges to only those who own specific badges of other collections (e.g. a KYC badge, a verified badge).
    • Fine-Grained Approvals: In addition to simply specifying approval of X amount, you can customize approvals further with details like predetermined balances (x1 of ID 1, then x1 of ID 2), max number of transfers allowed, and more!
    • Incoming Approvals: In addition to having control over your outgoing transfers, have control over your incoming transfers via incoming approvals.
      • Ex: Block certain users from transferring to you. Block all transfers unless you opt-in to receiving them.
    • And more!
  • Customizable Permissions: Each collection has fine-grained customizable permissions that can be optionally set and executed by a special party called the manager, such as archiving the collection, deleting it, updating its metadata, updating transferability, etc.
  • Time-Based Details: Important collection details such as metadata are time-based, allowing you to automatically commit to updating it at a future time without needing to transact at that time.
    • Ex: Set the metadata to be one value from January 1 to January 10 and then auto-change to another value!
  • Batch Transfers: Batch transfer badges instead of only being able to transfer one by one.
    • Instead of needing 1000 transactions to send 1000 unique non-fungible badges in a collection (e.g. x1 of Badge ID 1, x1 of ID 2, ...), you can batch all into one transaction efficiently (e.g. send x1 of Badge IDs 1-1000).
And much more!

Distribution Tools

There are infinitely many ways to distribute badges to holders. A few are supported natively by the BitBadges website (whitelists, passwords, claim codes, QR codes).
However, there is no way that we can natively support all distribution methods. Even if we could, this would centralize the badge distribution process.
BitBadges wants to decentralize the distribution process by supporting a vast ecosystem of community-built distribution tools. Our goal is that users will have thousands of options to choose from built by different teams, each offering their own unique niche.
See Ecosystem for all the distribution tools we and the community offer.
Currently Supported
We currently support the following:
  • Whitelists - Specify a list of users that can claim the badge.
  • Password - Enter the correct password can claim a badge.
  • Codes - Enter unique custom codes to claim a badge. Codes can be distributed however you would like (email, social media DMs, anything!).
  • QR Codes - Restrict badges to be claimed by only those who scan a specific QR code.
See Creating a Distribution Tool for how to create one.

Ecosystem Tools

In addition to distribution tools, we aim to have thousands of community-built ecosystem tools for anything from authenticating users, communicating with badge holders, distributing badges, and more!
Similar to distribution tools, we want to support a vast ecosystem of tools built by different teams, each with their own unique niche. See Ecosystem for all the tools currently built.
Blockin - Badge-Gate Websites
With Blockin, you can restrict access to any website to only your badge holders!
Blockin is a universal, multi-chain sign-in interface that includes support for badge-gating websites. It extends Sign-In with Ethereum to support any and all blockchains.
BitBadges App -
Improvement Proposals -
Last modified 2d ago