Skip to main content
Your on-chain reputation is a live score computed by the reputation_contract by scanning every attestation associated with your Stellar address. It is not stored in a profile or a database — it is recalculated on demand from the raw truth of what you have actually been paid for, and it is broken down by the category of work you have performed.

How Reputation Is Computed

The reputation contract follows a straightforward process each time a score is requested:
1

Fetch attestations

The contract calls get_recipient_attestations on the attestation contract, retrieving the list of all attestation IDs for your address (up to the most recent 100).
2

Score each attestation

For every attestation, the contract computes a point value based on three factors: a base score of 10 points, a payment bonus (up to 100 extra points based on the token amount paid), a recency multiplier, and a category multiplier.
3

Apply category breakdown

Points are added to both the overall total and the specific sub-bucket for the attestation’s category (Freelance, Salary, Bounty, Grant, AgentTask, or Subscription).
4

Apply the score cap

The total score is capped at 10,000 points. Individual category sub-scores are not capped.

Score Breakdown

Your reputation is split across six categories that reflect the different ways work can be structured on Aven: The category is set on the stream at creation time by the client. Each attestation inherits its category from the stream it originated from.

Recency Weighting

Not all attestations are worth the same number of points. The reputation contract applies a recency multiplier based on how recently an attestation was minted, measured in Stellar ledgers (approximately 5 seconds per ledger): Recent work scores meaningfully higher than old work. An attestation minted last week contributes 50% more to your score than an equivalent attestation from two months ago. This design rewards active, consistent contributors over workers who did a lot of work once and have been idle since. Additionally, client-confirmed attestations are worth double the points of auto-released ones. When a client actively reviews and approves your session rather than letting the deadline expire automatically, their explicit confirmation counts as a stronger signal of quality. Grant and Bounty work also receive category multipliers (130% and 120% respectively), reflecting the typically competitive or high-impact nature of those work types. Freelance work receives a 110% category multiplier.

Why It Matters

Traditional reputation systems are controlled by the platform that hosts them. Your rating on a freelance marketplace disappears if the platform closes, bans your account, or simply decides to change how scores are calculated. Aven’s reputation works differently:
  • Portable — your score is derived from on-chain attestations that exist independently of any Aven-hosted service. Any application that can query the Stellar network can read your reputation.
  • Verifiable — every point in your score traces back to a real payment transaction. There is no self-reporting, endorsement gaming, or opaque algorithm that can be manipulated without an actual on-chain record.
  • Worker-owned — your Stellar address is the key. No one can remove, alter, or transfer your attestation history. As long as the Stellar network exists, your work history exists.
This makes your Aven reputation useful beyond the Aven platform itself. DAOs can gate contributions by minimum score, protocols can offer preferential rates to high-reputation agents, and clients can verify claims without relying on references.
Build your reputation through consistency, not volume. Because recent attestations score up to 50% higher than older ones, a steady stream of recent work will outperform a single burst of activity from months ago. Aim for regular engagement across streams to keep your score in the high-weight recency window.