Quorum

On your own
machine.

Python 3.10 to 3.13. If python3 -m venv fails on your machine, the uv path avoids it entirely. No API key is needed to pull verified source from Base.

Install

Python 3.10 to 3.13
$ git clone https://github.com/Yonkoo11/quorum && cd quorum

$ python3 -m venv .venv && .venv/bin/pip install -e .   # or:
$ uv venv --python 3.12 .venv && uv pip install --python .venv/bin/python -e .

Verify it yourself

60 seconds
$ .venv/bin/python -m pytest tests -q                           # 24 passed
$ .venv/bin/quorum --db fresh.db run --targets fixtures/*.sol   # confirmed 2 | recalled 1 | candidates 5
$ .venv/bin/quorum --db fresh.db run --no-memory --targets fixtures/*.sol
# confirmed 0 | recalled 0: without memory the swarm cannot corroborate, recognise or forget.
$ .venv/bin/quorum --db fresh.db import 0x7556ec748f8ffb9e2ca5809c4383e407f4affb9b847124c0d33205281e905f32
# ok digest matches the claim · ok revealed by the claim's signer · ok claim fee of 100,000 QUORUM burned

Every line was run on a fresh memory file before it was written here. No key, no wallet. The chain half of a claim can also be checked with nothing installed, on the registry page.

Environment

DEPLOYER_PRIVATE_KEY
Signing key, read at call time, never logged or written to disk.
QUORUM_RPC
Overrides the public Robinhood Chain endpoint, the default claim chain.
QUORUM_CHAIN_ID
Which chain new claims go to: 4663 (default) or 8453.
BASE_RPC
Overrides the public Base endpoint, used to read the first claim.

Publishing also needs the claim fee in QUORUM on Robinhood Chain.

What publishing costs

quorum fetch

no API key needed
# pull real verified source from Base mainnet (no API key needed)
$ .venv/bin/quorum fetch 0xCF205808Ed36593aa40a44F10c7f7C2F67d4A4d4 \
    0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43 \
    0x4200000000000000000000000000000000000006

Every command

quorum fetch <address>
Download verified contract source from Base into targets/.
quorum run
Run the swarm over targets/. Add --targets <files> to point it somewhere else.
quorum run --no-memory
The deletion test: the identical swarm with a memory that forgets on write.
quorum swarm --workers 3
Three agent processes against one memory, no message bus between them.
quorum recall
What the swarm knows before it reads any code, and how it came to know it.
quorum recall --since <iso>
What it learned after a point in time.
quorum retire <key> --reason
A human overrules a finding. No later session reports that shape again.
quorum attest
Burn the claim fee, then publish confirmed findings to Robinhood Chain.
quorum verify <tx>
Check a published claim against memory, and its fee burn against the token.
quorum reveal <key>
Disclose the pattern behind a paid claim.
quorum import <tx>
Learn a revealed pattern, only if its claim fee was burned.
quorum status
Memory tier report.

Memory is a local file. Nothing is uploaded. Only attest, verify, reveal and import touch a network.

Fixtures

The fixtures in fixtures/ are vulnerable on purpose and are not deployed anywhere.

The tests

.venv/bin/python -m pytest tests -q runs the tests. They cover the idiom signature matching across contracts, that one lens never confirms, that two lenses reach quorum, that the deletion test really confirms nothing, the claim and reveal calldata shapes, that a burn is only valid for the fee on the token, that attest burns before it claims, that the scanner modules never touch the token, that burn and claim share one chain by default, and that the first Base claim still reads after the move.

PreviousThe registry