go-tcap

A robust TCAP (Transaction Capabilities Application Part) implementation in Go.

Overview

Package tcap provides simple and painless handling of TCAP (Transaction Capabilities Application Part) in SS7/SIGTRAN protocol stack, implemented in the Go Programming Language.

TCAP is an ASN.1-based protocol used in telecommunications networks for SS7-SIGTRAN information exchange between applications. It's commonly used in mobile networks for operations like SMS delivery, subscriber information retrieval, and authentication.

The TCAP structures in this library are directly defined based on the ASN.1 definition from ITU-T Q.773 (06/97). This implementation does not use any ASN.1 files or ASN.1 parsers, making it lightweight and easy to integrate.

Installation

go get github.com/gomaja/go-tcap

Features

Transaction Portion

Message Types

Message type	Supported?
Unidirectional	Yes
Begin	Yes
End	Yes
Continue	Yes
Abort	Yes

Fields

Tag	Supported?
Originating Transaction ID	Yes
Destination Transaction ID	Yes
P-Abort Cause	Yes

Component Portion

Component types

Component type	Supported?
Invoke	Yes
Return Result (Last)	Yes
Return Result (Not Last)	Yes
Return Error	Yes
Reject	Yes

Dialogue Portion

Dialogue types

Dialogue type	Supported?
Dialogue Request (AARQ-apdu)	Yes
Dialogue Response (AARE-apdu)	Yes
Dialogue Abort (ABRT-apdu)	Yes
Unidirectional Dialogue (AUDT-apdu)	Yes

Elements

Tag	Type	Supported?
Object Identifier	Structured	Yes
Dialogue PDU	Structured	Yes
Object Identifier	Unstructured	Yes
Unidirectional Dialogue PDU	Unstructured	Yes

API Documentation

Main Types

• TCAP: The main structure representing a TCAP message
• BeginTCAP, EndTCAP, ContinueTCAP, AbortTCAP, UnidirectionalTCAP: Different TCAP message types
• ComponentTCAP: Represents the component portion of a TCAP message
• DialogueTCAP: Represents the dialogue portion of a TCAP message

Common Use Cases

This library can be used to implement various SS7/SIGTRAN protocols that use TCAP, such as:

• MAP (Mobile Application Part)
• CAP (CAMEL Application Part)
• INAP (Intelligent Network Application Part)

Common operations include:

• SMS delivery and routing
• Subscriber information retrieval
• Authentication and authorization
• Call handling and routing

Author

Marwan Jadid

License

This project is licensed under the MIT License - see the LICENSE file for details.