Skip to content

lancekrogers/agent-defi

BranchesTags

Repository files navigation

agent-defi

Go Base Uniswap Hedera ERC-8004 ERC-8021

Autonomous DeFi trading agent for Base Sepolia with on-chain identity, machine-to-machine payments, and transaction attribution.

Part of the Obey Agent Economy project.

Overview

A trading agent that operates on Base Sepolia (chain ID 84532). It registers an on-chain identity via ERC-8004, pays for external services autonomously via the x402 payment protocol, executes mean reversion trades on Uniswap V3, and attributes all transactions with ERC-8021 builder codes. P&L reports and health status are published to the coordinator via Hedera Consensus Service (HCS).

The agent is designed for self-funded operation: trading logic, x402 payment handling, and P&L accounting are implemented in code, while additional live trading evidence is still being collected.

TL;DR — Autonomous trading agent on Base Sepolia: registers on-chain identity (ERC-8004), executes mean reversion trades on Uniswap V3, pays for services via x402, attributes transactions with ERC-8021 builder codes, and reports P&L to the coordinator via Hedera HCS. Includes implemented testnet economics and cost tracking.

Built with Obedience Corp

This project is part of an Obedience Corp campaign -- built and planned using camp (campaign management) and fest (festival methodology). This repository, its git history, and the planning artifacts in festivals/ are a live example of these tools in action.

Architecture

graph TD
    subgraph "Hedera Network"
        HCS_IN["HCS Task Topic<br/><i>task assignments</i>"]
        HCS_OUT["HCS Status Topic<br/><i>P&L reports, results</i>"]
    end

    subgraph "Base Sepolia (Chain ID: 84532)"
        ERC8004["ERC-8004 Registry<br/><i>agent identity</i>"]
        UNISWAP["Uniswap V3 Router<br/><i>exactInputSingle</i>"]
        ERC8021["ERC-8021 Attribution<br/><i>builder codes in calldata</i>"]
    end

    subgraph "x402 Protocol"
        X402_SERVER["Resource Server<br/><i>HTTP 402 → Invoice</i>"]
        X402_PAY["On-Chain Payment<br/><i>ETH/USDC transfer</i>"]
    end

    AGENT["DeFi Agent<br/><i>Go + JSON-RPC</i>"]

    HCS_IN -->|"1. task_assignment"| AGENT
    AGENT -->|"2. register()"| ERC8004
    AGENT -->|"3. Mean reversion signal"| UNISWAP
    ERC8021 -.->|"appended to calldata"| UNISWAP
    X402_SERVER -->|"HTTP 402 + Invoice"| AGENT
    AGENT -->|"pay + X-Payment-Proof"| X402_PAY
    AGENT -->|"4. pnl_report"| HCS_OUT
    AGENT -->|"5. task_result"| HCS_OUT
Loading

Trading Pipeline

Each trading cycle follows this sequence:

Step Component Action
1. Market Data TradeExecutor.GetMarketState() Fetch price and moving average from DEX/oracle
2. Signal MeanReversionStrategy.Evaluate() Compare price deviation against buy/sell thresholds
3. Execute TradeExecutor.Execute() ABI-encode Uniswap V3 exactInputSingle, apply ERC-8021 attribution
4. Record PnLTracker.Record() Track trade result, calculate running P&L
5. Report HCS.PublishPnLReport() Broadcast P&L to coordinator via HCS

Concurrent Goroutines

The agent runs three concurrent loops under a shared context:

  • Trading loop: Evaluates strategy and executes trades at DEFI_TRADING_INTERVAL (default: 60s)
  • P&L reporting: Publishes cumulative P&L via HCS at DEFI_PNL_REPORT_INTERVAL (default: 5min)
  • Health heartbeat: Broadcasts agent liveness at DEFI_HEALTH_INTERVAL (default: 30s)

Base Protocol Integration

ERC-8004: On-Chain Agent Identity

The agent registers a verifiable on-chain identity before trading:

  • Contract: ERC-8004 registry deployed on Base Sepolia
  • Registration: register(bytes32 agentID, bytes pubKey, bytes metadata)
  • Verification: getIdentity(bytes32 agentID) returns the full identity record
  • Purpose: Enables other agents and contracts to verify this agent's identity and provenance

x402: Machine-to-Machine Payments

The agent autonomously handles payment-gated resources:

  1. Agent requests a resource (e.g., market data API, compute service)
  2. Server responds with HTTP 402 Payment Required + PaymentEnvelope JSON body
  3. Agent parses the invoice, validates amount and expiry
  4. Agent checks gas price against safety limit (MaxGasPrice)
  5. Agent submits on-chain payment to Base Sepolia
  6. Agent retries the request with X-Payment-Proof and X-Payment-TxHash headers
  7. Server verifies payment on-chain and grants access

This enables fully autonomous resource acquisition without human intervention.

ERC-8021: Builder Attribution

Every trade transaction includes an ERC-8021 builder code:

  • Format: [original calldata] [4-byte magic marker] [20-byte builder code]
  • Adds 24 bytes to calldata
  • Transparent: All attributed transactions are identifiable on-chain
  • Purpose: Tracks which builder/agent generated the transaction for analytics and revenue sharing

Uniswap V3: Trade Execution

Trades are executed against the Uniswap V3 SwapRouter on Base Sepolia:

  • Function: exactInputSingle((address,address,uint24,address,uint256,uint256,uint160))
  • Selector: 0x414bf389
  • Fee tier: 3000 (0.3%)
  • Default pair: USDC (0x036CbD...7e) → WETH (0x4200...06)
  • Slippage: Configurable via SlippageBPS (default: 50 = 0.5%)

Mean Reversion Strategy

The trading strategy operates on a simple principle: prices tend to revert to their historical mean.

Parameter Default Description
BuyThreshold 2% Buy when price is this far below the moving average
SellThreshold 2% Sell when price is this far above the moving average
DataStalenessLimit 5min Reject market data older than this
MinLiquidity configurable Minimum DEX liquidity to trade
MaxPositionSize configurable Cap on individual trade size

Signal confidence scales linearly with deviation magnitude (0.5 at threshold, 1.0 at 2x threshold). Position size scales proportionally with confidence.

P&L Summary

The agent's economic model estimates ~$12-16 net profit per trade at the 2% mean reversion threshold with a $1000 position:

Component Amount
Revenue (2% deviation) $20.00
Uniswap fee (0.3%) -$3.00
Gas (Base L2) -$0.01
Slippage (est.) -$1-5
Net per trade ~$12-16

Base L2 gas costs are negligible (~$0.01 per exactInputSingle call), which makes the model plausible even at conservative trading thresholds. The IsSelfSustaining flag in every HCS P&L report is computed as NetPnL > 0, but additional live trade evidence is still worth collecting before treating the estimate as proven.

For full economic analysis, break-even math, and verification steps, see docs/pnl-proof.md.

Quick Start

cp .env.example .env   # fill in values below
just build
just run

Prerequisites

  • Go 1.24+
  • Hedera testnet account (portal.hedera.com)
  • Base Sepolia ETH (for gas) and USDC (for trading)
  • Base Sepolia RPC endpoint (default: https://sepolia.base.org)

Configuration

Agent Core

Variable Default Description
DEFI_AGENT_ID (required) Unique agent identifier
DEFI_TRADING_INTERVAL 60s How often to evaluate and trade
DEFI_PNL_REPORT_INTERVAL 5m How often to publish P&L reports
DEFI_HEALTH_INTERVAL 30s Heartbeat cadence

Base Chain

Variable Default Description
DEFI_BASE_RPC_URL https://sepolia.base.org Base Sepolia JSON-RPC endpoint
DEFI_WALLET_ADDRESS (required) Agent's Ethereum address
DEFI_PRIVATE_KEY (required) Hex-encoded private key for signing
DEFI_DEX_ROUTER Uniswap V3 SwapRouter address
DEFI_TOKEN_IN 0x036CbD...7e Token to sell (USDC on Base Sepolia)
DEFI_TOKEN_OUT 0x4200...06 Token to buy (WETH on Base Sepolia)

Protocol Integration

Variable Description
DEFI_ERC8004_CONTRACT ERC-8004 identity registry contract address
DEFI_BUILDER_CODE 20-byte ERC-8021 builder code (hex)
DEFI_ATTRIBUTION_ENABLED Enable ERC-8021 attribution (default: true)

Hedera Transport

Variable Description
HEDERA_ACCOUNT_ID Hedera testnet account (0.0.xxx)
HEDERA_PRIVATE_KEY Hedera private key
HCS_TASK_TOPIC Topic ID for receiving task assignments
HCS_RESULT_TOPIC Topic ID for publishing results and P&L

Project Structure

agent-defi/
├── cmd/
│   └── agent-defi/            # Entry point, dependency wiring
├── internal/
│   ├── agent/                 # Agent lifecycle, config, goroutine orchestration
│   ├── base/
│   │   ├── attribution/       # ERC-8021 builder code encoder/decoder
│   │   ├── identity/          # ERC-8004 on-chain identity registration
│   │   ├── payment/           # x402 machine-to-machine payment protocol
│   │   └── trading/           # Mean reversion strategy, trade executor, P&L tracker
│   ├── guard/                 # CRE Risk Router constraint enforcement (position clamping)
│   └── hcs/                   # HCS publish/subscribe transport (Hiero SDK)

Development

just build      # Build binary to bin/
just run        # Run the agent
just test       # Run unit tests
just lint       # golangci-lint
just fmt        # gofmt
just clean      # Remove build artifacts

CRE Risk Router Integration

The agent enforces position constraints from the CRE Risk Router via internal/guard/CREGuard:

  • For coordinator execute_trade tasks, a cre_decision payload is required and must be approved + non-expired (decision_timestamp + ttl_seconds)
  • max_position_usd is converted from 6-decimal USD into base-asset units using current market price, then applied as a hard clamp
  • max_slippage_bps is enforced per task when present
  • For autonomous/background cycles (outside coordinator tasks), the agent falls back to local strategy limits (and optional CRE_MAX_POSITION_USD env clamp)
  • All constraint decisions are logged for audit

This ensures the DeFi agent can never exceed the position size approved by the Chainlink DON consensus risk evaluation.

Base Bounty Alignment

This project targets the Base: Self-Sustaining Agent bounty.

Requirement Implementation
Cost-aware agent Trading logic, x402 handling, and P&L accounting are implemented for self-funded operation
On-chain identity ERC-8004 agent identity registered on Base Sepolia
Machine-to-machine payments x402 protocol: HTTP 402 handshake with on-chain payment proof
Transaction attribution ERC-8021 builder codes appended to all trade calldata
DeFi trading Mean reversion strategy on Uniswap V3 (USDC/WETH)
Provable P&L Trading results tracked per-trade with tx hashes; P&L reports published to Hedera HCS
Base Sepolia deployment All on-chain operations target chain ID 84532

ERC Standards Used

Standard Purpose Package
ERC-8004 Agent identity registration internal/base/identity/
ERC-8021 Builder attribution codes internal/base/attribution/
x402 Machine-to-machine payment protocol internal/base/payment/

License

MIT

About

ETHDenver 2026: Autonomous Go DeFi agent on Base. Uniswap V3 trading, ERC-8004 identity, x402 payments, ERC-8021 attribution. Part of Obey Agent Economy.

Topics

go base autonomous-agents ai-agents ethdenver hedera defi uniswap-v3 x402 agent-economy erc-8004 ethdenver-2026 festival-methodology obedience-corp

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages