remerkleable 0.1.0

Typed mutable SSZ views over cached and immutable binary merkle trees

remerkleable

Remerkleable: Typed mutable SSZ views over cached and immutable binary Merkle trees.

Features:

• Types:
  • custom byte-vector view for Python bytes-like behavior
  • bitfields: bitlist, bitvector
  • list, container, vector
  • basic types
• Functionality:
  • Serialize all types. Into output stream (returning the written count) and as bytes
  • Deserialize all types. From input stream (and scope) and from bytes
  • Hash-tree-root all types
  • Merkle-based data-sharing:
    • every view can be initialized/backed by a binary Merkle tree
    • complex views have backings, and can share data.
    • complex views provide a nice mutable interface, and replace their backing. And this also works for child-views through view-hooks.
    • SSZ-Partials: if a partial proof is loaded as backing, a view can be overlaid, and the partial backing works as long as no excluded branches are accessed.
  • Get serialization info from the bare types: min/max byte length, or just byte length for fixed-length types.

Also see

• SSZ: "SimpleSerialize", part of Ethereum 2.0
• SSZ draft spec
• Ethereum Merkle trees information aggregate

Contact

Author: @protolambda

License

MIT, see LICENSE file.