Network Observability

Summary of Changes - Support Network Observability

• Prometheus → OTLP migration — the otelsetup plugin now exports metrics, traces, and logs via OTLP to a configurable collector endpoint (otlpEndpoint), replacing the Prometheus /metrics HTTP scrape endpoint.
• Distributed tracing — OpenTelemetry trace spans added across the HTTP handler and step execution pipeline (schema validation, signature validation, signing, etc.), enabling end-to-end request visibility in a trace viewer.
• Audit logging — new configurable audit log subsystem that projects only specified fields from each Beckn action's request/response body into OTLP logs, controlled via a per-action YAML rules file (auditFieldsConfig). Supports nested keys, namespaced keys (beckn:), and array traversal.
• reqpreprocessor config rename — uuidKeys renamed to contextKeys to reflect its expanded role of propagating context fields (subscriber_id, module_id) in addition to auto-generated UUIDs. Breaking change for existing configs.
• New HTTP metric — onix_http_request_count tracks requests by status class, route, method, role, sender, and recipient.
• Network observability stack — reference Docker Compose setup added under install/network-observability/ with pre-configured OTLP collectors, Loki, Prometheus, and Grafana dashboards for application metrics, traces, and network-level observability.
• parent_id in all log entries — every log line now includes a parent_id field in the format :<subscriber_id>:<pod_name_or_hostname> for cross-service log correlation in multi-node deployments.

What's Changed

• Feat: Network Observability - Update the logger config to show the parent_id by @manendrapalsingh in #605

Full Changelog: v1.3.1...v1.4.0

Enhancements and fixes from production deployments & AWS support for new ONIX - Jan 2026

Executive Summary

This release (v1.3.1) focuses on enhancing the security, scalability, and configuration accuracy of the Beckn-ONIX stack. Key updates include improved infrastructure security through Redis TLS support, optimized resource management for containerized environments, and refined validation logic for network signatures.

Key Highlights:

• Enhanced Security & Validation: * Introduced TLS support for Redis, ensuring encrypted communication with the caching layer.

• Expanded signature validation capabilities by allowing specific parent namespaces, providing more granular control over security protocols.

• Infrastructure Optimization: * Integrated automaxprocs to automatically set GOMAXPROCS based on container cgroup limits, improving CPU efficiency and performance in cloud-native deployments.

• Configuration & Reliability Updates:

• Migrated example registry URLs to the beckn.io domain for consistency with the evolving ecosystem.

• Refined the Request Preprocessor configuration by transitioning from uuidKeys to contextKeys, ensuring better alignment with current data schemas.

• Added schema-validator2 configurations specifically tailored for local network setups to streamline developer environments.

These changes collectively improve the robustness of the Beckn-ONIX gateway, providing better stability for production workloads and a more seamless configuration experience for contributors.

What's Changed

• Issue 587 - add: include schema-validator2 config for local network s… by @ameersohel45 in #591
• fix : add the tls support for the redis cache by @manendrapalsingh in #590
• Feat : add automaxprocs to set GOMAXPROCS from cgroup limits by @manendrapalsingh in #597
• feat: add allowed parent namespaces for signature validation by @nirmalnr in #595
• Issue 599 - fix reqpreprocessor config: use contextKeys instead of uuidKeys by @ameersohel45 in #602
• Update registry URLs in example configuration files to use beckn.io domain by @nirmalnr in #606
• Issue 542 - aws-cdk - update scripts to use new onix docker containers by @abhey-WIL @nirmay

Full Changelog: v1.3.0...v1.3.1

Serviceability framework & Schema transformer plugins - Dec 2025

This release introduces significant architectural enhancements designed to improve the flexibility, reliability, and transparency of the Beckn-Onix ecosystem. Key updates include new plugin capabilities, refined logging for better troubleshooting, and a robust observability framework.

🚀 New Features & Enhancements

Plugin Ecosystem

• Schema Mapper Plugin: Introduced a new plugin dedicated to schema mapping, enabling seamless data transformation between different object models.

• Transport Wrapper: Added the initial implementation of the transport wrapper, providing a standardized layer for managing communication protocols.

• Extended Validation: Upgraded the schemav2validator plugin with extended validation capabilities to ensure stricter adherence to complex data schemas.

Observability & Monitoring

• Observability Suite: Implemented a new observability feature set to track system metrics and improve real-time performance monitoring.

• Clean Error Logging: Optimized error logs by removing raw payload byte arrays. This change significantly improves log readability and reduces noise during debugging sessions.

🛠️ Bug Fixes & Stability

• Build Integrity: Updated the plugin build scripts to ensure the process exits immediately upon failure, preventing the deployment of incomplete or broken artifacts.

• Test Suite Reliability: Resolved failing test cases within main_test.go and module_test.go to stabilize the CI/CD pipeline.

📝 Documentation & Configuration

• Registry URL Update: Updated all example configuration files to point to the official Beckn One Registry URL, ensuring easier onboarding for new users and developers.

What's Changed

• fix the test case in main_test.go and module_test.go by @manendrapalsingh in #572
• 573 - New plugin - schema mapper by @nirmay in #575
• docs: updated URL in example config files to beckn one registry URL. by @nirmalnr in #577
• Issue 569 - Remove payload byte array from error logs to improve readability by @ameersohel45 in #581
• 570 - transport wrapper initial checkin by @nirmay in #578
• Issue 580 - Add extended schema validation capability to schemav2validator plugin by @ameersohel45 in #582
• Issue 551 - fix: ensure script exits on plugin build failure by @ameersohel45 in #583
• Feat/observability by @manendrapalsingh in #568

New Contributors

• @manendrapalsingh made their first contribution in #572

Full Changelog: v1.2.3...v1.3.0

Enhanced support for Beckn One - Nov 2025

Summary

• Improved schema validator for core spec v2
• Domain agnostic router for core spec v2
• Beckn One support in local deployment
• Other improvements

What's Changed

• Issue 552 - Improve schema2validator Performance by Building In-Memory Action→Schema Lookup Map by @ameersohel45 in #555
• Issue 553 and 554 - Update documentation for schema2validator and improve response readability by @ameersohel45 in #557
• 558 - feat: Add domain-agnostic routing support for v2 in Onix Adapter Router Plugin by @ameersohel45 in #560
• Issue 559 - feat: add Beckn One setup option and update documentation by @ameersohel45 in #562
• Issue 556 - Add configurable retry logic to dediregistry plugin by @ameersohel45 in #564
• Issue 565 - Add retry configuration to configs files. by @ameersohel45 in #566
• Issue 571 - Setup Guide - Link to downstream plugins for specific public cloud providers. by @nirmay

Full Changelog: v1.2.2...v1.2.3

New Schema Validator Plugin for Beckn Core spec v2

What's Changed

• 543 - Add schemav2validator plugin for loading spec and validating incoming requests with full $ref resolution by @ameersohel45 in #549
• Add kin-openapi dependency for schemav2validator plugin by @ameersohel45 in #550

Full Changelog: v1.2.1...v1.2.2

Oct 2025

What's Changed

• Issue [ 526 ] - Implement automatic key synchronization for ONIX adapter deployment and build plugin steps. by @ameersohel45 in #528
• Issue 530 - docs: update SETUP.md and README.md with documentation improvements and updated local setup instructions by @ameersohel45 in #531
• Issue 527 - Remove static record_name from DeDI plugin config to enable dynamic participant lookup by @ameersohel45 in #529
• Issue 533 - Add new Dockerfile to build adapter and plugins together by @ameersohel45 in #534
• Issue 535 - merge docker compose file and update scripts ,docs by @ameersohel45 in #536
• Issue 540 - refactor: migrate DeDi registry plugin to new wrapper API by @nirmay in #544
• Issue 540 - fix: remove hardcoded value and add test cases by @ameersohel45 in #545
• Added Go utility to generate keys by @nirmalnr in #547

Full Changelog: v1.2.0...v1.2.1

ONIX Core changes and multiple new plugins.

What's Changed

• 503 - Build a KeyManager Plugin to read keys from local by @nirmay in #512
• [Issue - 505] Beckn onix local setup by @ameersohel45 in #514
• [Issue 515] Update imports from beckn to beckn-one in beckn-onix by @ameersohel45 in #516
• [Issue 511] feat: Migrate registry client to a plugin by @ameersohel45 in #519
• ISSUE [509] - feat: Add DeDi registry plugin implementation for lookup by @ameersohel45 in #522
• feat(router): add excludeAction option for URL routing by @nirmalnr in #520
• Issue [523] - feat: Add configurable HTTP connection pooling for the adapter service by @ameersohel45 in #524
• Issue [517] [518] Refactor beckn-onix.sh to skip BAP/BPP containers and remove Vault dependency in setup.sh by @ameersohel45 in #525

New Contributors

• @nirmay made their first contribution in #512
• @ameersohel45 made their first contribution in #514
• @nirmalnr made their first contribution in #520

Full Changelog: v1.0.0...v1.2.0

New ONIX Core with Plugin Framework

What's Changed

• Core Plugin Framework written in Golang
• Cloud Agnostic Plugins for Redis and Hashicorp Vault,
• Setup and Developer documentation

Full Changelog

Changelog: https://github.com/beckn/beckn-onix/commits/v2.0

Beckn ONIX v0.6.0

Release Note: Beckn ONIX v0.6.0

Release Date: April 25, 2025
Version: v0.6.0
Repository: beckn/beckn-onix

---

🚀 Key Highlights

The v0.6.0 release introduces a significant enhancement to the onboarding flow of network participants (NPs), improving the decentralization of the Beckn ecosystem:

• Migration to DeDi-Based Registry
  Previously, NPs such as BAPs and BPPs were onboarded to the conventional Beckn Registry. With this release, onboarding is now directed to the DeDi (Distributed Directory) — the Beckn One registry, enabling a more decentralized and scalable network structure.

---

🛠️ What's Changed

• Enhancement implemented for v0.6.0
  #463 - V0.6.0 enhancement by @shreyvishal

---

👥 New Contributors

• 🎉 @shreyvishal made their first contribution!
  PR #463

---

📈 Full Changelog

View the complete changelog here:
Compare untagged → v0.6.0

V0.5

What's Changed

• Onix bugfixes & validation by @prasad-takale-eminds in #216
• Add Layer 2 config prompt to beckn-onix installation #222 by @prasad-takale-eminds in #227
• Registry role by @prasad-takale-eminds in #270
• Feature/app update by @prasad-takale-eminds in #301
• Add username/password authentication for PS deployment by @prasad-takale-eminds in #295
• Feature/Prompt user for domain input by @prasad-takale-eminds in #296
• Feature/onix menu by @prasad-takale-eminds in #297
• feat #271: Add support for installing all components (Registry, Gatew… by @prasad-takale-eminds in #305

Issue Fixed

• Add Validation for Registry URL Suffix During Beckn ONIX Setup #205
• Add URL Validator Throughout Beckn ONIX Installation #206
• Add Input Number Validation During Beckn ONIX Installation #207
• Docker Command Permission Validation During Beckn ONIX Installation #208
• Update Key Generation Logging for BAP Setup in Beckn ONIX #209
• Add Layer 2 config prompt back to installation #222
• Role Permissions not present in Beckn-ONIX installed registry #93
• Beckn-ONIX installation does not update existing key #177
• Beckn-ONIX is registering using wildcard domain #188
• Added message to not available in the current distribution #204
• Provide an option during install to update components #189
• Add option to install all Beckn components #271

Full Changelog: https://github.com/beckn/beckn-onix/commits/beckn-onix-v0.5