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 \
  -e NXCC_DAEMON_HTTP_LISTEN_ADDR=0.0.0.0:6922 \
  -e NXCC_DAEMON_LISTEN_ADDRESSES=/ip4/0.0.0.0/tcp/9000 \
  -p 6922:6922 \
  -p 9000:9000 \
  ghcr.io/nxcc-bridge/node:latest

That exposes the HTTP API at http://localhost:6922 and keeps port 9000 open for libp2p peers, so every CLI example in the docs works immediately.

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 is supported by the Next Generation Internet (NGI) TrustChain initiative, part of the European Union's commitment to building a more open, trustworthy, and human-centric internet with a focus on digital sovereignty and privacy by design.

πŸ“„ 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

  •  
  •