@ngraveio/ur-uuid

UUID CBOR type

Installing

To install, run:

yarn add @ngraveio/ur-uuid

npm install --save @ngraveio/ur-uuid

Source: https://github.com/lucas-clemente/cbor-specs/blob/master/uuid.md

UUID Tag for CBOR

This document specifies a tag for UUID in Concise Binary Object Representation (CBOR) [1].

Tag: 37
Data item: byte string
Semantics: Binary UUID (RFC 4122 section 4.1.2)
Point of contact: Lucas Clemente <[e-mail]>
Description of semantics: https://github.com/lucas-clemente/cbor-specs/blob/master/uuid.md

Usage

Generating a UUID

import { UUID } from '@ngraveio/ur-uuid';

const uuid = UUID.generate();
console.log(uuid.toString()); // Prints the generated UUID as a string

Creating a UUID from a string

import { UUID } from '@ngraveio/ur-uuid';

const uuidString = '123e4567-e89b-12d3-a456-426614174000';
const uuid = new UUID(uuidString);
console.log(uuid.toString()); // Prints the UUID as a string

Creating a UUID from bytes

import { UUID } from '@ngraveio/ur-uuid';

const uuidBytes = new Uint8Array([18, 62, 69, 103, 232, 155, 18, 211, 164, 86, 66, 20, 23, 64, 0]);
const uuid = new UUID(uuidBytes);
console.log(uuid.toString()); // Prints the UUID as a string

Verifying a UUID

import { UUID } from '@ngraveio/ur-uuid';

const uuidString = '123e4567-e89b-12d3-a456-426614174000';
const uuid = new UUID(uuidString);
const verification = uuid.verifyInput(uuidString);
console.log(verification.valid); // Prints true if the UUID is valid

Semantics

Tag 37 can be applied to a byte string (major type 2) to indicate that the byte string is a UUID as defined in RFC 4122 section 4.1.2.

References

[1] C. Bormann, and P. Hoffman. "Concise Binary Object Representation (CBOR)". RFC 7049, October 2013.

Author

Lucas Clemente [e-mail]