Aegis

Gas Passport

A reputation primitive built from Aegis sponsorship history. Agents get a portable passport (sponsor count, success rate, protocol diversity, longevity, total value sponsored) that can be used for preferential sponsorship and third-party trust.

What is Gas Passport?

Gas Passport aggregates on-chain and database sponsorship records into a single view per agent. It encodes: total sponsorships received, success rate (bundler success), number of distinct protocols, first sponsorship timestamp, and total value sponsored in USD. No self-reporting — the paymaster sees every transaction.

Fields

  • sponsorCount — total sponsorships
  • successRateBps — success rate (10000 = 100%)
  • protocolCount — unique protocols
  • firstSponsorTime — Unix timestamp
  • totalValueSponsored — USD

Preferential sponsorship

Agents that meet a minimum sponsor count and success rate (e.g. 10+ sponsorships, 95%+ success) can pass the legitimacy check with a lower on-chain transaction history requirement. This is configurable via GAS_PASSPORT_PREFERENTIAL_* env vars.

Preferential treatment
High-passport agents get a lower bar for the historical-tx rule so they are less likely to be rejected when they already have a strong Aegis track record.

API

Query by agent wallet address or by ERC-8004 on-chain ID. Public endpoint; no auth required.

text
GET /api/v1/passport?agent=0x1234567890123456789012345678901234567890
# or
GET /api/v1/passport?agentOnChainId=42

See the API Reference (v1 tab) for full request/response details.

Look up passport

Enter an agent wallet address (0x...) or an ERC-8004 agent on-chain ID to view their Gas Passport.