Updating with mainnet deployment March 8th, 2026

[mod]

Summary by CodeRabbit

• Documentation

  • Updated API reference documentation with contract changes across multiple modules.
  • Released comprehensive white paper v2.1 with clarifications on YELLOW token rights, governance, and technical architecture.
  • Updated SDK documentation to reflect latest ABI entries.

• New Features

  • AppRegistry now supports per-adjudicator slash cooldown tracking and configurable minimum slash amount controls.
  • Enhanced event signatures to include destination address in withdrawal operations.
  • Added new error types for improved slash operation validation.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 37aaafb8-a835-46bf-bf1c-6456a4441ea0

📥 Commits

Reviewing files that changed from the base of the PR and between 94e7de5 and ef472be.

📒 Files selected for processing (17)

• docs/build/api/contracts/api-reference/app-registry.md
• docs/build/api/contracts/api-reference/faucet.md
• docs/build/api/contracts/api-reference/interfaces/ilock.md
• docs/build/api/contracts/api-reference/interfaces/islash.md
• docs/build/api/contracts/api-reference/locker.md
• docs/build/api/contracts/api-reference/node-registry.md
• docs/build/api/contracts/api-reference/treasury.md
• docs/build/api/contracts/api-reference/yellow-governor.md
• docs/build/api/contracts/api-reference/yellow-token.md
• docs/build/api/contracts/faq.md
• docs/build/api/contracts/index.md
• docs/build/api/contracts/integration/events.md
• docs/build/api/contracts/sdk/_category_.json
• docs/build/api/contracts/sdk/api-reference.md
• src/pages/whitepaper.md
• vendors/yellow
• yellow_whitepaper_v2.1.md

---

📝 Walkthrough

Walkthrough

Documentation updates across contract API references reflecting contract changes from a new commit, including per-adjudicator slash cooldowns, minimum slash amount validation, updated withdrawal event signatures, and comprehensive whitepaper upgrade to v2.1 with MiCA compliance enhancements.

Changes

Cohort / File(s)	Summary
AppRegistry Contract Updates docs/build/api/contracts/api-reference/app-registry.md	Added minSlashAmount state variable, setMinSlashAmount() function, MinSlashAmountUpdated event. Changed lastSlashTimestamp from single uint256 to mapping(address => uint256) for per-adjudicator tracking. Updated economic design notes on slash cooldown and dispute fee semantics.
Slash & Lock Interface Updates docs/build/api/contracts/api-reference/interfaces/islash.md, docs/build/api/contracts/api-reference/interfaces/ilock.md	Added RecipientIsUser and SlashAmountTooLow error definitions. Extended Withdrawn event signature to include indexed destination parameter for token receiver identification.
Contract Link Updates docs/build/api/contracts/api-reference/faucet.md, docs/build/api/contracts/api-reference/locker.md, docs/build/api/contracts/api-reference/node-registry.md, docs/build/api/contracts/api-reference/treasury.md, docs/build/api/contracts/api-reference/yellow-governor.md, docs/build/api/contracts/api-reference/yellow-token.md	Updated Git source commit references across contract documentation (no functional changes).
Events & SDK Integration docs/build/api/contracts/integration/events.md, docs/build/api/contracts/sdk/api-reference.md	Documented Withdrawn event parameter updates and new MinSlashAmountUpdated event. Updated AppRegistryAbi entry count (46 → 51) and ISlashAbi entry count (4 → 6). Updated deployed addresses link reference.
Documentation Structure & Metadata docs/build/api/contracts/faq.md, docs/build/api/contracts/index.md, docs/build/api/contracts/sdk/_category_.json	Reordered FAQ sidebar position (7 → 2), added "Deployed Addresses" section with formatting fixes, removed key field from SDK category JSON.
Whitepaper v2.0 to v2.1 Upgrade src/pages/whitepaper.md	Comprehensive updates clarifying token rights (no ownership/voting), expanded governance sections, refined Layer 3 entity descriptions, enhanced MiCA compliance details, added token allocation tables, management body information, and updated technical architecture terminology (Nitrolite vs Nitro).
MiCA Regulatory White Paper yellow_whitepaper_v2.1.md	New comprehensive 1,209-line document providing MiCA-aligned disclosure for YELLOW token, including Article 6 statements, three-layer technical architecture, token economics (10B supply), governance framework, custody details, risk categories, mitigation strategies, audit references, and sustainability metrics.
Vendor Dependencies vendors/yellow	Updated yellow submodule commit reference.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• Updating the whitepaper #117: Updates to project whitepaper page with v2.0 to v2.1 transition, including regulatory compliance and governance enhancements.

Suggested reviewers

• dpatsora
• dimast-x
• philanton

Poem

🐰 New slash rules with per-adjudicator care,
Minimum amounts keep dust from the air,
White papers bloom in compliance so bright,
Layer three channels take flight in the night! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/wpfix

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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