Skip to content
jax docs.

Iroh

At the core of Jax’s architecture lies Iroh, a sophisticated peer-to-peer networking library that enables our decentralized storage solution. Iroh provides the critical infrastructure that allows Jax to operate as a permissionless file storage network with customizable incentive structures.

Key Functions of Iroh in Jax

Node Identity and Authentication

Iroh employs Ed25519 cryptographic keys to establish node identities within the network. This approach serves two essential purposes:

  • Provides verifiable on-chain signatures that authenticate Ethereum addresses for reward distribution
  • Enables peer discovery, allowing nodes to locate each other and request file proofs in a decentralized manner

Hot Storage Implementation

Unlike systems that require complex sealing and unsealing processes, Iroh facilitates immediate file availability:

  • All data remains accessible to peers at all times
  • No waiting periods for file retrieval
  • Efficient access to content when and where it’s needed

Proof Exchange Mechanism

Iroh’s networking capabilities support Jax’s proof verification system:

  • Enables nodes to exchange succinct storage proofs
  • Facilitates verification that peers actually possess the files they claim to have
  • Works seamlessly with Blake3’s merkelized hash structure for efficient partial proofs

Iroh in the Protocol Stack

Within Jax’s three-layer architecture, Iroh operates primarily at the file provider node level:

  1. Smart Contracts Layer - Coordinates reward distribution based on proof verification
  2. AVS Operator Nodes - Calculate global Eigentrust scores by communicating with file providers
  3. File Provider Nodes - Leverage Iroh to:
    • Establish peer connections
    • Distribute file content
    • Exchange storage proofs
    • Support local Eigentrust calculations

Technical Advantages of the Iroh Integration

Iroh provides several distinct advantages for Jax’s implementation:

  • Lightweight Protocol: Efficient communication with minimal overhead
  • Immediate Availability: No complex sealing or unsealing required for file access
  • Scalable Architecture: Can handle a growing network of nodes and increasing file sizes
  • Cryptographic Verification: Secure proof exchange with strong authentication

Future Development: Enhanced Content Discovery

Our current implementation coordinates content discovery through smart contracts. However, we are actively working with the Iroh team to implement a more sophisticated approach:

  • Distributed Hash Table (DHT) implementation for more efficient content location
  • Federated network of tracker nodes discovering and providing content locations
  • Advertisement of signed <node, hash> pairs for verified content availability

Conclusion

Iroh serves as the networking backbone of Jax, enabling the permissionless and incentivized file storage system we’ve built. By leveraging Iroh’s capabilities, Jax achieves a decentralized file-sharing network where files can be efficiently distributed, verified, and incentivized without requiring specialized expertise from developers implementing custom incentive models.