CIP-0187? | Utilization-Scaled Pledge Bonus (#1193)
* CIP-XXXX? | Utilization-Scaled Pledge Bonus
Adds a new CIP proposing that the pledge bonus in the Reward Sharing
Scheme be multiplied by pool utilization u = min(S, S_sat) / S_sat.
The change removes the dilution regime that currently punishes
delegators for arriving at high-pledge pools (per-delegator ROA
becomes monotonically increasing in pool stake), strengthens Sybil
resistance at the formula level (splitting an MPO's pledge across N
pools reduces total bonus by ~1/N), and leaves a_0 untouched so the
existing delegator-preference deterrent continues to operate.
Folder contents:
- README.md - the CIP itself.
- CIP_UTILIZATION_SCALED_PLEDGE_BONUS.html - interactive simulator
with four guided tutorials (math explainer, stakeholder tour, MPO
tour, free exploration). Also published at
https://johnshearing.github.io/pool_ranger/CIP_UTILIZATION_SCALED_PLEDGE_BONUS.html
- utilization_scaled_pledge_bonus.md - full written derivation,
numerical anchors, and risk analysis.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* CIP-XXXX? | Address review: consolidate to single Markdown file
Per rphair's review on PR #1193:
- Fold utilization_scaled_pledge_bonus.md into README.md as
Appendix A (Detailed Derivation and Worked Examples). Drop the
sections that duplicated the body; keep the deeper problem
statement, Sybil math, worked numerical example, extended
stakeholder analysis, and expanded risks table.
- Remove CIP_UTILIZATION_SCALED_PLEDGE_BONUS.html from the CIP
folder. The simulator stays on the author's repository and is
linked once from the Rationale and once from References.
- Trim the interactive-simulator callout from the Abstract.
- Capitalize "Why" and "How" in the Motivation and Rationale
section headings.
- Fix front-matter Discussions URL (pull/? -> pull/1193).
- Define Pool Ranger with a link on first reference; bare name
thereafter.
- Add GitHub hyperlinks for CIP-0001, CIP-0050, CIP-0084,
CIP-1694 in the Comparison table and References. Link the RSS
paper to its IACR preprint.
- Expand the Notation subsection under Specification to absorb
F, m, p, and A with current mainnet values, in lieu of a
separate Glossary appendix.
- Generalize the Appendix's cooperative-bargaining discussion
to "cooperatives" as a class, with Pool Ranger cited as an
example where it grounds an abstract claim.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* CIP-XXXX? | Fix stale references to deleted supporting files
Replace the Motivation pointer to the now-deleted
utilization_scaled_pledge_bonus.md and CIP_UTILIZATION_SCALED_PLEDGE_BONUS.html
with a link to Appendix A and the live simulator. Missed in the
prior consolidation commit.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
* label original PR & add forum link
* escaping `?` CIP number to avoid YAML error & properly format header
* assign CIP number 187
* rename folder CIP-XXXX → CIP-0187
* Update CIP-0187/README.md
Co-authored-by: Robert Phair <[email protected]>
* Update CIP-0187/README.md
Co-authored-by: Robert Phair <[email protected]>
* Update CIP-0187/README.md
Co-authored-by: Robert Phair <[email protected]>
* Update CIP-0187/README.md
Co-authored-by: Robert Phair <[email protected]>
* Update CIP-0187/README.md
Co-authored-by: Robert Phair <[email protected]>
* CIP-0187 | Drop letter from Appendix heading & fix incoming links
Rename "Appendix A" to "Appendix" (only one appendix, so the letter
violates outline convention and makes anchors fragile), update the two
incoming links to the new anchor, and renumber subsections A.1-A.5 to
1-5 for consistency. Addresses reviewer feedback on PR #1193.
Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
* CIP-0187 | Use exact 'Appendix' section heading to pass validation
The validator matches the full H2 heading text against the allowed
section names, so the descriptive title made it an "Unknown section".
Rename the heading to exactly "## Appendix" and point the two incoming
links at #appendix. The descriptive phrasing already lives in the
appendix intro sentence. Addresses rphair's review on PR #1193.
Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>
Co-authored-by: Robert Phair <[email protected]>
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4&s=80)
![sg-doc-holiday[bot]](https://avatars.githubusercontent.com/in/1508860?v=4&s=80)