# Empire Builder — From Dream to Empire

> The complete journey infrastructure for creators, builders, and founders. Empire Builder turns tokens and communities into Empires: ERC-4337 SmartVault treasuries with leaderboards, boosters, distributions, burns, and airdrops on Base and Arbitrum.

This is the long-form companion to /llms.txt. It concatenates the most important content so an AI agent can ingest the site in a single fetch instead of crawling every page.

## What it is

Empire Builder is Web3 infrastructure for creators and communities. An "Empire" is a community treasury — an ERC-4337 SmartVault on Base (chain 8453) or Arbitrum (chain 42161) — paired with an identity called an "Empire ID".

An Empire ID can take three shapes, all resolving to one Empire but never interchangeable with the on-chain vault address:
- Token empire: an ERC-20 base-token address (0x + 40 hex).
- Farcaster tokenless: `fid` + digits (for example `fid12345`).
- Custom tokenless slug: an alphanumeric slug.

The SmartVault address is the on-chain treasury contract (sometimes called `empireAddress` or `treasuryAddress`) and is distinct from the Empire ID. Resolve it from `GET /api/empires/[empire_id]`.

## What you can do

- Deploy a Clanker token and attach it to an Empire treasury.
- Run leaderboards that rank holders and contributors.
- Reward holders with boosters and ERC-20 token distributions.
- Execute burns (sending tokens to a burn address) and record them.
- Run airdrops across multiple chains.

Treasury payouts follow a prepare -> owner-broadcast executeBatch -> store pipeline:
1. `POST /api/distribute-prepare` (signed by the vault `owner()`).
2. The owner wallet broadcasts the vault `executeBatch` transactions and pays gas.
3. `POST /api/store-distribution` persists the payouts from mined transaction hashes.

## Core pages

- Home (https://www.empirebuilder.world/): Overview, live empire rankings, and entry point.
- Build your empire (https://www.empirebuilder.world/create): Deploy a Clanker token and wire it to an Empire treasury.
- How it works (https://www.empirebuilder.world/landing): Walkthrough of the Empire Builder journey.
- Dashboard (https://www.empirebuilder.world/dashboard): Manage your empires, treasuries, and distributions.
- Migrate (https://www.empirebuilder.world/migrate): Migrate existing tokens and treasuries into Empire Builder.

## For AI agents

The machine-readable agent skill lives at https://www.empirebuilder.world/skill/SKILL.md and documents the HTTP API, signing workflows, and on-chain contracts in detail. A machine-readable OpenAPI 3.1 description of the HTTP API is published at https://www.empirebuilder.world/openapi.json. Key facts:

- Base URL: https://www.empirebuilder.world — mainnet only. There is no testnet or sandbox.
- Authentication: send `x-api-key` where required. Writes often require an EIP-191 `signature`, `message`, and `signer`/`signerAddress`.
- Reads are mostly open GETs; some require an API key.
- `POST /api/distribute-prepare` requires the vault `owner()` — co-signers cannot use this path.
- Content negotiation: the homepage returns JSON, Markdown, or plain text based on the `Accept` header.

### Error codes

- 400 Bad parameters
- 401 API key / signature invalid
- 403 Forbidden
- 404 Not found
- 429 Rate limited
- 500 Server error — retry with backoff

## Contact

- Discord: https://discord.gg/6g8syHhvs9
- X: https://x.com/glankerempire
- Farcaster: https://farcaster.xyz/~/channel/glanker