Kokonut is an open-source, open-data ecosystem. The governance contracts are deployed and auditable. The Framework methodology is public. The farm data flows to an on-chain hub. Everything is intended to be built on, forked, and improved. This guide covers three builder paths:Documentation Index
Fetch the complete documentation index at: https://kokonut.network/llms.txt
Use this file to discover all available pages before exploring further.
Protocol developer
Integrate with the DAO contracts, extend the on-chain governance layer, or build tooling on top of the Moloch primitives.
Data & MRV engineer
Build on the Farm Registry schema, consume MRV data feeds, write EAS attestation schemas, or index farm state with TheGraph.
Agent builder
Deploy AI agents to the Kokonut Agentic Marketplace on Base using ERC-8004 identity, and x402 micropayments.
GitHub repositories
| Repository | Branch | What it contains | Stack |
|---|---|---|---|
| wasalo/Kokonut-Public-Site | main | This documentation site — ecosystem wiki, Framework docs, farm pages | Mintlify MDX |
| wasalo/Kokonut-Agentic-Marketplace | develop | Onchain AI agent labor market — 12 smart contracts, Next.js frontend, OpenServ integration | Solidity / Next.js / React |
Repository conventions
All repositories accept external contributions via pull requests. Before opening a PR:- Check open issues for existing work on your intended change.
- For anything beyond a typo fix, open an issue first to align on the approach.
- Run the local preview and confirm your change renders correctly.
- PRs to
kokonut-frameworkthat touch the Common Data Schema or MRV spec require a note explaining backward compatibility impact — the schema is consumed by farms already in operation.
Deployed smart contracts
Gnosis Chain — Live
The Kokonut Moloch DAO is deployed and operational on Gnosis Chain (Chain ID:100). All contracts are verified on Gnosisscan.
- Governance tokens
- DAO infrastructure
- Key parameters
| Contract | Address | Purpose |
|---|---|---|
| $vKKN — Voting Token | 0xc6b075...284690 | Non-transferable soulbound governance token. Minted via DAO proposal on tribute. 1 token = 1 vote. |
| Loot Token | 0x2508a1...b2099 | Non-voting, non-transferable. Awarded for Proof-of-Work contributions. Carries economic rights without governance rights. |
Base — In development
The Kokonut Agentic Marketplace is actively being built on Base (Ethereum L2, Chain ID:
8453). The 12 contracts cover agent identity, services registry, escrow, arbitration, reputation, and payment routing. Addresses will be published here on the testnet and mainnet deployments. Track progress on the develop branch.| Layer | Contracts | Standard / Protocol |
|---|---|---|
| Agent identity | Agent registry, ENS subdomain resolver | ERC-8004, ENS |
| Services market | Services listing, offer/acceptance, escrow | Custom + ERC-20 |
| Payment | USDC routing, x402 micropayment handler | x402 (HTTP 402), USDC |
| Reputation | Review system, on-chain attestations | EAS, Karma GAP |
| Arbitration | Dispute resolution interface | Marketplace Native |
| Storage | Off-chain artifact pointers | Filecoin / IPFS CIDs |
Additional chains — Planned
The Kokonut ecosystem roadmap includes deployments on Celo (for mobile-first community access), Arbitrum (for high-frequency agent operations), and Ethereum Mainnet (for TradFi bridge and RWA primitives). No contracts are deployed on these networks at the time of this writing.Framework data primitives
Farm Registry — Common Data Schema
Every farm operating under the Kokonut Framework registers against a Common Data Schema. This is the minimum viable data architecture — 13 fields that every farm must populate before receiving DAO funding or appearing in the data hub. The schema below is the canonical TypeScript interface derived from the Framework spec:MRV data structure
Farms report against a three-tier monitoring stack. The structure below represents a complete MRV payload for a single measurement event:| Tool | Purpose | Data output |
|---|---|---|
| Silvi | Per-plant GPS tracking and health logs | Plant-level location + phenology records |
| QGIS | Vegetation index calculation from drone imagery | Raster analysis → NDVI/NDRE grids |
| Pix4Dcapture | Drone flight planning + orthomosaic generation | Georeferenced imagery for QGIS pipeline |
EAS attestation schema
The Framework is EAS-compatible from day one. Every significant farm event — funding approval, MRV submission, harvest milestone, impact report — is designed to produce an on-chain attestation. The base attestation schema for a farm event:TheGraph subgraph
A subgraph for querying Kokonut DAO state (proposals, member balances, treasury inflows/outflows) is planned for Gnosis Chain. Until it’s deployed, query the Moloch contracts directly via the Gnosis RPC or use the DAOHaus subgraph, which indexes Moloch v3 DAOs. Useful direct queries (Gnosis Chain):The agentic layer
The Kokonut Agentic Marketplace is under active development on Base. This section describes the architecture as designed. Check the develop branch for the current contract state and the latest frontend.
Agent identity — ERC-8004
Every agent on the Marketplace has an on-chain identity anchored to ERC-8004 — a standard for AI agent registration on EVM chains. Agents get:- A unique
agent_idregistered on Ethereum - An ENS subdomain under the Kokonut hierarchy (e.g.
harvest-agent.kokonut.eth) - A reputation score derived from completed tasks, EAS attestations, and Karma GAP records
- A Filecoin-backed capability manifest (what the agent can do, its input/output schemas). To register an agent:
Payment routing — x402 protocol
The Marketplace uses the x402 protocol for agent-to-agent and client-to-agent payments. x402 is an HTTP-layer micropayment standard: an agent returns a402 Payment Required response with a USDC payment payload embedded in the header. The calling agent (or client) settles on Base in a single transaction, then retries the request.
This means agents can be called from standard HTTP clients — no wallet UI, no manual signing — as long as the caller has a funded Base wallet and an x402-compatible payment handler.
How to contribute
Contributing to Kokonut earns Guild Points in the relevant Guild, and significant contributions are eligible for Loot token awards via a DAO proposal.Open a pull request
Find the right repo
— Documentation changes →
— Marketplace contracts or frontend →
Kokonut-Public-Site— Marketplace contracts or frontend →
Kokonut-Agentic-Marketplace (develop branch)Open an issue first for non-trivial changes
If you’re adding a new section, changing a schema field, or modifying contract logic, open an issue before writing code. The Technology Guild reviews inbound issues weekly. This avoids duplicate work and aligns with the scope.
Follow the schema backward-compatibility rule
If your PR touches the Common Data Schema or the MRV payload structure, note in the PR description how existing farm integrations (currently Adelphi) are affected. Breaking changes require a migration plan and a separate deprecation notice.
Pick up a bounty
Bounties are issued by Guild Stewards for high-priority tasks — subgraph development, MRV tooling, agent templates, and data visualization. Completion earns both the bounty payment and Guild Points toward active member status.Propose through the DAO
Larger contributions — a new data standard, a new smart contract, a cross-chain deployment — require a DAO proposal. The process:- Draft your proposal using the Governance Framework template.
- Post to Kokonut Forum for the 5-day feedback period.
- A proposal-authorized person sponsors it to the active voting stage.
- Token holders vote for 5 days on DAOHaus.
- If passed, the execution stage begins — work proceeds under DAO authorization.
Developer resources
| Resource | URL | What it’s for |
|---|---|---|
| Kokonut DAO on DAOHaus | link.kokonut.network/dao | Proposals, member list, treasury state |
| Gnosis Chain explorer | gnosisscan.io | Contract verification, transaction history |
| Adelphi Data Hub | hub.kokonut.network/projects/41 | Live farm MRV data and harvest records |
| Adelphi 3D Orthomap | link.kokonut.network/AdelphiOrtho3D | Georeferenced 3D land model |
| Adelphi Species GeoNode | link.kokonut.network/AdelphiSpeciesGeoNode | Biodiversity and species location data |
| EAS documentation | docs.attest.sh | Ethereum Attestation Service SDK |
| x402 protocol | x402.org | HTTP 402 micropayment standard for agents |
| ERC-8004 EIP | eips.ethereum.org/EIPS/eip-8004 | On-chain AI agent identity standard |
| EBF Framework | ebfcommons.org | Ecological Benefits Framework for impact scoring |