animica 0.4.0

Animica blockchain CLI and client libraries — node, wallet, miner, contracts, and useful-work jobs.

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.

Mine & earn

pip install animica

# CPU: dual-mine ANM + Monero on pool.animica.org with one command
animica miner dual-mine <anm-address> --pool-host pool.animica.org

# GPU: earn TAO by backing Animica Pool's Bittensor SN51 (Celium) miner —
# the pool splits on-chain earnings 70/30 with rig owners, paid in
# ANM/XMR/SOL/BTC/USDT. Token comes from https://pool.animica.org/workers.
animica bittensor overview                       # pool status (no token)
animica bittensor status --token anm_worker_…    # this rig: eligibility
animica bittensor enroll --token anm_worker_…    # join the GPU pool
animica bittensor up     --token anm_worker_…    # install the SN51 executor

Rigs need uptime history before they can enroll (default: 97% over 7 days, ≥16 GB VRAM) because Bittensor slashes collateral for flaky hardware — install the worker agent from the Workers page and keep it heartbeating. Full details: https://pool.animica.org/bittensor

Installation

From the repository root you can install the package in editable mode:

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:

python -m pip install -e "python[stratum,dev]"

Stratum pool runtime

Preferred operator path:

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:

python -m animica.stratum_pool --profile asic_sha256

Validation helpers

The repo now ships executable smoke helpers for the repaired setup/runtime path:

./scripts/smoke_backend_imports.sh
./scripts/smoke_ena.sh
./scripts/smoke_stratum.sh
./scripts/smoke_setup_install.sh