Skip to main content

Reputation

AntSeed derives core on-chain seller stats directly from AntseedChannels. Completed channels, ghost channels, and settled volume live in the Channels contract itself. An optional AntseedStats contract can additionally ingest buyer-signed metadata during settlement to aggregate token and request counters.

On-Chain Stats

Each seller's ERC-8004 agentId maintains the following core counters in AntseedChannels:

CounterUpdated DuringDescription
channelCountclose()Number of completed channels
ghostCountwithdraw() when nothing was settledTimed-out channels with no proven spend
totalVolumeUsdcsettle() / close()Cumulative USDC volume settled
lastSettledAtsettle() / close()Timestamp of most recent settlement

If the optional AntseedStats contract is configured, it can also track:

CounterUpdated DuringDescription
totalInputTokenssettle() / topUp() settle pathBuyer-signed cumulative input tokens, delta-accounted per channel
totalOutputTokenssettle() / topUp() settle pathBuyer-signed cumulative output tokens, delta-accounted per channel
totalRequestCountsettle() / topUp() settle pathBuyer-signed cumulative request count, delta-accounted per channel

No counter can be incremented without a corresponding on-chain state transition and buyer-signed metadata hash.

Staking

Sellers stake USDC via AntseedStaking, binding their stake to an ERC-8004 agentId. Minimum stake: 10 USDC. An unstaked seller cannot have reserve() called on AntseedChannels.

ERC-8004 Feedback

Buyers submit structured feedback via the deployed ERC-8004 ReputationRegistry (Base: 0x8004BAa1...). Feedback signals:

SignalTypeRange
Qualityuint80-100
Latencyuint80-100
Accuracyuint80-100
Reliabilityuint80-100

Feedback produces a multiplier on the seller's emission rate:

feedbackMultiplier = 0.5 + (avgFeedbackScore / 100)
// Range: 0.5x (score=0) to 1.5x (score=100)

Feedback does not affect core stats counters. It modulates emission only.

ANTS Emission

Token emission is tied to proven delivery. Points accumulate per-interaction and convert to ANTS via a Synthetix-style reward-per-point distribution (O(1) per interaction, no epoch batching).

Seller Points

sellerPoints = V(P) * feedbackMultiplier

Where:

  • V(P) = USDC volume settled in the session
  • feedbackMultiplier = feedback-derived multiplier (0.5x to 1.5x)

Buyer Points

buyerPoints = usagePoints + feedbackPoints + diversityBonus
  • usagePoints: proportional to USDC spent in qualified sessions
  • feedbackPoints: awarded for submitting feedback (incentivizes signal)
  • diversityBonus: bonus for transacting with more unique sellers

Distribution Split

RecipientShare
Seller / Provider Pool50%
Buyer20%
Protocol reserve15%
Contributors / team15%

Seller rewards are capped at 50% of the seller bucket per seller per epoch. Buyer rewards are capped at 5% of the buyer bucket per buyer per epoch. Cap overages are redirected to the Protocol Reserve.

ANTS tokens are non-transferable until network maturity. This prevents early speculation from distorting incentives.

Router Scoring

On-chain reputation feeds into the router's peer selection algorithm. The @antseed/router-core default weights:

FactorWeight
Price0.40
Latency0.30
Capacity0.20
Reputation0.10

Scoring Rules

  • Minimum reputation filter: Defaults to 0 (no reputation gate). Buyers can explicitly raise minPeerReputation to exclude lower-reputation peers before scoring.
  • On-chain precedence: When on-chain reputation data is available, it takes precedence over locally reported reputation. Runtime metrics such as latency and failure history are handled separately by router scoring.
  • Score composition: On-chain score is multi-factor. Settled USDC volume carries the largest weight through an exponent-shaped logarithmic curve, so large settled-volume differences continue to matter and many tiny channels cannot rank highly by themselves. Completed channelCount, average settled value per channel, lastSettledAt recency, and seller stake age also contribute. ghostCount applies a penalty based on the ghost-channel rate.
  • Latency: Tracked as an exponential moving average (alpha: 0.3).
  • Failure backoff: Peers with consecutive failures enter exponential backoff cooldown.