astreum 0.2.21__py3-none-any.whl → 0.2.23__py3-none-any.whl

astreum/models/accounts.py

@@ -1,80 +1,34 @@
-"""Account‐state management built on a PatriciaTrie.
-
-Only the *initial skeleton* is provided here per current request:
-  • __init__: wrap an existing trie root (or start empty).
-  • get_account: look up an Account object, using a cache so multiple
-    balance/nonce updates in one block operate on the same instance.
-
-Additional mutation helpers (set_account, change_balance, etc.) will be
-added next, once confirmed.
-"""
 from __future__ import annotations
-
 from typing import Dict, Optional, Callable
-
 from .patricia import PatriciaTrie
 from .account import Account
 
-
 class Accounts:
-    """Light wrapper around a PatriciaTrie (address → body_hash) plus
-    an in‑memory cache of Account objects currently being worked on.
-    """
-
-    # ------------------------------------------------------------
-    # construction
-    # ------------------------------------------------------------
     def __init__(
         self,
         root_hash: Optional[bytes] = None,
-        *,
-        get_node_fn: Optional[Callable[[bytes], Optional[bytes]]] = None,
+        global_get_fn: Optional[Callable[[bytes], Optional[bytes]]] = None,
     ) -> None:
-        """Wrap an existing state trie *or* start empty (root_hash=None).
-
-        `get_node_fn` (optional) is a callback that retrieves raw node bytes
-        when the underlying PatriciaTrie encounters an unknown hash – useful
-        for disk or network-backed light clients.
-        """
-        self._remote_get = get_node_fn
-        # Instantiate the trie; we pass the external fetcher straight in.
-        # PatriciaTrie is expected to accept `node_get` and `root_hash`.
-        self._trie = PatriciaTrie(node_get=get_node_fn, root_hash=root_hash)
-
-        # Working‑set cache: address → Account instance
+        self._global_get_fn = global_get_fn
+        self._trie = PatriciaTrie(node_get=global_get_fn, root_hash=root_hash)
         self._cache: Dict[bytes, Account] = {}
 
-    # ------------------------------------------------------------
-    # public introspection
-    # ------------------------------------------------------------
     @property
     def root_hash(self) -> Optional[bytes]:
-        """Current trie root (updates automatically after puts)."""
         return self._trie.root_hash
 
-    # ------------------------------------------------------------
-    # account access – read‑only for now
-    # ------------------------------------------------------------
     def get_account(self, address: bytes) -> Optional[Account]:
-        """Return an *Account* for `address`, or *None* if it doesn't exist.
-
-        • First check the in‑memory cache (so repeat reads/updates reuse the
-          same object).
-        • Otherwise look up `body_hash` in the PatriciaTrie.
-        • If found, create a lightweight `Account` wrapper, cache it, and
-          return it.  The Account is initialised with the same external
-          node‑fetcher so its own Merkle lookups can go remote if needed.
-        """
-        # cache hit → hot path
         if address in self._cache:
             return self._cache[address]
 
-        # trie lookup (raw body_hash)
         body_hash: Optional[bytes] = self._trie.get(address)
         if body_hash is None:
             return None
 
-        # wrap in Account and cache
-        acc = Account(body_hash, get_node_fn=self._remote_get)
+        acc = Account(body_hash, get_node_fn=self._global_get_fn)
         self._cache[address] = acc
         return acc
+
+    def set_account(self, address: bytes, account: Account) -> None:
+        self._cache[address] = account
+        self._trie.put(address, account.body_hash())

astreum/models/block.py

@@ -1,6 +1,10 @@
 from __future__ import annotations
 
 from typing import List, Dict, Any, Optional, Union
+
+from astreum.models.account import Account
+from astreum.models.accounts import Accounts
+from astreum.models.patricia import PatriciaTrie
 from ..crypto import ed25519
 from .merkle import MerkleTree
 
@@ -128,3 +132,39 @@ class Block:
             return True
         except Exception:
             return False
+
+    @classmethod
+    def genesis(cls, validator_addr: bytes) -> "Block":
+        # 1 . validator-stakes sub-trie
+        stake_trie = PatriciaTrie()
+        stake_trie.put(validator_addr, (1).to_bytes(32, "big"))
+        stake_root = stake_trie.root_hash
+
+        # 2 . build the two Account bodies
+        validator_acct = Account.create(balance=0, data=b"",        nonce=0)
+        treasury_acct  = Account.create(balance=1, data=stake_root, nonce=0)
+
+        # 3 . global Accounts structure
+        accts = Accounts()
+        accts.set_account(validator_addr, validator_acct)
+        accts.set_account(b"\x11" * 32, treasury_acct)
+        accounts_hash = accts.root_hash
+
+        # 4 . constant body fields for genesis
+        body_kwargs = dict(
+            number                  = 0,
+            prev_block_hash         = b"\x00" * 32,
+            timestamp               = 0,
+            accounts_hash           = accounts_hash,
+            transactions_total_fees = 0,
+            transaction_limit       = 0,
+            transactions_root_hash  = b"\x00" * 32,
+            delay_difficulty        = 0,
+            delay_output            = b"",
+            delay_proof             = b"",
+            validator_pk            = validator_addr,
+            signature               = b"",
+        )
+
+        # 5 . build and return the block
+        return cls.create(**body_kwargs)

{astreum-0.2.21.dist-info → astreum-0.2.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astreum
-Version: 0.2.21
+Version: 0.2.23
 Summary: Python library to interact with the Astreum blockchain and its Lispeum virtual machine.
 Author-email: "Roy R. O. Okello" <roy@stelar.xyz>
 Project-URL: Homepage, https://github.com/astreum/lib

{astreum-0.2.21.dist-info → astreum-0.2.23.dist-info}/RECORD

@@ -11,13 +11,13 @@ astreum/lispeum/parser.py,sha256=jQRzZYvBuSg8t_bxsbt1-WcHaR_LPveHNX7Qlxhaw-M,116
 astreum/lispeum/tokenizer.py,sha256=J-I7MEd0r2ZoVqxvRPlu-Afe2ZdM0tKXXhf1R4SxYTo,1429
 astreum/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 astreum/models/account.py,sha256=sHujGSwtV13rvOGJ5LZXuMrJ4F9XUdvyuWKz-zJ9lkE,2986
-astreum/models/accounts.py,sha256=-To0l_COBa9A4hA1zNVvtxCbnKOT4O0bcj_CUMfXQFo,3283
-astreum/models/block.py,sha256=YIY3qLneFM7OooY29khLDEs3NIEA7y8VhlXitflkxTo,4564
+astreum/models/accounts.py,sha256=aFSEWlq6zRf65-KGAdNGqEJyNVY3fpKhx8y1vU6sgSc,1164
+astreum/models/block.py,sha256=3OyAAqw853aLnnWogYdkxOg_WXNEsfn2g8jrFEip2aY,6141
 astreum/models/merkle.py,sha256=merV3rx2iRfzvglV6gNusrJf7OMbcVV854T-DUWCC64,6733
 astreum/models/patricia.py,sha256=ohmXrcaz7Ae561tyC4u4iPOkQPkKr8N0IWJek4upFIg,13392
 astreum/models/transaction.py,sha256=yBarvRK2ybMAHHEQPZpubGO7gms4U9k093xQGNQHQ4Q,3043
-astreum-0.2.21.dist-info/licenses/LICENSE,sha256=gYBvRDP-cPLmTyJhvZ346QkrYW_eleke4Z2Yyyu43eQ,1089
-astreum-0.2.21.dist-info/METADATA,sha256=naZ-ipusDSvUJg4oNgtVFC2F8oMCrHu0R6ge66lU1cQ,5478
-astreum-0.2.21.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-astreum-0.2.21.dist-info/top_level.txt,sha256=1EG1GmkOk3NPmUA98FZNdKouhRyget-KiFiMk0i2Uz0,8
-astreum-0.2.21.dist-info/RECORD,,
+astreum-0.2.23.dist-info/licenses/LICENSE,sha256=gYBvRDP-cPLmTyJhvZ346QkrYW_eleke4Z2Yyyu43eQ,1089
+astreum-0.2.23.dist-info/METADATA,sha256=itKxfzkJrO8JcpMVCW3nDA_8NdtdndEj9zKJaoT5GGc,5478
+astreum-0.2.23.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+astreum-0.2.23.dist-info/top_level.txt,sha256=1EG1GmkOk3NPmUA98FZNdKouhRyget-KiFiMk0i2Uz0,8
+astreum-0.2.23.dist-info/RECORD,,