CORONA
DEVELOPERS

Build on Corona.

Private balances, payments, markets and launches, all behind one open API. Read the chain, sign with any Solana wallet, post transactions.

Read the chain

Every public endpoint is open, JSON in and JSON out. Amounts are strings in base units: SOL has 9 decimals, Corona coins have 6.

GET /api/chainChain id, head block, state root and the latest Solana receipt open
GET /api/blocksLatest blocks with tx root and state root open
GET /api/blocks/:idOne block by height or hash
GET /api/tx/:hashPublic view of a transaction and its status
GET /api/checkpointsEvery receipt written to Solana open
GET /api/coinsEvery coin with price, market cap and curve progress in USD open
GET /api/coins/:idOne coin
GET /api/coins/:id/candlesPrice candles for charts
GET /api/coins/:id/quoteQuote a buy or sell before sending it
GET /api/nonce/:pubkeyNext nonce for an account
GET /api/streamLive stream of new blocks
POST /api/txSend a signed transaction

AI agents

Corona speaks MCP. Add https://coronasol.com/mcp as a connector in Claude, ChatGPT or any MCP client and your agent can read blocks, receipts, coins and perps markets, and send transactions it signs with its own Solana key.

Private data

Balances, history and points are readable only by the wallet that owns them. Sign a short message with the wallet and send three headers. One signature is good for five minutes.

x-l2-pubkey: <base58 public key>
x-l2-ts:     <time in ms>
x-l2-sig:    <base58 signature of "RINGS-L2 auth v1\n" + pubkey + "\n" + ts>

Then call /api/me/balances, /api/me/history, /api/me/points, /api/me/links and /api/me/withdrawals.

Send a transaction

A transaction is a small JSON object signed with the sender's Solana key. The wallet signs the text RINGS-L2 tx v1, a new line, and the canonical JSON of the unsigned fields: keys sorted at every level, no spaces. The tx hash is the SHA256 of those bytes.

import bs58 from 'bs58';

function canonicalJson(v) {
  if (v === null || typeof v !== 'object') return JSON.stringify(v);
  if (Array.isArray(v)) return '[' + v.map(canonicalJson).join(',') + ']';
  const keys = Object.keys(v).filter((k) => v[k] !== undefined).sort();
  return '{' + keys.map((k) => JSON.stringify(k) + ':' + canonicalJson(v[k])).join(',') + '}';
}

async function sendTx(wallet, type, body) {
  const base = 'https://coronasol.com';
  const from = wallet.publicKey.toBase58();
  const { nonce } = await (await fetch(base + '/api/nonce/' + from)).json();
  const unsigned = { chainId: 'rings-l2-1', from, nonce, type, body };
  const msg = new TextEncoder().encode('RINGS-L2 tx v1\n' + canonicalJson(unsigned));
  const { signature } = await wallet.signMessage(msg);
  const res = await fetch(base + '/api/tx?wait=1', {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ ...unsigned, sig: bs58.encode(signature) }),
  });
  return res.json();
}

await sendTx(wallet, 'pay.transfer', { to: '<pubkey>', asset: 'SOL', amount: '100000000' });

Transaction types

TYPEBODY
pay.transfer{ to, asset, amount, memo? }
pay.link.create{ asset, amount, claimHash, expiresAt }
pay.link.claim{ id, secret }
pay.link.cancel{ id }
coin.launch{ name, symbol, publicGraduation, uri?, initialBuy? }
coin.buy{ coin, solIn, minOut }
coin.sell{ coin, amountIn, minSolOut }
coin.graduate.claim{ coin, to }
bridge.withdraw{ asset, amount, to, public? }

Deposits

Users bring SOL into Corona from any Solana wallet through the app at coronasol.com/app. Everything after that, payments, trades, launches and withdrawals, is a Corona transaction your app can build and send.

Limits

300 requests a minute per address for the API, and 60 a minute for sending transactions.