02 / Tools
Every tool, grouped by
what you would do with it.
Filter by read or write, or search by name. Each tool returns JSON. A failure comes back as an error object with a code, so an agent can react to it instead of guessing. Write tools only exist in a session where a key is set, and even then they dry-run until you confirm.
| Tool | Mode | What it does |
|---|
Parameter tables, worked examples with real chain values, and the full error list are in docs/TOOLS.md in the repo.
Errors
When it fails,
it says why.
| INVALID_ADDRESS | Malformed 0x address parameter. |
|---|---|
| INVALID_PARAMS | Bad input, or a state precondition the contract would revert on. |
| NOT_A_LAUNCH | Address is not a Pons-launched token or curve. |
| CAP_EXCEEDED | The opening-buy cap or the daily launch cap would be exceeded. |
| CHAIN_MISMATCH | The RPC is not serving chainId 4663. Every tool checks this first, so it can appear on any call. |
| REVERTED | The contract reverted, in simulation or in a mined transaction. |
| RPC_FAILURE | Transport or node failure after retries, with the node's message preserved. |