YCR Rewards Token - YouthChain

YCR is the rewards token users earn by being active on the network — every Post, Like, Share, Comment, Watch, NftCreate or Tip recorded by the EngagementOracle accumulates pending YCR for the actor. Users claim it from YCRRewards whenever they want.


Address	`0x6afd8143a2d213067a31abe5adf0d458a0df532b`
Type	ERC-20 standard (transfer, approve, balanceOf) + claim hooks
Decimals	18
Mint authority	`EngagementOracle` (via `addPending`) + `setMinter`-authorized addresses
Initial supply	50M (seeded into the AMM pool)

Standard ERC-20

All standard methods work as expected:

function balanceOf(address) view returns (uint256)
function transfer(address to, uint256 amount) returns (bool)
function approve(address spender, uint256 amount) returns (bool)
function allowance(address holder, address spender) view returns (uint256)
function transferFrom(address from, address to, uint256 amount) returns (bool)
function totalSupply() view returns (uint256)
function totalBurned() view returns (uint256)

Claim flow

The interesting bit is the pending YCR mechanism. Engagement actions don’t mint YCR immediately — they accumulate into pendingByAction[user][type]. The user claims it at their convenience:

`previewClaim(address user, uint8 activeActionTypes) view returns (uint256)`

How much YCR the user would receive if they called claim right now. activeActionTypes is a bitmask: include action n by setting bit n.

`claim(uint8 activeActionTypes) returns (uint256)`

User burns their pending into a real YCR balance. Call from the user’s own wallet.

const ycr = new ethers.Contract(YCR, [
  "function previewClaim(address,uint8) view returns (uint256)",
  "function claim(uint8) returns (uint256)",
], wallet);

const allActions = 0xff; // all 7 action types active
const pending = await ycr.previewClaim(wallet.address, allActions);
console.log("about to claim:", ethers.formatEther(pending), "YCR");

const tx = await ycr.claim(allActions, { gasLimit: 300_000n, type: 0 });
const receipt = await tx.wait();

`claimFor(address user, uint8 activeActionTypes) returns (uint256)`

Same as claim but called by an authorized minter on behalf of the user. The EngagementOracle is typically the minter for batch claim flows.

Indexer convenience endpoints

Instead of calling previewClaim directly, mobile apps can use:

GET /api/mobile/rewards/:address — returns YCR balance + pending breakdown by action type
POST /api/mobile/claim — server-side claim helper (testnet convenience)

Integration tip

If you’re showing the user “today’s earnings” in the app UI, don’t trigger an on-chain claim on every page load. Instead:

Read previewClaim() to display “Your pending YCR: X”
Show a “Claim now” button
Only call claim() when the user taps the button

This keeps gas usage and chain noise low.

​Standard ERC-20

​Claim flow

​previewClaim(address user, uint8 activeActionTypes) view returns (uint256)

​claim(uint8 activeActionTypes) returns (uint256)

​claimFor(address user, uint8 activeActionTypes) returns (uint256)

​Indexer convenience endpoints

​Integration tip