node-tlv

This package is based on node-tlv with some additional features like update

You can find the npm package here: https://www.npmjs.com/package/node-tlv-upgraded

Example for parse FCI

constTLV=require("node-tlv");constassert=require("assert");// 6F20840E315041592E5359532E4444463031A50E8801015F2D046B6F656E9F110101constresp="6F20840E315041592E5359532E4444463031A50E8801015F2D046B6F656E9F110101";consttlv=TLV.parse(resp);assert(tlv.getTag()==="6F");assert(tlv.getLength()===0x20);// find dedicated file nameconstdf_name=tlv.find("84");// find FCI Proprietary Templateconstfci_prop_template=tlv.find("A5");

Example for update a tag

constTLV=require("node-tlv");constassert=require("assert");// 6F20840E315041592E5359532E4444463031A50E8801015F2D046B6F656E9F110101constresp="6F20840E315041592E5359532E4444463031A50E8801015F2D046B6F656E9F110101";consttlv=TLV.update("6F3A8407A0000000041010A52F500A4D6173746572436172649F38069F5C089F4005BF0C179F5E095413339000001513019F5D030101009F4D020B0A","9F5D","999999");assert(tlv.value==="999999");

Example for parse GPO response

constTLV=require("node-tlv");constassert=require("assert");// parse TLVconstresp="770E8202580094080801010010010301";consttlv=TLV.parse(resp);// response message templateassert(tlv.getTag()==="77");assert(tlv.getLength()===14);assert(tlv.getValue()=="8202580094080801010010010301");// get TLV arrayconstchild=tlv.getChild();assert(child.length===2);constfirst=child[0];assert(first.getTag()==="82");// find AIPconstaip=tlv.find(0x82);assert(aip.getTag()==="82");assert(aip.getLength()===2);assert(aip.getValue()==="5800");// you can also use a string tag valueconstafl=tlv.find("94");assert(afl.getTag()==="94");assert(afl.getLength()===0x08);assert(afl.getValue()==="0801010010010301");

Example for parse PSE Record

constTLV=require("node-tlv");constassert=require("assert");constresp="702961134F08A0000000250104025004414D455887010161124F07A00000002910105004414D4558870102";consttlv=TLV.parse(resp);// find multiple tagsconstdirectory_enties=tlv.findAll("61");assert(directory_enties.length()===2);constdirectory_entry_1=directory_enties[0];varadf_name=directory_entry_1.find("4f");assert(adf_name.getTag()==="4F");assert(adf_name.getLength()>5);assert(adf_name.getLength()<16);varapplication_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]: VISACREDITconstTLV=require("node-tlv");constassert=require("assert");// step 1 build leafconstdf_name=newTLV("84","325041592E5359532E4444463031");// DF name for PPSEconstadf_name=newTLV("4F","A0000000031010");// aid for visaconstapp_label=newTLV("50","56495341435245444954");// VISACREDIT// step 2 build directory entry '61'constdir_entry=newTLV("61",adf_name.getTLV()+app_label.getTLV());// step 3 build FCI Issuer Discretionary data ' BF0C'constissuer_discretionary_data=newTLV("BF0C",dir_entry.getTLV());// step 4 build FCI Proprietary Template 'A5'constfci_proprietary_template=newTLV("A5",issuer_discretionary_data.getTLV());// step 5 build FCI template '6F'constfci_template=newTLV("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 MASTERconstTLV=require("node-tlv");constassert=require("assert");// step 1 build leafconstadf_name=newTLV("4F","A0000000041010");// aid for mastercardconstapp_priority=newTLV("87","01");constapp_label=newTLV("50","4D415354455243415244");// MASTERCARDconstapp_pref_name=newTLV("9F12","43495449204D4153544552");// CITI MASTER// step 2 build directory entry '61'constdir_entry=newTLV("61",adf_name+app_priority+app_label+app_pref_name);// step 3 build read record response message templateconstrecord_template=newTLV("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