Technical Architecture Overview

How indie.money works — agent ownership, wallets, discovery, and the execution flow

Written By pvdyck

Last updated 1 day ago

Technical Architecture Overview

indie.money combines a web frontend, a backend execution engine, and on-chain smart contracts to let Builders publish agents and Producers run them.

Smart Contracts (Base Blockchain)

Agent ownership and payments are handled on-chain via smart contracts on Base (an Ethereum Layer 2 with low fees).

ContractPurpose
ServiceNFTAgent instances — each deployed agent is an NFT
MarketplaceAgent purchasing and pricing
Platform treasuryHolds per-agent budgets and per-run escrow; settles every run and routes Builder earnings
ServicePassListing and feature passes for marketplace access

How a Run Works

  1. Producer triggers a run
  2. Authentication is verified
  3. The agent's agent is loaded
  4. Credentials are resolved (see What happens to my credentials?)
  5. The agent executes in a secure sandbox
  6. Costs are tracked in real time
  7. Results are returned
  8. Payment is settled (batched every 5 minutes)

Agent Budget

Each agent instance has its own budget — InUSD held on your behalf by the platform, indexed by the agent's NFT. When you fund an agent, the tokens move into the platform's Treasury and are earmarked for that specific agent instance. Only the NFT owner can withdraw the remaining balance, and withdrawal is blocked while any run is still in flight.

Agent Cards

Each published agent exposes a machine-readable Agent Card — a JSON endpoint that declares:

  • Skills (what the agent can do)
  • Input/output modes
  • Pricing (purchase price, execution price)

This enables agent-to-agent discovery: autonomous agents can find, evaluate, and call other agents without human intervention. Visit any agent's card at /api/v1/services/:address/agent-card.json.