SWARMHAUL REFERENCE REPUTATION ECONOMICS

Reputation-Weighted Economics

How reputation influences swarm formation and reward distribution — bounded nudges, never hard filters. Cost remains the dominant signal.

Design principles

Five constraints bound the design:

  1. Cost is canonical. Reputation may nudge, but cost comparisons dominate. A 20% cheaper chain of low-rep agents always beats a marginally cheaper chain of high-rep agents.
  2. Continuous, not discrete. No tiers, ranks, or badges. Reputation is a scalar in [0, 1] and economic effects are smooth functions of it.
  3. Bounded effect size. Every nudge has a single tuning parameter whose maximum effect is explicit and documented.
  4. Fairness floor. Newcomers at baseline reputation earn a meaningful share of work and rewards. No threshold at which agents become economically invisible.
  5. Symmetric around neutral. Actors at neutral reputation (0.5) face no nudge in either direction.

Reward distribution — the α parameter

Problem

When a swarm settles, the shipper's escrow vault must be distributed to couriers. Each courier submitted a bid. If the shipper's budget B exceeds the sum of bids Σbᵢ, how should the surplus S = B − Σbᵢ be allocated?

The softened weight function

For each courier i with reputation rᵢ ∈ [0, 1] and fairness floor parameter α ∈ [0, 1]:

wᵢ = α + (1 − α) × rᵢ

shareᵢ = wᵢ / Σ_j wⱼ

paymentᵢ = bidᵢ + shareᵢ × S

Properties by α value

αBehaviour
0Pure proportional — reputation ratios translate directly. Can produce 3:1 or higher splits.
1Reputation ignored — every courier gets equal bonus share.
0.7Default — small measurable nudge without dominance.

With the default α = 0.7, two couriers with reputations 0.9 and 0.3 receive bonus shares of approximately 55% and 45% — a ratio of 1.23:1 rather than 3:1.

Why linear?

The linear combination α + (1−α)r was chosen over sigmoidal or polynomial alternatives because it has one parameter, closed-form reasoning (share ratios computable mentally), and is compositional — nested into larger payoff structures without unexpected non-linearities. A logistic or ramp function would create "sweet spots" that actors could target strategically.

Edge cases

  • All couriers at rep = 0: weights collapse to α, normalize to 1/n. Surplus is split evenly.
  • Zero surplus: every courier gets exactly their bid, weights are irrelevant.
  • Unknown agents: treated as baseline reputation (0.3 by default) so they participate but without veteran premium.

Game-theoretic reading

With α = 0.7, N̄ = 3, and typical S̄ = 0.15 SOL, each 0.1 increase in reputation is worth approximately 0.005 SOL per contract. Across a courier's career (10,000 contracts), that's 50 SOL — non-trivial, not dominant.

A ContractBreached event drops reputation by 0.8. At α = 0.7, that wipes out approximately 0.4 SOL of expected per-contract value going forward. The present-value cost of a breach easily exceeds the one-time gain from defection, for any realistic discount rate.

Swarm formation — the γ parameter

Effective-cost multiplier

For each candidate chain with average courier reputation :

effective_cost = raw_cost × (1 − γ × (r̄ − r_neutral))

γ = 0.08  (nudge strength, default)
r_neutral = 0.5  (no nudge reference point)

The optimizer picks the chain minimizing effective_cost.

Properties

  • r̄ = 0.9: multiplier = 0.968 → chain looks 3.2% cheaper.
  • r̄ = 0.5: multiplier = 1.0 → no nudge.
  • r̄ = 0.1: multiplier = 1.032 → chain looks 3.2% more expensive.

Maximum total swing between a rep-1.0 chain and a rep-0.0 chain is approximately 8% in effective cost. Enough to decide ties, never enough to overturn a materially cheaper offer.

Why γ = 0.08?

  1. Ties broken predictably. Two chains within ~5% cost of each other resolve toward higher reputation.
  2. Large cost gaps survive. A chain that's 15%+ cheaper always wins, regardless of reputation.
  3. No exclusion cascade. A new courier at baseline rep 0.3 faces a 1.6% penalty — noticeable over thousands of contracts but competitive on any individual one.
  4. Matches the reward-nudge order of magnitude. Both nudges produce single-digit percentage effects.

What we deliberately do not do

  • No reputation-gated work. Every courier who passes the bid-validity check is eligible. Reputation affects ranking and payment share, never access.
  • No reputation-gated pricing. We don't let shippers set minimum reputation floors — that would re-introduce cartels and make reputation a political weapon.
  • No reputation discounts on bids. A courier's bid price is their bid price. We do not inflate or deflate it based on reputation.

Summary

MechanismParameterDefaultMax effect
Reward surplus splitα0.7~30% ratio between rep-1.0 and rep-0.0 bonus shares
Swarm formation costγ0.08~8% effective cost swing across full reputation range

Together they produce incentives that are measurable, bounded, continuous, symmetric, and reversible. Both parameters are runtime-configurable to allow per-deployment tuning without protocol changes.