@kawkab-oss/node-tlv v1.6.0

node-tlv

node base tlv parser

Example for parse FCI

    const TLV = require('node-tlv');
    const assert = require('assert');
    // 6F20840E315041592E5359532E4444463031A50E8801015F2D046B6F656E9F110101

    const resp = '6F20840E315041592E5359532E4444463031A50E8801015F2D046B6F656E9F110101';
    const tlv = TLV.parse(resp);

    assert(tlv.getTag() === '6F');
    assert(tlv.getLength() === 0x20);
    
    // find dedicated file name 
    const df_name = tlv.find('84')

    // find FCI Proprietary Template 
    const fci_prop_template = tlv.find('A5')

Example for parse GPO response

    const TLV = require('node-tlv');
    const assert = require('assert');

    // parse TLV
    const resp = '770E8202580094080801010010010301';
    const tlv = TLV.parse(resp);

    // response message template 
    assert(tlv.getTag() === '77');
    assert(tlv.getLength() === 14);
    assert(tlv.getValue() == '8202580094080801010010010301');

    // get TLV array
    const child = tlv.getChild();
    assert(child.length === 2);

    const first = child[0];
    assert(first.getTag() === '82');

    // find AIP
    const aip = tlv.find(0x82);
    assert(aip.getTag() === '82');
    assert(aip.getLength() === 2);
    assert(aip.getValue() === '5800');

    // you can also use a string tag value
    const afl = tlv.find('94');
    assert(afl.getTag() === '94');
    assert(afl.getLength() === 0x08);
    assert(afl.getValue() === '0801010010010301');

Example for parse PSE Record

    const TLV = require('node-tlv');
    const assert = require('assert');

    const resp = '702961134F08A0000000250104025004414D455887010161124F07A00000002910105004414D4558870102'
    const tlv = TLV.parse(resp);

    // find multiple tags
    const directory_enties = tlv.findAll('61')
    assert(directory_enties.length() === 2);

    const directory_entry_1 = directory_enties[0];
    var adf_name = directory_entry_1.find('4f');

    assert(adf_name.getTag() === '4F');
    assert(adf_name.getLength() > 5);
    assert(adf_name.getLength() < 16);

    var application_label = directory_entry_1.find('50');
    
    assert(application_label.getTag() === '50');
    assert(application_label.getLength() > 1);
    assert(application_label.getLength() < 16);
    

Exmaple for build PPSE FCI

    // EMV Contactless Book B Entry Point Specification 
    // Table 3-2: SELECT Response Message Data Field (FCI) of the PPSE
    //'6F' FCI Template M
    //    '84' DF Name (‘2PAY.SYS.DDF01’) O
    //    'A5' FCI Proprietary Template M
    //        'BF0C' FCI Issuer Discretionary Data M
    //        '61' Directory Entry M
    //            '4F'   ADF Name M
    //            '50'   Application Label O
    // example for my credit card real data
    // CAPDU: 00A404000E325041592E5359532E4444463031
    // RAPDU: 6F2C840E325041592E5359532E4444463031A51ABF0C1761154F07A0000000031010500A56495341435245444954
    // 6F  2C(44) [FCI Template]
    //     84  0E(14) [DF Name]: 325041592E5359532E4444463031
    //     A5  1A(26) [FCI Proprietary Template] 
    //         BF0C  17(23) [FCI Issuer Discretionary Data]
    //            61  15(21) [Directory Entry]
    //                4F  07( 7) [ADF Name]: A0000000031010
    //                50  0A(10) [Application Label]: VISACREDIT
    
    const TLV = require('node-tlv');
    const assert = require('assert');

    // step 1 build leaf
    const df_name = new TLV('84', '325041592E5359532E4444463031'); // DF name for PPSE
    const adf_name = new TLV('4F', 'A0000000031010'); // aid for visa
    const app_label = new TLV('50', '56495341435245444954'); // VISACREDIT
    
    // step 2 build directory entry '61'
    const dir_encty = new TLV('61', adf_name.getTLV()+app_label.getTLV());
    
    // step 3 build FCI Issuer Discretionary data ' BF0C'
    const issuer_discretionary_data = new TLV('BF0C', dir_encty.getTLV());

    // step 4 build FCI Proprietary Template 'A5'
    const fci_proprietary_template = new TLV('A5', issuer_discretionary_data.getTLV());
    
    // step 5 build FCI template '6F'
    const fci_template = new TLV('6F',  df_name.getTLV() + fci_proprietary_template.getTLV());
    assert(fci_template.getTLV() === '6F2C840E325041592E5359532E4444463031A51ABF0C1761154F07A0000000031010500A56495341435245444954');

Exmaple for build PSE record

    // EMV 4.3 Book 1
    // Table 46: Payment System Directory Record Format
    // Tag '70'  | Data Length (L) | Tag '61' | Length | Directory entry 1 (ADF)
    // EMV 4.3 Book 1 
    // Table 47: ADF Directory Entry Format
    // '4F'   5–16 ADF Name M
    // '50'   1–16 Application Label M
    // '9F12' 1–16 Application Preferred Name O
    // '87'   1    Application Priority Indicator O
    // '73'   var. Directory Discretionary Template O
    // CAPDU: 00B2010C00
    // RAPDU: 702861264F07A0000000041010870101500A4D4153544552434152449F120B43495449204D4153544552
    // 70   28(40) [READ RECORD Response Message Template]
    //    61   26(38) [Directory Entry]
    //        4F   07( 7) [ADF Name]: A0000000041010
    //        87   01( 1) [Application Priority Indicator]: 01
    //        50   0A(10) [Application Label]: MASTERCARD
    //        9F12 0B(11) [Application Preferred Name]: CITI MASTER
    const TLV = require('node-tlv');
    const assert = require('assert');

    // step 1 build leaf
    const adf_name      = new TLV('4F',   'A0000000041010');        // aid for mastercard
    const app_priority  = new TLV('87',   '01'); 
    const app_label     = new TLV('50',   '4D415354455243415244'); // MASTERCARD
    const app_pref_name = new TLV('9F12', '43495449204D4153544552'); // CITI MASTER
    
    // step 2 build directory entry '61'
    const dir_entry = new TLV('61', adf_name + app_priority + app_label + app_pref_name);
    
    // step 3 build read record response message template
    const record_template = new TLV('70', dir_entry.getTLV());
    assert(record_template.toString() === '702861264F07A0000000041010870101500A4D4153544552434152449F120B43495449204D4153544552');

Installation

You can install the latest tag via npm:

npm install node-tlv

##Use node-tlv-parser

1. Github
2. Heroku