Class TSTInfo

TSTInfo structure for RFC 3161 Time-Stamp Protocol.

The TSTInfo is the core content of a timestamp token. It contains the actual timestamp along with the hashed data and policy information. This structure is encapsulated within a SignedData content type.

Asn

TSTInfo ::= SEQUENCE  {
    version                      INTEGER  { v1(1) },
    policy                       TSAPolicyId,
    messageImprint               MessageImprint,
      -- MUST have the same value as the similar field in
      -- TimeStampReq
    serialNumber                 INTEGER,
     -- Time-Stamping users MUST be ready to accommodate integers
     -- up to 160 bits.
    genTime                      GeneralizedTime,
    accuracy                     Accuracy                 OPTIONAL,
    ordering                     BOOLEAN             DEFAULT FALSE,
    nonce                        INTEGER                  OPTIONAL,
      -- MUST be present if the similar field was present
      -- in TimeStampReq.  In that case it MUST have the same value.
    tsa                          [0] GeneralName          OPTIONAL,
    extensions                   [1] IMPLICIT Extensions  OPTIONAL   }

TSAPolicyId ::= OBJECT IDENTIFIER

See

RFC 3161 Section 2.4.2 - TSTInfo Structure

Hierarchy (View Summary)

PkiBase<TSTInfo>
- TSTInfo

Index

Constructors

constructor

new TSTInfo(
    options: {
        accuracy?: Accuracy;
        extensions?: Extension[];
        genTime: Date;
        messageImprint: MessageImprint;
        nonce?: Uint8Array<ArrayBuffer>;
        ordering?: boolean;
        policy: ObjectIdentifierString;
        serialNumber: Uint8Array<ArrayBuffer>;
        tsa?: GeneralName;
        version?: number;
    },
): TSTInfo
Creates a new TSTInfo instance.
Parameters
- options: {
      accuracy?: Accuracy;
      extensions?: Extension[];
      genTime: Date;
      messageImprint: MessageImprint;
      nonce?: Uint8Array<ArrayBuffer>;
      ordering?: boolean;
      policy: ObjectIdentifierString;
      serialNumber: Uint8Array<ArrayBuffer>;
      tsa?: GeneralName;
      version?: number;
  }
  Configuration object for the timestamp info
  - Optionalaccuracy?: Accuracy
    Optional accuracy specification
  - Optionalextensions?: Extension[]
    Optional extensions
  - genTime: Date
    Generation time of the timestamp
  - messageImprint: MessageImprint
    Hash imprint that was timestamped
  - Optionalnonce?: Uint8Array<ArrayBuffer>
    Optional nonce (must match request if present)
  - Optionalordering?: boolean
    Whether timestamps are ordered
  - policy: ObjectIdentifierString
    TSA policy OID
  - serialNumber: Uint8Array<ArrayBuffer>
    Unique serial number (up to 160 bits)
  - Optionaltsa?: GeneralName
    Optional TSA identity
  - Optionalversion?: number
    Protocol version, defaults to 1
Returns TSTInfo
Example
```
const tstInfo = new TSTInfo({
    policy: "1.3.6.1.4.1.123.456.1",
    messageImprint: messageImprint,
    serialNumber: new Uint8Array([1, 2, 3, 4]),
    genTime: new Date(),
    accuracy: new Accuracy({ seconds: 1 }),
    ordering: false
})
```
Overrides PkiBase.constructor
- Defined in packages/pki-lite/src/timestamp/TSTInfo.ts:269

Properties

`Optional`accuracy

accuracy?: Accuracy

Optional accuracy of the timestamp

`Optional`extensions

extensions?: Extension[]

Optional extensions

genTime

genTime: Date

Time at which the timestamp was generated

messageImprint

messageImprint: MessageImprint

Hash of the data that was timestamped

`Optional`nonce

nonce?: Uint8Array<ArrayBuffer>

Optional nonce from the request

ordering

ordering: boolean = false

Whether timestamps are ordered (default false)

policy

policy: ObjectIdentifier

TSA policy under which the timestamp was issued

serialNumber

serialNumber: Uint8Array<ArrayBuffer>

Unique serial number for this timestamp

`Optional`tsa

tsa?: GeneralName

Optional TSA identity

version

version: number

Version of the TSTInfo format, currently always 1

Accessors

pemHeader

get pemHeader(): string
Gets the PEM header name for this object type. Converts the class name to uppercase for use in PEM encoding.

Returns string
Inherited from PkiBase.pemHeader
- Defined in packages/pki-lite/src/core/PkiBase.ts:60

pkiType

get pkiType(): string
Gets the PKI type name for this object (typically the class name). Used for PEM headers and debugging output.

Returns string
Inherited from PkiBase.pkiType
- Defined in packages/pki-lite/src/core/PkiBase.ts:52

Methods

equals

equals(other: PkiBase<any>): boolean
Compares this PKI object with another for equality. Two objects are considered equal if their DER encodings are identical.
Parameters
- other: PkiBase<any>
  The other PKI object to compare with
Returns boolean
true if the objects are equal, false otherwise
Inherited from PkiBase.equals
- Defined in packages/pki-lite/src/core/PkiBase.ts:122

parseAs

parseAs<T>(type: ParseableAsn1<T>): T
Parses this object as a different PKI type. Useful for converting between related PKI structures.
Type Parameters
- T
  The target type to parse as
Parameters
- type: ParseableAsn1<T>
  The target type constructor with parsing capabilities
Returns T
A new instance of the target type
Inherited from PkiBase.parseAs
- Defined in packages/pki-lite/src/core/PkiBase.ts:134

toAsn1

toAsn1(): Asn1BaseBlock
Converts the TSTInfo to its ASN.1 representation.

Creates a SEQUENCE containing all the timestamp info fields in the proper order according to RFC 3161 specification.

Returns Asn1BaseBlock
ASN.1 structure representing the timestamp info
Example
```
const asn1 = tstInfo.toAsn1()
const der = asn1.toBER(false)
```
Overrides PkiBase.toAsn1
- Defined in packages/pki-lite/src/timestamp/TSTInfo.ts:322

toDer

toDer(): Uint8Array<ArrayBuffer>
Converts this PKI object to DER (Distinguished Encoding Rules) format.

Returns Uint8Array<ArrayBuffer>
The DER-encoded bytes of this object
Inherited from PkiBase.toDer
- Defined in packages/pki-lite/src/core/PkiBase.ts:100

toHumanString

toHumanString(): string
Returns a human-readable string representation of this object. By default, returns the same as toString(), but subclasses can override for more user-friendly output.

Returns string
A human-readable string representation
Inherited from PkiBase.toHumanString
- Defined in packages/pki-lite/src/core/PkiBase.ts:90

toJSON

toJSON(): ToJson<T>
Converts this object to a JSON representation.

Returns ToJson<T>
A JSON-serializable representation of this object
Inherited from PkiBase.toJSON
- Defined in packages/pki-lite/src/core/PkiBase.ts:69

toPem

toPem(): string
Converts this PKI object to PEM (Privacy-Enhanced Mail) format.

Returns string
A PEM-encoded string with appropriate headers
Inherited from PkiBase.toPem
- Defined in packages/pki-lite/src/core/PkiBase.ts:109

toString

toString(): string
Returns a string representation of this PKI object. Includes the type name and ASN.1 structure.

Returns string
A string representation for debugging
Inherited from PkiBase.toString
- Defined in packages/pki-lite/src/core/PkiBase.ts:79

`Static`fromAsn1

fromAsn1(asn1: Asn1BaseBlock): TSTInfo
Creates a TSTInfo from an ASN.1 structure.

Parses the ASN.1 SEQUENCE and extracts all optional and required fields according to RFC 3161 specification.
Parameters
- asn1: Asn1BaseBlock
  The ASN.1 structure to parse
Returns TSTInfo
The parsed TSTInfo object
Throws
Asn1ParseError if the ASN.1 structure is invalid
Example
```
const asn1 = derToAsn1(tstInfoBytes)
const tstInfo = TSTInfo.fromAsn1(asn1)
console.log(tstInfo.genTime)
console.log(tstInfo.messageImprint.hashAlgorithm)
```
- Defined in packages/pki-lite/src/timestamp/TSTInfo.ts:399

`Static`fromDer

fromDer(bytes: Uint8Array<ArrayBuffer>): TSTInfo
Parameters
- bytes: Uint8Array<ArrayBuffer>
Returns TSTInfo
- Defined in packages/pki-lite/src/timestamp/TSTInfo.ts:504

Class TSTInfo

Asn

See

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Optionalaccuracy?: Accuracy

Optionalextensions?: Extension[]

genTime: Date

messageImprint: MessageImprint

Optionalnonce?: Uint8Array<ArrayBuffer>

Optionalordering?: boolean

policy: ObjectIdentifierString

serialNumber: Uint8Array<ArrayBuffer>

Optionaltsa?: GeneralName

Optionalversion?: number

Returns TSTInfo

Example

Properties

Optionalaccuracy

Optionalextensions

genTime

messageImprint

Optionalnonce

ordering

policy

serialNumber

Optionaltsa

version

Accessors

pemHeader

Returns string

pkiType

Returns string

Methods

equals

Parameters

Returns boolean

parseAs

Type Parameters

Parameters

Returns T

toAsn1

Returns Asn1BaseBlock

Example

toDer

Returns Uint8Array<ArrayBuffer>

toHumanString

Returns string

toJSON

Returns ToJson<T>

toPem

Returns string

toString

Returns string

StaticfromAsn1

Parameters

Returns TSTInfo

Throws

Example

StaticfromDer

Parameters

Returns TSTInfo

Settings

On This Page

`Optional`accuracy?: Accuracy

`Optional`extensions?: Extension[]

`Optional`nonce?: Uint8Array<ArrayBuffer>

`Optional`ordering?: boolean

`Optional`tsa?: GeneralName

`Optional`version?: number

`Optional`accuracy

`Optional`extensions

`Optional`nonce

`Optional`tsa

`Static`fromAsn1

`Static`fromDer