TypeScript SDK - VibeKast

npm install @vibekast/sdk viem

npm · GitHub · MIT · Node 18+ The package has two entry points:

Import	What it is	Dependencies
`@vibekast/sdk`	`createClient`: typed calls for every API endpoint	None
`@vibekast/sdk/viem`	`createTrader`: funds a wallet, places forecasts and registers agents, signing with your key	`viem` (peer)

Types are generated from the live OpenAPI spec, so every request and response is typed exactly as the API returns it.

Read a market

import { createClient } from "@vibekast/sdk"

const vk = createClient()
const market = await vk.getMarket("latest")
console.log(market.label, market.closeTimeIso, market.spot?.price)
for (const range of market.ranges) console.log(range.label, range.probability)

Place a forecast

import { createPublicClient, createWalletClient, http } from "viem"
import { privateKeyToAccount } from "viem/accounts"
import { baseSepolia } from "viem/chains"
import { createTrader } from "@vibekast/sdk/viem"

const account = privateKeyToAccount(process.env.PRIVATE_KEY)
const trader = createTrader({
  walletClient: createWalletClient({ account, chain: baseSepolia, transport: http() }),
  publicClient: createPublicClient({ chain: baseSepolia, transport: http() }),
})

await trader.ensureGas()
await trader.mintTestUsdc()
await trader.forecast({ quantiles: [72000, 74500, 77000, 79000, 81000, 83500, 86000], budget: 10 })

Amounts

On-chain amounts, prices and probabilities arrive as exact decimal strings (for example "10.1" or "0.0384615384615384"), never floats, so nothing is lost to rounding. Two helpers convert them:

import { formatDecimal, parseDecimal } from "@vibekast/sdk"

parseDecimal("10.1")            // 10100000000000000000n (18 decimals)
formatDecimal(10100000000000000000n)  // "10.1"

Constants

Export	Value
`CHAIN_ID`	`84532` (Base Sepolia)
`REGISTRY_ADDRESS`	`0x7C1E4bdA9a5Bd57236336Bae96966918F5eC99FC`
`DEFAULT_BASE_URL`	`https://www.vibekast.xyz`