🧠Concepts
This directory contains detailed explanations of the core concepts and data structures that form the foundation of the BitBadges module.
UintRange - Representing ranges of unsigned integers
Timeline System - How properties change over time with immutable historical records
Badge Collections - The primary entity that defines groups of related badges
Balance System - How token ownership is tracked with precise control over quantities and time
Balances Type - How token ownership and transfers are managed within collections
Off-Chain Balances - Legacy off-chain balance types (deprecated - use Standard balances)
Default Balances - Predefined balance stores assigned to new users upon genesis creation
Valid Badge IDs - Defining the range of badge identifiers that can exist within a collection
Total Supply - Maximum number of badges that can exist for each badge ID
Mint Escrow Address - Reserved address for holding native funds on behalf of the Mint address
Archived Collections - Temporarily or permanently disabling collection transactions
Metadata - Rich, dynamic content for collections and badges with timeline support
Manager - Central authority for collection administration with timeline-based control
Transferability & Approvals - Overview of the three-tier approval system for token transfers
Approval Criteria - Detailed approval criteria and conditions for token transfers
Address Lists - Reusable collections of addresses for approval configurations
Permissions - Granular control over collection management operations
Standards - Generic framework for defining collection behavior and interpretation guidelines
Time Fields - Understanding the different time-related fields used throughout BitBadges
Custom Data - Generic string fields for storing arbitrary application-specific data
Cosmos Wrapper Paths - 1:1 wrapping between badges and native Cosmos SDK coins for IBC compatibility
Collection Invariants - Immutable rules that enforce fundamental constraints on collection behavior
Protocols - Standardized implementation patterns for badge collections
Last updated