This library provides you with low level tools to use CBOR format.
It is inspired by minicbor crate in Rust and rxjs library in Javascript.
To see the full API Documentation, please visit Docs.
Using npm:
npm install cbor-utilsUsing jsr:
npx jsr add @whiteand/cborIf you want to encode something to Uint8Array you can use encode function.
import { encode, u8, bytes, bool } from "cbor-utils";
const bytes = encode((e) => {
e.encode(u8, 42);
e.encode(bytes, new Uint8Array([1, 2, 3]));
e.encode(bool, true);
});If you want to decode something you can use decode function.
import { ok, decode, Result, u8, bytes, bool } from "cbor-utils";
/**
* @type {Result<{id: number, hash: Uint8Array, submitted: boolean }, DecodingError>
*/
const res = decode(cborBytes, (d) => {
const id = d.decode(u8);
if (!id.ok()) return id;
const hash = d.decode(bytes);
if (!hash.ok()) return hash;
const submitted = d.decode(bool);
if (!submitted.ok()) return submitted;
return ok({
id: id.value,
hash: hash.value,
submitted: submitted.value,
});
});
//or less type safe version, but without necessity to check each decoded item result:
import { tryDecode, u8, bytes, bool } from "cbor-utils";
/**
* @type {Result<{id: number, hash: Uint8Array, submitted: boolean }, unknown>
*/
const result2 = tryDecode(cborBytes, (d) => {
const id = d.decode(u8);
const hash = d.decode(bytes);
const submitted = d.decode(bool);
return {
id,
hash,
submitted,
};
});A CBOR Type is an object that allows you to encode and decode values of the specified type. Example: CBOR Type of u8 means that this object has encode capability that converts u8 into a CBOR data item, also it is able to read u8 data item from an Uint8Array.
Is an object that allows you to encode values into a growing Uint8Array.
Is an object that consists of two fields buf: Uint8Array and ptr: number.
CBOR Types modify the decoder type to read cbor item.
Is a function that takes one CBOR Type (called source type) and returns another CBOR Type (called target type). Example: array operator takes CBOR Type of u8 and returns CBOR type of array<u8>.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent