🌐 Allianza Blockchain

Quantum-Safe, Bridge-Free Cross-Chain Interoperability Platform

Live Demo • Documentation • Security • Contributing

📌 Executive Summary

Allianza Blockchain is a next-generation interoperability protocol enabling real cross-chain transfers between completely different blockchains (Bitcoin, Ethereum, Polygon, Solana) without bridges, custody, or wrapped tokens — using cryptographic proofs and quantum-resistant security. The protocol provides a production-ready foundation for enterprises, financial institutions, and exchanges seeking secure, auditable cross-chain interoperability without the risks associated with traditional bridge solutions. A working testnet with verifiable on-chain proofs is publicly available.

🎯 Overview

Allianza Blockchain is a production-grade, quantum-safe interoperability platform that enables real cross-chain transfers between completely different blockchains (Bitcoin, Ethereum, Polygon, Solana) without bridges, custody, or wrapped tokens.

💼 Commercial Licensing: Production deployments, enterprise integrations, and real cross-chain adapters are available under a commercial license. Contact us for production access.

👥 Who is this for?

This platform is designed for:

🔐 Blockchain Developers - Build decentralized applications with cross-chain capabilities
🏦 Financial Institutions - Integrate secure, quantum-resistant interoperability into banking systems
💱 Exchanges & Custodians - Enable cross-chain transfers without bridge custody risks
🏢 Enterprises - Deploy production-grade interoperability with compliance and SLA support
🔬 Researchers & Academics - Study quantum-safe cryptography and bridge-free interoperability protocols

⚠️ What is NOT included here

This public repository provides the open core of Allianza Blockchain. The following are NOT included and require a commercial license:

❌ Production Execution Engines - Real transaction signing and broadcasting services
❌ Enterprise Integrations - Custom adapters, compliance layers, and regulatory features
❌ SLA-Backed Infrastructure - Production deployment with service level agreements
❌ Commercial Support - Technical support, roadmap influence, and priority assistance
❌ Mainnet Adapters - Production-ready blockchain connectors for mainnet operations

For production deployment, enterprise features, or commercial use, please contact: [email protected]

🌟 Key Innovations

🔐 Quantum-Safe Security - Post-quantum cryptography (NIST PQC standards: ML-DSA, ML-KEM, SPHINCS+)
🌉 Bridge-Free Interoperability - Direct transfers without custodial bridges or wrapped tokens
🔒 Zero-Knowledge Proofs - Every cross-chain state transition is cryptographically verified
🆔 UChainID - Universal Chain ID for on-chain traceability of cross-chain transfers
⚡ Real Cross-Chain Transfers - Live Polygon → Bitcoin testnet transfers with on-chain verification

📋 Open Core Strategy

Allianza Blockchain follows an "Open Core + Paid Brain" strategy:

🟢 Open Source (MIT License)

✅ Core Protocol - ALZ-NIEV protocol, UChainID system, quantum security specs
✅ Testnet - Full testnet implementation for development and testing
✅ Documentation - Complete specs, whitepapers, and technical proofs
✅ Examples - Educational examples and demos

🔒 Commercial License Required

Production deployments, enterprise integrations, and real cross-chain adapters are available under a commercial license.

🔒 Production Adapters - Production-ready blockchain connectors
🔒 Enterprise Integration - Custom adapters, compliance, optimization
🔒 Support & Services - Production deployment, SLA, roadmap influence

For commercial use, production deployment, or enterprise integration, please contact: [email protected]

Commercial Code Repository: Production implementations are available in our private repository: blockchainallianza-business (private, requires license)

📖 Learn more: See OPEN_CORE_STRATEGY.md and COMMERCIAL_LICENSE.md

🚀 Live Demo

Testnet Dashboard: https://testnet.allianza.tech

Example Real Transaction

Polygon → Bitcoin Testnet Transfer:

Bitcoin Testnet TX: 2b010250667459e2bc30fd4a33f9caab937310156839c87364a5ba075594e554
UChainID: UCHAIN-... (visible in testnet dashboard)
ZK Proof: Verifiable via embedded proof verifier

✨ Features

🔐 Quantum-Safe Cryptography

NIST PQC Standards: ML-DSA (signatures), ML-KEM (key exchange), SPHINCS+ (hash-based)
QRS-3 (Triple Redundancy): Three independent PQC signatures for maximum security
Quantum Attack Resistance: Protection against Shor's and Grover's algorithms
Cryptographic Agility: Easy migration to new PQC standards

🌉 Bridge-Free Interoperability (ALZ-NIEV)

No Custody: No locked funds in bridge contracts
No Wrapped Tokens: Direct native token transfers
No Intermediaries: Peer-to-peer cross-chain execution
UChainID System: Global identifier for cross-chain transfers
ZK Proofs: Cryptographic verification of state transitions

🔗 Supported Blockchains

✅ Bitcoin (Testnet/Mainnet)
✅ Ethereum (Testnet/Mainnet)
✅ Polygon (Testnet/Mainnet)
✅ Solana (Testnet/Mainnet)
✅ BSC (Binance Smart Chain)
✅ Allianza Native Chain

🛡️ Security Features

CSRF Protection - Applied to all critical routes
Rate Limiting - Global protection against DDoS
Input Validation - Comprehensive sanitization
Security Headers - CSP, COEP, COOP
Audit Logging - Complete transaction traceability
Path Traversal Protection - Secure file handling

🚀 Quick Start

Prerequisites

Python 3.10+
pip and virtualenv (recommended)
Node.js (optional, for rebuilding Tailwind/JS assets)

Installation

# Clone the repository
git clone https://github.com/allianzatech/blockchainallianza.git
cd blockchainallianza

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

Configuration

Create a .env file in the project root. See the example below for required variables:

Required Variables:

# Flask Configuration
FLASK_ENV=development
FLASK_DEBUG=True
SECRET_KEY=your-secret-key-here  # Generate with: python -c "import secrets; print(secrets.token_hex(32))"

# Blockchain APIs (Testnet)
BLOCKCYPHER_API_TOKEN=your_blockcypher_token
BITCOIN_PRIVATE_KEY=your_bitcoin_testnet_wif
BITCOIN_TESTNET_ADDRESS=your_bitcoin_testnet_address

# EVM Chains (Testnet)
POLYGON_PRIVATE_KEY=your_polygon_private_key
ETH_PRIVATE_KEY=your_ethereum_private_key
POLYGON_RPC_URL=https://polygon-mumbai.g.alchemy.com/v2/YOUR_KEY
ETH_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY

# Solana (Testnet)
SOLANA_PRIVATE_KEY=your_solana_private_key
SOLANA_RPC_URL=https://api.testnet.solana.com

⚠️ Important:

Never commit real mainnet keys. Only use testnet keys for development.

The .env file is already in .gitignore to prevent accidental commits.

For a complete list of environment variables, see the configuration section in the codebase.

Run Locally

Development Mode:

python allianza_blockchain.py

Production Mode (Gunicorn):

gunicorn -w 2 -b 0.0.0.0:5000 --timeout 300 --keep-alive 5 --preload wsgi_optimized:application

Then open: http://localhost:5000/interoperability

🏗️ Architecture

Core Components

┌─────────────────────────────────────────────────────────────┐
│                    Allianza Blockchain                       │
├─────────────────────────────────────────────────────────────┤
│                                                               │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐     │
│  │  Quantum     │  │  ALZ-NIEV    │  │  UChainID    │     │
│  │  Security    │  │  Interop     │  │  System      │     │
│  └──────────────┘  └──────────────┘  └──────────────┘     │
│                                                               │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐     │
│  │  ZK Proofs  │  │  Cross-Chain │  │  State       │     │
│  │  System     │  │  Bridge      │  │  Machine     │     │
│  └──────────────┘  └──────────────┘  └──────────────┘     │
│                                                               │
└─────────────────────────────────────────────────────────────┘

Technology Stack

Backend: Python 3.10+, Flask 2.3.3
Blockchain: Web3.py, bitcoinlib, python-bitcointx, solana-py
Cryptography: liboqs-python (NIST PQC), cryptography
Database: SQLite (development), PostgreSQL-ready
Frontend: HTML5, Tailwind CSS, JavaScript
Deployment: Gunicorn, Render.com

🔒 Security

Security Audit

A comprehensive security audit has been performed. See:

Security Audit Report - Full vulnerability analysis
Dependency Vulnerabilities Report - Dependency security status

Security Features Implemented

✅ Path Traversal Protection - Secure file download validation
✅ CSRF Protection - Applied to all critical POST routes
✅ Rate Limiting - Global DDoS protection
✅ Input Validation - Comprehensive sanitization
✅ Security Headers - CSP, COEP, COOP
✅ SECRET_KEY Validation - Production environment checks
✅ Audit Logging - Complete transaction traceability

Dependency Security

Run security checks:

python scripts/check_dependencies_security.py

Or directly:

pip-audit

📚 Documentation

Core Documentation

Architecture Documentation - Complete system architecture and design
Architecture Documentation - Complete system architecture and design
Security Audit Report - Complete security analysis
Dependency Vulnerabilities - Dependency security status
Quantum Attack Analysis - Quantum security methodology
Contributing Guide - How to contribute to the project

Module Documentation

Core Module - Core functionality documentation
Contracts - Smart contracts documentation

API Documentation

Testnet Dashboard: https://testnet.allianza.tech
API Endpoints: Available in testnet dashboard
ZK Proof Verifier: /verify-proof endpoint

Technical Proofs

Complete Technical Proofs: COMPLETE_TECHNICAL_PROOFS_FINAL_EN.json
On-Chain Proofs: proofs/on_chain/
Interoperability Proofs: proofs/interoperability/

🧪 Testing

Running Tests

# Complete validation suite
python complete_validation_suite.py

# Professional test suite
python testnet_professional_test_suite.py

# Critical tests
python critical_tests_suite.py

# All tests
python run_all_tests.py

# With pytest (if installed)
pytest tests/

# With coverage report
pytest tests/ --cov=. --cov-report=html

Test Structure

tests/
├── public/              # Public test suite
├── test_results/        # Test results
└── ...

test_results/
├── test_results_complete.json
└── ...

Test Coverage

✅ Cross-chain interoperability
✅ Quantum-safe cryptography
✅ ZK proof generation and verification
✅ UChainID system
✅ Security features (CSRF, rate limiting)
✅ Input validation
✅ Real blockchain transactions (testnet)

Writing Tests

See CONTRIBUTING.md for guidelines on writing tests.

🤝 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create a feature branch: git checkout -b feature/my-improvement
Make your changes (follow code style guidelines)
Add tests for new features
Commit your changes: git commit -m "Add my improvement"
Push to your branch: git push origin feature/my-improvement
Open a Pull Request

Code Style

Follow PEP 8 for Python code
Use type hints where appropriate
Add docstrings to functions and classes
Write tests for new features

Reporting Issues

If you find a bug or have a suggestion, please open an issue on GitHub with:

Clear description of the problem
Steps to reproduce (if applicable)
Expected vs. actual behavior
Environment details (Python version, OS, etc.)

📊 Project Status

✅ Completed Features

Quantum-safe cryptography (NIST PQC standards)
Bridge-free cross-chain interoperability
UChainID system
ZK proof generation and verification
Real cross-chain transfers (Polygon → Bitcoin)
Testnet dashboard
Security audit and fixes
Comprehensive test suite

🚧 In Progress

Mainnet deployment
Additional blockchain support
Performance optimizations
Enhanced documentation

📅 Planned

Mobile SDK
Browser extension
Advanced analytics dashboard
Governance system

🔗 Links

Live Testnet: https://testnet.allianza.tech
GitHub Repository: https://github.com/allianzatech/blockchainallianza
Documentation: See Documentation section above

📄 License

Open Source Components

The core protocol, testnet, documentation, and examples are licensed under the MIT License - see the LICENSE file for details.

Commercial Components

Production-ready implementations, enterprise features, and commercial use require a Commercial License. See COMMERCIAL_LICENSE.md for details.

Contact for commercial licensing: [email protected]

🙏 Acknowledgments

NIST for Post-Quantum Cryptography standards
liboqs for quantum-safe cryptography library
Open Source Community for various blockchain libraries

📧 Contact

For questions, suggestions, or collaboration opportunities:

GitHub Issues: Open an issue
Testnet: https://testnet.allianza.tech

Built with ❤️ by the Allianza Team

⭐ Star us on GitHub • 🐛 Report Bug • 💡 Request Feature

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
cli		cli
core		core
docs		docs
examples		examples
proofs		proofs
scripts		scripts
sdk		sdk
static		static
templates		templates
.gitignore		.gitignore
COMMERCIAL_LICENSE.md		COMMERCIAL_LICENSE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
OPEN_CORE_STRATEGY.md		OPEN_CORE_STRATEGY.md
README.md		README.md
alz_niev_interoperability.py		alz_niev_interoperability.py
package-lock.json		package-lock.json
package.json		package.json
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
tailwind.config.js		tailwind.config.js
universal_chain_id.py		universal_chain_id.py
zk_proofs_system.py		zk_proofs_system.py

License

allianzatech/blockchainallianza

Folders and files

Latest commit

History

Repository files navigation