Skip to content
NFH Fabric Support home
NFH Fabric Support home

ONIX — connect to everything

ONIX is an enterprise-grade middleware adapter system designed to facilitate seamless communication in any Fabric-enabled network.

Realises the Fabric Network Adapters Edge service.

Overview

ONIX is an enterprise-grade middleware adapter system designed to facilitate seamless communication in any Fabric-enabled network. It acts as a protocol adapter between consumer nodes (buyer applications) and provider nodes (seller platforms), ensuring secure, validated, and compliant message exchange across various commerce networks.

Features

🔌 Plugin-Based Architecture

  • Dynamic Plugin Loading: Load and configure plugins at runtime without code changes

  • Extensible Design: Easy to add new functionality through custom plugins

  • Hot-Swappable Components: Update plugins without application restart (in development)

🔐 Enterprise Security

  • Ed25519 Digital Signatures: Cryptographically secure message signing and validation

  • Vault Integration: Centralized secrets and key management

  • Request Authentication: Every message is authenticated and validated

  • TLS/SSL Support: Encrypted communication channels

✅ Protocol Compliance

  • JSON Schema Validation: Ensures all messages comply with Beckn protocol specifications

  • Version Management: Support for multiple protocol versions simultaneously

  • Domain-Specific Schemas: Tailored validation for different business domains

🚀 High Performance

  • Caching: Response caching for improved performance

  • Queue Integration: Asynchronous message processing via message queues

  • Connection Pooling: Efficient resource utilization

  • Configurable Timeouts: Fine-tuned performance controls

📊 Observability

  • Structured Logging: JSON-formatted logs with contextual information

  • Transaction Tracking: End-to-end request tracing with unique IDs

  • Metrics Support: Performance and business metrics collection

  • Health Checks: Liveness and readiness probes for Kubernetes

🌐 Usecase/Domain Agnostic

  • Retail & E-commerce: Product search, order management, fulfillment tracking

  • Mobility Services: Ride-hailing, public transport, vehicle rentals

  • Logistics: Shipping, last-mile delivery, returns management

  • Healthcare: Appointments, telemedicine, pharmacy services

  • Financial Services: Loans, insurance, payments

For more detailed information, developer guides please visit ONIX repository

GitHub - beckn/beckn-onix: beckn onixGitHub

The Fabric capability: Network Adapters Edge

ONIX realises the Fabric Network Adapters Edge — the protocol-aware adapter every participant runs. It handles signing, schema validation, policy enforcement, transport, encryption, and audit logging, so participants speak the network correctly without re-implementing the wire.

What it gives you

  • Pluggable transport — HTTP, message queues, custom transports.

  • Signing and verification — every outbound and inbound message verified.

  • Policy plug-ins — Rego-based policy enforcement for network rules.

  • Schema validation — guaranteed conformance to the protocol.

  • Audit logging — every exchange traceable, signed, and verifiable.

Where it sits — reference software NFH publishes (every participant runs their own adapter, on their own infrastructure; NFH never sees the traffic) plus the protocol NFH defines (the adapter's wire format and plug-in interface).

Powered by Plain