Key Concepts
Key concepts to understand before diving into XP Protocol
Term
XP Instance
Definition
An instance is a single xp environment that belongs to a community. All scoreboards/scores are associated with their communit's XP Instance.
Term
Scoreboard
Definition
Each wallet in an XP instance has its own scoreboard. This is where we store all scores for that particular wallet.
Term
Score Type
Definition
Each instance can keep multiple scores stored for a single user, these Score Types are stored inside a particular user's Scoreboard.
Example: A Scoreboard may have multiple Score Types to track a user's "attribution", "Social Reputation", "Collector Reputation", "Bot Level Signal"
Term
Score/Points
Definition
The units of measurement for a Score Type. A user is said to have <Points> of XP for a specific Score Type.
Example: John may have 200 XP of "Collector Reputation" in the Fly Frogs XP instance

QmXAJgtNayakBvXfhVKWDxKH2b4Uycs1XNq4oix7W8txcu.jpeg
Term
Action
Definition
An action is what moves scores in either direction. An action contains two key components within it -> {amount: <XP>, direction:<UP/Down>}
Term
Score Update
Definition
This is the process in which a score is updated in an XP instance. The score update consists of an Action that is applied to a user's Score Type on their Scoreboard.
An XP Instance at its core is an on-chain data structure that defines Actions(your point rules), and how they apply to Score Types. This data is on-chain and open allowing anyone to query and check a score of a particular wallet. This opens up the possibility for anyone to build loyalty/reputation/gating tools/protocols on top of this community-defined score system.

Last modified 1mo ago