Skip to content

docs: clarify legacy startReward references after TIP-20 rewards deprecation #741

Description

@Osraka

The old /protocol/tip20-rewards/overview route now redirects to the T7 deprecation guidance, so I do not think the removed rewards overview itself needs to be restored.

I did find two remaining references to startReward() in the evergreen protocol docs:

  • src/pages/docs/protocol/fees/spec-fee.mdx lists it as a TIP-20 fee-token inference call.
  • src/pages/docs/protocol/transactions/spec-tempo-transaction.mdx lists it in limited-key spending-limit tracking.

The current TIP-20 ABI exposes distributeReward() rather than startReward(). The T7/T8 upgrade docs say new reward opt-ins and distributions are deprecated/no-ops, while previously settled rewards remain claimable.

Before proposing a narrow documentation update, could you confirm:

  1. Should these sections be updated to omit reward calls from the current evergreen behavior, or retained as explicitly labeled pre-T7 historical behavior?
  2. If historical behavior should remain documented, is distributeReward() the intended selector to describe for the pre-T7 path?
  3. Is the T7/T8 upgrade wording the preferred source of truth to reuse?

Happy to prepare a focused docs PR once the intended framing is clear.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions