Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Glossary

SBT Revocation

SBT revocation is the process by which an issuer can invalidate a previously issued Soulbound Token, typically managed through a registry or smart contract that maintains a revocation list.
Chainscore © 2026
definition
SOULBOUND TOKEN MECHANISM

What is SBT Revocation?

SBT Revocation is the process of permanently invalidating or 'burning' a Soulbound Token (SBT), a non-transferable blockchain credential, to remove its associated permissions, status, or attestations from a holder's wallet.

SBT Revocation is the critical counterpoint to the issuance of a Soulbound Token (SBT), enabling the entity that granted the credential—such as a university, employer, or DAO—to retract it. Unlike revoking a transferable NFT, which merely changes ownership, revoking an SBT typically involves a smart contract operation that permanently destroys the token or marks it as invalid in a revocation registry, thereby severing the on-chain link between the holder and the attested quality (e.g., a diploma, membership, or certification). This mechanism is fundamental for maintaining the accuracy and accountability of a decentralized identity system.

The technical implementation of revocation varies, with common patterns including a centralized revocation list maintained by the issuer, a merkle tree-based revocation registry for privacy, or a time-lock/expiry mechanism. In many designs, the issuer retains a private key or administrative privilege to call a revoke function on the SBT's smart contract. More decentralized models may involve multi-signature controls or community governance votes to authorize revocation, balancing issuer control with censorship resistance. The choice of method directly impacts the system's trust assumptions, privacy, and compliance with regulations like the GDPR's 'right to be forgotten'.

Revocation is essential for practical SBT ecosystems. It allows institutions to correct errors (e.g., a mistakenly issued credential), enforce consequences (e.g., revoking access after a community vote or violation of terms), and manage state changes (e.g., a membership that has expired or been voluntarily surrendered). Without a reliable revocation mechanism, SBTs would represent permanent, immutable claims that could become outdated or misleading, undermining their utility for verifiable credentials in areas like professional licensing, credit scoring, and DAO governance.

key-features
MECHANISMS

Key Features of SBT Revocation

Soulbound Token (SBT) revocation is the process of permanently burning or invalidating a non-transferable token, typically triggered by the issuer to update a holder's on-chain credentials or status.

01

Issuer-Controlled Burn

The most common revocation method where the issuer's wallet (or a designated smart contract) calls a burn or revoke function, permanently removing the SBT from the holder's address. This enforces the issuer's sovereignty over the credential's lifecycle, allowing them to retract privileges, certifications, or memberships based on predefined conditions or real-world events.

02

Time-Based Expiry

SBTs can be programmed with a built-in expiration timestamp, after which they are automatically considered invalid. The token may remain in the wallet but its status is checked against the validUntil parameter. This is used for temporary memberships, event access passes, or time-limited certifications, removing the need for manual revocation.

03

Conditional Logic & Oracles

Revocation can be automated via smart contract logic that listens to external conditions. An oracle (e.g., Chainlink) can feed off-chain data (like a failed KYC check, loss of legal license, or governance vote outcome) to trigger revocation automatically. This creates trustless, objective systems for credential management.

04

Stateful vs. Stateless Verification

  • Stateful: The verifier checks the SBT's current on-chain state (e.g., ownerOf(tokenId)). Revocation is a state change.
  • Stateless: The verifier checks a cryptographic proof (like a Merkle proof) against a published revocation list or root. The token isn't burned, but its ID is added to a list, enabling privacy-preserving verification.
05

Revocation Registries

A separate, on-chain registry contract maintains a list of revoked SBT identifiers (like a revocation list). Instead of burning tokens, issuers update this registry. Verifiers must check both token ownership and the registry. This pattern is common in Verifiable Credentials (VC) frameworks adapted for blockchain, allowing for more granular control and audit trails.

06

Social Recovery & Governance

In decentralized contexts, revocation authority may be distributed. A multi-signature wallet or a DAO vote could be required to execute a revocation, preventing unilateral action by a single issuer. This is critical for SBTs representing community status or decentralized identity attributes, aligning revocation with collective governance.

how-it-works
MECHANISMS

How SBT Revocation Works

An explanation of the technical and social mechanisms for invalidating or deactivating a Soulbound Token (SBT), a critical feature for managing reputation and credentials on-chain.

SBT revocation is the process by which an issuer invalidates a previously issued Soulbound Token, rendering it non-functional for verification or access control. Unlike the permanent binding implied by the name "soulbound," revocation is a necessary mechanism for correcting errors, responding to expired credentials, or penalizing bad behavior. This capability transforms SBTs from static badges into dynamic, accountable systems of attestation, ensuring that on-chain reputation can be updated or rescinded as circumstances change.

Technically, revocation can be implemented through several on-chain patterns. The most common is an issuer-managed revocation list, where the issuing smart contract or a separate registry maintains a list of revoked token identifiers. When a dApp checks an SBT's validity, it queries this list. Alternatively, expiration timestamps can be built into the token's logic, causing it to become invalid after a certain date. More advanced methods include using cryptographic proofs of non-inclusion in a Merkle tree, which allows for privacy-preserving revocation checks without revealing the entire list.

The social and governance layer of revocation is as critical as the technical implementation. Clear, transparent revocation policies must be established by the issuer, defining the conditions under which an SBT can be revoked—such as violation of community rules, proven fraud, or credential expiration. This prevents arbitrary or malicious deactivation. Furthermore, some designs incorporate appeal mechanisms or community governance votes for contentious revocations, balancing issuer control with holder rights. This ensures the system maintains trust and resists centralized abuse.

In practice, a user interacting with a protocol might present an SBT as a proof of membership or achievement. The verifying contract will first call a function like isRevoked(tokenId) on the issuer's contract. If the function returns true, access is denied. This check is a fundamental part of the verification logic for any SBT-gated application. For example, a lending protocol using a "Trusted Borrower" SBT would revoke the token if the borrower defaults, automatically removing their access to favorable loan terms in real-time across the entire ecosystem.

Ultimately, effective revocation mechanisms are what make SBTs practical for real-world use cases like professional licenses, academic degrees, and DAO memberships. They provide the necessary statefulness to credentials on a otherwise stateless blockchain. By combining immutable issuance with mutable revocation, SBT systems can mirror the complexity of off-chain trust relationships, where reputations can be both earned and lost.

ecosystem-usage
SBT REVOCATION

Ecosystem Usage & Standards

SBT revocation refers to the mechanisms and standards for invalidating or removing a Soulbound Token (SBT) from a holder's wallet, a critical function for managing credentials, memberships, and attestations on-chain.

01

Core Revocation Mechanisms

SBTs can be revoked through several technical methods, each with different trust assumptions and on-chain footprints. Key approaches include:

  • Burn Function: The issuer calls a function to destroy the token, removing it from the holder's address. This is permanent and on-chain.
  • Revocation List: The issuer maintains an on-chain or off-chain list (like a revocation registry) of invalidated token IDs. Verifiers must check this list to confirm status.
  • Expiry Timestamp: The token contains a built-in expiry time, after which it is considered invalid without a direct revocation transaction.
  • Pausable Contracts: The issuer can pause the entire smart contract, freezing all state changes or rendering all tokens temporarily invalid.
02

The EIP-4973 Standard

EIP-4973 (Account-bound Tokens) is a proposed standard that explicitly includes a revoke function. This function can only be called by the token's issuer, burning the token and emitting a Revoke event. This standardizes revocation at the smart contract level, providing a clear, auditable record of when and by whom a credential was invalidated. It contrasts with transferable ERC-721 tokens, where revocation is not a native concept.

03

Off-Chain Revocation with Attestations

Frameworks like Ethereum Attestation Service (EAS) handle revocation differently. An attestation (the core credential) is immutable, but the issuer can create a separate, linked revocation attestation. Verifiers must query the schema to check for an active revocation. This keeps the original record intact but flags it as invalid, which is useful for compliance and audit trails where a history of status changes is required.

04

Use Cases Driving Revocation Needs

The requirement for revocation emerges from real-world credential management:

  • Membership Termination: Revoking an SBT when a member leaves a DAO or community.
  • Credential Expiry: Invalidating a license, certification, or proof-of-attendance that is no longer valid.
  • Key Compromise: Removing access credentials if a wallet is suspected to be compromised.
  • Compliance & Legal Orders: Enforcing takedowns or sanctions required by law.
  • Error Correction: Revoking an attestation issued incorrectly or based on false information.
05

Privacy Considerations & Selective Disclosure

Simple on-chain revocation can leak privacy by broadcasting the revocation event. Advanced systems use zero-knowledge proofs (ZKPs). A holder can prove they possess a valid, unrevoked SBT from a set without revealing which specific token they hold or triggering a public revocation check against their address. This balances the need for issuer control with holder privacy.

06

Verifier's Responsibility & Status Checks

The security model shifts responsibility to the verifier. Simply checking for token ownership is insufficient. A verifier's application logic must actively check the revocation status by:

  1. Querying the smart contract's revocation state.
  2. Checking an on-chain revocation registry.
  3. Verifying there is no revocation attestation in a framework like EAS. Failure to perform this check is a critical security flaw, as it accepts invalidated credentials.
security-considerations
SBT REVOCATION

Security & Trust Considerations

SBT revocation refers to the mechanisms for invalidating a Soulbound Token, a critical function for managing identity, permissions, and compliance on-chain.

01

Revocation by Issuer

The most common model where the entity that minted the SBT (the issuer) retains exclusive control to revoke it. This is typically enforced via an owner or admin role in the smart contract. Revocation permanently burns the token or flags it as invalid in a registry.

  • Use Case: Revoking a credential for misconduct or expired membership.
  • Trust Assumption: Requires trust in the issuer's judgment and key management.
02

Time-Based Expiry

A self-revoking mechanism where an SBT automatically becomes invalid after a predefined timestamp or block height. The expiry logic is encoded directly into the token's smart contract.

  • Use Case: Temporary access passes, subscription credentials, or event tickets.
  • Security Benefit: Eliminates the need for a manual revocation transaction, reducing issuer overhead and potential key compromise risk.
03

Revocation Registries

A design pattern that separates the proof of validity from the token itself. A separate on-chain revocation registry (like a smart contract or a merkle tree) maintains a list of revoked token identifiers. Verifiers must check this registry to confirm an SBT's current status.

  • Use Case: Scalable systems where many issuers or verifiers are involved.
  • Example: The W3C Verifiable Credentials model often uses revocation registries.
04

User-Initiated Burning

A user-centric model where the token holder (the "soul") can destroy their own SBT. This is a key feature for privacy and self-sovereignty, allowing users to sever links or withdraw consent.

  • Trust Implication: Shifts control from issuer to holder, aligning with decentralized identity principles.
  • Consideration: May conflict with systems requiring immutable records for compliance.
05

Social Recovery & Governance

Revocation authority is distributed across a decentralized autonomous organization (DAO) or a set of trusted guardians. A vote or multi-signature scheme is required to approve a revocation.

  • Use Case: Community-issued reputation badges or decentralized identity attestations.
  • Security Model: Mitigates single-point-of-failure risks but introduces governance complexity and potential attack vectors.
06

Technical Risks & Challenges

Key security considerations for any revocation system:

  • Centralization Risk: An issuer's private key is a single point of failure.
  • State Bloat: Maintaining large revocation lists on-chain can be expensive.
  • Privacy Leaks: Checking a public registry for revocation can reveal when and why a specific SBT was invalidated.
  • Liveness Requirement: Relies on the underlying blockchain's availability for revocation transactions to be processed.
code-example
SBT REVOCATION

Code Example: Revocation Logic

A practical implementation of the mechanisms used to invalidate a Soulbound Token (SBT), demonstrating how programmatic control is enforced on-chain.

SBT revocation logic is the set of smart contract functions and conditions that allow an issuer to permanently invalidate a previously minted Soulbound Token. Unlike transfer functions, which are disabled, revocation is a core, intentional capability that enforces the issuer's ongoing authority. This logic is typically implemented through a state variable, like a mapping that tracks a token's active status, or a burn function restricted to the issuer's address. When invoked, the token is effectively 'burned' or flagged as inactive, removing its utility or attestation value from the holder's wallet without the possibility of transfer.

A common pattern involves an isRevoked mapping that returns a boolean for each token ID. The main contract functions, such as those checking for ownership or privileges, must first query this mapping. For example, a function like require(!isRevoked[tokenId], "Token revoked") acts as a gatekeeper. The issuer, or a designated authority, calls a revoke(tokenId) function that updates this mapping. This design separates state logic from the token URI or metadata, allowing the historical record of issuance to remain visible while the token's functional state is terminated.

Advanced revocation schemes can incorporate time-locks, multi-signature requirements, or vote-based governance to decentralize the revocation authority. For instance, a DAO might hold the revocation key, requiring a member vote to invalidate an SBT. The logic may also support partial revocation, where specific attributes or permissions of the token are disabled while others remain active. Implementing events, such as TokenRevoked(tokenId, reason), is crucial for off-chain indexers and applications to track the lifecycle of SBTs transparently.

Testing revocation logic is critical for security. This includes verifying that: only authorized callers can trigger revocation, revoked tokens cannot be used in gated applications, and the logic is resilient to reentrancy attacks. Developers often use upgradeable proxy patterns cautiously with SBTs, as changing revocation logic post-deployment could violate the immutability expectations of holders. The code example thus serves not just as a functional blueprint but as a foundation for trust-minimized social and reputational systems on-chain.

SBT STATE MANAGEMENT

Comparison: Revocation vs. Burning vs. Transfer

A comparison of three primary methods for managing the lifecycle and state of a Soulbound Token (SBT) on-chain.

Feature / MechanismRevocationBurningTransfer

Token State After Action

Invalidated but on-chain

Permanently destroyed

Moved to new owner

Token ID Persistence

On-Chain Record

Persists with revoked flag

Removed from total supply

Persists with updated owner

Reversibility

Potentially reversible by issuer

Reversible by new owner

Gas Cost

~45k-60k gas

~25k-40k gas

~50k-70k gas

Typical Use Case

Temporary suspension of privileges

Permanent retirement of credential

Explicit delegation of credential

Issuer Control Post-Action

Issuer retains metadata control

Issuer loses all control

Control transfers to new holder

Impact on Holder's Wallet

Token remains visible as revoked

Token is removed from view

Token is removed from sender's wallet

examples
SBT REVOCATION

Real-World Use Cases & Examples

Soulbound Token (SBT) revocation is a critical mechanism for managing digital identity and credentials on-chain. These examples illustrate how controlled token removal enables dynamic, trust-based systems.

01

Expiring Professional Credentials

A professional licensing body issues SBTs to certified engineers. These tokens are programmed with an expiration date and require periodic renewal. The organization's revocation authority can automatically burn tokens for members who fail to complete continuing education, instantly updating their on-chain credential status. This creates a self-cleaning registry of currently qualified professionals.

02

DAO Membership & Governance

A decentralized autonomous organization (DAO) grants voting rights via membership SBTs. The DAO's multisig council holds revocation power to remove tokens from members who violate the community's code of conduct or are found to be acting maliciously. This protects the DAO from sybil attacks and ensures governance power is held by trusted, active participants. Revocation severs all governance access instantly.

03

Dynamic Credit Scoring

A decentralized credit protocol issues SBTs representing credit scores based on on-chain repayment history. The protocol's smart contract logic can automatically revoke (burn) a high-score SBT if the holder defaults on a loan. Conversely, it can issue a new, lower-score SBT. This creates a real-time, behavior-based financial identity system without centralized intermediaries.

04

University Degree Verification

A university issues non-transferable diploma SBTs to graduates. If a degree is later rescinded due to academic misconduct (e.g., plagiarism), the university's authorized revocation key can burn the token. This provides a definitive, globally-verifiable record that the credential is no longer valid, surpassing the capabilities of traditional paper diplomas or static digital records.

05

Event & Community Access

An exclusive conference or online community uses SBTs as access passes. The event organizer can revoke tokens from attendees who violate event rules (e.g., harassment), immediately revoking their access to gated chat channels or future event registrations. This enables programmable consequences within digital and physical spaces, enforcing community standards directly through asset control.

06

Supply Chain Attestations

An auditing firm issues SBTs to factories certifying ethical labor practices. This SBT is linked to the factory's digital identity. If an audit reveals violations, the firm can revoke the certification SBT. Downstream brands and consumers can query the blockchain to see that the attestation is no longer valid, enabling dynamic, trust-minimized supply chain verification.

FAQ

Common Misconceptions About SBT Revocation

Soulbound Token (SBT) revocation is a nuanced mechanism often misunderstood. This section clarifies the technical realities behind common assumptions about how SBTs can be removed, burned, or rendered invalid.

No, a core property of a Soulbound Token (SBT) is non-transferability, meaning it cannot be moved from the wallet to which it was originally minted. This is enforced at the smart contract level, typically by overriding the standard ERC-721 transferFrom function to revert any transfer attempt. The token is permanently "bound" to that cryptographic identity or "soul." However, the token holder or an authorized entity (like the issuer) can still call a burn or revoke function to destroy the token, removing it from their wallet entirely. This is not a transfer but a state change on-chain that sets the token's existence to false.

SBT REVOCATION

Frequently Asked Questions (FAQ)

Soulbound Token (SBT) revocation is a critical mechanism for managing on-chain credentials. These questions address how revocation works, its technical implementation, and its implications for decentralized identity.

SBT revocation is the process of invalidating or removing the permissions associated with a Soulbound Token, rendering it non-functional for its intended purpose. It is necessary to maintain the integrity of decentralized identity systems by allowing for the correction of errors, the response to compromised credentials, or the withdrawal of privileges. Without a revocation mechanism, SBTs representing credentials like diplomas, licenses, or memberships would be permanent and immutable, which is impractical for real-world applications where statuses can change. Revocation enables dynamic, accountable, and trustworthy credential systems on the blockchain.

ENQUIRY

Get In Touch
today.

Our experts will offer a free quote and a 30min call to discuss your project.

NDA Protected
24h Response
Directly to Engineering Team
10+
Protocols Shipped
$20M+
TVL Overall
NDA Protected Directly to Engineering Team