# Foundry Base Contract Brief

> Foundry Base Contract Brief is a paid API for AI agents from minty-sprout.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

Returns a plain-English security brief for a Base blockchain contract address, explaining who controls it, what they can do, and key on-chain facts about the token.

## Facts

- Endpoint: POST https://minty-sprout.onrender.com/v1/base-contract-brief?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-base-contract-brief-9eb7c5f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HaPUbLPbWTAHcQzqvMXTg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability foundry-base-contract-brief-9eb7c5f2 -d '<json body>'
```

Example prompt: Can you give me a plain-English breakdown of who controls the Base contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — what the owner can do, whether it's upgradeable, and what I should verify?

## When to prefer this

Choose this endpoint when you need a human-readable security assessment of a specific Base network contract address, covering admin controls, upgradeability, and token powers. It combines raw on-chain facts with a plain-English interpretation, making it ideal for due diligence workflows, risk checks before interacting with a token, or explaining contract risks to non-technical users. Prefer this over generic block explorers when you need structured, agent-consumable output rather than raw blockchain data.

## Known failure modes

- Invalid or non-0x address format returns validation error
- Address is an EOA wallet, not a contract — no contract facts available
- Contract exists but has no readable ABI or is unverified — limited data returned
- Network timeout if Base RPC is slow or unavailable
- Rate limiting or payment failure for the $0.01 USDC x402 charge

## How this service works

Base contract brief: base-contract-facts plus a plain-English explanation of who controls the contract and what they can do (mint, freeze, blacklist, change fees, upgrade the code), with things to verify. Grounded only in on-chain facts; never investment advice. Input: 0x address.

## Output

A JSON object containing a 'brief' with a plain-English summary, who controls the contract, a list of things to verify, and what the controller can do (e.g. mint, pause, blacklist, upgrade). Also includes a 'facts' sub-object with proxy details (type, admin, implementation), token metadata (name, symbol, decimals, total supply), pause status, list of powers, address, control info (owner, whether owner is a contract, whether ownership is renounced), bytecode size, and on-chain observations about risks.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "maxLength": 8000,
   "description": "Base contract address, 0x + 40 hex characters"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "brief": {
   "summary": "USD Coin (USDC) on Base: an upgradeable proxy token with about 4.29 billion supply.",
   "who_controls_it": "A single externally owned account is owner; a separate account administers the proxy.",
   "things_to_verify": [
    "Who holds the owner and proxy-admin keys"
   ],
   "what_the_controller_can_do": [
    "Mint new tokens",
    "Pause all transfers",
    "Blacklist addresses",
    "Replace the contract logic"
   ]
  },
  "facts": {
   "proxy": {
    "type": "zeppelinos",
    "admin": "0x4fc7850364958d97B4d3f5A08f79db2493f8cA44",
    "implementation": "0x2Ce6311ddAE708829bc0784C967b7d77D19FD779"
   },
   "token": {
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6,
    "total_supply": 4290041494.13
   },
   "paused": false,
   "powers": [
    "blacklist",
    "burn",
    "mint",
    "ownership",
    "pause",
    "upgrade"
   ],
   "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "control": {
    "owner": "0x3ABd6f64A422225E61E435baE41db12096106df7",
    "owner_is_contract": false,
    "ownership_renounced": false
   },
   "code_size": 1852,
   "is_contract": true,
   "observations": [
    "upgradeable proxy: logic can be replaced (admin is an externally owned account)",
    "owner-side mint function present: supply can grow",
    "pause function present: transfers can be frozen"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-base-contract-brief-9eb7c5f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minty-sprout.onrender.com](https://www.zero.xyz/host/minty-sprout.onrender.com/llms.txt)