mpt package¶
Submodules¶
mpt.mpt module¶
-
class
mpt.mpt.MerklePatriciaTrie(storage, root=None, secure=False)¶ Bases:
object-
__init__(storage, root=None, secure=False)¶ Creates a new instance of MPT.
MerklePatriciaTrie works like a wrapper over provided storage. Storage must implement dict-like interface. Any data structure that implements __getitem__ and __setitem__ should be OK.
Parameters: - storage (dict-like) – Data structure to store all the data of MPT.
- root (bytes) – (Optional) Root node (not root hash!) of the trie. If not provided, tree will be considered empty.
- secure (bool) – (Optional) In secure mode all the keys are hashed using keccak256 internally.
Returns: An instance of MPT.
Return type:
-
delete(encoded_key)¶ This method removes a value associtated with provided key.
Note: this method does not RLP-encode the key. If you use encoded keys, you should encode it yourself.
Parameters: encoded_key (bytes) – RLP-encoded key. Raises: KeyError– KeyError is raised if there is no value assotiated with provided key.
-
get(encoded_key)¶ This method gets a value associtated with provided key.
Note: this method does not RLP-encode the key. If you use encoded keys, you should encode it yourself.
Parameters: encoded_key (bytes) – RLP-encoded key. Returns: Stored value associated with provided key. Return type: bytes Raises: KeyError– KeyError is raised if there is no value assotiated with provided key.
-
root()¶ Returns a root node of the trie. Type is bytes if trie isn’t empty and None othrewise.
-
root_hash()¶ Returns a hash of the trie’s root node. For empty trie it’s the hash of the RLP-encoded empty string.
-
update(encoded_key, encoded_value)¶ This method updates a provided key-value pair into the trie.
If there is no such a key in the trie, a new entry will be created. Otherwise value associtaed with key is updated. Note: this method does not RLP-encode neither key or value. If you use encoded keys, you should encode it yourself.
Parameters: - encoded_key (bytes) – RLP-encoded key.
- encoded_value (bytes) – RLP-encoded value.
-