diff --git a/docs/GLOSSARY.md b/docs/GLOSSARY.md new file mode 100644 index 00000000..d36b1332 --- /dev/null +++ b/docs/GLOSSARY.md @@ -0,0 +1,185 @@ +# AITBC Master Glossary + +**Last Updated:** 2026-05-09 +**Version:** 1.0 +**Purpose:** Comprehensive glossary of AITBC-specific terms, acronyms, and concepts + +--- + +## A + +- **AITBC**: Artificial Intelligence Training Blockchain - The blockchain platform for decentralized AI compute training +- **AIT**: AITBC Token - The native cryptocurrency token used for transactions, staking, and governance on the AITBC network +- **Agent**: An autonomous software entity that performs tasks on the AITBC network, such as wallet management, AI job submission, or marketplace operations +- **Agent Coordinator**: A specialized agent type that orchestrates multi-agent workflows and manages complex coordination tasks +- **Agent SDK**: Software Development Kit for building AITBC agents with identity management, authentication, and communication capabilities +- **Agent Type**: Classification of agents based on their capabilities (coordinator, genesis, follower, wallet, general, specialized, architect) +- **Architect Agent**: Expert agent type that designs and manages multi-chain architectures and bridge protocols + +## B + +- **Bridge Protocol**: Cross-chain mechanism enabling asset transfers and communication between different blockchain networks +- **Bounty System**: Marketplace feature where agents can post bounties for specific tasks and earn rewards for completing them +- **Blockchain Node**: A node running the AITBC blockchain software that participates in consensus and maintains the blockchain state +- **Block Reward**: Tokens earned by miners for successfully mining and adding blocks to the blockchain + +## C + +- **CLI**: Command Line Interface - The aitbc-cli tool for interacting with the AITBC blockchain and services +- **Consensus**: The mechanism by which blockchain nodes agree on the state of the blockchain +- **Coordinator API**: REST API service for coordinating agent operations and managing system-wide resources +- **Cross-Chain**: Operations involving multiple blockchain networks or islands +- **Cross-Chain Transfer**: Moving assets or data between different blockchain networks using bridge protocols +- **CoW**: Copy-on-Write - A filesystem feature that can cause SQLite corruption when used with database files + +## D + +- **DAO**: Decentralized Autonomous Organization - Governance structure for AITBC network decisions +- **Distributed Consensus**: Agreement mechanism across multiple nodes in a network +- **Distributed AI Training**: AI model training distributed across multiple compute providers + +## E + +- **Enterprise AI Agent**: Specialized agent for enterprise-level AI operations and workflows +- **Edge Compute Agent**: Agent that manages edge computing resources and operations + +## F + +- **Federated Learning Coordinator**: Agent that coordinates federated learning across multiple participants +- **Follower Agent**: Agent type that monitors blockchain state and maintains synchronization +- **Failure Recovery**: Stage 10 training covering error handling, recovery procedures, and fault tolerance +- **Faucet**: A service that provides test tokens for development and testing purposes + +## G + +- **Genesis Agent**: Agent type responsible for blockchain genesis operations and network bootstrap +- **Genesis Block**: The first block in a blockchain that initializes the network +- **Genesis Deployment**: Creating and deploying a genesis block to initialize a new blockchain network +- **GPU Service**: Service for managing GPU resources and compute capacity +- **Governance Voting**: Mechanism for token holders to vote on network proposals and decisions +- **Gossip Protocol**: Peer-to-peer communication protocol for message dissemination in the AITBC network + +## H + +- **Hermes**: The AI agent training curriculum and learning system for AITBC agents +- **HTLC**: Hashed Time-Locked Contract - Smart contract mechanism for atomic cross-chain swaps +- **Health Check**: Status verification for services and system components + +## I + +- **IPFS**: InterPlanetary File System - Decentralized storage system used by AITBC for content-addressed storage +- **Island**: An independent blockchain network or chain within the AITBC federated mesh +- **Island Creation**: Process of creating a new island or independent blockchain network +- **Identity SDK**: SDK for agent identity management, authentication, and permission handling + +## J + +- **JWT**: JSON Web Token - Authentication token format used for secure API authentication +- **Job Submission**: Process of submitting AI compute jobs to the AITBC network + +## K + +- **Keystore**: Encrypted file format for storing wallet private keys securely +- **Knowledge Graph**: Structured representation of knowledge used by specialized agents + +## L + +- **Ledger**: The record of all transactions on the blockchain + +## M + +- **Marketplace**: Platform for trading GPU resources, storage, and other services +- **Marketplace Bidding**: Competitive bidding mechanism for acquiring marketplace resources +- **Mining**: Process of validating transactions and creating new blocks to earn block rewards +- **Multi-Chain**: Operations spanning multiple blockchain networks +- **Multi-Chain Architecture**: Design patterns for managing assets and operations across multiple chains +- **Multi-Node**: Operations involving multiple blockchain nodes +- **Monitoring Agent**: Agent that collects and analyzes system metrics and performance data + +## N + +- **Network Topology**: The structure and arrangement of nodes and connections in the network +- **Node**: A participant in the blockchain network that runs blockchain software + +## O + +- **Operations Audit**: Review and analysis of training operations coverage and execution records +- **Ollama**: External AI service integration plugin for local LLM inference +- **Oracle**: Agent or service that provides external data to the blockchain + +## P + +- **PoS**: Proof-of-Stake - Consensus mechanism where validators stake tokens to participate in block validation +- **PoW**: Proof-of-Work - Consensus mechanism where miners solve computational puzzles to validate blocks +- **Portfolio Management**: Agent capability for managing investment portfolios and assets +- **Plugin**: Extensible software component that adds functionality to the AITBC system + +## R + +- **RPC**: Remote Procedure Call - Protocol for blockchain node communication +- **Redis**: In-memory data store used for caching and pub/sub messaging + +## S + +- **SDK**: Software Development Kit +- **Specialized Agent**: Agent type with domain-specific expertise (bounty systems, portfolio management, etc.) +- **Staking**: Locking tokens to earn rewards and participate in network governance +- **Staking Validator Agent**: Agent that operates as a validator in the Proof-of-Stake consensus +- **Scenario**: A documented use case or workflow demonstrating AITBC functionality +- **Smart Contract**: Self-executing contract with terms directly written into code +- **Swarm Coordinator**: Agent that manages and coordinates groups of agents (swarms) +- **Systemd**: Linux service manager for running AITBC services as system daemons + +## T + +- **Transaction**: A transfer of value or data on the blockchain +- **Transaction Send**: CLI operation for sending transactions on the blockchain +- **Training Schema**: JSON schema defining the structure and requirements for agent training stages +- **Training Stage**: A level in the agent training curriculum (Stage 1-11) + +## V + +- **Validator**: A node that participates in consensus by validating transactions and blocks +- **Validation**: Process of verifying operations, transactions, or training completion +- **Version Control**: System for managing changes to documentation and code + +## W + +- **Wallet**: Software for managing AIT tokens and signing transactions +- **Wallet Agent**: Agent type focused on wallet operations +- **Wallet Balance**: Amount of AIT tokens in a wallet +- **Wallet Create**: CLI operation for creating a new wallet +- **Wallet Fund**: Adding tokens to a wallet (deprecated in favor of transaction_send) +- **Wallet Import**: Importing an existing wallet from a private key +- **WAL Mode**: Write-Ahead Logging - SQLite journal mode for better concurrency and performance + +## Z + +- **Zero Knowledge Proof**: Cryptographic method for proving knowledge without revealing the knowledge itself +- **ZK Verification**: Zero-knowledge proof verification process + +## Acronyms Quick Reference + +| Acronym | Full Term | +|---------|-----------| +| AITBC | Artificial Intelligence Training Blockchain | +| AIT | AITBC Token | +| CLI | Command Line Interface | +| DAO | Decentralized Autonomous Organization | +| GPU | Graphics Processing Unit | +| HTLC | Hashed Time-Locked Contract | +| IPFS | InterPlanetary File System | +| JWT | JSON Web Token | +| PoS | Proof-of-Stake | +| PoW | Proof-of-Work | +| RPC | Remote Procedure Call | +| SDK | Software Development Kit | +| WAL | Write-Ahead Logging | +| ZK | Zero Knowledge | + +--- + +**Related Documentation:** +- [Agent Training Documentation](agent-training/README.md) +- [Scenarios Documentation](scenarios/README.md) +- [Blockchain Documentation](blockchain/README.md)