Skip to content

docs(x2earn-rewards-pool): V9 - separate sustainable from bonus rewards#36

Draft
Agilulfo1820 wants to merge 1 commit into
mainfrom
feat/x2earn-rewards-pool-v9
Draft

docs(x2earn-rewards-pool): V9 - separate sustainable from bonus rewards#36
Agilulfo1820 wants to merge 1 commit into
mainfrom
feat/x2earn-rewards-pool-v9

Conversation

@Agilulfo1820

Copy link
Copy Markdown
Member

Tracks the X2EarnRewardsPool V9 contract change in vechain/vebetterdao#3398.

Changes

  • x-2-earn-apps / sustainability-proofs — new "V9 — Sustainable vs Bonus Rewards" section, NonProofRewardCategory enum table, V9-aware distribution-functions matrix, and bonus-reward JS + Solidity examples. Updated the mandatory-proof rule to reflect V9.
  • x-2-earn-apps / getting-started — Solidity reference example switched to distributeRewardWithProof (typed arrays, V9-compliant) and added a payLeaderboardPrize example using distributeNonProofReward.
  • vebetterdao / vebetterdao — interface snippet now includes NonProofRewardCategory and distributeNonProofReward; Solidity / JS / multi-clause examples switched to the V9 entrypoints; mandatory-rule note updated.
  • vebetterdao / contracts-tokens-apps — X2EarnRewardsPool function table rewritten with a V9 status column, deprecation flags on distributeReward, and an overview of the sustainable / bonus / legacy flows.

Test plan

  • Sanity-check the function signatures and NonProofRewardCategory enum order against the V9 interface
  • Confirm the bonus-reward examples compile / type-check against the V9 ABI

vechain/vebetterdao#3398

- Document distributeNonProofReward (V9) and the NonProofRewardCategory
  enum (Endorser / Leaderboard / Streak / Cashback / Referral / Other).
  This entrypoint does NOT register a passport action and emits the
  dedicated NonProofRewardDistributed event so indexers can exclude
  these payouts from personhood signals.
- Mark the proof arrays as mandatory on every distributeRewardWithProof*
  entrypoint (V9): empty arrays revert with 'X2EarnRewardsPool: proof
  is mandatory'. The pre-V9 'at least proof OR impact' relaxation no
  longer applies.
- Mark distributeReward as DEPRECATED in V9 (kept for backward
  compatibility) and add distributeRewardDeprecatedForRound to the
  distribution-function tables.
- Refresh the x-2-earn-apps Solidity example to call
  distributeRewardWithProof with typed arrays and add a
  distributeNonProofReward leaderboard-prize example.
- Refresh the vebetterdao backend / multi-clause examples to use the
  V9-compliant entrypoints.
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown

Skill Security Audit

Scanned 75 file(s) — found 14 issue(s) across 5 file(s).

🔵 LOW (14)
File Line Finding Excerpt
skills/thor/references/contributing.md 6 External URL: golangci-lint.run https://golangci-lint.run/usage/install/
skills/thor/references/contributing.md 261 External URL: golang.org https://golang.org/doc/effective_go
skills/x-2-earn-apps/references/getting-started.md 153 External URL: image.png https://image.png
skills/x-2-earn-apps/references/getting-started.md 153 External URL: twitter.com https://twitter.com/tweet/1
skills/x-2-earn-apps/references/security.md 124 External URL: docs.guardianstack.ai https://docs.guardianstack.ai/
skills/x-2-earn-apps/references/sustainability-proofs.md 43 External URL: image.png https://image.png
skills/x-2-earn-apps/references/sustainability-proofs.md 44 External URL: twitter.com https://twitter.com/tweet/1
skills/x-2-earn-apps/references/sustainability-proofs.md 60 External URL: twitter.com https://twitter.com/tweet/123
skills/x-2-earn-apps/references/sustainability-proofs.md 133 External URL: link-to-proof.com https://link-to-proof.com
skills/x-2-earn-apps/references/sustainability-proofs.md 133 External URL: link-to-image.com https://link-to-image.com/1.png
skills/x-2-earn-apps/references/sustainability-proofs.md 219 External URL: link-to-proof.com https://link-to-proof.com
skills/x-2-earn-apps/references/sustainability-proofs.md 219 External URL: link-to-image.com https://link-to-image.com/1.png
skills/x-2-earn-apps/references/sustainability-proofs.md 282 External URL: x.com https://x.com/user/status/123456
skills/x-2-earn-apps/references/vepassport.md 149 External URL: vechain-energy.github.io https://vechain-energy.github.io/vebetterdao-signal-admin/

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown

Skill Size Report

Skill SKILL.md (always loaded) Ref files (on demand) Total est. tokens Alerts
thor ~1.3K tok 13 files, ~25.3K tok ~26.6K tok
vebetterdao ~1.1K tok 6 files, ~17.1K tok ~18.1K tok
smart-contract-development ~1.1K tok 5 files, ~16.5K tok ~17.6K tok ⚠️ smart-contracts.md ~6.6K tok (consider splitting)
vechain-kit ~1.4K tok 7 files, ~15.2K tok ~16.6K tok
create-vechain-dapp ~1.8K tok 3 files, ~14.2K tok ~16.0K tok ⚠️ monorepo.md ~10.8K tok (consider splitting)
x-2-earn-apps ~1.0K tok 6 files, ~11.9K tok ~12.9K tok
vechain-core ~1.2K tok 4 files, ~8.7K tok ~9.9K tok
vechain-react-native-dev ~1.5K tok 3 files, ~6.7K tok ~8.2K tok
stargate ~736 tok 2 files, ~5.0K tok ~5.7K tok
vebetterdao-navigators ~5.7K tok 0 files, ~0 tok ~5.7K tok ⚠️ SKILL.md ~5.7K tok (always in context)
auto-voting-relayers ~5.5K tok 0 files, ~0 tok ~5.5K tok ⚠️ SKILL.md ~5.5K tok (always in context)
indexer-core ~1.2K tok 5 files, ~3.0K tok ~4.1K tok
secure-github-actions ~1.2K tok 4 files, ~2.9K tok ~4.0K tok
frontend ~1.1K tok 1 files, ~3.0K tok ~4.0K tok
translate ~1.2K tok 0 files, ~0 tok ~1.2K tok
grill-me ~418 tok 0 files, ~0 tok ~418 tok
TOTAL ~156.6K tok
Large reference files (>5.0K tok)
File Est. tokens
create-vechain-dapp/references/monorepo.md ~10.8K
smart-contract-development/references/smart-contracts.md ~6.6K

How to read this: SKILL.md is always loaded into the context window. Reference files are loaded on demand when the topic matches. Token counts are estimates (~4 chars/token). Consider splitting reference files over ~5.0K tokens.

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.

1 participant