SDK JavaScript / Node.jsTigerTag SDK

Leia, verifique e grave chips NFC TigerTag com JavaScript.

O SDK do protocolo aberto TigerTag para filamento e resina de impressão 3D: transforma os bytes de um chip em material, cor, ajustes de impressão e quantidade, confere a assinatura ECDSA-P256 offline e monta novas tags byte a byte.

npm install tigertag

Começar Ver no npm Código no GitHub

quick-start.js

const { TigerTag } = require('tigertag');

const tag = TigerTag.fromPages(uid, payload);   // from your NFC SDK
console.log(tag.pretty());                      // human-readable summary
console.log(String(tag.verify()));              // VALID / NOT SIGNED / INVALID
console.log(tag.toDict());                      // JSON-ready object

O início rápido do README: funciona logo após o npm install, sem configuração.

1.2.1Versão atual, lançada em 2026-11-06

Node.js 18+Usa crypto e fetch nativos

0Dependências de execução para ler e verificar

Apache-2.0Licença de código aberto, com concessão de patentes

Comece em três passos

Instale o pacote, leia um chip com sua biblioteca NFC e grave um novo. As tabelas de referência incluídas fazem a primeira execução funcionar sem rede.

1
Instalar o pacote
Pelo registro do npm. pnpm, yarn e bun instalam o mesmo pacote.
```
npm install tigertag
```
```
pnpm add tigertag
yarn add tigertag
bun add tigertag
```

Ler um chip

Passe o UID de 7 bytes e os 144 bytes lidos pela sua biblioteca NFC. Aqui com nfc-pcsc e um ACR122U.

// Node.js — nfc-pcsc (ACR122U / PN532)
reader.on('card', async (card) => {
  const uid = Buffer.from(card.uid, 'hex');        // 7 bytes
  const payload = await reader.read(4, 144, 4);    // pages 4–39, 144 bytes
  const tag = TigerTag.fromPages(uid, payload);
  console.log(tag.pretty());
  console.log(String(tag.verify()));               // VALID / NOT SIGNED
});

Alterar e gravar

Cada alteração retorna um novo TigerTag; toBytes() dá os bytes para gravar. erase() dá um chip em branco.

// Immutable surgical update — returns a new TigerTag, original unchanged
const patched = tag.patch({ nozzleTempMin: 200, dryTemp: 55 });

// Erase a chip — write the returned 80 bytes to the NFC chip
const blankBytes = TigerTag.erase();

A API completa no README

O que o SDK faz

Um só pacote para tudo em um chip TigerTag: ler, conferir, gravar e manter os dados atualizados.

Ler qualquer dump

fromPages(), fromDump() e fromFile() aceitam um UID com 80 ou 144 bytes, ou um dump completo de 180 bytes. pretty(), describe(), toDict() e toRawDict() retornam texto, um parágrafo em linguagem simples ou objetos prontos para JSON.

Verificar a autenticidade offline

verify() confere a assinatura ECDSA-P256 que liga o UID do chip aos dados do produto, com a chave pública incluída no pacote. O resultado é valid, invalid, unsigned, no_key ou no_uid.

Criar e editar tags

create(), asInit(), patch() e erase() montam os bytes do chip. Um TigerTag é imutável: patch() retorna um novo e não deixa alterar idTigertag, idProduct, uid nem a assinatura.

Montar a partir do catálogo

TigerTag.fromCatalog(productId) monta um TigerTag+ completo a partir do catálogo oficial de produtos, baixado no primeiro uso e guardado em cache numa pasta por usuário.

Sincronizar com o fabricante

Para chips TigerTag+, rawApi(), diffApi() e patchFromApi() buscam os dados atuais da marca, listam o que difere do chip e aplicam as mudanças.

Dados de referência, offline primeiro

As tabelas de material, marca, aspecto, tipo, diâmetro e unidade vêm no pacote. Uma verificação em segundo plano as atualiza no máximo uma vez por dia; offline: true ou TIGERTAG_OFFLINE=1 significa nenhuma chamada de rede.

Três tipos de tag

O SDK lê e grava os três tipos de tag do protocolo TigerTag v2.2, em chips NTAG213, NTAG215 e NTAG216.

idProduct 0xFFFFFFFF

TigerTag (Maker)

Todos os campos no chip, legíveis totalmente offline.

idProduct 0x00000000

TigerTag Init

Um modelo em branco, pronto para programar. TigerTag.asInit() cria um.

ECDSA-P256

TigerTag+

Todos os campos no chip, mais um ID de produto ligado à API na nuvem para atualizações do fabricante. Um chip assinado é conferido com verify().

Na linha de comando e dentro do Electron

O pacote instala o comando tigertag e roda no processo principal de um app Electron.

O comando tigertag

Interpreta um dump como texto, JSON ou campos brutos, e atualiza as tabelas de referência quando você quiser.

# Parse a dump file
tigertag dump.bin

# JSON output
tigertag dump.bin --json

# Update the reference tables now (into the data dir)
tigertag update

Dentro de um app Electron

Interprete os chips no processo principal, sem subprocesso para distribuir.

// main.js — replace parseTigerTag() subprocess dependency
const { TigerTag, TigerTagDB } = require('tigertag');

function parseTigerTag(payload, uid) {
  const tag = TigerTag.fromPages(Buffer.from(uid), Buffer.from(payload));
  const db  = new TigerTagDB();
  return {
    dict: tag.toDict(db),
    raw:  tag.toRawDict(),
    sig:  tag.verify(db).toDict(),
  };
}

Experimente sem leitor: o playground

Uma página web local, servida pelo próprio SDK, que monta e decodifica chips TigerTag e mostra cada byte. Não precisa de hardware NFC.

Entrada e saída do SDK lado a lado: a chamada create(), depois pretty(), describe(), verify() e toDict().
Com um ou mais leitores PC/SC como o ACR122U, os chips são lidos assim que colocados, e Burn grava o conteúdo atual.
O playground nunca grava uma assinatura: só um fabricante certificado pode emiti-la.

npm run playground
# then open http://localhost:7432/tools/playground.html

# Enable live reader support (one-time install)
npm install ws nfc-pcsc

Parte do ecossistema TigerTag

O SDK implementa a especificação aberta TigerTag, ao lado das outras ferramentas oficiais.

Especificação do protocolo TigerTag

A especificação aberta que o SDK implementa: layout de memória, tipos de tag, esquema de assinatura e banco de dados de referência.

Repositório: TigerTag-RFID-Guide

SDK TigerTag para Python

A versão em Python: ler, verificar, gravar e comparar. A página do playground é o mesmo arquivo nos dois SDKs.

Repositório: TigerTag-SDK-Python

TigerTag Studio Manager

Gerenciador de estoque para desktop, de código aberto, para Windows, macOS e Linux, compatível com TigerTag Pod e leitores ACR122U.

Repositório: TigerTag-Studio-Manager

TigerTag RFID Connect

O app móvel oficial: leia e grave chips com o NFC do celular.

App Store Google Play

Perguntas

Como instalo o SDK JavaScript TigerTag?

Rode npm install tigertag, ou pnpm add tigertag, yarn add tigertag ou bun add tigertag. Ele precisa do Node.js 18 ou mais recente e de nenhum outro pacote para ler e verificar.

Precisa de conexão com a internet?

Não. As tabelas de referência e a chave pública de assinatura vêm no pacote, então leitura e verificação funcionam offline. A rede só é usada para a verificação diária das tabelas, o catálogo de produtos e os métodos de nuvem do TigerTag+; offline: true ou TIGERTAG_OFFLINE=1 a desliga.

Com quais chips e leitores NFC ele funciona?

O TigerTag usa chips NTAG213, NTAG215 e NTAG216 (ISO 14443-3). O SDK recebe o UID e os bytes lidos pela sua biblioteca NFC, então não depende de um leitor específico; o README mostra nfc-pcsc com um ACR122U.

Como ele confere se um chip é autêntico?

verify() confere a assinatura ECDSA-P256 do chip sobre o UID e os identificadores do produto, com a chave pública incluída no pacote. Retorna valid, invalid, unsigned (uma tag Maker), no_key ou no_uid, sem chamar servidor.

Ele grava chips?

Ele monta os bytes: create(), patch(), asInit(), erase() e fromCatalog() dão um TigerTag cujo toBytes() é o conteúdo que sua biblioteca NFC grava. O botão Burn do playground grava nos chips dos leitores conectados.

Existe uma versão em Python?

Sim: TigerTag-SDK-Python é a versão em Python da mesma API, e os dois SDKs servem a mesma página de playground.

Qual é a licença do SDK?

Apache-2.0, que traz uma concessão expressa de patentes. Implementar o próprio protocolo TigerTag não exige licença.

Um comando para começar

npm install tigertag e depois TigerTag.fromPages(uid, payload).

Ver no npm