sip2json: A Focused SIP Parser for Modern C++

sip2json is a header-only Modern C++20 SIP protocol parser and serializer library designed with nlohmann::json as a first-class API metaphor for seamlessly converting SIP protocol messages to/from JSON for NoSQL databases and distributed event processing.

---

Documentation

siddiqsoft.github.io/sip2json

• Quick Start & Integration
• Performance & Benchmarks
• Asynchronous Stream Parsing
• JSON Schema Metaphor
• API Reference

---

Quick Examples

Stream Parsing

#include <iostream>
#include "siddiqsoft/sip2json.hpp"

using namespace siddiqsoft;

void onNetworkDataReceived(std::string& tcpReadBuffer)
{
    // Asynchronously parse multiple SIP frames from buffer (erasing consumed bytes)
    sip2json::parseAsync(
        tcpReadBuffer,
        [](sipmessage&& msg) {
            std::cout << "Parsed " << msg.getMethod() << " Call-ID: " << msg.getCallID() << "\n";
            nlohmann::json doc = msg; // First-class JSON metaphor
        },
        [](const sip2json_exception& ex, auto& start, const auto& end) {
            std::cerr << "Parser warning: " << ex.what() << "\n";
        }
    );
}

Push to RabbitMQ

#include "siddiqsoft/sip2json.hpp"
#include <SimpleAmqpClient/SimpleAmqpClient.h>

using namespace siddiqsoft;

// Stream incoming SIP frames directly into a RabbitMQ exchange as JSON
auto channel = AmqpClient::Channel::Create("localhost");

sip2json::parseAsync(tcpReadBuffer, [&](sipmessage&& msg) {
    nlohmann::json doc = msg;
    auto body = AmqpClient::BasicMessage::Create(doc.dump());
    channel->BasicPublish("sip_events", std::string(msg.getMethod()), body);
});

Log to DuckDB

#include "siddiqsoft/sip2json.hpp"
#include <duckdb.hpp>

using namespace siddiqsoft;

// Stream incoming SIP traffic directly into DuckDB for columnar analytics
duckdb::DuckDB db("sip_analytics.db");
duckdb::Connection con(db);
con.Query("CREATE TABLE IF NOT EXISTS sip_traffic (method VARCHAR, call_id VARCHAR, payload JSON);");

duckdb::Appender appender(con, "sip_traffic");
sip2json::parseAsync(tcpReadBuffer, [&](sipmessage&& msg) {
    nlohmann::json doc = msg;
    appender.AppendRow(std::string(msg.getMethod()), std::string(msg.getCallID()), doc.dump());
});
appender.Flush();

Note

Use threadpool or async versions of specific SDKs to maximize performance.

---

Standards Compliance

sip2json is verified against official IETF specifications across dedicated automated test suites:

• RFC 3261 (Core SIP): tests/compliance/src/rfc3261_compliance_tests.cpp
• RFC 4475 (Torture Test Suite -- 50/50): tests/compliance/src/rfc4475_torture_tests.cpp
• RFC 3262, RFC 3515, RFC 3903, RFC 6665 (SIP Extensions): tests/compliance/src/sip_certification_suite.cpp
• RFC 8866 / RFC 4566, RFC 3264, RFC 8829 / RFC 8839 (SDP & WebRTC): tests/compliance/src/sdp_compliance_tests.cpp

For full coverage matrices, section mappings, and torture test details, see the Standards Compliance Guide on our documentation site.

Note

Performance: High-throughput stream parsing with low microsecond latency -- see our pipeline-compiled Performance & Benchmarks Guide.

---

License

Licensed under the BSD 3-Clause License.