🧠Concepts
This directory contains detailed explanations of the core concepts and data structures that form the foundation of the BitBadges module.
Overview
Each concept is documented in its own file for better organization and easier navigation:
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 badge ownership is tracked with precise control over quantities and time
Balances Type - How badge ownership and transfers are managed within collections
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 badge transfers
Approval Criteria - Detailed approval criteria and conditions for badge 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
Protocols - Standardized implementation patterns for badge collections
Last updated