x-2-earn-apps

X2Earn Apps Skill

CRITICAL RULES

1. Read reference files FIRST. When the user's request involves any topic in the reference table below, read those files before doing anything else — before writing code, before making decisions. Briefly mention which files you are reading so the user can confirm the skill is active (e.g., "Reading X2Earn integration reference...").
2. Information priority for VeChain topics: (a) Reference files in this skill — always the primary source. (b) VeChain MCP tools — use @vechain/mcp-server for on-chain data, transaction building, and live network queries; use Kapa AI MCP for VeChain documentation lookups. (c) Web search — only as a last resort, and only for topics NOT covered in the reference files.
3. Prefer working directly in the main conversation for VeChain tasks. Plan mode and subagents do not inherit skill context and may fall back to web search instead of using reference files.
4. After compaction or context loss, re-read this SKILL.md to restore awareness of the reference table and operating procedure before continuing work.

Scope

Use this Skill for X2Earn app development on VeBetterDAO:

• Building sustainability-rewarding applications
• Distributing B3TR token rewards to users
• Sustainability proofs and impact tracking
• App submission, endorsement, and lifecycle
• Integration patterns (smart contract, backend, hybrid)
• VePassport and Sybil resistance considerations

Operating procedure

1. Clarify before implementing

When the user's request is ambiguous, ask before building. Key questions:

• Which integration pattern? (smart contract only, backend only, hybrid)
• Mainnet or testnet?
• Does the app already have a Creator NFT and endorsement?

2. Implement with VeChain-specific correctness

• Network: always explicit (mainnet/testnet/solo)
• Use correct contract addresses for the target network
• Always include sustainability proofs when distributing rewards
• Register reward distributors before attempting distribution

3. Verify and deliver

A task is not complete until all applicable gates pass:

1. Code compiles — no build errors
2. Tests pass — existing tests still pass; new logic has test coverage
3. Reward distribution tested — verified on testnet with correct proofs

Reference files

Read the matching files BEFORE doing anything else. See Critical Rules above.

Topic	File	Read when user mentions...
Getting started, integration patterns, test environment, contract addresses, reward distribution basics, fund management	getting-started.md	building X2Earn app, getting started, testnet setup, solo node, reward distributor, integration pattern, fund management
Sustainability proofs, impact tracking, proof types, reward metadata	sustainability-proofs.md	sustainability proof, impact codes, distributeRewardWithProof, proof types, impact categories, reward metadata
Security, anti-farming, bot prevention, rate limiting	security.md	security, farming, bot prevention, rate limiting, device fingerprinting, private key management, Guardian
AI image validation, photo verification, fake image detection	ai-image-validation.md	AI image validation, photo verification, fake image, doctored photo, watermark detection
App submission, Creator NFT, endorsement, APP_ID, categories	app-submission.md	submit app, Creator NFT, endorsement, APP_ID, app categories, treasury address, admin address
VePassport, personhood check, bot signaling, Sybil resistance	vepassport.md	VePassport, personhood, bot signaling, Sybil, isPerson, whitelisting, blacklisting, KYC