XChain Platform Action - COLLECT

This action collects all accrued validator rewards to the broadcasting address.

PARAMS

Name	Type	Description
`VERSION`	String	Format Version

Formats

Version `0`

VERSION

Examples

COLLECT|0
Collect all accrued validator rewards for the broadcasting address

Rules

BTC chain only
Broadcasting address must have an active stake (gated by the 6-block activation delay)
Broadcasting address must have unclaimed rewards greater than 0
Rewards are paid by debiting the reward pool address and crediting the broadcasting address — XCHAIN is never minted by COLLECT
The reward pool must hold enough XCHAIN to cover the full claim, or the COLLECT is rejected (see Reward Funding)

Reward Sources

Rewards accumulate from multiple validator activities, all stored in the indexer’s validator_rewards table:

Reward Type	Earned By	Trigger
`oracle_round`	Validator with `price` capability	Signature included in the on-chain PRICE v0 action of a finalized price round
`attest_fee`	Validator with `attestation` capability	Share of the request fee for a fulfilled ATTEST request
`anchor_<chain>`	Validator with `oracle_publish` capability	Publishing a per-chain ANCHOR v0 checkpoint
`anchor_archive`	Validator with `oracle_publish` capability	Publishing an ANCHOR v1 archive batch

Reward Population Path

Reward rows reach the indexer’s validator_rewards table on two rails:

Derived (replayable): oracle_round and attest_fee are computed by the indexer itself during block processing, as deterministic functions of on-chain actions — oracle_round splits the configured per-round reward equally across the verified, capability-qualified signer set of the PRICE v0 action (so a round that finalizes but never lands a PRICE earns nothing), and attest_fee splits a fulfilled request’s fee across its responsible set. A reindex reproduces these rows exactly.
Pushed (archived): anchor_<chain> / anchor_archive are recorded by the hub federation when an anchor publishes and pushed via the pushvalidatorrewards JSON-RPC endpoint (which rejects any non-anchor type). Because a chain parse cannot re-derive them, they ride the ANCHOR v1 archive and are restored by full-parse recovery — see ANCHOR.

COLLECT queries the indexer’s validator_rewards table directly — no hub round-trip during transaction processing.

Replayability

COLLECT validation sums unclaimed rewards earned at or before the COLLECT’s own block (validator_rewards.block_index <= BLOCK_INDEX). The scope is a no-op live (rows never carry a future block), but it makes every historical claim replay identically on a reindex or ANCHOR full-parse recovery — bulk-restored reward rows can never become visible to an earlier COLLECT than they were when it confirmed.

Reward Funding

XCHAIN is a fixed-supply token (minted once at genesis, then locked — see GAS). Rewards are therefore not minted; they are paid out of a dedicated reward pool address (config['ADDRESS']['REWARD'], BTC only). A valid COLLECT debits the pool for the reward amount and credits the broadcasting address, leaving total XCHAIN supply unchanged.

The pool is seeded at genesis and topped up manually (an ordinary XCHAIN SEND to the pool address) by the operator. Because the balance check reads the pool at the action’s block/action index, every validator computes the same accept/reject outcome.

If the pool cannot cover the full pending reward, the COLLECT is rejected with invalid: insufficient reward pool. The claim is recorded as invalid, so the reward remains unclaimed and fully collectible later — the validator simply re-broadcasts COLLECT once the pool has been replenished. No rewards are lost or partially paid.

Notes

Rewards accrue continuously while the address holds an active stake
All pending rewards are collected in a single action; partial collection is not supported
Rewards may be collected at any time while a stake is active
Rewards can also be collected after initiating UNSTAKE during the cooldown period
A single pubkey can earn from multiple capabilities in the same round — e.g. a validator with both price and oracle_publish capabilities can earn the per-round consensus reward AND the per-publish broadcast reward in the same round

Based on XChain Platform by Dankest, LLC – https://dankest.llc

Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later) with a commercial license available for proprietary use.

You may use, modify, and distribute this material under the terms of the License. See LICENSE and NOTICE for full terms. See the licensing overview.