1 unstable release

0.0.2 Jun 7, 2019

#6 in #ewasm


Used in ssz-cli

Apache-2.0

10KB
179 lines

ssz-json

A human readable ssz format using json.

Format

The format is a subset of JSON and follows most of the conventions closely. The two biggest deviations 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
number `"N:{u8
string "string"
vector (fixed length) ["vector", "0:u8", "1:u8"]
list (variable length) ["list", "0:u8", "1:u8"]
object { "key1": "123u32", "key2": ["vector", "456u32"] }

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–3MB
~59K SLoC