Quickstart

npm install @kashdao/protocol-sdk @solana/web3.js @coral-xyz/anchor @solana/spl-token bn.js

import { Connection } from '@solana/web3.js';
import { createSolanaClient } from '@kashdao/protocol-sdk/solana';

const kash = createSolanaClient({
  connection: new Connection(process.env.SOLANA_RPC_URL!, 'confirmed'),
}); // mainnet-beta by default

const config = await kash.protocol.config();
console.log(`protocol fee ${config.defaultProtocolFeeBps} bps`);

// By numeric market id, or by the market account address
// (the REST API's `contractAddress` for a Solana market).
const market = await kash.markets.get(5n);
console.log(market.status, market.numOutcomes);
market.probabilitiesWad.forEach((p, k) => {
  console.log(`outcome ${k}: ${(Number(p) / 1e16).toFixed(2)}%`);
});

// What would 5 USDC of outcome 0 buy?
const buy = await kash.markets.quoteBuy({ market: 5n, outcome: 0, amountUsdc: 5_000_000n });
console.log(`${buy.tokensOutWad} WAD, fee ${buy.protocolFeeUsdc} atomic USDC`);

// What would selling 0.1 token of outcome 1 pay? Only tokens traders hold can
// be sold, so a sell quote larger than that throws KashValidationError (ExceedsSupply).
const sell = await kash.markets.quoteSell({ market: 5n, outcome: 1, tokensInWad: 10n ** 17n });
console.log(`${sell.amountOutUsdc} atomic USDC`);

import { Keypair } from '@solana/web3.js';
import { keypairSigner } from '@kashdao/protocol-sdk/solana';

const keypair = Keypair.fromSecretKey(
  Uint8Array.from(JSON.parse(process.env.SOLANA_SECRET_KEY!) as number[]),
);
const signer = keypairSigner(keypair);

console.log(`USDC: ${await kash.account.usdcBalance(keypair.publicKey)} (atomic)`);

// Buy 1 USDC of outcome 0, accepting at most 1% below the quote.
// The first buy also opens the position account in the same transaction.
const bought = await kash.trades.buy({
  market: 5n,
  outcome: 0,
  amountUsdc: 1_000_000n,
  maxSlippageBps: 100,
  signer,
  computeUnitPriceMicroLamports: 10_000, // optional priority fee
});
console.log(`bought: ${bought.signature} (floor ${bought.plan.minTokensOutWad} WAD)`);

// Sell the whole position back.
const position = await kash.account.position({ market: 5n, outcome: 0, owner: keypair.publicKey });
const sold = await kash.trades.sell({
  market: 5n,
  outcome: 0,
  tokensInWad: position.balanceWad,
  maxSlippageBps: 100,
  signer,
});
console.log(`sold: ${sold.signature} for at least ${sold.plan.minAmountOutUsdc} atomic USDC`);

const plan = await kash.trades.buildBuy({
  market: 5n,
  outcome: 0,
  amountUsdc: 1_000_000n,
  maxSlippageBps: 100,
  trader: keypair.publicKey,
});
console.log(plan.instructions.length, plan.opensPosition, plan.minTokensOutWad);

const simulation = await kash.trades.simulate(plan, { payer: keypair.publicKey });
if (simulation.error) throw new Error(`refused: ${simulation.error.name ?? 'unknown'}`);

const { signature } = await kash.trades.send(plan, { signer });

const settled = await kash.markets.get(5n);
const redeem = settled.status === 'resolved' ? kash.trades.redeem : kash.trades.redeemCancelled;

// amountWad defaults to the whole position. A losing outcome pays zero.
const redeemed = await redeem({ market: 5n, outcome: 0, maxSlippageBps: 50, signer });
console.log(`redeemed: ${redeemed.signature}`);

const closed = await kash.trades.closePosition({ market: 5n, outcome: 0, signer });
console.log(`rent returned to ${closed.plan.rentRecipient.toBase58()}`);