Pool Deploy Documentation

Concept

A Cookchain DEX pool is a pair of two token contracts plus reserves, LP ownership and fee settings. The first liquidity operation creates or initializes the pool state when the target node allows it. Later liquidity and swap calls update the same pair and emit DEX events.

External providers should treat pool deployment like a Solidity router workflow: validate token contracts, convert display amounts to raw units, submit the pool transaction from a backend, then watch the pair streams until the pool appears in the explorer.

Base URLs

Public DEX apps should call their own backend first. The backend validates input, checks balances and slippage, signs or authorizes the operation, then calls https://rpc.ldbl.net. The fullnode remains the primary chain data source.

Swap Request

curl -X POST "https://rpc.ldbl.net/api/dex/swap" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer USER_OR_ROUTER_TOKEN" \
  -d '{
    "token_in": "CoTOKENAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "token_out": "CoTOKENBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB",
    "amount_in": "1000000000000000000",
    "trader": "Co2222222222222222222222222222222222222222"
  }'

External routers should calculate expected output and slippage before calling the node. Keep the final user confirmation in display units, but submit only raw units to the RPC.

Realtime Streams

const pairs = new EventSource("https://rpc.ldbl.net/api/stream/pairs");
pairs.onmessage = (event) => {
  const update = JSON.parse(event.data);
  renderPool(update);
};

const prices = new EventSource("https://rpc.ldbl.net/api/stream/prices");
prices.onmessage = (event) => {
  const tick = JSON.parse(event.data);
  updatePrice(tick);
};

Use streams for pool cards, prices, candle builders, route refreshes and explorer-style deploy history without full page reloads.

JavaScript Template

function toRaw(amount, decimals) {
  const [whole, fraction = ""] = String(amount).split(".");
  return BigInt(whole + fraction.padEnd(decimals, "0")).toString();
}

async function deployPool(baseUrl, pool, operatorToken) {
  const body = {
    token_a: pool.tokenA,
    token_b: pool.tokenB,
    amount_a: toRaw(pool.amountA, pool.decimalsA),
    amount_b: toRaw(pool.amountB, pool.decimalsB),
    lp_owner: pool.lpOwner
  };

  const res = await fetch(`${baseUrl}/api/dex/liquidity/add`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": `Bearer ${operatorToken}`
    },
    body: JSON.stringify(body)
  });

  if (!res.ok) throw new Error(`pool deploy failed: ${res.status}`);
  return res.json();
}

Explorer Links

• Pool detail: /explorer/pool/:pairId
• Token detail: /explorer/token/:contract
• Contract detail: /explorer/contract/:id
• Deploy overview: /deploys?tab=pairs&page=1
• Pool logo metadata can use normal URLs or IPFS gateway URLs, same as token logos.