Package-level declarations

ASN.1 BIT STRING

ASN1 structure (i.e. containing child nodes) with custom tag

Interface providing convenience methods to decode from ASN.1. Especially useful when companion objects of classes implementing Asn1Encodable implement it.

Base ASN.1 data class. Can either be a primitive (holding a value), or a structure (holding other ASN.1 elements)

Generic serializer for ASN.1 tree model types.

ASN.1 OCTET STRING 0x04 (BERTags.OCTET_STRING) containing an Asn1Element

Interface providing methods to encode to ASN.1

Explicit ASN.1 Tag. Can contain any number of children

A very simple implementation of an ASN.1 variable-length integer. It is only good for reading from and writing to ASN.1 structures. It is not a BigInt, nor does it define any operations. It has a sign though, and supports twosComplement representation and converting fromTwosComplement. Hence, it directly interoperates with Kotlin MP BigNum and the JVM BigInteger.

String serializer for Asn1Integer.

Interface describing an ASN.1 OCTET STRING.

ASN.1 primitive. Holds no children, but content under tag

ASN.1 OCTET STRING 0x04 (BERTags.OCTET_STRING) containing arbitrary bytes

ASN.1 REAL number. Mind possible loss of precision compared to Kotlin's built-in types. This type is irrelevant for PKI applications, but required for generic ASN.1 serialization

String serializer for Asn1Real.

ASN.1 SEQUENCE 0x30 (BERTags.SEQUENCE OR BERTags.CONSTRUCTED)

ASN.1 SET 0x31 (BERTags.SET OR BERTags.CONSTRUCTED)

ASN.1 SET OF 0x31 (BERTags.SET OR BERTags.CONSTRUCTED)

ASN.1 String class used as wrapper do discriminate between different ASN.1 string types By default, the string value is decoded using UTF-8. If a different charset or custom decoding is needed, the rawValue property can be used directly.

ASN.1 structure. Contains no data itself, but holds zero or more children

ASN.1 TIME (required since GENERALIZED TIME and UTC TIME exist)

Pure Kotlin Bit Set created by throwing a bunch of extension functions at a MutableList<Byte>. As a mental model: this BitSet grows from left to right, just like writing a text.

String serializer for BitSet used for interoperability with non-DER serialization formats.

Adds oid to the implementing class

Holds known OIDs and their descriptions. If the oids module is part of your classpath, call KnownOIDs.describeAll() to add descriptions for all known OID constants shipped with the module.

ASN.1 OBJECT IDENTIFIER featuring the most cursed encoding of numbers known to man, which probably surfaced due to an ungodly combination of madness, cruelty and a twisted sense of humour. Courtesy of what were most probably tormented souls to begin with.

String-based serializer for ObjectIdentifier.

ASN.1 NULL as constant

asserts that this element's tag matches tag.

Asserts only the tag number, but neither class, nor CONSTRUCTED bit.

Non-fatal-only-catching version of stdlib's runCatching, returning a Result -- Re-throws any fatal exceptions, such as OutOfMemoryError. Re-implements Arrow's nonFatalOrThrow logic to avoid a dependency on Arrow for a single function.

shorthand for set(index, false)

Exception-free version of Asn1Decodable.decodeFromTlv

Decodes this ASN.1 structure using the provided decoder lambda, rethrowing any caught exception as an Asn1Exception. This is a wrapper around Asn1Structure.decodeAs that ensures exceptions thrown during decoding are consistently rethrown as Asn1Exception, using the runRethrowing utility.

Drops bytes at the start, or adds zero bytes at the start, until the size is reached

Returns a binary representation of this byte array's memory layout Bytes are separated by a single space. An empty byte array results in an empty string.

decodes this Asn1Primitive's content into an ObjectIdentifier

Runs block inside catchingUnwrapped and encapsulates any thrown exception in an Asn1Exception unless it already is one

shorthand for set(index, true)

copies this byteArray into a BitSet

Returns all bits as they are accessible by the global bit index (i.e. after wrapping this ByteArray into a BitSet)

Directly moves the byte array to a buffer without copying. Thus, it keeps bytes managed by a Buffer accessible. The bytes may be overwritten through the Buffer or even recycled to be used by another buffer. Therefore, operating on these bytes after wrapping leads to undefined behaviour.