blong-codec

Implement and compose HTTP and TCP communication protocols in Blong applications.

1|Updated Dec 21, 2023
One-click install
npx skills add https://github.com/feasibleone/blong --skill blong-codec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blong-codec
Source: https://github.com/feasibleone/blong/tree/main/.github/skills/codec
Command: npx skills add https://github.com/feasibleone/blong --skill blong-codec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codecs provide a modular, reusable layer to implement and compose communication protocols (HTTP and TCP) on top of transport layers within Blong. They standardize serialization, deserialization, message framing, and multiplexing, enabling reliable cross-protocol communication.

Core Features & Use Cases

  • HTTP Codecs: OpenAPI, JSON-RPC, MLE
  • TCP Codecs: Payshield, SMPP, ISO8583, APTRA/NDC
  • Stackable composition: Combine multiple codecs (e.g., OpenAPI + MLE) and configure layered runtimes
  • Configuration & testing: Patterned configuration and round-trip encode/decode testing for reliability

Quick Start

Configure and load the desired HTTP or TCP codec in your realm, import the codec module, and wire it into your adapter configuration to start encoding, decoding, and framing messages.

Frequently Asked Questions about blong-codec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement ISO8583 message serialization and deserialization for TCP communications?

You can serialize and deserialize ISO8583 messages by loading the TCP codec module and wiring it into your adapter configuration. The codec handles message framing and encoding natively for reliable financial messaging over transport layers.

What is the best way to combine multiple protocol codecs like OpenAPI and MLE for HTTP workflows?

The best way to combine multiple HTTP codecs like OpenAPI and MLE is through stackable composition. You configure layered runtimes to stack the codecs, enabling modular protocol composition that handles serialization and request/response matching across the combined stack.

Can I use this codec module for Payshield HSM interactions over TCP?

Yes, you can use the TCP codec module for Payshield HSM interactions. It includes a dedicated Payshield codec that manages the serialization, deserialization, and message framing required for secure hardware security module communications.

How does message framing work when building custom communication protocols on top of transport layers?

Message framing standardizes how data streams are chunked into discrete messages at the transport layer. The codec module applies lifecycle hooks and configuration patterns to delimit boundaries, ensuring reliable cross-protocol communication and correct request matching.

Do I need specific adapter configurations to test JSON-RPC request and response matching?

You need to configure the JSON-RPC HTTP codec in your realm and wire it into your adapter configuration. The module supports patterned configuration and round-trip encode/decode testing to verify request and response matching reliability.

Are there limitations when composing SMPP and APTRA/NDC codecs in the same runtime stack?

There are no stated limitations on composing SMPP and APTRA/NDC codecs in the same runtime stack. The module supports modular stack composition via configuration patterns and lifecycle hooks, allowing you to layer multiple TCP codecs as needed.