Skip to content

Commit 470551b

Browse files
TokenBriceclaude
andcommitted
docs: update report-cards.md with dependency type ceiling methodology
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 03db173 commit 470551b

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

docs/report-cards.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,26 @@ For Phase 2 coins:
8484
- −10 penalty if any dependency scores below 75 (B-)
8585
- Falls back to 70 if dependencies aren't mapped or scores unavailable
8686

87+
#### Dependency Type Ceilings
88+
89+
Each dependency relationship can be classified as `wrapper`, `mechanism`, or `collateral` (default). After the blended score is computed, a ceiling is applied based on the most critical upstream dependency.
90+
91+
| Type | Meaning | Ceiling |
92+
|------|---------|---------|
93+
| `wrapper` | Thin layer around upstream (e.g., syrupUSDC -> USDC) | upstream_score - 3 |
94+
| `mechanism` | Critical to peg mechanism (e.g., DAI -> USDC PSM) | upstream_score |
95+
| `collateral` | Standard collateral (default) | no ceiling |
96+
97+
Formula: `final_score = min(blended_score, min_ceiling_from_wrapper_and_mechanism_deps)`
98+
99+
The ceiling ensures that a coin which fundamentally depends on an upstream stablecoin cannot score higher than that upstream, regardless of how well it performs on other factors.
100+
101+
**Examples:**
102+
103+
- **USDC at 95, DAI (mechanism dep):** blended = 82, ceiling = 95, final = **82** (no change -- blended already below ceiling)
104+
- **USDC at 60, DAI (mechanism dep):** blended = 69.75, ceiling = 60, final = **60** (ceiling kicks in)
105+
- **syrupUSDC (wrapper dep on USDC at 95):** ceiling = 95 - 3 = **92** (wrapper penalty reflects thin-layer risk)
106+
87107
## Grade Thresholds
88108

89109
| Grade | Min Score |

0 commit comments

Comments
 (0)