2 releases

0.1.2 Jun 11, 2019
0.1.1 Jun 10, 2019

#5 in #ewasm

Apache-2.0

18KB
463 lines

sszt

A human-readable serialization of ssz.

Format

The sszt engine is written as a Serde deserializer for the recursive SsztValue enum and should be easily modified to support most formats supported by Serde.

Two major formats are currently supported:

  • JSON
  • YAML

The biggest deviations from the JSON / YAML specifications are appending the integer type at the end of the number using a string and declaring the type array (list / vector) in the first element.

Type Representation
null null
bool true | false
number "N:{u8|u16|u32|u64|u128|u256}"
string "string"
vector (fixed length) ["vector", "0:u8", "1:u8"]
list (variable length) ["list", "0:u8", "1:u8"]
object { "key1": "123:u32", "key2": ["vector", "456:u32"] }

Examples

{
	"new_messages": [
		"list",
		{
			"timestamp": "1:u64",
			"message": "0:u256"
		},
		{
			"timestamp": "2:u64",
			"message": "454086624460063511464984254936031011189294057512315937409637584344757371137:u256"
		}
	],
	"state": {
		"messages": ["list"]
	}
}

ssz encoding: 5c0000005000000001000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000010101010101010101010101010101010101010101010101010101010101010400000000000000

--

{
	"messages": [
		"list",
		{
			"timestamp": "1:u64",
			"message": "0:u256"
		},
		{
			"timestamp": "2:u64",
			"message": "454086624460063511464984254936031011189294057512315937409637584344757371137:u256"
		}

	]
}

ssz encoding: 5c0000005000000001000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000001010101010101010101010101010101010101010101010101010101010101010400000000000000

--

{
	"fixed": [
		"vector",
		["vector", "0:u8"],
		["vector", "1:u8"],
		["vector", "2:u8"],
		["vector", "3:u8"],
		["vector", "4:u8"]
	],
	"other": {
		"a": {
			"b": {
				"c": {
					"d": [
						"vector",
						"16:u16"
					]
				}
			}
		},
		"b": "32:u32"
	}
}

ssz encoding: 0001020304100020000000

Maintainer

License

Apache 2.0

Dependencies

~2.5–3.5MB
~71K SLoC