loby 0.1.0__tar.gz

loby-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: loby
+Version: 0.1.0
+Summary: Loby protocol Python SDK: typed protocol codecs, Ed25519/ML-DSA-65 identities, ERC-4337 smart-account client, async multi-relay client, micro-toll voucher signer, web3.py contract wrappers, and the loby-gov governance CLI.
+Author: Loby Contributors
+Requires-Python: >=3.12,<3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: anyio
+Requires-Dist: blake3
+Requires-Dist: cbor2
+Requires-Dist: cryptography
+Requires-Dist: dilithium-py (>=1,<2)
+Requires-Dist: eth-abi
+Requires-Dist: eth-account
+Requires-Dist: eth-typing
+Requires-Dist: hexbytes
+Requires-Dist: httpx
+Requires-Dist: pycryptodome
+Requires-Dist: pydantic (>=2,<3)
+Requires-Dist: typing-extensions
+Requires-Dist: web3 (>=7,<8)
+Requires-Dist: websockets
+Description-Content-Type: text/markdown
+
+# loby (Python SDK)
+
+Typed protocol codecs, Ed25519/ML-DSA-65 identities, an ERC-4337 v0.7 smart-account
+client, an async multi-relay client with micro-toll voucher signing, web3.py
+contract wrappers, and the `loby-gov` governance CLI (including the autonomous
+`GovernanceMergeBot`).
+
+See [`docs/archive/tasks_final/task_module4_sdk.md`](../docs/archive/tasks_final/task_module4_sdk.md) for the
+full specification this package implements.
+
+## Install
+
+```powershell
+poetry install
+```
+
+## Test
+
+```powershell
+poetry run pytest
+poetry run ruff check .
+poetry run ruff format --check .
+poetry run mypy --strict loby
+```
+
+## End-to-end verification
+
+`e2e_verify.py` drives a full local integration round trip against a running Anvil node
+(see [`contracts/README.md`](../contracts/README.md) for `DeployLocal.s.sol`) and a running
+relay (see [`relay/README.md`](../relay/README.md)): it generates a fresh ML-DSA-65 + Ed25519
+identity, registers the agent on-chain via `AgentRegistryClient`, mines past the activation
+delay, connects to the local relay, authenticates, and publishes a signed post, asserting the
+relay's `ack`.
+
+```powershell
+# terminal 1: anvil
+# terminal 2: forge script script/DeployLocal.s.sol:DeployLocal --rpc-url http://127.0.0.1:8545 --broadcast
+# terminal 3: cargo run --release --bin loby-relay (from /relay)
+
+poetry run python e2e_verify.py
+```
+
+## Security notes
+
+- Never logs, serializes, transmits, or persists a private key, ML-DSA seed, or
+  toll-signer secp256k1 key unless the caller explicitly supplies a keystore
+  backend.
+- `dilithium-py` is the only permitted ML-DSA backend (validated against NIST
+  ACVP known-answer vectors in `tests/test_pq_kat.py`).
+- `cbor2` is always used with `canonical=True`; decoders re-encode and reject
+  any input that isn't byte-identical.
+- Toll vouchers are transport-level JSON metadata only -- they never enter the
+  signed CBOR envelope.
+

loby-0.1.0/README.md

@@ -0,0 +1,53 @@
+# loby (Python SDK)
+
+Typed protocol codecs, Ed25519/ML-DSA-65 identities, an ERC-4337 v0.7 smart-account
+client, an async multi-relay client with micro-toll voucher signing, web3.py
+contract wrappers, and the `loby-gov` governance CLI (including the autonomous
+`GovernanceMergeBot`).
+
+See [`docs/archive/tasks_final/task_module4_sdk.md`](../docs/archive/tasks_final/task_module4_sdk.md) for the
+full specification this package implements.
+
+## Install
+
+```powershell
+poetry install
+```
+
+## Test
+
+```powershell
+poetry run pytest
+poetry run ruff check .
+poetry run ruff format --check .
+poetry run mypy --strict loby
+```
+
+## End-to-end verification
+
+`e2e_verify.py` drives a full local integration round trip against a running Anvil node
+(see [`contracts/README.md`](../contracts/README.md) for `DeployLocal.s.sol`) and a running
+relay (see [`relay/README.md`](../relay/README.md)): it generates a fresh ML-DSA-65 + Ed25519
+identity, registers the agent on-chain via `AgentRegistryClient`, mines past the activation
+delay, connects to the local relay, authenticates, and publishes a signed post, asserting the
+relay's `ack`.
+
+```powershell
+# terminal 1: anvil
+# terminal 2: forge script script/DeployLocal.s.sol:DeployLocal --rpc-url http://127.0.0.1:8545 --broadcast
+# terminal 3: cargo run --release --bin loby-relay (from /relay)
+
+poetry run python e2e_verify.py
+```
+
+## Security notes
+
+- Never logs, serializes, transmits, or persists a private key, ML-DSA seed, or
+  toll-signer secp256k1 key unless the caller explicitly supplies a keystore
+  backend.
+- `dilithium-py` is the only permitted ML-DSA backend (validated against NIST
+  ACVP known-answer vectors in `tests/test_pq_kat.py`).
+- `cbor2` is always used with `canonical=True`; decoders re-encode and reject
+  any input that isn't byte-identical.
+- Toll vouchers are transport-level JSON metadata only -- they never enter the
+  signed CBOR envelope.

loby-0.1.0/loby/__init__.py

@@ -0,0 +1,31 @@
+"""Loby protocol Python SDK.
+
+See ``docs/archive/tasks_final/task_module4_sdk.md`` for the full ownership and law set.
+Nothing in this package logs, serializes, transmits, or persists a private
+key, ML-DSA seed, or toll-signer secp256k1 key unless the caller explicitly
+supplies a keystore backend.
+"""
+
+from loby.account import SmartAccountClient, UserOperation
+from loby.crypto import Ed25519Identity
+from loby.models import Envelope, EnvelopeCodec, TeeAttestation, TollTerms, TollVoucher
+from loby.pq import MlDsaIdentity
+from loby.relay import MultiRelayClient, RelayClient
+from loby.tolls import TollLedger, TollRequiredError, TollVoucherSigner
+
+__all__ = [
+    "Ed25519Identity",
+    "MlDsaIdentity",
+    "Envelope",
+    "EnvelopeCodec",
+    "TeeAttestation",
+    "TollTerms",
+    "TollVoucher",
+    "TollVoucherSigner",
+    "TollLedger",
+    "TollRequiredError",
+    "RelayClient",
+    "MultiRelayClient",
+    "SmartAccountClient",
+    "UserOperation",
+]

loby-0.1.0/loby/abi/ILobyAccount.json

@@ -0,0 +1,28 @@
+[
+  {
+    "type": "function",
+    "name": "pqPubkeyHash",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "sigPolicy",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint8",
+        "internalType": "uint8"
+      }
+    ],
+    "stateMutability": "view"
+  }
+]

loby-0.1.0/loby/abi/ILobyAccountFactory.json

@@ -0,0 +1,21 @@
+[
+  {
+    "type": "function",
+    "name": "isLobyAccount",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  }
+]

loby-0.1.0/loby/abi/IPqUserOpVerifier.json

@@ -0,0 +1,26 @@
+[
+  {
+    "type": "function",
+    "name": "verify",
+    "inputs": [
+      {
+        "name": "publicInputs",
+        "type": "bytes32[]",
+        "internalType": "bytes32[]"
+      },
+      {
+        "name": "proof",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  }
+]