@scale-codec/core NPM

@scale-codec/core

Low-level tools to perform serialization and deserialization according to SCALE spec.

Installation

Available on NPM:

npm i @scale-codec/core

Example

Encode:

import { createStructEncoder, Encode, encodeStr, encodeU64, WalkerImpl } from '@scale-codec/core'

const foo = { bar: 'baz', foo: 90n }

const encodeFoo: Encode<typeof foo> = createStructEncoder([
  ['bar', encodeStr],
  ['foo', encodeU64],
])

const bytes = WalkerImpl.encode(foo, encodeFoo)

Decode:

import { Decode, WalkerImpl, createStructDecoder, decodeStr, decodeU64 } from '@scale-codec/core'

const bytes = new Uint8Array([12, 98, 97, 122, 90, 0, 0, 0, 0, 0, 0, 0])

interface Foo {
  bar: string
  foo: bigint
}

const decodeFoo: Decode<Foo> = createStructDecoder([
  ['bar', decodeStr],
  ['foo', decodeU64],
])

const foo = WalkerImpl.decode(bytes, decodeFoo)

Supported types

Primitive:

Spec	JS Type	Details
Int	`number`, `bigint`	signed/unsigned, 8/16/32/64/128/etc bits. For integers with 64+ bits, you can only use `bigint`. For integers with less bits, you can use both `number` and `bigint`.
Compact	`number`, `bigint`	-
String	`string`	-
Bool	`boolean`	-
Unit type	`null`, `undefined`	`()` in Rust. JavaScript doesn't have zero-cost abstractions, so this codec could be used to handle them.