Developers
Overview
Lowest fee rails for agents
Every contract is ownerless and its fees are fixed in bytecode. Agents pay a 1 bp protocol fee on the router and launchpad, routed to the StonkBroker AI Buyback Burn, which buys and burns $STONKBROKER. The suite includes a Uniswap v3 fork with fee tiers down to 0.0001%.
- Router across the AI fork and canonical Uniswap v3, multi hop, ETH in and out
- Lens with batch quotes and machine readable reason codes
- Launchpad with anti snipe tax, bond into a locked LP and referral fees
- Verified on Sourcify with an exact match
Fees
Integrator fee hook
Every user action takes an Integrator struct. A front end, bot or agent platform sets its own wallet and up to 250 bps. The fee is charged on top of the input and sent to feeTo in the same transaction, so builders earn on every order they route with no registration.
| Leg | Amount | Recipient |
|---|---|---|
| Protocol fee | 1 bp | StonkBroker AI: Buyback Burn |
| Integrator fee | 0 to 250 bps, set per call | Your feeTo wallet |
| Fork LP protocol share | 1/10 of LP fees | StonkBroker AI: Buyback Burn |
| Fork fee tiers | 0.0001% 0.0005% 0.001% 0.005% 0.01% 0.05% 0.3% 1% | Liquidity providers |
MCP
MCP server
The server runs over stdio and needs Node 22.12 or newer. With no key it is read only and returns unsigned transactions. Set AGENT_PRIVATE_KEY in the agent host environment to enable execute.
{
"mcpServers": {
"stonkbroker-ai": {
"command": "npx",
"args": ["-y", "@stonkbrokers/agent-mcp"],
"env": {
"RPC_URL": "https://rpc.mainnet.chain.robinhood.com",
"AGENT_MAX_VALUE_WEI": "100000000000000000"
}
}
}
}| Tool | What it does |
|---|---|
| suite_info | Addresses, fees and venues |
| directory | Read the onchain Directory |
| quote / quote_batch | Router and Lens quotes with reason codes |
| pool_depth / route_health | Depth and health checks before sizing |
| feed_status | Chainlink feed freshness |
| balances | ERC20 and ETH balances for any wallet |
| launch_info | Launchpad state, mcap and quotes |
| build_swap / build_approve | Unsigned transactions for the router |
| build_launch_create / buy / sell | Unsigned launchpad transactions |
| simulate | eth_call any built transaction |
| execute | Sign and send, only when AGENT_PRIVATE_KEY is set, capped by AGENT_MAX_VALUE_WEI |
Contracts
Router interface
struct Hop { uint8 venue; uint24 fee; address tokenOut; } // venue 0 = AI fork, 1 = Uniswap v3
struct Integrator { address feeTo; uint16 feeBps; bytes32 ref; } // feeBps <= 250, charged on top of input
function quoteExactIn(address tokenIn, uint256 amountIn, Hop[] hops) returns (uint256 amountOut);
function swapExactIn(
address tokenIn, uint256 amountIn, Hop[] hops,
uint256 minOut, address recipient, uint256 deadline,
bool unwrapOut, Integrator integrator
) payable returns (uint256 amountOut);Quote with viem
import { createPublicClient, http, parseEther } from "viem";
import routerAbi from "./StonkBrokerAIRouter.abi.json";
const ROUTER = "0x003B266B70Ac750e9cf23c4002CE216626E2f95a";
const WETH = "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73";
const STONK = "0xe934e36A439C94017B64a3FecE66AF12099aBF50";
const client = createPublicClient({ transport: http("https://rpc.mainnet.chain.robinhood.com") });
const hops = [{ venue: 0, fee: 10000, tokenOut: STONK }];
const amountOut = await client.readContract({
address: ROUTER, abi: routerAbi, functionName: "quoteExactIn",
args: [WETH, parseEther("0.01"), hops],
});
// Your front end earns 0.5% on top of every swap it sends:
const integrator = { feeTo: "0xYourFeeWallet", feeBps: 50, ref: "0x" + "00".repeat(32) };Lens
Reason codes
| Code | Name | Meaning |
|---|---|---|
| 0 | OK | Route quoted and healthy |
| 1 | NO_POOL | No pool for this pair and fee tier |
| 2 | BAD_ROUTE | Hops do not connect or venue is unknown |
| 3 | THIN_POOL | Quote side depth under the requested minimum |
| 4 | QUOTE_FAILED | The venue quoter reverted |
| 5 | ZERO_AMOUNT | Input amount is zero |
| 6 | FEED_STALE | Price feed older than its max age |
| 7 | FEED_INVALID | Price feed answered zero or negative |
| 8 | TOKEN_PAUSED | Token transfers are paused by its issuer |
| 9 | FEE_TOO_HIGH | Integrator fee above 250 bps |
| 10 | GAS_OVER_CEILING | Estimated gas above the requested ceiling |
Addresses
Robinhood Chain 4663
| Contract | Address | |
|---|---|---|
| StonkBroker AI: Directory | 0x5A79…16BF0x5A798EFed58DB4E732fEf50315e0393b720E16BF | |
| StonkBroker AI: Router | 0x003B…f95a0x003B266B70Ac750e9cf23c4002CE216626E2f95a | |
| StonkBroker AI: Lens | 0xAd61…35040xAd6163CB3292a69c2D81f4Fbd5D6e7aCbD533504 | |
| StonkBroker AI: Launchpad | 0xbB30…5FC00xbB303Ecb31d53e87cD99c98c63fB5e81C5e55FC0 | |
| StonkBroker AI: LP Locker | 0xA8E0…040C0xA8E00Ef659E6B727b8A1b1c58DB99B6121fD040C | |
| StonkBroker AI: Liquidity Vault | 0x1a8d…e26e0x1a8dFEAe3c1382D1F0D7195a70edF1bDF39Ce26e | |
| StonkBroker AI: Buyback Burn | 0x041D…3dC50x041Db4686Ab865747D7e70a57bd5af01350f3dC5 |
| Contract | Address | |
|---|---|---|
| StonkBroker AI: Factory | 0x22F0…E70C0x22F0917A6e8A14b127C4bE7d89aD172a3d8DE70C | |
| StonkBroker AI: Fee Controller | 0x2828…b8CD0x28287F8D04a375fdf51bb2628a6c39111504b8CD | |
| StonkBroker AI: Position Manager | 0xeAc7…10870xeAc77d5F8a06a780c811af960677665ca8561087 | |
| StonkBroker AI: Swap Router | 0x1284…0ff30x12847F5934A559AF31aC0102092899c5E1670ff3 | |
| StonkBroker AI: Quoter | 0xa7b8…a3550xa7b854B3f780D7aB40474488ad823a3Faf27a355 |
Downloads
