A get the job done javascript/typescript library for interacting with GlobalPlatform devices. You can use node-gp to manage a GlobalPlatform device on any major desktop OS and Android.
npm install node-gpA get the job done javascript/typescript library for interacting with GlobalPlatform devices. You can use node-gp to manage a GlobalPlatform device on any major desktop OS and Android.
node-gp provides a GlobalPlatform class that requires a single function in order to communicate with a device. You must provide an interface for the device itself; in node.js smartcard does this job well and for mobile apps phonegap-nfc is just as good.
#### Using node-gp with smartcard in node.js/electron/nw.js projects:
> note: linux users beware - when using tomkp/smartcard you are advised to review the steps required for santigimeno/node-pcsclite as this lilbrary is ultimately doing the communication with your hardware. We're looking into simplifying this.
First add node-gp and smartcard to your project:
npm install node-gp smartcard --save
Then you want a function to integrate your hardware library (smartcard in this case) and node-gp.
Because smartcard already has a promisified issueCommand function that takes a string or Buffer as a parameter, integration is as easy as snippet 1..
snippet 1.
``javascript`
const transceive = event.card.issueCommand.bind(event.card)
const gpcard = new GlobalPlatform(transceive)
If you want the fully working example index.js then copy this index.js example:
`javascript
// index.js
const GlobalPlatform = require("node-gp")
const smartcard = require('smartcard')
const Devices = smartcard.Devices
const devices = new Devices()
devices.on('device-activated', event => {
event.device.on('card-inserted', event => {
const transceive = event.card.issueCommand.bind(event.card)
const gpcard = new GlobalPlatform(transceive)
gpcard.connect().then(() => {
console.log("connected")
// now you have a connected device
gpcard.getPackages().then(packages => {
for (let package of packages) {
// demo: print out package aids
console.log(Buffer.from(package.aid).toString("hex"))
}
})
}).catch(error => {
console.error(error)
})
})
})
`
#### Using node-gp with phonegap-nfc in phonegap/cordova/etc mobile projects:
There is a complete example for node-gp with Cordova here: https://github.com/dcdc-io/node-gp-phonegap
More coming soon....
node-gp was created to make smartcard development accessible to more people and more platforms.
Smartcard development is hard and the existing tools will leave you wondering why you ever bothered*. Given that there are overwhelmingly more smartcards in the world than there are smartphones - your passport, debit card, and sim card are smartcards - we figured we should make programming this type of device feel less like stepping in dogshit with new shoes on the way to a job interview you're already late to, and instead more like typing "npm install" and hitting return.
_*There are notable exceptions to this trend like the fantastic GlobalPlatformPro from Martin Paljak. If you're doing a lot of smartcard work you'll want to GlobalPlatformPro in your toolkit._
The rising interest in decentralised apps, blockchains, distributed ledgers, IoT, and so on, has driven the need for small, low power, low cost and normal person usable cryptography. Smartcard devices like the tiny chip in your bank card give you portable cryptographic computation and very secure key storage without both the bullshit of charging batteries and the inexplicable paying for 1U of LEDs and aluminium. We think these smartcard devices are so important that to not have made an easy-to-use programmer would have been criminal on our part.
We're using the 2.1.1 specification as a reference for this implementation, and we're not anticipating that we will cover it to a large extent. We're interested in basic installing and deleting applets as far as Global Platform goes. Anything else we need will be added case by case when it's worth anybody's time to do it.
You can get more information about the specification at the official site.
node-gp itself doesn't have any hardware requirements. Instead it asks that you implement an transceive function to send and receive APDUs. This means that if your platform supports phonegap-nfc or smartcard with pcsc-lite then node-gp will work. Android devices with NFC support and other computers with smartcard readers are almost always going to work.
At the time of writing node-gp is not useful for iOS devices because Apple disables meaningful use of the NFC API. If you are an iPhone/iPad etc user and you want to use NFC then you will need either get a proper phone and/or lobby and Apple and let them know you want NFC enabling.
node-gp is a typescript project and we're using yarn as a package manager (which means we don't test npm but it likely works the same).
To build:
yarn rebuild
Or npm if you really insist:
npm rebuild
Whether you load the browser/nodegp-bundle.js in a script tag or require('node-gp') in your node project you are likely going to work with the GlobalPlatform class as your base class and not bother with anything else.
To use the GlobalPlatform class directly do something like the following:
_mobile snippet (untested**)._
`javascript
// mobile example with phonegap-nfc (after a