all AGENTS.md

A repository guide for Animica, a decentralized proof-of-work blockchain and its related software. It explains the main parts of the codebase, how to run them, and which live endpoints are available.

In plain words
What is it for?
Use it to understand where consensus, execution, networking, transactions, wallets, SDKs, mining, and other Animica components live, and to follow their setup and testing instructions.
Why use it?
It helps developers navigate a large blockchain monorepo, where many related components are stored and maintained together.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/animicaorg/all/agents-md
Clone the repo
git clone --depth 1 https://github.com/animicaorg/all

Made for: Codex, OpenCode.

Per session 2,603 This file is loaded in full into every session.
When invoked 2,603 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02603 $0.02603
Opus 5 $0.01301 $0.01301
Sonnet 5 $0.00521 $0.00521
Haiku 4.5 $0.00260 $0.00260

Measured 2d ago against content hash 22bc8d010208, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

all AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s -X POST https://rpc.animica.org/rpc -H 'content-type: application/json' \
AGENTS.md · 119 lines

How it starts

The opening of the file, as written. The whole thing — 119 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Animica — agent guide

Animica is a live, fully decentralized proof-of-work Layer-1 blockchain (chain id 1, mainnet) with post-quantum signatures (ML-DSA-65), deterministic Python-VM smart contracts, PoIES consensus (blocks are accepted when hash work plus verified useful-work evidence — AI/quantum/storage proofs — clears a difficulty threshold Θ; see spec/poies_math.md), an ANM-native Layer-2 rollup (l2/), and an off-chain AI-compute layer (AICF). This monorepo contains the node, consensus and execution engines, cryptography, wallets, SDKs (Python/TypeScript/Rust), the mining pool, explorer, and websites. The native coin is ANM; addresses are bech32m anim1…; 1 ANM = 10^9 base units.

Repo layout (the directories that matter)

Path What it is
consensus/ PoIES consensus: scoring, difficulty retarget, fork choice, nullifiers
execution/ Deterministic state machine: gas, journaled state, receipts
core/ Node boot, block/state DBs, genesis
mempool/, mempool2/ Transaction admission and propagation
rpc/ JSON-RPC server (FastAPI) — namespaces chain.*, state.*, tx.*, mempool.*, net.*, aicf.*, l2_*
p2p/ Gossip network, peer discovery, PQ handshake
mining/ Miner core; apps/miner-gui/ is the Qt GUI miner
l2/ ANM-native L2 rollup (10.x): SMT state, parallel executor, validity-by-re-execution, bridge. Docs in docs/l2/
aicf/, capabilities/ AI-compute framework: job matching, providers, settlement
contracts/, vm_py/ Python-VM contracts, compiler, gas table (vm_py/gas_table.json)
pq/, proofs/, zk/, randomness/ Post-quantum crypto, proof verifiers, ZK, randomness beacon
spec/ Canonical schemas and specs — read before changing serialization or consensus
governance/ Chain-parameter registries and upgrade process
sdk/ Python (omni_sdk), TypeScript (@animica/sdk), Rust clients
python/ The PyPI animica package (CLI + client, version 10.1.0). This is what pip install animica ships
wallet/, wallet-qt/, wallet-extension/ Flutter mobile, Qt desktop, browser-extension wallets
explorer-web/, explorer2/ Block explorer frontends/backends
animica-pool/, pool-web/ Stratum mining pool + pool site
website/ animica.org (Astro)
docs/, tests/, ops/, scripts/ Guides, integration tests, deployment, tooling

Read the full file on GitHub · 119 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 119 lines · 2,603 tokens per session scan A 22bc8d010208

Subscribe to this mod's changes

all AGENTS.md is an instructions file published in the GitHub repository animicaorg/all (4 stars, last pushed 8d ago), licensed Apache-2.0. It adds 2,603 tokens to every session, about $0.0130 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.