astreum 0.2.21__tar.gz → 0.2.23__tar.gz

{astreum-0.2.21/src/astreum.egg-info → astreum-0.2.23}/PKG-INFO

@@ -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 → astreum-0.2.23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "astreum"
-version = "0.2.21"
+version = "0.2.23"
 authors = [
   { name="Roy R. O. Okello", email="roy@stelar.xyz" },
 ]

astreum-0.2.23/src/astreum/models/accounts.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+from typing import Dict, Optional, Callable
+from .patricia import PatriciaTrie
+from .account import Account
+
+class Accounts:
+    def __init__(
+        self,
+        root_hash: Optional[bytes] = None,
+        global_get_fn: Optional[Callable[[bytes], Optional[bytes]]] = None,
+    ) -> None:
+        self._global_get_fn = global_get_fn
+        self._trie = PatriciaTrie(node_get=global_get_fn, root_hash=root_hash)
+        self._cache: Dict[bytes, Account] = {}
+
+    @property
+    def root_hash(self) -> Optional[bytes]:
+        return self._trie.root_hash
+
+    def get_account(self, address: bytes) -> Optional[Account]:
+        if address in self._cache:
+            return self._cache[address]
+
+        body_hash: Optional[bytes] = self._trie.get(address)
+        if body_hash is None:
+            return None
+
+        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-0.2.21 → astreum-0.2.23}/src/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 → astreum-0.2.23/src/astreum.egg-info}/PKG-INFO

@@ -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/src/astreum/models/accounts.py

@@ -1,80 +0,0 @@
-"""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,
-    ) -> 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._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)
-        self._cache[address] = acc
-        return acc