build on visionary.

// Launch an instant coin from a script. You sign locally; visionary never sees your key.
import { Keypair, Transaction } from "@solana/web3.js";
const wallet = Keypair.fromSecretKey(/* your key */);
const api = (path, body) => fetch("https://usevisionary.fun" + path, {
  method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body),
}).then((r) => r.json());
const sign = (b64) => { const tx = Transaction.from(Buffer.from(b64, "base64")); tx.partialSign(wallet); return tx.serialize().toString("base64"); };

const draft = await api("/api/v1/coins", {
  starter: wallet.publicKey.toBase58(),
  name: "hush", ticker: "HUSH", description: "a quiet coin",
  image: "https://example.com/hush.png",   // or a data URL
  start: "instant", payCoin: "zec",
  openingBuySol: 0.1, mcapGoalUsd: 25000, mcapStep: 2,
});
if (draft.error) throw new Error(draft.error);
const { coin } = await api(`/api/v1/coins/${draft.id}/start`, { signedTransaction: sign(draft.transaction) });
console.log("live:", coin.url, "mint", coin.mint);

// Buy 0.5 SOL of a coin, then sell all of it (same api and sign helpers as above)
const buy = await api("/api/v1/trade", { wallet: wallet.publicKey.toBase58(), coin: "{id}", side: "buy", amount: 0.5, slippageBps: 300 });
console.log(buy.venue, "expect", buy.expectedOut, "tokens, at least", buy.minimumOut);
console.log(await api("/api/v1/send", { signedTransaction: sign(buy.transaction) }));

const sell = await api("/api/v1/trade", { wallet: wallet.publicKey.toBase58(), coin: "{id}", side: "sell", amount: "100%" });
console.log(await api("/api/v1/send", { signedTransaction: sign(sell.transaction) }));

// Take a spot in an open circle
const spot = await api(`/api/v1/coins/${id}/spot`, { wallet: wallet.publicKey.toBase58() });
const r = await api(`/api/v1/coins/${id}/spot/confirm`, { signedTransaction: sign(spot.transaction) });
console.log(r.seated ? "in" : `refused: ${r.rejected}`, r.departing ? "(that was the last spot, going live)" : "");

// Point a wallet's Zcash payouts at a Zcash address (one signed message, no funds move)
import nacl from "tweetnacl"; import bs58 from "bs58";
const me = wallet.publicKey.toBase58();
const { sign: s } = await fetch(`https://usevisionary.fun/api/v1/wallets/${me}/take-home?to=${zcashAddress}`).then((r) => r.json());
const signature = bs58.encode(nacl.sign.detached(new TextEncoder().encode(s.message), wallet.secretKey));
console.log(await api(`/api/v1/wallets/${me}/take-home`, { to: s.to, time: s.time, signature }));

// Alert on every circle filling (poll every 10s)
const seen = new Map();
setInterval(async () => {
  const { coins } = await fetch("https://usevisionary.fun/api/v1/coins?status=open").then((r) => r.json());
  for (const c of coins) {
    if (seen.get(c.id) === c.spotsTaken) continue;
    seen.set(c.id, c.spotsTaken);
    console.log(`$${c.ticker}: ${c.spotsTaken}/${c.spotsTotal} spots at ${c.spotPriceSol} SOL, pays ${c.payCoin.symbol} ${c.url}`);
  }
}, 10_000);

// Label visionary coins in a terminal or bot
async function psstInfo(mint) {
  const r = await fetch(`https://usevisionary.fun/api/v1/coins/mint/${mint}`);
  if (r.status === 404) return null; // not a visionary coin
  const c = await r.json();
  return {
    devIsPot: c.pot,              // the "dev" wallet is the pot, not a person
    circle: c.buyers.length,      // the wallets terminals call bundle or insiders
    linked: c.buyers.filter((w) => w.linked).length,
    entryPriceSol: c.entryPriceSol,
    paysIn: c.payCoin.symbol,     // ZEC or XMR
    holders: c.holders,
  };
}

// Each payday of a coin, the milestone that set it off, and its transactions
const c = await fetch("https://usevisionary.fun/api/v1/coins/{id}").then((r) => r.json());
const d = 10 ** c.payCoin.decimals;
for (const p of c.paydays) {
  const why = p.reason === "mcap" ? `market cap hit $${p.milestoneUsd}` : "payday"; // older rows: "fees" or null
  console.log(new Date(p.at).toISOString(), why, p.sol, "SOL claimed,",
    Number(p.coinSent ?? 0) / d, c.payCoin.symbol, "to", p.recipients, "holders,",
    p.carriedSol, "SOL carried, claim", p.claimTx, "swap", p.swapTx, "transfers", p.payTxs);
}

// How close a coin is to its next payday: market cap against the next milestone
const { ticker, goals: g } = await fetch("https://usevisionary.fun/api/v1/coins/{id}").then((r) => r.json());
if (g.marketCapUsd == null) console.log(`$${ticker}: market cap not checked yet`);
else {
  const pct = Math.min(100, Math.round((g.marketCapUsd / g.nextMcapUsd) * 100));
  console.log(`$${ticker}: $${g.marketCapUsd} of $${g.nextMcapUsd} (${pct}%), then x${g.mcapStep}`);
}