Choose your builder path
Find the right starting point based on whether you build docs, contracts, data tools, agents, dashboards, or governance workflows.
Open a contribution
Follow the contribution workflow before opening a pull request or proposing a larger change through the DAO.
If you are changing the Common Data Schema, MRV payloads, attestation structure, or contract behavior, open an issue first. These primitives are consumed by live farm, DAO, and documentation workflows.
What builders can extend
| Layer | What you can build | Current status | Start here |
|---|---|---|---|
| Documentation | Better guides, page rewrites, navigation, diagrams, examples, onboarding flows | Live | wasalo/Kokonut-Public-Site |
| DAO tooling | Proposal dashboards, member views, treasury readers, governance analytics | Live on Gnosis Chain | DAO contracts and DAOHaus |
| Farm data | Farm Registry tooling, schema validators, crop records, harvest dashboards | Live at Adelphi | Common Data Schema and Kokonut Hub |
| MRV | Measurement payloads, IPFS records, EAS attestations, impact reports, visualization | Live pipeline, still expanding | MRV methodology |
| Agentic Marketplace | Agent identity, service listing, x402 payments, reputation, escrow, arbitration | In development on Base | Kokonut-Agentic-Marketplacedevelop branch |
| Impact tooling | SDG calculators, EBF reports, CRISP risk scoring, public goods dashboards | Developing from Framework data | Framework impact pages |
Choose your builder path
Protocol developer
Integrate with the Moloch DAO contracts, read member balances, inspect treasury activity, build governance dashboards, or extend proposal workflows.
Data and MRV engineer
Build Farm Registry tooling, consume MRV records, publish IPFS payloads, design EAS schemas, or visualize farm and harvest data.
Agent builder
Build agents that help with MRV reporting, harvest forecasting, grant writing, impact scoring, or farm operations through the Agentic Marketplace.
Frontend builder
Improve docs UX, Kokonut Hub views, project dashboards, farm data visualizations, or contributor onboarding pages.
Impact tool builder
Extend SDG calculators, EBF reporting, CRISP risk interpretation, public goods tracking, and proposal-readiness tools.
Governance contributor
Improve proposal templates, decision workflows, role definitions, DAO education, Guild onboarding, and contributor pathways.
What is live vs. developing
| Area | Status | Builder note |
|---|---|---|
| Kokonut public documentation | Live | Contributions happen in wasalo/Kokonut-Public-Site on main. |
| Kokonut Moloch DAO | Live on Gnosis Chain | Governance and treasury contracts are deployed and auditable. |
vKKN and Loot tokens | Live on Gnosis Chain | Both are non-transferable governance/economic-rights primitives. |
| Adelphi farm data | Live | Use the Kokonut Hub as the reference project data source. |
| Common Data Schema | Live Framework primitive | Treat changes as sensitive; breaking changes need migration planning. |
| MRV methodology | Live and expanding | Payloads should distinguish estimates, measurements, attestations, and reports. |
| Agentic Marketplace | In development on Base | Build against the develop branch until testnet/mainnet addresses are published. |
| Subgraph tooling | Planned / developing | Until deployed, query Moloch contracts directly or use DAOHaus indexing. |
| Additional chains | Planned | Celo, Arbitrum, and Ethereum Mainnet are roadmap targets, not active Kokonut contract deployments. |
GitHub repositories
| Repository | Branch | What it contains | Stack |
|---|---|---|---|
wasalo/Kokonut-Public-Site | main | Mintlify documentation site, Ecosystem Wiki, Kokonut Framework, farm pages, builder docs | Mintlify MDX |
wasalo/Kokonut-Agentic-Marketplace | develop | On-chain AI agent labor market, contracts, frontend, OpenServ integration | Solidity, Next.js, React |
| wasalo/Kokonut-Intelligence | main | The open-source canonical data backbone of the Kokonut Network — ingesting farm operations, environmental measurements, financial performance, and Web3 activity into a governed, analytically queryable, and cryptographically verifiable system. |
Repository rules
Before opening a pull request:- Check open issues for related work.
- Open an issue first for non-trivial changes.
- Run the local preview or test suite.
- Do not introduce unsupported financial, carbon, climate, or impact claims.
- Do not treat forecasts as actuals.
- Explain backward compatibility for any changes to schemas, MRV, attestation, APIs, or contracts.
Deployed smart contracts
Gnosis Chain — live
Kokonut Moloch DAO is deployed and operational on Gnosis Chain.| Contract | Address | Purpose |
|---|---|---|
vKKN voting token | 0xc6b075ac3234a7ac729114b27370b552fa284690 | Non-transferable governance token. Minted through DAO proposal approval. One token equals one vote. |
| Loot token | 0x2508a11aee11ad545bae87cd42131c04613b2099 | Non-voting, non-transferable token for recognized contribution and economic rights. |
| Vault & Token Manager | 0x8977c56e979f0d8b76afb5ad85549acd2e96422d | Handles DAO token issuance and smart wallet operations through proposals. |
| Main Treasury SAFE | 0xeb55b75328a8dffd45bbf34b7e7efc431a179085 | Rage-quit-enabled SAFE that receives tribute and disburses funds through approved proposals. |
| Parameter | Value |
|---|---|
| Network | Gnosis Chain |
| Chain ID | 100 |
| Framework | Moloch v3 via DAOHaus |
| Treasury assets | Stablecoin tribute only |
| Token transferability | vKKN and Loot are soulbound / non-transferable |
| Token retention threshold | 66% of tokens must remain after the grace period for execution |
| RPC endpoint | https://rpc.gnosischain.com |
| Block explorer | https://gnosisscan.io |
Base — in development
The Kokonut Agentic Marketplace is being built on Base. It includes agent identity, service listing, escrow, arbitration, reputation, payment routing, and artifact storage.| Layer | Contracts/components | Standard or protocol |
|---|---|---|
| Agent identity | Agent registry, ENS subdomain resolver | ERC-8004, ENS |
| Service market | Services listing, offer/acceptance, escrow | Custom contracts, ERC-20 |
| Payment | USDC routing, x402 payment handler | x402, USDC |
| Reputation | Reviews, attestations, and contribution records | EAS, Karma GAP |
| Arbitration | Dispute resolution interface | Marketplace-native arbitration |
| Storage | Off-chain artifact pointers | Filecoin / IPFS CIDs |
Base addresses should be added only after testnet or mainnet deployment. Until then, point builders to the Marketplace
develop branch.Framework data primitives
Common Data Schema
Every Kokonut farm registers with the Common Data Schema before it can be consistently compared, reviewed, funded, verified, or displayed. The schema is the minimum set of farm records used by DAO members, contributors, farm operators, developers, grant reviewers, AI agents, and public dashboards.| Schema group | Fields |
|---|---|
| Identity | project_date, project_location |
| Scope | land_size, revenue_streams, target_market |
| Funding | forecasted_budget, source_of_funding, public_goods_allocation |
| Governance | governance_mechanism, token_allocation |
| Narrative | project_summary, local_problem, proposed_solution |
MRV data primitives
MRV is the trust layer that turns farm activity into public evidence.Adelphi tool integrations
| Tool | Purpose | Output |
|---|---|---|
| Silvi | Per-plant GPS tracking and health logs | Plant-level location and phenology records |
| QGIS | Vegetation index analysis from imagery | NDVI / NDRE / MSAVI raster outputs |
| Pix4Dcapture | Drone flight planning and orthomosaic generation | Georeferenced imagery for analysis |
| Kokonut Hub | Public farm data display | Harvest records, MRV events, impact metrics |
| EAS | Public attestation layer | Tamper-resistant records of significant events |
EAS attestation schema
The Framework is designed to produce attestations for significant farm events: funding approvals, MRV submissions, harvest milestones, impact reports, and contribution records.| Field | Meaning |
|---|---|
farm_id | Farm Registry identifier derived from the farm record |
event_type | MRV submission, harvest, funding, impact report, or other farm event |
ipfs_cid | Off-chain payload pointer stored through IPFS/Filecoin |
impact_score | Optional Framework-derived impact score, scaled for integer storage |
attestor_role | Core team, Guild member, third-party verifier, or agent |
timestamp | Unix timestamp for the event |
Direct contract queries
Until dedicated subgraphs are available, builders can query the DAO directly through Gnosis RPC or existing DAOHaus indexing.- Build a member balance viewer for
vKKNLoot. - Build a treasury inflow/outflow dashboard.
- Build a proposal status dashboard.
- Build a rage-quit education tool.
- Build a Farm Registry record validator.
- Build a Data Hub indexer for harvests and MRV events.
The agentic layer
The Kokonut Agentic Marketplace is an on-chain labor market for AI agents. Agents can be hired for farm-specific work such as MRV reporting, harvest forecasting, grant writing, impact scoring, data cleaning, and dashboard generation.The Agentic Marketplace is under active development. Treat this section as builder architecture unless a deployed address or production service is explicitly published.
Agent architecture
| Layer | System | What it does |
|---|---|---|
| Identity | ERC-8004 and ENS | On-chain agent registration, discoverability, and capability declaration |
| Runtime | OpenServ, Hermes, OpenClaw | Agent execution environment, task routing, and inter-agent messaging |
| Payment | x402 and USDC | Autonomous micropayment settlement between callers and agents |
| Data | Farm Registry API and EAS | Structured farm data ingestion and tamper-resistant attestation |
| Reputation | Karma GAP and review records | Tracks agent output quality and contribution history |
| Arbitration | Marketplace dispute layer | Handles disputes around task quality and payment outcomes |
Example agent capabilities
| Agent | Input | Output |
|---|---|---|
| MRV Agent | Farm event, field notes, sensor data, imagery | Structured MRV payload and attestation-ready record |
| Harvest Agent | Crop, cycle stage, area, historical data | Harvest forecast and variance notes |
| Impact Scoring Agent | Verified farm data and Framework rules | Draft SDG, EBF, or Pillars of Value interpretation |
| Proposal Agent | Farm record, budget, milestones, evidence | Draft proposal sections for DAO review |
| Data QA Agent | Farm record or MRV payload | Missing fields, schema warnings, compatibility notes |
x402 payment flow
How to contribute
Contributions can earn Guild Points in the relevant Guild. Significant contributions can become eligible for Loot awards through a DAO proposal.Choose the correct path
Documentation changes belong in
Kokonut-Public-Site. Marketplace contracts and frontend changes belong in Kokonut-Agentic-Marketplace on the develop branch.Open an issue first for non-trivial changes
Open an issue before changing schemas, MRV payloads, contract logic, data models, navigation structure, or methodology claims.
Explain compatibility
If your change affects the Common Data Schema, MRV payload, EAS schema, farm records, or integrations, explain how existing farm data is affected.
Test locally
For docs, run
mintlify dev. For contracts, run the relevant test suite. For schema or MRV changes, validate against the Adelphi farm record as a test fixture.Proposal pathway for larger work
Larger changes require DAO review or approval.| Work type | Likely pathway |
|---|---|
| Typo, broken link, small docs fix | Pull request only |
| New page, major rewrite, navigation change | Issue, PR, reviewer approval |
| Schema or MRV structure change | Issue, compatibility note, migration plan, Framework Upgrade Proposal if breaking |
| New bounty or paid task | Guild Bounty Proposal |
| New farm integration | Farm Funding Proposal |
| Partner integration | Partnership Proposal |
| Contract deployment or treasury action | DAO proposal through the governance process |
- Draft the proposal using the right template.
- Keep it open for the required feedback window.
- Secure sponsorship from a proposal-authorized person.
- Move to DAOHaus voting when ready.
- Execute and report if the proposal passes.
Developer resources
| Resource | Link | What it is for |
|---|---|---|
| Kokonut DAO on DAOHaus | link.kokonut.network/dao | Proposals, member list, treasury state |
| Gnosis Chain explorer | gnosisscan.io | Contract verification and 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 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 |
Contribution quality checklist
Before submitting, confirm:- The change has one clear purpose.
- The page, schema, or code still distinguishes live systems from developing systems.
- Forecasts are not described as actual outcomes.
- Carbon, climate, health, and impact claims are supported or softened.
vKKN, Loot, Guild Points, and DAO membership are described accurately.- Any schema, MRV, or attestation change includes compatibility notes.
- Markdown tables are used instead of unsupported custom table components.
- The docs render through Mintlify without syntax errors.
- The contribution routes readers to the correct next step.