animica 0.1.0__tar.gz

animica-0.1.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: animica
+Version: 0.1.0
+Summary: Animica blockchain CLI and client libraries — node, wallet, miner, contracts, and useful-work jobs.
+Project-URL: Homepage, https://animica.org
+Project-URL: Repository, https://github.com/animicaorg/all
+Project-URL: Documentation, https://animica.org/docs
+Project-URL: Issues, https://github.com/animicaorg/all/issues
+License: Apache-2.0
+Keywords: animica,blockchain,cli,miner,node,useful-work,wallet
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: alembic<2.0.0,>=1.17.0
+Requires-Dist: cbor2>=5.6.0
+Requires-Dist: eth-account<1.0.0,>=0.13.7
+Requires-Dist: fastapi<0.116.0,>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: prometheus-client<1.0.0,>=0.20.0
+Requires-Dist: psycopg[binary]<4.0.0,>=3.2.12
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: sqlalchemy<3.0.0,>=2.0.44
+Requires-Dist: typer>=0.12.3
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0
+Requires-Dist: web3<8.0.0,>=7.14.0
+Provides-Extra: all
+Requires-Dist: accelerate<1.0.0,>=0.34.0; extra == 'all'
+Requires-Dist: alembic<2.0.0,>=1.17.0; extra == 'all'
+Requires-Dist: datasets<4.0.0,>=2.20.0; extra == 'all'
+Requires-Dist: eth-account<1.0.0,>=0.13.7; extra == 'all'
+Requires-Dist: fastapi<0.116.0,>=0.115.0; extra == 'all'
+Requires-Dist: prometheus-client<1.0.0,>=0.20.0; extra == 'all'
+Requires-Dist: psycopg[binary]<4.0.0,>=3.2.12; extra == 'all'
+Requires-Dist: pyarrow>=17.0.0; extra == 'all'
+Requires-Dist: pypdf>=5.0.0; extra == 'all'
+Requires-Dist: pypng>=0.20220715.0; extra == 'all'
+Requires-Dist: segno<2.0.0,>=1.6.1; extra == 'all'
+Requires-Dist: sqlalchemy<3.0.0,>=2.0.44; extra == 'all'
+Requires-Dist: torch>=2.2.0; extra == 'all'
+Requires-Dist: transformers<5.0.0,>=4.44.0; extra == 'all'
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0; extra == 'all'
+Requires-Dist: web3<8.0.0,>=7.14.0; extra == 'all'
+Provides-Extra: backend
+Requires-Dist: fastapi<0.116.0,>=0.115.0; extra == 'backend'
+Requires-Dist: prometheus-client<1.0.0,>=0.20.0; extra == 'backend'
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0; extra == 'backend'
+Provides-Extra: bridge
+Requires-Dist: alembic<2.0.0,>=1.17.0; extra == 'bridge'
+Requires-Dist: eth-account<1.0.0,>=0.13.7; extra == 'bridge'
+Requires-Dist: psycopg[binary]<4.0.0,>=3.2.12; extra == 'bridge'
+Requires-Dist: sqlalchemy<3.0.0,>=2.0.44; extra == 'bridge'
+Requires-Dist: web3<8.0.0,>=7.14.0; extra == 'bridge'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9; extra == 'dev'
+Requires-Dist: omni-sdk>=0.1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: ena
+Requires-Dist: accelerate<1.0.0,>=0.34.0; extra == 'ena'
+Requires-Dist: datasets<4.0.0,>=2.20.0; extra == 'ena'
+Requires-Dist: fastapi<0.116.0,>=0.115.0; extra == 'ena'
+Requires-Dist: prometheus-client<1.0.0,>=0.20.0; extra == 'ena'
+Requires-Dist: pyarrow>=17.0.0; extra == 'ena'
+Requires-Dist: pypdf>=5.0.0; extra == 'ena'
+Requires-Dist: transformers<5.0.0,>=4.44.0; extra == 'ena'
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0; extra == 'ena'
+Provides-Extra: gpu
+Requires-Dist: accelerate<1.0.0,>=0.34.0; extra == 'gpu'
+Requires-Dist: datasets<4.0.0,>=2.20.0; extra == 'gpu'
+Requires-Dist: torch>=2.2.0; extra == 'gpu'
+Requires-Dist: transformers<5.0.0,>=4.44.0; extra == 'gpu'
+Provides-Extra: operator
+Requires-Dist: fastapi<0.116.0,>=0.115.0; extra == 'operator'
+Requires-Dist: prometheus-client<1.0.0,>=0.20.0; extra == 'operator'
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0; extra == 'operator'
+Provides-Extra: stratum
+Requires-Dist: fastapi<0.116.0,>=0.115.0; extra == 'stratum'
+Requires-Dist: prometheus-client<1.0.0,>=0.20.0; extra == 'stratum'
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0; extra == 'stratum'
+Provides-Extra: wallet-qt
+Requires-Dist: pypng>=0.20220715.0; extra == 'wallet-qt'
+Requires-Dist: segno<2.0.0,>=1.6.1; extra == 'wallet-qt'
+Description-Content-Type: text/markdown
+
+# Animica Python toolbox
+
+This directory packages the Python utilities that live under `animica/`,
+including data-availability helpers, mempool policy tests, and the
+stratum pool prototype. Installing it as a Python package allows tools
+and tests elsewhere in the repo to import `animica` modules directly.
+
+## Installation
+
+From the repository root you can install the package in editable mode:
+
+```bash
+python -m pip install -e "python[operator,dev]"
+```
+
+### Optional extras
+
+- Base package: now includes the backend runtime dependencies required by
+  `rpc.server`, the ENA node, and the Stratum pool (`fastapi`,
+  `uvicorn[standard]`, `prometheus-client`).
+- `backend`, `ena`, `stratum`, `operator`: compatibility aliases kept for
+  operator/install scripts and older docs. They resolve to the same runtime
+  dependency set as the base package.
+- `dev`: pytest, mypy, ruff, respx, and other local development tools.
+
+Example with extras:
+
+```bash
+python -m pip install -e "python[stratum,dev]"
+```
+
+### Stratum pool runtime
+
+Preferred operator path:
+
+```bash
+animica stratum up --daemon --profile asic_sha256 --rpc-url http://127.0.0.1:8545/rpc
+animica stratum status
+animica stratum down
+```
+
+Lower-level entrypoint:
+
+```bash
+python -m animica.stratum_pool --profile asic_sha256
+```
+
+### Validation helpers
+
+The repo now ships executable smoke helpers for the repaired setup/runtime path:
+
+```bash
+./scripts/smoke_backend_imports.sh
+./scripts/smoke_ena.sh
+./scripts/smoke_stratum.sh
+./scripts/smoke_setup_install.sh
+```

animica-0.1.0/README.md

@@ -0,0 +1,57 @@
+# Animica Python toolbox
+
+This directory packages the Python utilities that live under `animica/`,
+including data-availability helpers, mempool policy tests, and the
+stratum pool prototype. Installing it as a Python package allows tools
+and tests elsewhere in the repo to import `animica` modules directly.
+
+## Installation
+
+From the repository root you can install the package in editable mode:
+
+```bash
+python -m pip install -e "python[operator,dev]"
+```
+
+### Optional extras
+
+- Base package: now includes the backend runtime dependencies required by
+  `rpc.server`, the ENA node, and the Stratum pool (`fastapi`,
+  `uvicorn[standard]`, `prometheus-client`).
+- `backend`, `ena`, `stratum`, `operator`: compatibility aliases kept for
+  operator/install scripts and older docs. They resolve to the same runtime
+  dependency set as the base package.
+- `dev`: pytest, mypy, ruff, respx, and other local development tools.
+
+Example with extras:
+
+```bash
+python -m pip install -e "python[stratum,dev]"
+```
+
+### Stratum pool runtime
+
+Preferred operator path:
+
+```bash
+animica stratum up --daemon --profile asic_sha256 --rpc-url http://127.0.0.1:8545/rpc
+animica stratum status
+animica stratum down
+```
+
+Lower-level entrypoint:
+
+```bash
+python -m animica.stratum_pool --profile asic_sha256
+```
+
+### Validation helpers
+
+The repo now ships executable smoke helpers for the repaired setup/runtime path:
+
+```bash
+./scripts/smoke_backend_imports.sh
+./scripts/smoke_ena.sh
+./scripts/smoke_stratum.sh
+./scripts/smoke_setup_install.sh
+```

animica-0.1.0/aicf/README.md

@@ -0,0 +1,172 @@
+# AICF — AI Compute Fund
+
+**Purpose.** The AI Compute Fund (AICF) is Animica’s off-chain compute coordination layer. It:
+- matches **AI** and **Quantum** jobs to registered providers,
+- ties completed work to **on-chain proofs** (via `proofs/`),
+- prices and settles rewards under transparent **policy & SLA** rules,
+- and exposes read/write **RPC/WS** endpoints + CLIs for ops and testing.
+
+AICF is *policy-driven* and *deterministic*: identifiers, accounting epochs, and payouts are derived from chain parameters so independent nodes converge on the same state.
+
+---
+
+## Lifecycle (enqueue → assign → prove → settle)
+
+1) **Enqueue.**  
+   A contract (via `capabilities/host/compute.py`) or a tool submits a job.  
+   A deterministic `task_id = H(chainId | height | txHash | caller | payload)` is derived (see `capabilities/jobs/id.py`).  
+   The job is persisted in the **queue** with priority (fee, age, size, requester tier).
+
+2) **Assign.**  
+   The dispatcher selects eligible providers using the **registry** (stake, attestation, health, quotas) and grants a **lease** with TTL. Quotas & concurrency caps prevent overload.
+
+3) **Prove.**  
+   The provider executes the job and publishes an **attested result**. On-chain, this appears as a `QuantumProof` or `AIProof` included in a block. Off-chain adapters (`aicf/integration/proofs_bridge.py`) map proof → claim (`task_id`, nullifier, metrics).
+
+4) **Settle.**  
+   At epoch boundaries, the economics engine prices units (policy), applies **split rules** (provider/treasury/miner), and writes **payouts**. SLAs (traps ratio, QoS, latency) are evaluated; failing providers are **slashed**.
+
+**Data flow (high-level):**
+
+contracts / SDK  ──enqueue──▶  capabilities  ──►  aicf.queue  ──assign──▶ providers
+▲                                          ▲                               │
+│                                          │                               ▼
+proofs ◀──── aicf.integration.proofs_bridge ◀┘                     proofs on-chain
+│                                                                            │
+└────────── aicf.economics.settlement ◀──────────────────────────────────────┘
+
+---
+
+## Components
+
+- **Registry & Staking** (`aicf/registry/*`): provider identities, attestation checks (TEE/QPU), stake/lockups, allow/deny lists, health heartbeats.
+- **Queue & Matcher** (`aicf/queue/*`): persistent job queue (SQLite/Rocks), priorities, quotas, leases, retries/expiry.
+- **Economics & Settlement** (`aicf/economics/*`): pricing schedules, split rules, epoch rollover, payout batches.
+- **SLA & Slashing** (`aicf/sla/*`): metrics aggregation, threshold checks, penalties and jailing.
+- **Treasury** (`aicf/treasury/*`): internal balances; withdraw with delay/cooldown.
+- **Integration bridges** (`aicf/integration/*`): link proofs/results to claims; randomness for assignment shuffles; RPC/WS surfacing.
+- **RPC & CLI** (`aicf/rpc/*`, `aicf/cli/*`): operational control & inspection.
+
+---
+
+## Threat model (summary) & mitigations
+
+| Threat | Mitigation |
+|---|---|
+| **Fake results** (no real compute) | Vendor **attestation verification** (SGX/TDX, SEV-SNP, CCA) and **Quantum trap-circuit** checks; results only pay when a **proof** is finalized on-chain. |
+| **Result replay / job theft** | Deterministic `task_id` binds to chainId, height, txHash, caller, payload. **Nullifiers** prevent re-use across windows. |
+| **Sybils & griefing** | **Stake & registry** gates; **quotas** and **rate limits**; cooldowns and jailing. |
+| **QoS degradation** | **SLA evaluator** with rolling windows; slashing and score decay. |
+| **Assignment bias** | Stochastic shuffles mixed with chain randomness; region/feature filters; diversity quotas. |
+| **Double-claim / double-spend** | Proofs → **claim mapping** is 1:1 via hashes/nullifiers; settlement is deterministic per epoch. |
+| **Privacy / sensitive data** | AICF treats payloads as opaque; operators should use **redacted digests** or DA references. |
+
+---
+
+## Configuration
+
+See `aicf/config.py` and `aicf/policy/example.yaml` for:
+- **Pricing schedules** (AI/Quantum units → base reward),
+- **Splits** (provider / treasury / miner),
+- **Stake minima and lockups**,
+- **SLA thresholds** & windows,
+- **Epoch length** and Γ_fund caps.
+
+**Storage:** default is a local SQLite database; RocksDB is optional. Paths can be set via environment variables or config (exact names in `aicf/config.py`).
+
+---
+
+## Quickstart (devnet)
+
+> Prereqs: Python ≥3.11, a working Animica devnet (or run tests offline), and `pip install -e .` from the repo root.
+
+1. **Register a provider** (using sample attestation):
+```bash
+python -m aicf.cli.provider_register \
+  --provider-id provider1 \
+  --caps AI \
+  --attestation aicf/fixtures/providers.json
+
+	2.	Stake some units:
+
+python -m aicf.cli.provider_stake --provider-id provider1 --amount 1000
+
+	3.	Submit a job (AI example; or use aicf/fixtures/jobs_ai.json):
+
+python -m aicf.cli.queue_submit --ai --prompt "hello world" --max-units 100
+# or:
+python -m aicf.cli.queue_list
+
+	4.	(Dev only) Simulate completion without real compute by injecting a result:
+
+python -m aicf.cli.inject_result \
+  --task-id <printed_task_id> \
+  --result aicf/fixtures/result_example.json
+
+	5.	Settle the current epoch and inspect payouts:
+
+python -m aicf.cli.settle_epoch
+python -m aicf.cli.payouts_inspect --provider-id provider1
+
+	6.	Heartbeat (ops):
+
+python -m aicf.cli.provider_heartbeat --provider-id provider1
+
+In production, step 4 is replaced by on-chain proofs: miners include AIProof/QuantumProof in blocks; aicf/integration/proofs_bridge.py maps them to claims; settlements then credit provider balances.
+
+⸻
+
+RPC & WS (read-only in this module)
+
+AICF exposes optional endpoints (mounted in the main FastAPI app):
+	•	aicf.listProviders, aicf.getProvider
+	•	aicf.listJobs, aicf.getJob, aicf.getBalance, aicf.claimPayout
+	•	WS events: jobAssigned, jobCompleted, providerSlashed, epochSettled
+
+See aicf/rpc/methods.py and aicf/rpc/ws.py for exact schemas.
+
+⸻
+
+Metrics
+
+Prometheus counters & histograms in aicf/metrics.py:
+	•	enqueue/assign/complete counts, queue depth, lease renewals
+	•	SLA pass/fail, slashes
+	•	payout amounts per epoch and per capability
+
+⸻
+
+Testing
+
+Run the unit/integration suite:
+
+pytest -q aicf/tests
+
+Useful focused tests:
+	•	test_queue_matcher.py — eligibility, quotas, tie-breaks
+	•	test_integration_proof_to_payout.py — proof → claim → payout
+	•	test_rpc_mount.py — RPC routes work
+
+⸻
+
+Repository layout (selected)
+
+aicf/
+  registry/      # provider identities, staking, filters, penalties
+  queue/         # storage, priority, leases, dispatcher, retries
+  economics/     # pricing, split, escrow, settlement
+  sla/           # metrics & thresholds, slashing engine
+  treasury/      # internal ledgers & withdrawals
+  integration/   # bridges to proofs/capabilities/randomness
+  rpc/, cli/     # APIs & ops tools
+  fixtures/, tests/  # sample data & pytest suites
+  policy/        # example policy with sane defaults
+
+
+⸻
+
+Notes
+	•	All cryptographic identities and signatures are post-quantum by default (Dilithium3/SPHINCS+; Kyber-768 for handshakes).
+	•	Economic and SLA policies are network-specific; embed their roots in headers so nodes agree on the active policy set.
+	•	Determinism matters: ids, epochs, and settlement batches are derived from chain state so independently run nodes converge.
+

animica-0.1.0/aicf/__init__.py

@@ -0,0 +1,63 @@
+from __future__ import annotations
+
+"""
+AICF - AI Compute Fund package.
+
+This package coordinates off-chain AI/Quantum jobs with on-chain proofs,
+provider registry/staking, settlement economics, SLAs/slashing, and RPC/CLI
+surfaces. Submodules are lazily imported to keep import time minimal.
+
+Public surface (lazily loaded):
+- config, errors, metrics
+- registry, queue, economics, sla, treasury
+- integration, rpc, cli, policy
+"""
+
+
+from typing import List
+
+try:
+    # Populated by aicf/version.py (created in this repo).
+    from .version import __version__  # type: ignore
+except Exception:  # pragma: no cover - safe fallback when building incrementally
+    __version__ = "0.0.0+local"
+
+__all__: List[str] = [
+    "__version__",
+    # lazily importable subpackages/modules
+    "config",
+    "errors",
+    "metrics",
+    "registry",
+    "queue",
+    "economics",
+    "sla",
+    "treasury",
+    "credits",
+    "integration",
+    "rpc",
+    "cli",
+    "policy",
+]
+
+# --- Lazy module loader (PEP 562) -------------------------------------------------
+# This avoids ImportError while the repo is being brought up incrementally.
+import importlib
+import types
+
+_lazy_modules = set(__all__) - {"__version__"}
+
+
+def __getattr__(name: str):
+    if name in _lazy_modules:
+        return importlib.import_module(f".{name}", __name__)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__():
+    return sorted(set(globals().keys()) | _lazy_modules)
+
+
+def get_version() -> str:
+    """Return the AICF package version string."""
+    return __version__