status-im
/
eth2.0-specs
mirror of https://github.com/status-im/eth2.0-specs.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Remove int as per discussions, update implementations

This commit is contained in:
NatoliChris 2018-10-02 09:41:18 +10:00
parent 4c75cd0db2
commit b1c873c8f6
No known key found for this signature in database
GPG Key ID: D3EA7DBA19945306
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
specs/simpleserialize.md
View File

@ -15,13 +15,13 @@ deserializing objects and data types.
* [Constants](#constants) * [Constants](#constants)
* [Overview](#overview) * [Overview](#overview)
+ [Serialize/Encode](#serializeencode) + [Serialize/Encode](#serializeencode)
- [int/uint: 8/16/24/32/64/256](#intuint-816243264256) - [uint: 8/16/24/32/64/256](#uint-816243264256)
- [Address](#address) - [Address](#address)
- [Hash32](#hash32) - [Hash32](#hash32)
- [Bytes](#bytes) - [Bytes](#bytes)
- [List](#list) - [List](#list)
+ [Deserialize/Decode](#deserializedecode) + [Deserialize/Decode](#deserializedecode)
- [int/uint: 8/16/24/32/64/256](#intuint-816243264256-1) - [uint: 8/16/24/32/64/256](#uint-816243264256-1)
- [Address](#address-1) - [Address](#address-1)
- [Hash32](#hash32-1) - [Hash32](#hash32-1)
- [Bytes](#bytes-1) - [Bytes](#bytes-1)
@ -59,7 +59,7 @@ overhead.
### Serialize/Encode ### Serialize/Encode
#### int/uint: 8/16/24/32/64/256 #### uint: 8/16/24/32/64/256
Convert directly to bytes the size of the int. (e.g. ``uint16 = 2 bytes``) Convert directly to bytes the size of the int. (e.g. ``uint16 = 2 bytes``)
@ -150,7 +150,7 @@ At each step, the following checks should be made:
|:-------------------------|:----------------------------------------------------------| |:-------------------------|:----------------------------------------------------------|
| Ensure sufficient length | ``length(rawbytes) > current_index + deserialize_length`` | | Ensure sufficient length | ``length(rawbytes) > current_index + deserialize_length`` |
#### int/uint: 8/16/24/32/64/256 #### uint: 8/16/24/32/64/256
Convert directly from bytes into integer utilising the number of bytes the same Convert directly from bytes into integer utilising the number of bytes the same
size as the integer length. (e.g. ``uint16 == 2 bytes``) size as the integer length. (e.g. ``uint16 == 2 bytes``)
@ -193,9 +193,9 @@ return rawbytes[current_index+4:current_index+4+bytes_length], new_index
#### List #### List
Deserailize each object in the list. Deserialize each object in the list.
1. Get the length of the serialized list. 1. Get the length of the serialized list.
2. Loop through deseralizing each item in the list until you reach the 2. Loop through deserializing each item in the list until you reach the
entire length of the list. entire length of the list.
@ -218,8 +218,9 @@ return deserialized_list, new_index
## Implementations ## Implementations
| Language | Implementation | Description | | Language | Implementation | Description |
|:--------:|--------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------| |:--------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------|
| Python | [ https://github.com/ethereum/beacon_chain/blob/master/ssz/ssz.py ](https://github.com/ethereum/beacon_chain/blob/master/ssz/ssz.py) | Beacon chain reference implementation written in Python. | | Python | [ https://github.com/ethereum/beacon_chain/blob/master/ssz/ssz.py ](https://github.com/ethereum/beacon_chain/blob/master/ssz/ssz.py) | Beacon chain reference implementation written in Python. |
| Rust | [ https://github.com/sigp/lighthouse/tree/master/ssz ](https://github.com/sigp/lighthouse/tree/master/ssz) | Lighthouse (Rust Ethereum 2.0 Node) maintained SimpleSerialize. | | Rust | [ https://github.com/sigp/lighthouse/tree/master/ssz ](https://github.com/sigp/lighthouse/tree/master/ssz) | Lighthouse (Rust Ethereum 2.0 Node) maintained SimpleSerialize. |
| Nim | [ https://github.com/status-im/nim-beacon-chain/blob/master/beacon_chain/ssz.nim ](https://github.com/status-im/nim-beacon-chain/blob/master/beacon_chain/ssz.nim) | Nim Implemetnation maintained SimpleSerialize. |
| Rust | [ https://github.com/paritytech/shasper/tree/master/util/ssz ](https://github.com/paritytech/shasper/tree/master/util/ssz) | Shasper implementation of SSZ maintained by ParityTech. |