Skip to content

Fix CIP-82 grants documentation#609

Open
mfw78 wants to merge 17 commits into
cowprotocol:mainfrom
mfw78:fix/cip-82-grants-docs
Open

Fix CIP-82 grants documentation#609
mfw78 wants to merge 17 commits into
cowprotocol:mainfrom
mfw78:fix/cip-82-grants-docs

Conversation

@mfw78
Copy link
Copy Markdown
Contributor

@mfw78 mfw78 commented Apr 2, 2026

Summary

Builds on the work from #604 by @theChim9 with the following corrections:

  • Fixed truncated CIP-82 Snapshot proposal URL and added forum discussion link
  • Removed accidentally included LLM-generated footer from how-to-apply.md
  • Restored IPFS link for Grant Agreement (was changed to a non-public GitHub URL)
  • Added cowdao-grants GitHub org link to resource sections
  • Added CIP-63 deprecation notice for Process Guide and Grant Agreement (still reference Gnosis Chain payouts)
  • Aligned focus areas with the 4 areas defined in CIP-82 (was 5, with fabricated entries)
  • Corrected performance bonus structure per CIP-82 (quarterly pool of 1,500 xDAI/member/month, not 10k/grant)
  • Documented original 5-member committee composition and middleway.eth's March 2026 departure
  • Fixed "focusses" typo

Test plan

  • Verify all external links resolve (Snapshot, forum, IPFS, GitHub, Discord)
  • Confirm CIP-82 focus areas match the approved proposal text
  • Review committee composition against current Safe signers
  • Verify Docusaurus :::note admonition renders correctly

Supersedes #604.

Summary by CodeRabbit

Documentation

  • Updated Grants governance: renamed to "Strategic Focus Areas" and refreshed priorities toward developer onboarding, ecosystem alignment, novel CoW applications, and volume incentives.
  • Revised budget and timelines: adjusted total allocations, volume grants allocation, extended authority to Jan 31, 2027, and added quarterly fund releases.
  • Governance/process updates: updated committee composition/approval thresholds, treasury migration to Ethereum mainnet, outcome-based evaluation, required grantee feedback forms, and added Grants Hub and GitHub links.

theChim9 and others added 16 commits March 16, 2026 01:57
Update the Grants Program documentation to align with CIP-82
Update the Grants Program documentation to align with CIP-82

* Added Volume Grants
* Added Partnership Incentives to Bonus section
Update the Grants Program documentation to align with CIP-82

* Updated committee composition and treshold
* Updated Safe structure details
* Updated Grant Lifecycle section
* Added direct link to the #grants channel on Discord
Update the Grants Program documentation to align with CIP-82

* Added emphasis on outcome-based results
* Added mention of feedback form for After Approval
Update the Grants Program documentation to align with CIP-82
Update the Grants Program documentation to align with CIP-82
Update the Grants Program documentation to align with CIP-82
- Fixed truncated snapshot proposal hash (was missing 'a2bb9194')
- Added forum discussion link for CIP-82
- Fixed typo: 'focusses' → 'focuses'
Removed chatbot-style "Key Updates for 2026" section that was
accidentally left in the document by the author.
The Grant Agreement link was changed to a non-public GitHub repo URL.
Restored the original IPFS link consistent with how-to-apply.md.
Added link to https://github.com/cowdao-grants in both
how-to-apply.md and program-structure.md resource sections.
The linked Process Guide and Grant Agreement predate CIP-82 and still
reference Gnosis Chain payouts. Added a notice directing applicants to
follow CIP-82 / Ethereum Mainnet guidance where there are discrepancies.
CIP-82 defines 4 focus areas, not 5. Removed fabricated 'Ecosystem
Growth' and 'Integrations' areas. Added 'Volume Incentive Program'
which is a CIP-82 focus area. Updated descriptions to match CIP text.
CIP-82 defines committee performance bonuses as a quarterly pool of
up to 1,500 xDAI per member per month via peer review, not 10k per
grant. Added cash-on-cash clarification for partnership incentives.
CIP-82 established a 5-member committee with 3/5 threshold to prevent
core team veto. Document middleway.eth's March 2026 departure and the
resulting 3/4 threshold adjustment for transparency.
Consistent with program-structure.md - note original 5-member design
with anti-veto rationale and current 4-member state.
@mfw78 mfw78 requested a review from a team as a code owner April 2, 2026 12:05
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 2, 2026

@mfw78 is attempting to deploy a commit to the cow Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 2, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 2, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c2b696d5-8349-4213-80ee-6d5389ecde76

📥 Commits

Reviewing files that changed from the base of the PR and between 9b3d702 and 8207ebc.

📒 Files selected for processing (1)
  • docs/governance/grants/grant-types.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/governance/grants/grant-types.md

📝 Walkthrough

Walkthrough

The PR updates CoW Grants governance docs from CIP-63 (Jan 2025) to CIP-82 (Jan 2026), revising budgets, grant types, incentive structures, committee composition/thresholds, treasury network (Gnosis → Ethereum), quarterly release mechanics, evaluation criteria, and post‑grant reporting across four grant docs.

Changes

Grants mandate, budgets, and strategic focus

Layer / File(s) Summary
Mandate, budget and high-level focus
docs/governance/grants/README.mdx, docs/governance/grants/program-structure.md
Replace CIP-63 references with CIP-82; update mandate authority to Jan 31, 2027; change stated budgets (600,000 xDAI + 1,465,260 COW → 500,000 xDAI + ~6,550,314 COW total, retaining 4,990,000 COW for volume incentives); rename “Focus Areas” → “Strategic Focus Areas” and replace previous focus list with developer/ecosystem/novel applications/volume incentives framing.

Grant types and incentives

Layer / File(s) Summary
Grant-type descriptions and incentive rules
docs/governance/grants/grant-types.md
Reformat sections (headings → bold/asterisk bullets); add a new Volume Grants section with 4,990,000 COW allocation and targeting/deployment conditions; replace “Bonus Allocations” with Bonus & Partnership Incentives and add Performance Bonuses (quarterly pool, up to 1,500 xDAI/month) and Partnership Incentives (5% success fee, capped 10,000 xDAI, cash-on-cash from external funds); remove the instruction requiring explicit grant-type declaration in application.

Application process, evaluation and post‑approval steps

Layer / File(s) Summary
Process guide links, evaluation criteria, and post-approval flow
docs/governance/grants/how-to-apply.md
Update Process Guide thread URL; add callout noting Process Guide/Grant Agreement were authored under CIP-63 and instruct following CIP-82 due to treasury migration; reword stewardship and feedback-phase guidance to emphasize alignment with protocol priorities; change evaluation criteria to outcome-based strategic alignment, measurable impact, feasibility, and technical expertise; require standardized Grantee Feedback Form on completion; change payment timing phrasing to “after technical review”; add external resources (CoW Grants Hub, CoW DAO Grants GitHub).

Committee composition, Safe mechanics, and operational rules

Layer / File(s) Summary
Committee makeup, signing thresholds, Safe network and fund flow
docs/governance/grants/program-structure.md, docs/governance/grants/README.mdx
Replace prior 5-member/4/5 committee model under CIP-63 with CIP-82-defined five-member committee and 3/5 threshold, then reflect current four-member committee with 3/4 threshold after March 2026 departure; refresh named stewards/roles (add mfw78, Chim9, Sov; remove middleway.eth); change Committee Safe references from gno: to eth:, add quarterly release mechanic (25% annually per quarter), permit returning up to 75% idle assets to CoW Treasury, and update communication channels (CoW Grants Hub, Discord channel URL, GitHub org).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A mandate hopped from six-three to eighty-two,
Budgets reshuffled, focus set anew.
Committee trimmed, the Safe lands on eth,
Volume grants and bonuses now take breath —
The rabbit cheers: clearer paths for grants and crew! 🥕

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Fix CIP-82 grants documentation' directly corresponds to the main purpose of the PR, which is correcting and aligning grants documentation to match CIP-82 standards.
Description check ✅ Passed The description provides a detailed summary of changes, organized with a clear Summary section and Test plan checklist, though it lacks explicit 'Changes' section heading matching the template structure.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
docs/governance/grants/program-structure.md (1)

50-56: Consider hyphenating "Decision Making" for grammatical correctness.

The heading "Decision Making Process" would be more grammatically correct as "Decision-Making Process" when used as a compound adjective.

📝 Suggested fix
-## Decision Making Process
+## Decision-Making Process
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/governance/grants/program-structure.md` around lines 50 - 56, Change the
heading "Decision Making Process" to the hyphenated form "Decision-Making
Process" by updating the header text (the string "Decision Making Process") in
the markdown so the compound adjective is grammatically correct.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/governance/grants/program-structure.md`:
- Around line 64-72: Replace the channel-specific Discord URL used in the
"**Discord**: The [`#grants` channel]" line with a public invite link (or a
permanent invite) so external users can access the server without needing prior
membership; update the markdown link target for the "#grants channel" anchor to
the invite URL and keep the visible text unchanged so the entry still reads
"**Discord**: The [`#grants` channel]".

---

Nitpick comments:
In `@docs/governance/grants/program-structure.md`:
- Around line 50-56: Change the heading "Decision Making Process" to the
hyphenated form "Decision-Making Process" by updating the header text (the
string "Decision Making Process") in the markdown so the compound adjective is
grammatically correct.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 32ca2f3e-89b2-4ebc-a09e-73232a1f21b5

📥 Commits

Reviewing files that changed from the base of the PR and between 207ce3b and 9b3d702.

📒 Files selected for processing (4)
  • docs/governance/grants/README.mdx
  • docs/governance/grants/grant-types.md
  • docs/governance/grants/how-to-apply.md
  • docs/governance/grants/program-structure.md

Comment on lines +64 to +72
- Grantee Feedback Forms are completed upon project conclusion to drive operational improvements
- Regular updates are shared via the [CoW Grants Hub](https://sovs.notion.site/CoW-Grants-Hub-2a8000c0d59080b18bc3f17b694939b7)

## Communication and Resources

- **Forum**: The [Grants Program Forum Section](https://forum.cow.fi/c/cow-grants-program/10) is the primary communication channel
- **Discord**: The #grants channel in the CoW Protocol Discord serves as a secondary communication channel
- **Discord**: The [#grants channel](https://discord.com/channels/869166959739170836/1232280402522275850) in the CoW Protocol Discord serves as a secondary communication channel
- **Snapshot**: All formal votes happen on the [Grants Program Snapshot Space](https://snapshot.box/#/s:cowgrants.eth)
- **GitHub**: Grant repositories are hosted on the [CoW DAO Grants](https://github.com/cowdao-grants) organization
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Check if the Discord channel URL is accessible/redirects properly

echo "Checking Discord channel URL..."
curl -sI "https://discord.com/channels/869166959739170836/1232280402522275850" | head -5

echo ""
echo "Note: Channel-specific Discord URLs typically require the user to already be a server member."
echo "Consider if this is the intended behavior or if an invite link would be more appropriate."

Repository: cowprotocol/docs

Length of output: 403


Consider using a public invite link instead of a channel-specific URL.

The Discord link uses a channel-specific format (https://discord.com/channels/869166959739170836/1232280402522275850). While this URL is valid, users who aren't already members of the CoW Protocol Discord server won't be able to access it directly and will see a "page not found" or "private" message. For documentation, a public server invite link would provide better accessibility.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/governance/grants/program-structure.md` around lines 64 - 72, Replace
the channel-specific Discord URL used in the "**Discord**: The [`#grants`
channel]" line with a public invite link (or a permanent invite) so external
users can access the server without needing prior membership; update the
markdown link target for the "#grants channel" anchor to the invite URL and keep
the visible text unchanged so the entry still reads "**Discord**: The [`#grants`
channel]".

@theChim9
Copy link
Copy Markdown

theChim9 commented Apr 3, 2026

I have read the CLA Document and I hereby sign the CLA

github-actions Bot added a commit that referenced this pull request Apr 3, 2026
@mfw78
Copy link
Copy Markdown
Contributor Author

mfw78 commented Apr 3, 2026

recheck

Copy link
Copy Markdown
Contributor

@pretf00d pretf00d left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor tweak

Comment thread docs/governance/grants/grant-types.md Outdated
- Your role requires flexibility in addressing emerging needs
**When to choose:**
* Your contribution involves ongoing work or maintenance
* The value is in consistent effort rather than specific outputs
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest re-wording to: Value is measured in consistent effort rather than specific outputs

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest re-wording to: Value is measured in consistent effort rather than specific outputs

Can you please supply a suggested edit.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did! See above. It's not the same as the original copy.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 8207ebc.

Quick note for next time — your re-wording was written as plain prose rather than in a GitHub '```suggestion' block, so I had to copy-paste it in manually instead of using the one-click "Commit suggestion" button. Wrapping the new line in a suggestion block makes adopting these tweaks a single click rather than a round-trip.

Copy link
Copy Markdown
Contributor

@pretf00d pretf00d left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

left comment in response to my comment.

Comment thread docs/governance/grants/grant-types.md Outdated
- Your role requires flexibility in addressing emerging needs
**When to choose:**
* Your contribution involves ongoing work or maintenance
* The value is in consistent effort rather than specific outputs
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did! See above. It's not the same as the original copy.

@mfw78 mfw78 requested a review from pretf00d May 12, 2026 02:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants