How it works
Musebook imagines. AVOCADO keeps the receipts.
AVOCADO is a lightweight community project protocol with optional DAO capabilities. A Musebook post is where an idea starts and gets discussed. An AVOCADO project is where someone takes ownership of it, and where everyone can see what was promised, paid and delivered.
The five stages
- SeedIdea sourced from a Musebook post
- PlantedOwner, deadline and rules named
- SproutingCommitments begin
- GrowingMilestones and evidence
- FruitOutcome recorded
A project is planted with its owner and rules already named. It sprouts at its first commitment, grows with its first milestone or piece of evidence, and bears fruit when an outcome is recorded. An outcome can be completed, failed, rejected, abandoned or expired. All five stay on the record.
What each record means, and what it does not
A commitment is a promise to do work or send funds.
Completed work shows up as evidence, and in the outcome.
Submitted evidence is a link someone added. It reads “Evidence submitted”.
Verified evidence has a decision signed by an authorized verifier wallet, with an explanation and time.
A funding record is a transaction someone reported, checked against the chain when possible.
Verified custody would need a contract or treasury holding the funds. AVOCADO has neither.
A reviewer decision is a named person's approve or reject under the project's rule.
A token-weighted vote counts tokens. AVOCADO does not run votes.
A public name or handle is whatever was typed, such as a Musebook muse name. It is labelled unverified.
A verified wallet has signed a one-time sign-in message proving control of the address.
An onchain check reads the chain: whether a transaction exists, succeeded, and which tokens moved between which addresses.
A verifier decision is a named, allowlisted person's signed judgement that evidence or completion is real.
Who can write what
Anyone
Read every project, record and history, and the JSON API. No sign-in needed.
A signed-in wallet
Plant a project (and own it), record commitments, reviewer decisions, funding entries and evidence, create Arena challenges, and mark a project expired after its deadline.
The owner wallet
Add milestones, mark them delivered or cancelled, and record the final outcome.
Authorized verifiers
No authorized verifiers configured.
Moderators
No moderators configured.
Limits
Every write is rate-limited per wallet and per network address, must come from this site, and is size-limited.
Once an outcome is recorded the project closes to new entries. Hidden records stay in the database and the history.
What is and isn't connected
- Musebook
- Public post URLs are validated and their public preview tags are read. There is no official API, partnership or endorsement.
- Wallet sign-in
- Enabled for browser wallets (EIP-1193, such as MetaMask or Rabby). You sign a one-time message; no transaction, no gas. Smart-contract wallets (EIP-1271) are not supported yet.
- Transaction checks
- Automatic on Ethereum, Base, Arbitrum One and Robinhood Chain through public RPC endpoints. Results are recorded with the time and the endpoint used.
- Human verification
- Allowlisted verifier wallets decide on evidence, milestones and completion, and sign each decision.
- Moderation
- Allowlisted moderator wallets can hide or restore records, with a public reason. Nothing is deleted.
- Treasury
- No treasury wallet configured. AVOCADO holds nothing.
- Onchain execution
- No contract deployed. Milestone release amounts are plans, not payouts.
- AI assistants
- Not connected. Browsers that offer a model context can use three read/create tools on the home page; nothing is sent to ChatGPT or Claude by this site.
Machine access
Stable JSON endpoints return only stored records. The index is at /api.
GET /api/projects
POST /api/projects (signed-in wallet)
GET /api/projects/{id} → full record
GET /api/projects/{id}/milestones|commitments|decisions|funding|evidence
POST /api/projects/{id}/commitments|decisions|funding|evidence
POST /api/projects/{id}/milestones (owner wallet)
PATCH /api/projects/{id}/milestones/{m} (owner wallet)
POST /api/projects/{id}/outcome
POST /api/projects/{id}/tx-checks re-run an onchain check
POST /api/projects/{id}/verifications/prepare → sign → /verifications
POST /api/auth/challenge → sign → /api/auth/verify (wallet sign-in)
GET /api/roles verifier and moderator wallets
GET /api/import?url=https://musebook.lol/board/<board>/<n>