RoboNet.EMVParser 0.6.1

EMV Parser  

Span API based EMV TLV parser for .NET. This library is designed to parse EMV data structures, specifically the BER-TLV (Tag-Length-Value) format used in EMV transactions.

Features

• 🚀 High-performance parsing using Span API
• 📦 Support for both Memory<byte> and Span<byte>
• 🔍 Automatic detection and parsing of constructed tags
• 🎯 Support for long tags and multi-byte lengths
• 🛠️ Convenient extension methods for working with tag lists
• 💡 Performance optimization and minimal memory allocation
• 📝 Built-in EMV tags dictionary with descriptions and strongly-typed constants
• 📝 Comprehensive documentation in English and Russian

Installation

dotnet add package RoboNet.EMVParser

Quick Start

Get all tags from EMV data:

var someEMVData = "5F2A02097882021C00950580800088009A032110149C01009F02060000000020219F03060000000000009F0902008C9F100706010A03A480109F1A0202769F26080123456789ABCDEF9F2701809F3303E0F0C89F34034103029F3501229F3602003E9F37040F00BA209F41030010518407A0000000031010";
var data = Convert.FromHexString(someEMVData);

// Get all tags
IReadOnlyList<TagPointer> tagsList = EMVTLVParser.ParseTagsList(data);

foreach (var tag in tagsList)
{
    Console.WriteLine($"Tag: {tag.TagHex}, Value: {tag.ValueHex}");
}

Get specific tag value from EMV data:

// Get value of tag 5F2A
Span<byte> tagValue = EMVTLVParser.ReadTagValue(data.AsSpan(), "5F2A"); 
Console.WriteLine("Tag 5F2A value: " + Convert.ToHexString(tagValue));

Main Features

TagPointer Class

The main class for working with TLV data provides:

• Complete TLV data access
• Tag and value manipulation
• Support for constructed tags
• Convenient hex and string value representations
• Numeric value conversion

Working with Tags

// Search in tag list
var tag = tagsList.GetTag("5F2A");

// Get value in different formats
string hexValue = tagsList.GetTagValueHex("5F2A");
Memory<byte> byteValue = tagsList.GetTagValue("5F2A");
string stringValue = tag.ValueString;
long numericValue = tag.ValueNumeric;

Documentation

For detailed information about working with the library, please refer to the documentation:

• English Documentation
• Russian Documentation

License

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