liquid-agent-kit

Build agents on Liquid Protocol in 50 lines.

Composable wrapper around liquid-sdk + the public LiquidPad API + ERC-8004 reads. Read-only without a private key. Add a key to enable deploys.

npm install liquid-agent-kit

What it gives you

• draftConcept({ vibe }) — turn a free-form vibe into { name, symbol, theme, tagline } via LiquidPad's curator endpoint.
• deployToken({ name, symbol, ... }) — deploy a token via liquid-sdk. Auto-stamps your ERC-8004 agent id into deploy context for provenance.
• shipFromVibe('matcha latte ghosts') — end-to-end pipeline: vibe → concept → onchain. One call, full lifecycle.
• getProofOfBurn(tokenAddress) — pending fees + burn transfers + LIQ buybacks for any token. Sourced directly from Base, no backend needed.
• verifyToken(tokenAddress) — provenance check via LiquidPad's public verify endpoint (kind, deployer, ERC-8004 agent id).
• listAgents() — query the cross-ecosystem agent registry (ERC-8004 verified agents shipping on Liquid Protocol).

The shape is intentionally tiny so you can drop it into any TypeScript / Node.js project — agents, bots, CLIs, MCP servers, dashboards.

Quick start

import { createLiquidAgent } from "liquid-agent-kit";

const agent = createLiquidAgent({
  privateKey: process.env.AGENT_PK as `0x${string}`,
  liquidpadApiKey: process.env.LIQUIDPAD_API_KEY,
  erc8004AgentId: 50962,
});

const result = await agent.shipFromVibe("matcha latte coded by ghosts at 3am");

console.log(result.concept);       // { name: "Ghost Matcha", symbol: "GMTC", ... }
console.log(result.tokenAddress);  // 0x...
console.log(result.txHash);        // 0x...

Read-only mode

Everything except deployToken and shipFromVibe works without a wallet:

const agent = createLiquidAgent();

const proof = await agent.getProofOfBurn("0xBF0775cBCA2744549cD016DAb8D3b3403De58bBF");
console.log(proof.burns.count, "burn cycles");
console.log("pending fees:", proof.pendingFees);

const verify = await agent.verifyToken("0xBF0775cBCA2744549cD016DAb8D3b3403De58bBF");
console.log(verify.kind, verify.deployer);

API reference

createLiquidAgent(config?)

Returns a LiquidAgent instance. All config fields are optional.

| Field | Type | Default | Notes | |---|---|---|---| | privateKey | 0x{hex} | — | Required for deployToken / shipFromVibe. Read-only without it. | | rpcUrl | string | viem default | Base mainnet RPC. | | liquidpadApiKey | string | — | From @liquidpadbot on Telegram (/apikey). Required for draftConcept / shipFromVibe. | | liquidpadApi | string | https://api.liquidpad.site | API base URL. | | liquidpadSite | string | https://www.liquidpad.site | Site URL (used for verifyToken, listAgents). | | erc8004AgentId | number | — | Stamped into deploy context for provenance. |

Methods

draftConcept({ vibe, previous?, feedback? }) → Concept

Turn a vibe into a shippable concept. Returns { name, symbol, theme, tagline }.

deployToken({ name, symbol, image?, metadata?, context? }) → DeployResult

Deploy a token via liquid-sdk. ERC-8004 agent id is auto-merged into context if configured.

Returns { tokenAddress, txHash, poolId, event }.

shipFromVibe(vibe, options?) → DeployResult & { concept }

draftConcept(vibe) → deployToken(concept) in one call.

getProofOfBurn(tokenAddress, { fromBlock?, treasuryAddress? }) → ProofOfBurn

Pending fees + burn transfers + LIQ buybacks. Reads directly from Base. No API key needed.

verifyToken(tokenAddress) → VerifyResult

{ verified, kind, deployer, deployedAt, txHash, erc8004AgentId }. Calls LiquidPad's public /api/verify/<addr>.

listAgents({ verified? }) → AgentEntry[]

Cross-ecosystem agent registry. Currently returns ERC-8004 verified agents that have deployed via Liquid Protocol.

Design

• Tiny surface: 6 methods. Composable. Each one does one thing.
• Zero lock-in: drop it in, take it out, no opinions about your runtime.
• Read-only friendly: most surface works without a private key. Pull data into dashboards, audits, indexers without spinning up a wallet.
• Attribution-aware: ERC-8004 agent id stamps into deploy context automatically — your token's provenance is queryable onchain forever.

Built on

• liquid-sdk by @m00npapi — the actual onchain primitive.
• viem — Base mainnet client.
• LiquidPad public API — concept curator, verify, agent registry.

See also

• LiquidPad ecosystem dashboard — live attribution metrics.
• liquidpad-mcp — MCP server for AI assistants (Claude, Cursor, Kiro).
• aeon framework — autonomous agent runtime that LiquidPad runs on.

License

MIT. See LICENSE.