asn1Oid

ASN.1 OID database — bidirectional name ↔ OID resolution, ≥ 180 entries.

Module asn1Oid | Source packages/front/fw/src/crypto/utils/asn1-oid.js | Deps none | Worker-safe yes

Resolve

const oid = runtime.resolve('asn1Oid');
// Returns: { lookup, byName, findByCategory, OID_DATABASE }

API

OidEntry

{
  name: string;       // canonical unique name (e.g. 'sha256WithRSAEncryption')
  shortName: string;  // abbreviation (e.g. 'sha256WithRSA')
  category: string;   // group (e.g. 'pkcs1', 'x509-dn', 'ecc-curve')
  // optional fields depending on category:
  hashAlg?: string;   // e.g. 'sha-256'
  sigAlg?: string;    // e.g. 'rsa', 'ecdsa', 'rsa-pss'
  curve?: string;     // e.g. 'P-256'
  keyLen?: number;    // e.g. 128, 256 (AES)
  mode?: string;      // e.g. 'cbc', 'gcm' (AES)
}

Supported categories

Total: ≥ 180 OIDs

Examples

const oid = runtime.resolve('asn1Oid');

// OID → metadata
oid.lookup('1.2.840.113549.1.7.2');
// → { name: 'pkcs7-signedData', shortName: 'signedData', category: 'pkcs7' }

oid.lookup('1.2.840.113549.1.1.11');
// → { name: 'sha256WithRSAEncryption', shortName: 'sha256WithRSA',
//      category: 'pkcs1', hashAlg: 'sha-256', sigAlg: 'rsa' }

oid.lookup('9.9.9.9.9');
// → null  (unknown)

// name/shortName → OID (case-insensitive)
oid.byName('signedData');               // → '1.2.840.113549.1.7.2'
oid.byName('pkcs7-signedData');         // → '1.2.840.113549.1.7.2'  (same OID)
oid.byName('sha256WithRSAEncryption'); // → '1.2.840.113549.1.1.11'
oid.byName('CN');                       // → '2.5.4.3'

// Category
oid.findByCategory('ecc-curve');
// → [{ oid: '1.2.840.10045.3.1.7', name: 'prime256v1', shortName: 'P-256', ... }, ...]

// Raw catalogue
Object.keys(oid.OID_DATABASE).length; // ≥ 180

Worker Usage

const worker = fw.createWorker(workerFn, { modules: ['asn1Oid'] });
// asn1Oid uses no DOM API — natively worker-safe.

Adding a new OID

Add an entry to the static OID_DATABASE (at the top of the source file):

'1.2.3.4.5.6': {
    name: 'myAlgorithm',        // canonical name (unique in the DB)
    shortName: 'myAlg',         // short abbreviation
    category: 'pkcs1',          // existing or new category
    hashAlg: 'sha-256',         // optional field depending on usage
},

The key is the dotted OID string. The internal _nameIndex is rebuilt on each factory() call.

Notes

• No npm or external dependency — the table is hand-built from public RFCs and specs.
• lookup and byName always return null for invalid or unknown input, never throw.
• byName is case-insensitive and accepts both the canonical name and the shortName.
• Duplicate entries in _nameIndex (shared shortName case) are overwritten deterministically following the iteration order of OID_DATABASE.

See also

• asn1 — ASN.1 DER (X.690) parser whose semantic companion is asn1Oid
• pem — PEM encoding (BEGIN/END) used with X.509 certificates
• keyformat — EC/RSA/Ed key serialisation (PKCS#8 + SPKI)