Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

346 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nXCC Logo nXCC

The Programmable Glue for the Multi-Chain World

Secure, off-chain orchestration engine connecting any blockchain, API, or system

🚀 Quick Start💡 Use Cases📖 Documentation


🌐 Overview

nXCC provides the essential infrastructure to bind disparate systems into cohesive applications through:

  • 🔐 Confidential Computing: JavaScript workers execute in hardware-protected Trusted Execution Environments (TEEs), ensuring code and data remain encrypted during execution
  • ⛓️ Multi-Chain Native: Built-in support for 400+ EVM-compatible networks with extensible architecture for non-EVM chains
  • ⚡ Event-Driven Architecture: React to on-chain events, HTTP webhooks, and P2P messages with sub-20ms latency
  • 🤝 Federated Trust Model: Run your own nodes or form consortiums with cryptographic identity verification and on-chain governance

⚡ Performance

Metric Value
Event Latency (p99) < 17ms
Event Throughput 1,130+ events/sec
HTTP Throughput 3,224+ req/sec
Worker Capacity 130+ concurrent workers

Source: Benchmark Results

🏗️ Architecture

nXCC uses a multi-process architecture where JavaScript workers execute inside trusted execution environments (TEEs) for confidential computation:

Core Components

  • Daemon: P2P networking hub managing libp2p communications, work distribution, and blockchain connections
  • Enclave: TEE-based execution environment providing verifiable computation with Intel TDX/SGX support
  • VM: Cloudflare Workerd runtime for isolated JavaScript worker execution
  • Interface: gRPC/protobuf communication layer enabling secure inter-process communication

🚀 Quick Start

Start a node with Docker:

docker run --rm \
  --add-host=host.docker.internal:host-gateway \
  -p 127.0.0.1:6922:6922 \
  -p 127.0.0.1:9000:9000 \
  ghcr.io/nxcc-bridge/node:latest

The image listens on 0.0.0.0 by default; these bindings expose the HTTP API at http://localhost:6922, keep port 9000 ready for libp2p peers, and still confine access to your machine unless you remove the 127.0.0.1 prefix.

Prefer a native setup? Follow the full walkthrough in the Getting Started guide.

💡 Use Cases

🤖 Secure AI Agents

Enable autonomous agents to interact with multiple blockchains while protecting valuable models and decision logic within confidential computing environments.

🏦 Cross-Chain DeFi

Build sophisticated trading strategies that aggregate liquidity across networks while keeping proprietary algorithms confidential.

📖 Explore more examples →

🛠️ Key Capabilities

Cross-Chain Orchestration: Define complex workflows that span multiple blockchains, automatically handling event subscription, transaction execution, and state synchronization.

Secret Management: Built-in distributed secret sharing using peer-to-peer TEE-to-TEE protocols, governed by on-chain policies for API keys and sensitive data.

Hardware-Enforced Privacy: Intel TDX/SGX trusted execution environments provide memory encryption and remote attestation for verifiable computation.

📁 Project Structure

nxcc/
├── 🗂️ node/                    # Core Rust workspace
│   ├── 📦 daemon/              # P2P networking & orchestration
│   ├── 🔒 enclave/             # TEE execution environment
│   ├── ⚙️ vm/                  # JavaScript runtime (Workerd)
│   ├── 📡 interface/           # gRPC/protobuf definitions
│   ├── ⛓️ chainlist/           # 400+ blockchain configurations
│   ├── 🔐 attestation/         # TDX/SGX attestation logic
│   └── 🧪 tests/               # Integration test suite
├── 📑 contracts/               # Smart contracts (Solidity)
├── 🏗️ infra/                   # Kubernetes & deployment tools
├── 🚀 benchmarks/              # Performance testing suite
├── 📖 docs/                    # Documentation site
├── 🔍 e2e/                     # End-to-end test scenarios
└── 🛠️ sdk/                     # Client SDKs & tooling

🧪 Development & Testing

Prerequisites

  • Rust 1.89.0+ with edition 2024
  • Node.js 18+ (for JavaScript workers)
  • Docker (for containerized deployment)
  • Intel TDX/SGX hardware (for production attestation)

Testing

cd node

# Unit tests
cargo test

# Integration tests with multi-node P2P scenarios
cargo build && sh tests/integration_test.sh

# End-to-end tests with full workflow execution
cd ../e2e && ./e2e_test.sh

# Performance benchmarks
cd ../benchmarks && ./run.sh

📋 View testing guide →

📚 Documentation

🤝 Contributing

nXCC is open source and welcomes contributions! We follow modern development practices:

  • Rust Edition 2024 with comprehensive testing
  • Component-based architecture with clear separation of concerns
  • Docker-first deployment for consistent environments
  • Automated CI/CD with quality gates

📋 Contributing guidelines coming soon

🏛️ Funding & Acknowledgments

NGI TrustChain

This project has received funding from the European Union's Horizon 2020 research and innovation program through the NGI TRUSTCHAIN program under cascade funding agreement No. 101093274.

📄 License

Licensed under the Apache License, Version 2.0. See LICENSE for details.


🌟 Ready to connect your multi-chain infrastructure? 🌟

📖 Get Started🐙 GitHub

Made with ❤️ by the nXCC community

About

Nano Cross-Chain Communication (NGI TRUSTCHAIN OC4)

Topics

Resources

Stars

0 stars

Watchers

2 watching

Forks

Packages

Used by

Contributors

Languages