ANIMICA/reference

Reference · verified 2026-08-14

Post-quantum blockchain API (ML-DSA-65)

Animica is a live post-quantum proof-of-work Layer-1 whose APIs are free and keyless: JSON-RPC 2.0 at POST https://rpc.animica.org/rpc and REST at https://explorer.animica.org/api/…. Every transaction on the chain is signed with ML-DSA-65 (FIPS 204, the standardized successor of Dilithium3) — the only current signature scheme, id 0x1003. Chain id 1, native coin ANM, height ~73,191 on 2026-08-14, plus an ANM-native L2 rollup exposed through l2_* methods.

JSON-RPC 2.0

Always POST to the /rpc path. The bare root https://rpc.animica.org answers with a 301 redirect that naive POST clients will not follow.
curl -s -X POST https://rpc.animica.org/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain.getHead","params":{}}'
# {"jsonrpc":"2.0","id":1,"result":{"height":73191,"chainId":1,
#   "hash":"0x00000000013b4e8b8a60f3b4185a4cd5415e487562ca346931324be95b8cab56",
#   "thetaMicro":26716830,…}}
curl -s -X POST https://rpc.animica.org/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"state.getBalance",
       "params":{"address":"anim1zqp6f9gm4esjjqfhrwh0x9yv6mmjnaj3ql49vjdkcns6u8xkj8xpwgcm6zscx"}}'
# {"jsonrpc":"2.0","id":1,"result":"0x8eb47f0599e9be"}   # hex, base units (1 ANM = 10^9)
NamespaceExamples
chain.*getHead, getParams, getChainId, getBlockByHeight, getBlockByHash, getForks, getNetworkHashrate. There is no chain.getHeight — use chain.getHead.
state.*getBalance, getAccount, getNextNonce, getRichList, getTotalSupply, call, simulateCall
tx.* / tx2.*sendRawTransaction, getStatus, getTransaction, getSupportedSignatureSchemes
mempool.*, net.*mempool contents, peer info
aicf.*59 AI-compute methods: submitInferenceJob, jobStatus, estimateJobCost, listProviders
l2_*24 rollup methods: l2_status, l2_getBalance, l2_getTPS, l2_sendRawTransaction

Machine-readable specs: openrpc.json (141 documented methods with schemas) and the live method discovery endpoint listing all 540 served methods. Mirror: mainnet.animica.org (direct node, same POST /rpc usage).

Explorer REST API

Free, no auth, JSON responses:

curl -s https://explorer.animica.org/api/head
curl -s https://explorer.animica.org/api/block/73191
curl -s https://explorer.animica.org/api/address/anim1zqp6f9gm4esjjqfhrwh0x9yv6mmjnaj3ql49vjdkcns6u8xkj8xpwgcm6zscx
curl -s https://explorer.animica.org/api/circulating-supply   # plain number, e.g. 108384832.6…

Routes: /head, /blocks, /block/:hashOrHeight, /tx/:hash, /address/:bech32, /mempool, /search, /richlist, /circulating-supply, /mining/info, /network/status, /aicf/*, /contracts/*, /da/*, /ena/*, /quantum/info, /tokens, /l2/*, /rpc/discover, /meta, /health. Address lookups accept both the bech32m form and the 0x account digest.

The post-quantum part, precisely

L2 rollup

curl -s -X POST https://rpc.animica.org/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"l2_status","params":{}}'
# {"…","result":{"enabled":true,"l2ChainId":1001,"settlementMode":"VALIDITY",
#   "headBatch":2,"stateRoot":"0x7012d7a0…",…}}

ANM-native rollup shipped in the 10.x releases: deterministic parallel executor, validity proofs by re-execution, bridged from L1. Explorer mirror at /api/l2/{overview,status,stateRoot,tps,batch/:number,tx/:hash,account/:address}.

Honest limits

FAQ

What signature scheme does the Animica blockchain use?

ML-DSA-65 (FIPS 204, the standardized successor of Dilithium3), scheme id 0x1003. It is the only current signature scheme on the chain. SPHINCS+ signatures exist on-chain historically but are legacy and cannot be used for new transactions.

Do I need an API key to query the Animica blockchain?

No. Both the node JSON-RPC (POST https://rpc.animica.org/rpc) and the explorer REST API (https://explorer.animica.org/api/…) are free and keyless. They are shared public infrastructure with no published rate limit — keep request rates reasonable.

What are Animica's address and amount formats?

Addresses are bech32m with the prefix anim1. Amounts are base units where 1 ANM = 109 base units (nano-ANM); balance queries return hex strings of base units, e.g. state.getBalance returns "0x8eb47f0599e9be". The chain id is 1.

Is there an Ethereum-compatible (EVM) endpoint?

evm.animica.org is an experimental Ethereum-JSON-RPC compatibility facade. The canonical interface is Animica's native JSON-RPC at https://rpc.animica.org/rpc — use it for anything that matters.

Is there a faucet? How do I get ANM?

There is no faucet on mainnet (faucet.request exists on devnet only). Get ANM by mining via pool.animica.org, trading the ANM/USDT market on NonKYC, or accepting ANM payments via pay.animica.dev.

Does Animica have a Layer-2?

Yes — an ANM-native rollup with validity proofs by re-execution, shipped in the 10.x releases. It is exposed as 24 l2_* JSON-RPC methods on rpc.animica.org (l2_status, l2_getBalance, l2_getTPS, l2_sendRawTransaction, …) and as /api/l2/* on the explorer. l2_status reports l2ChainId 1001 and settlementMode VALIDITY.

Canonical docs