Home

ASN.1 Definition Sifter Wiki

ASN.1 Definition Sifter is a browser-first TypeScript library and viewer that ranks ASN.1 definition candidates for DER/TLV fragments. It compares parsed ASN.1 nodes with a schema corpus and returns candidate type names with scores, confidence labels, evidence, diagnostics, ambiguity notes, and matched TLV/schema paths.

The package is published as:

npm install @pkistudio/asn1defsifter

Current package version: 0.1.5

What to Read First

• Getting Started: install the package, run a first candidate lookup, and open the browser viewer.
• Core API: use parsing, feature extraction, candidate matching, schema corpus helpers, PKI helpers, and report APIs.
• Candidate Reports: understand report roots, summaries, subtree reports, document hypotheses, annotated trees, diagnostics, and ambiguity output.
• PKI Matching: understand the built-in PKI component corpus, its shared ASN.1 Instance Builder source definition, and extra filtering for RSA public keys and integer-pair signatures.
• Browser App: use the hosted/local viewer, embedded PkiStudioJS input, candidate tree, selected details, and API log.
• Embedding: mount the standalone viewer in a browser page or Webview host.
• Architecture: understand how this package fits between PkiStudioJS and ASN.1 Instance Builder.
• Testing: run local checks, smoke tests, and package dry-runs.
• Development: local commands, package exports, Pages, release, and Wiki preview conventions.

Key Guarantees

• Candidate matching is deterministic and explainable; the core resolver does not depend on an AI model.
• DER/TLV input is treated as structural evidence, not as a globally unique schema identity.
• Uncertainty is represented through ranked alternatives, diagnostics, and ambiguity notes.
• The reusable resolver core stays UI-independent and host-neutral.
• PkiStudioJS integration stays in adapter and viewer layers.
• ASN.1 Instance Builder schema parsing and schema model integration stay in adapter/corpus layers.
• The standalone viewer is a verification and exploration surface, not a dependency of the core resolver.

Repository Links

• Main repository: https://github.com/pkistudio/asn1defsifter
• npm package: https://www.npmjs.com/package/@pkistudio/asn1defsifter
• Hosted viewer: https://pkistudio.github.io/asn1defsifter/
• PkiStudioJS: https://github.com/pkistudio/pkistudiojs
• ASN.1 Instance Builder: https://github.com/pkistudio/asn1instancebuilder