anya-core 1.2.0

Enterprise-grade Bitcoin Infrastructure Platform
Documentation

title: "Anya Core" description: "Enterprise Bitcoin Infrastructure Platform with Layer2 Protocol Integration"

Anya Core [AIR-3][AIS-3][BPC-3][RES-3]

A modular Bitcoin infrastructure platform designed for enterprise applications, Layer2 protocol integration, and decentralized AI/ML systems.

Build Status BIP-341 Layer2 Rust

Last Updated: July 14, 2025 Version: 1.2.0

📖 Documentation Hub

👉 Complete Documentation - Comprehensive guides and references

Quick Navigation:

Table of Contents

Overview

Anya Core is an advanced integrated system combining Bitcoin/crypto functionality, ML-based analytics, and Web5 decentralized data management with enterprise-grade security and revenue tracking. Built on a hexagonal architecture, it provides a robust, scalable, and secure platform for institutional-grade operations.

Core Bitcoin Features:

  • Bitcoin transaction processing and validation
  • Taproot (BIP-341) and Tapscript (BIP-342) support
  • PSBT (Partially Signed Bitcoin Transactions) implementation
  • Schnorr signatures (BIP-340) integration
  • Comprehensive Bitcoin wallet functionality

Layer2 Protocol Framework:

  • Lightning Network payment channels
  • RGB protocol for asset issuance
  • Discrete Log Contracts (DLC)
  • State channels implementation
  • Taproot Assets support
  • Cross-protocol interoperability

Enterprise Infrastructure:

  • Hexagonal architecture with clean separation of concerns
  • Hardware Security Module (HSM) integration
  • Comprehensive monitoring and metrics
  • Modular component design
  • Production-ready security measures

AI Labeling: This project follows the AI Labeling System with standardized compliance markers for AI readiness, security, and Bitcoin protocol compliance.

System Architecture:

┌─────────────────┐    ┌──────────────┐    ┌─────────────────┐
│   Applications  │    │   Web APIs   │    │  External Tools │
└─────────────────┘    └──────────────┘    └─────────────────┘
         │                       │                       │
    ┌────┴───────────────────────┴───────────────────────┴────┐
    │                   Anya Core                             │
    │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │
    │  │   Bitcoin   │  │   Layer2    │  │   Enterprise    │  │
    │  │   Protocol  │  │  Protocols  │  │  Infrastructure │  │
    │  └─────────────┘  └─────────────┘  └─────────────────┘  │
    └─────────────────────────────────────────────────────────┘

Quick Start

1. Prerequisites

# System requirements
- Rust 1.70+ with Cargo
- Git for version control
- 4GB+ RAM available
- 10GB+ disk space

# Optional for full features
- Bitcoin Core 24.0+ (for full Bitcoin integration)
- Docker (for containerized deployment)

2. Clone and Build

git clone https://github.com/Anya-org/Anya-core.git
cd Anya-core
cargo build --release

3. Basic Configuration

Create a basic configuration file:

mkdir -p ~/.config/anya-core
cat > ~/.config/anya-core/config.toml << EOF
[bitcoin]
network = "testnet"
rpc_url = "http://localhost:18332"

[layer2]
enabled = ["lightning", "rgb"]

[security]
hsm_enabled = false
log_level = "info"
EOF

4. Run Tests

# Run core functionality tests
cargo test --lib

# Run integration tests (requires setup)
cargo test --test integration_tests

5. Basic Usage

use anya_core::{BitcoinClient, Layer2Manager};

// Initialize Bitcoin client
let bitcoin_client = BitcoinClient::new(config)?;

// Create Layer2 manager for protocol integration
let layer2_manager = Layer2Manager::new()?;

// Process Bitcoin transactions
let tx_result = bitcoin_client.process_transaction(raw_tx)?;
println!("Transaction processed: {}", tx_result.txid);

Installation & Configuration

System Requirements

Minimum Requirements:

  • CPU: 8+ cores recommended
  • RAM: 16GB+ recommended
  • Storage: 1TB+ SSD recommended
  • Network: 1Gbps+ recommended
  • GPU: Optional for ML acceleration
  • NPU: Optional for advanced ML

Software Dependencies:

  • Rust 1.70+
  • PostgreSQL 14+
  • Redis 7.0+
  • Bitcoin Core 24.0+
  • Python 3.10+ (for ML components)

Installation Methods

Option 1: Quick Setup (Development)

# Clone and build
git clone https://github.com/Anya-org/Anya-core.git
cd Anya-core
cargo build --release

# Run setup script
./scripts/setup.sh

Option 2: Manual Installation

# Install Rust if not present
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Build the project
cargo build --release --features "complete"

# Install system-wide (optional)
sudo cp target/release/anya-core /usr/local/bin/

Configuration System

Configuration Files:

  • Main config: ~/.config/anya-core/config.toml
  • Bitcoin settings: ~/.config/anya-core/bitcoin.toml
  • Layer2 protocols: ~/.config/anya-core/layer2.toml

Example Configuration:

# ~/.config/anya-core/config.toml
[bitcoin]
network = "testnet"                    # testnet, mainnet, regtest
rpc_url = "http://localhost:18332"     # Bitcoin Core RPC
data_dir = "~/.anya-core/bitcoin"

[layer2]
enabled_protocols = ["lightning", "rgb", "dlc"]
lightning_node_url = "localhost:9735"

[security]
hsm_enabled = false                    # Enable for production
audit_logging = true
max_concurrent_operations = 100

[monitoring]
metrics_enabled = true
prometheus_port = 9090
log_level = "info"                     # trace, debug, info, warn, error

Environment Variable Overrides:

# Override any config value with environment variables
export ANYA_BITCOIN_NETWORK=mainnet
export ANYA_BITCOIN_RPC_URL=http://localhost:8332
export ANYA_SECURITY_HSM_ENABLED=true
export ANYA_MONITORING_LOG_LEVEL=debug

Core Features

Bitcoin Protocol Implementation

Consensus Layer:

  • BIP-341 (Taproot): Full implementation with key-path and script-path spending
  • BIP-342 (Tapscript): Complete script validation and execution
  • BIP-340 (Schnorr): Schnorr signature verification and batch validation
  • BIP-174 (PSBT): Partially Signed Bitcoin Transaction processing
  • Transaction Validation: Comprehensive validation including SegWit and Taproot

Wallet Functionality:

  • HD wallet implementation (BIP-32/39/44)
  • Multi-signature support
  • Hardware wallet integration ready
  • PSBT creation, signing, and finalization

Layer2 Protocol Framework

Currently Implemented:

  • Lightning Network: Payment channel management and routing foundation
  • RGB Protocol: Client-side validation framework for assets
  • State Channels: Generalized off-chain state management
  • DLC (Discrete Log Contracts): Oracle-based contract framework
  • Taproot Assets: Asset issuance on Bitcoin using Taproot

Integration Status:

  • BOB Protocol: Bitcoin-EVM bridge (framework ready)
  • RSK Integration: Rootstock sidechain support (in development)
  • Liquid Network: Sidechain integration (planned)
  • Stacks: Bitcoin layer for smart contracts (planned)

Enterprise Infrastructure

Architecture:

  • Hexagonal Design: Clean separation between business logic and adapters
  • Modular Components: Independent protocol implementations
  • Error Handling: Comprehensive error types and recovery mechanisms
  • Logging & Metrics: Structured logging with Prometheus metrics

Security Features:

  • HSM Integration: Hardware Security Module support for key management
  • Audit Trail: Comprehensive logging for compliance requirements
  • Input Validation: Strict validation for all external inputs
  • Constant-time Operations: Cryptographic operations resistant to timing attacks

Monitoring & Operations:

  • Health Checks: System health monitoring endpoints
  • Metrics Collection: Performance and operational metrics
  • Configuration Management: Flexible configuration with environment overrides
  • Resource Management: Memory and CPU usage optimization

Technical Implementation

Dependencies & Technology Stack

Core Languages & Frameworks:

  • Rust: Primary implementation language for performance and safety
  • Tokio: Async runtime for concurrent operations
  • Bitcoin Libraries: bitcoin, secp256k1, bdk for Bitcoin protocol implementation

Key Dependencies (from Cargo.toml):

[dependencies]
# Bitcoin ecosystem
bitcoin = { version = "0.32.6", features = ["std", "serde", "rand"] }
secp256k1 = { version = "0.29.1", features = ["rand-std", "global-context"] }
bdk = { version = "0.30", features = ["std", "compiler"] }

# Async runtime and networking
tokio = { version = "1.45.1", features = ["full"] }
hyper = { version = "1.6.0", features = ["full"] }

# Serialization and data handling
serde = { version = "1.0.219", features = ["derive", "rc"] }
serde_json = { version = "1.0.140", features = ["preserve_order"] }

# Error handling and logging
anyhow = { version = "1.0.98", features = ["std", "backtrace"] }
tracing = { version = "0.1.41", features = ["std", "attributes"] }

Project Structure

src/
├── bitcoin/              # Bitcoin protocol implementation
│   ├── consensus/        # Consensus rules and validation
│   ├── script/          # Script execution and Taproot support
│   └── transaction/     # Transaction processing and PSBT
├── layer2/              # Layer2 protocol implementations
│   ├── lightning/       # Lightning Network integration
│   ├── rgb/            # RGB protocol for assets
│   ├── dlc/            # Discrete Log Contracts
│   └── manager.rs      # Protocol coordination
├── security/           # Security and cryptographic operations
│   ├── hsm/           # Hardware Security Module integration
│   └── audit/         # Security auditing framework
├── core/              # Core system components
│   ├── config/        # Configuration management
│   └── error/         # Error handling
└── api/               # External API interfaces

BIP Compliance Status

Fully Implemented:

  • ✅ BIP-340: Schnorr Signatures for secp256k1
  • ✅ BIP-341: Taproot: SegWit version 1 spending rules
  • ✅ BIP-342: Validation of Taproot Scripts
  • ✅ BIP-174: Partially Signed Bitcoin Transaction Format

In Progress:

  • 🔄 BIP-370: PSBT Version 2 (85% complete)
  • 🔄 BIP-322: Generic Signed Message Format (partial)

Test Coverage:

  • BIP-341: 95% test coverage
  • BIP-342: 90% test coverage
  • BIP-174: 100% test coverage
  • Overall BIP Compliance: 92%

Development Status

Current Implementation Status

🟢 Completed Components:

  • Bitcoin transaction processing and validation
  • Taproot (BIP-341/342) implementation
  • PSBT transaction handling
  • Core Layer2 protocol framework
  • HSM integration architecture
  • Configuration and error handling systems

🟡 In Active Development:

  • Lightning Network payment processing
  • RGB asset management
  • DLC contract execution
  • Cross-protocol interoperability
  • Production deployment tooling

🔴 Planned Features:

  • Web5 decentralized identity integration
  • Advanced ML/AI system integration
  • DAO governance mechanisms
  • Mobile SDK development
  • Enterprise administration portal

Layer2 Protocol Status

Protocol Status Implementation Notes
Lightning Network 🟡 Framework Ready Core interfaces implemented Payment processing in development
RGB Protocol 🟡 Framework Ready Asset framework complete Client integration ongoing
State Channels 🟢 Implemented Generalized framework Ready for protocol-specific implementations
DLC 🟡 Framework Ready Oracle integration planned Contract execution in development
Taproot Assets 🟡 Framework Ready Asset issuance foundation Full implementation in progress
BOB Protocol 🔴 Planned EVM bridge design Integration planned for Q3 2025
RSK 🔴 Planned Sidechain integration Development planned for Q4 2025

Build & Test Status

# Current test results
Running 91 tests... ✅ PASSING
- Core Bitcoin: 28 tests passing
- Layer2 Framework: 15 tests passing  
- Security Components: 12 tests passing
- Integration Tests: 9 tests passing
- Utility Tests: 27 tests passing

Build Status: ✅ Clean compilation
Lint Status: ⚠️ 1 warning (unused import)

Testing & Validation

Running Tests

Unit Tests:

# Run all unit tests
cargo test --lib

# Run specific module tests
cargo test bitcoin::
cargo test layer2::
cargo test security::

Integration Tests:

# Run Layer2 integration tests
cargo test --test layer2_integration_comprehensive

# Run Bitcoin protocol tests  
cargo test --test bitcoin_integration

BIP Compliance Testing:

# Validate BIP compliance
./scripts/bitcoin/validate-bip-compliance.js

# Run BIP test vectors
cargo test --test bip_tests -- --nocapture

Validation Tools

Security Validation:

# Run security audit
cargo audit

# Check for unsafe code
cargo geiger

# Run clippy for code quality
cargo clippy -- -D warnings

Performance Testing:

# Run benchmarks
cargo bench

# Memory usage analysis
cargo test --release -- --nocapture | grep "memory"

Contributing

We welcome contributions to Anya Core! This project is actively developed and we appreciate community involvement.

How to Contribute

1. Development Setup:

# Fork and clone the repository
git clone https://github.com/your-username/Anya-core.git
cd Anya-core

# Set up development environment
./scripts/setup.sh
cargo build

# Run tests to ensure everything works
cargo test --lib

2. Areas for Contribution:

  • 🔧 Core Bitcoin Features: Transaction processing, script validation, wallet functionality
  • ⚡ Layer2 Protocols: Lightning Network, RGB, DLC implementations
  • 🔒 Security Enhancements: HSM integration, audit frameworks, cryptographic operations
  • 📚 Documentation: API documentation, tutorials, architecture guides
  • 🧪 Testing: Unit tests, integration tests, BIP compliance validation

3. Development Guidelines:

4. Submission Process:

# Create feature branch
git checkout -b feature/your-feature-name

# Make changes and test
cargo test --lib
cargo clippy -- -D warnings

# Commit with proper labels
git commit -m "feat(bitcoin): implement BIP-XXX support

[AIR-3][AIS-3][BPC-3] Detailed description of changes

Labels: [AIR-3][AIS-3][BPC-3]
Scope: bitcoin, protocol"

# Submit pull request
git push origin feature/your-feature-name

Getting Help

  • 📖 Documentation: Start with docs/ for comprehensive guides
  • 🐛 Issues: Report bugs via GitHub Issues
  • 💬 Discussions: Join discussions for questions and feature requests
  • 📧 Contact: Reach out to maintainers for complex technical questions

License & Resources

License

This project is dual-licensed under:

  • MIT License - For open source use
  • Apache 2.0 License - For enterprise applications

See LICENSE for full license text.

Resources & Links

Project Resources:

Bitcoin Standards:

Community:

Acknowledgments

Special thanks to the following projects and communities that make Anya Core possible:

  • Bitcoin Core - Reference implementation and standards
  • Rust Bitcoin - Rust Bitcoin ecosystem libraries
  • Lightning Development Kit (LDK) - Lightning Network implementation
  • RGB Protocol - Client-side validation framework
  • TBD/Block - Web5 and identity technologies

Maintainer: Botshelo Mokoka (botshelomokoka@gmail.com)
Last Updated: July 15, 2025
Version: 1.2.1 Development Build