Skip to content

nxcc-bridge/nxcc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors 2

  •  
  •