Developer Docs

// The launch params tuple. tax.projectWallet receives the creator's sell fee.
function launch(
  (string name, string symbol, address dev,
   (uint16 buyBps, uint16 sellBps, uint16 walletBps,
    uint16 floorBps, uint16 burnBps, address projectWallet) tax) p
) payable returns (address token, address curve, address pool)

function tokenCount() view returns (uint256)
function allTokens(uint256 index) view returns (address)
function recordOf(address token) view returns (address token, address curve, address dev, uint256 at)

event Launched(address indexed token, address indexed curve, address indexed pool, address dev, uint256 devBought)

function buy(address token, uint256 minOut) payable returns (uint256 tokensOut)
function sell(address token, uint256 amountIn, uint256 minOutEth) returns (uint256 ethOut)

// reads
function configOf(address token) view returns (
  (address pool, address curve, address projectWallet,
   uint16 buyBps, uint16 sellBps, uint16 walletBps,
   uint16 floorBps, uint16 burnBps, bool set) )
function devEscrow(address token) view returns (uint256)   // creator's uncollected sell fees (wei)
function bondOf(address token) view returns (address)

// creator-only fee controls (projectWallet)
function withdrawDev(address token)   // collect escrowed sell fees to the wallet
function burnDev(address token)       // buy + burn with them instead

event Bought(address indexed token, address indexed buyer, uint256 ethIn, uint256 fee, uint256 tokensOut)
event Sold(address indexed token, address indexed seller, uint256 tokensIn, uint256 fee, uint256 ethOut)
event FeeSplit(address indexed token, uint256 platform, uint256 deferred, uint256 platformCut, uint256 dev, uint256 floor, uint256 burn)

function pool() view returns (address)     // the Uniswap v3 pool
function dev() view returns (address)
function bond() view returns (address)     // zero until graduated
function seeded() view returns (bool)
function graduated() view returns (bool)
function ready() view returns (bool)       // eligible to graduate right now
function seedTime() view returns (uint64)

// geometry — ticks along the curve (price rises left→right)
function startTick() view returns (int24)      // curve start (~$4k FDV)
function minGradTick() view returns (int24)    // earliest graduation (~$30k)
function gradTarget() view returns (int24)     // auto-graduate price (dev-settable)
function gradTick() view returns (int24)       // ceiling (~$76k)

function setGradTarget(int24 targetTick)   // creator only, within [min, ceiling]
function graduate()                        // permissionless once ready()

event Seeded(int24 curveLo, int24 curveHi, uint128 liquidity)
event GradTargetSet(int24 targetTick)
event Graduated(address indexed bond, uint256 raisedWeth, uint256 leftoverToken)

function poke()   // permissionless: compound Sherwood LP fees back into the floor

event Posted(uint128 sherwoodL, uint128 bountyL, uint128 ambushL)
event Poked(int24 tick, uint128 bountyL, uint128 ambushL, uint256 sherwoodFees0, uint256 sherwoodFees1)

// 1) WATCH new launches — one event on the factory
const factory = new ethers.Contract(FACTORY, [
  "event Launched(address indexed token,address indexed curve,address indexed pool,address dev,uint256 devBought)",
], provider);
factory.on("Launched", (token, curve, pool, dev) => {
  // ...decide whether to snipe it, inside the same block the dev opens
});

// 2) BUY — native ETH in, no approval
const value = ethers.parseEther("0.1");
const q = await router.buy.staticCall(token, 0n, { value });
await (await router.buy(token, q * 99n / 100n, { value })).wait();

// 3) SELL — one exact-amount approval, then sell
await (await erc20.approve(ROUTER, amountIn)).wait();
await (await router.sell(token, amountIn, minOutEth)).wait();

import { ethers } from "ethers";

const FACTORY = "0x44855d49E73Ad103Df51871A072FEe8709E6A2d6";
const abi = [
  "function launch((string name,string symbol,address dev,(uint16 buyBps,uint16 sellBps,uint16 walletBps,uint16 floorBps,uint16 burnBps,address projectWallet) tax) p) payable returns (address token,address curve,address pool)",
];
const signer = await new ethers.BrowserProvider(window.ethereum).getSigner();
const factory = new ethers.Contract(FACTORY, abi, signer);

const me = await signer.getAddress();
const params = {
  name: "Sherwood", symbol: "WOOD", dev: me,
  tax: {
    buyBps: 100,   // 1% buy  → platform (min)
    sellBps: 100,  // 1% sell → you, the creator (min)
    walletBps: 0, floorBps: 0, burnBps: 0, // split of any ABOVE-1% fee
    projectWallet: me,                 // where your sell fee lands
  },
};

// staticCall first to get addresses without spending gas, then send.
const [token] = await factory.launch.staticCall(params, { value: 0n });
const tx = await factory.launch(params, { value: ethers.parseEther("0.02") }); // opening buy
await tx.wait();
console.log("launched", token);

const ROUTER = "0xAEFE708e04D3E2e9609e6bC987903b31818C2a46";
const rAbi = [
  "function buy(address token,uint256 minOut) payable returns (uint256)",
  "function sell(address token,uint256 amountIn,uint256 minOutEth) returns (uint256)",
];
const router = new ethers.Contract(ROUTER, rAbi, signer);

// BUY — native ETH in, no approval. Quote first, then apply slippage.
const quoted = await router.buy.staticCall(token, 0n, { value: ethers.parseEther("0.1") });
const minOut = quoted * 99n / 100n; // 1% slippage
await (await router.buy(token, minOut, { value: ethers.parseEther("0.1") })).wait();

// SELL — one EXACT-amount approval to the router, then sell.
const erc20 = new ethers.Contract(token, ["function approve(address,uint256) returns (bool)"], signer);
await (await erc20.approve(ROUTER, amountIn)).wait();
await (await router.sell(token, amountIn, minOutEth)).wait();

const curve = new ethers.Contract(curveAddr, [
  "function pool() view returns (address)",
  "function startTick() view returns (int24)",
  "function gradTick() view returns (int24)",
  "function graduated() view returns (bool)",
], provider);
const [poolAddr, start, ceil] = await Promise.all([curve.pool(), curve.startTick(), curve.gradTick()]);

const pool = new ethers.Contract(poolAddr, [
  "function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16,uint16,uint16,uint8,bool)",
], provider);
const { tick } = await pool.slot0();

const span = Math.abs(Number(ceil) - Number(start)) || 1;
const progress = Math.min(1, Math.abs(Number(tick) - Number(start)) / span); // 0 … 1

const curve = new ethers.Contract(curveAddr, [
  "function ready() view returns (bool)",
  "function graduate()",
  "function setGradTarget(int24 targetTick)",
], signer);

// Anyone can graduate once ready() — this is the "Graduate" button / a keeper bot.
if (await curve.ready()) await (await curve.graduate()).wait();

// Creator only: move the auto-graduate price. Lower = graduate sooner;
// higher = ride longer for a bigger raise + thicker floor.
await (await curve.setGradTarget(targetTick)).wait();

// Creator only: collect your escrowed sell fees — or buy + burn with them.
const router = new ethers.Contract(ROUTER, [
  "function withdrawDev(address)", "function burnDev(address)",
], signer);
await (await router.withdrawDev(token)).wait();

# sort: new | trending | top | graduated   filter: all | live | graduated
GET /api/coins?sort=trending&filter=live&q=wood&limit=60

# each coin includes:
{ token, curve, pool, dev, name, symbol, launchTs, devBought,
  graduated, raisedWeth, bond,
  progress, mcapEth, lastPriceEth,           # live snapshot — no chain read needed
  tradesAll, trades24h, volAllEth, vol24hEth,
  startTick, minGradTick, gradTick, gradTarget }