Aegis

For Protocols

Register your protocol with Aegis to sponsor gas fees for your users. No code changes required - just register, whitelist contracts, and deposit funds.

Protocols can also integrate with user-to-agent delegation so users delegate a gas budget to agents that then receive sponsored execution.

Registration

Register your protocol via the API or the registration form.

Required Fields

FieldTypeDescription
protocolIdstringUnique identifier (a-z, 0-9, -, _)
namestringDisplay name for your protocol
tierenumbronze, silver, or gold
bash
curl -X POST https://clawgas.vercel.app/api/protocol/register \
  -H "Content-Type: application/json" \
  -d '{
    "protocolId": "my-defi-app",
    "name": "My DeFi App",
    "tier": "silver",
    "whitelistedContracts": ["0x1234...5678"],
    "initialBalanceUSD": 100
  }'

Tier System

Choose a tier based on your expected sponsorship volume and feature needs.

Bronze

  • 100 sponsorships/day
  • Standard priority
  • Basic dashboard
  • Email support

Best for: Testing and small apps

POPULAR

Silver

  • 500 sponsorships/day
  • High priority queue
  • Budget alerts
  • Priority support

Best for: Growing protocols

Gold

  • Unlimited sponsorships
  • Highest priority
  • Custom rules
  • Dedicated support

Best for: High-volume protocols

Contract Whitelisting

Security First
Only whitelisted contracts can receive sponsored gas. This prevents abuse and ensures sponsorships go to legitimate protocol interactions.

Add contract addresses during registration or update them later:

bash
curl -X PATCH https://clawgas.vercel.app/api/protocol/my-defi-app \
  -H "Content-Type: application/json" \
  -d '{
    "whitelistedContracts": [
      "0x1234567890abcdef1234567890abcdef12345678",
      "0xabcdef1234567890abcdef1234567890abcdef12"
    ]
  }'
You can whitelist multiple contracts. Common use cases include main protocol contracts, router contracts, and helper contracts.

Budget Management

Cost Per Sponsorship

Each sponsored transaction costs approximately $0.50 USD. This covers gas fees and a small protocol fee.

Top Up Your Balance

Add funds to your sponsorship budget via the API or dashboard:

bash
curl -X POST https://clawgas.vercel.app/api/protocol/my-defi-app/topup \
  -H "Content-Type: application/json" \
  -d '{
    "amountUSD": 500,
    "reference": "invoice-123"
  }'
x402 Payment Protocol
For automated top-ups, integrate with the x402 payment protocol. Contact us for webhook configuration.

Webhook Integration

Receive real-time notifications when sponsorships occur or your budget runs low.

Payment Webhook

The /api/protocol/webhook endpoint receives x402 payment confirmations:

json
{
  "protocolId": "my-defi-app",
  "amountUSD": 100,
  "paymentId": "pay_abc123",
  "timestamp": "2024-01-15T12:00:00Z"
}
Signature Verification
All webhook requests include an HMAC-SHA256 signature in the x-aegis-signature header. Always verify signatures before processing.

Monitoring & Analytics

Track your protocol's sponsorship activity via the dashboard or API.

Dashboard Metrics

  • Total sponsorships
  • Cost breakdown
  • Unique users sponsored
  • Budget remaining

Activity Log

  • Transaction history
  • Decision hashes
  • On-chain verification
  • Export to CSV

API Access

bash
# Get protocol details
curl https://clawgas.vercel.app/api/protocol/my-defi-app

# Response
{
  "protocolId": "my-defi-app",
  "name": "My DeFi App",
  "tier": "silver",
  "balanceUSD": 450.00,
  "totalSpent": 50.00,
  "sponsorshipCount": 100,
  "whitelistedContracts": ["0x1234..."],
  "createdAt": "2024-01-01T00:00:00Z"
}

Next Steps

Register Your ProtocolView API ReferenceOpen Dashboard