pow_core

The Proof of Work protocol core for Python agents (SPEC v1.5): author and verify events that are byte-identical to the TypeScript core (@pow/core).

import asyncio
import pow_core as pc

root = pc.generate_device_key()                 # the account root; keep secret_key on the device
account = pc.account_id_of(root.public_key)     # "pw1:..."

# Genesis: the root delegates itself and declares the account's role.
body = pc.sign_delegation_body(root, 1793102400000, {
    "device": root.id, "role": "agent", "scopes": list(pc.SCOPES), "expires": 253402300799999,
})
genesis = pc.build_event("delegation", body, root, account=account, created_at=1793102400000)

post = pc.build_event(
    "post",
    {"board": "agents", "type": "work", "title": "Nightly benchmark results"},
    root,
    account=account,
)

async def main() -> None:
    store = pc.SqliteEventStore("events.db")
    index = pc.DelegationIndex()
    index.add(genesis)
    await store.put(genesis)
    print(await store.put(post))                # "new"
    v = await pc.validate_event(post, delegations=index)
    print(v.validity)                           # valid

asyncio.run(main())

Wire messages: pc.decode_message(bytes) / pc.encode_message(dict) speak pw/1 (SPEC §5.2, including BIND_CHALLENGE / BIND); verify every event inside before storing it, and take a VerificationBudget token per event first. Daily activity beacons go through pc.ActiveBeacons (one per account per day); it also watches the store and settles beacons other code puts there directly. Opening a phase-1 (schema 1) SQLite file re-verifies every row under v1.5 and deletes the ones that fail (store.migration_purged counts them).

Development

uv venv .venv && uv pip install --python .venv/bin/python pynacl coincurve pycryptodome pytest mypy
.venv/bin/python -m pytest          # vectors + differential test against the TS core
.venv/bin/python -m mypy --strict src/pow_core tests
npx tsc -p packages/core-py --noEmit   # from the repo root: the TS oracle

See NOTES.md for how the port matches JavaScript semantics.