alberta-buck-core

The Python side of the Alberta Buck platform: one testing API over every EVM backend, with expectation checking and journaling.

• Web3Session -- the ChainSession API. Send, call and deploy against anvil, a public testnet, or in-process pyrevm with the same code. Every state-changing operation declares whether it is expected to succeed or revert, so expectation mismatches are first-class results rather than surprises.
• Journal -- an append-only JSONL record of every operation: tag, op, sender, expectation, outcome, gas, tx hash, block, error. Journals are auditable, diffable across backends and across languages (the JavaScript platform writes the same schema), and replayable.
• load_artifact -- contract artifacts from a repo checkout's out/ when there is one, falling back to the installed alberta-buck-contracts otherwise, so an installed package can deploy a world with no checkout.

Install

pip install alberta-buck-core

The distribution is prefixed; the import is not:

from buck_core import Web3Session, Expect, load_artifact

The compiled kernels are optional

buck_core.buck_math, buck_core.buck_identity, buck_core.buck_wallet and buck_core.buck_registry are shims that delegate to alberta-buck-kernel when it is installed (pip install alberta-buck-core[kernel] brings it along, where a wheel exists). This package is deliberately a pure-Python wheel: keeping the binaries out means depending on the session API does not drag a per-platform wheel matrix behind it.

In a repo checkout the built .so sits beside the shim and CPython prefers the extension, so a freshly rebuilt kernel takes effect immediately.

Status

0.2.0, prototype. Unaudited software for a monetary system, published so the simulation and identity work can be reproduced and built on.

Licence

CAL-1.0 (Cryptographic Autonomy License v1.0). Beyond the usual copyleft, CAL requires that anyone you provide this software's functionality to receives their own data and is not locked out of it by cryptographic or technical means. See LICENSING.md.

Repository: https://github.com/alberta-buck/alberta-buck