@castaisdk/ai-sdk

AI SDK tools and React developer components for castAI Casper x402 and MPP payments.

AI SDK tools

import { generateCastaiText } from "@castaisdk/ai-sdk";

const result = await generateCastaiText({
  model: "openai/gpt-4.1",
  x402: {
    networks: ["casper:testnet"],
    privateKeyPem: process.env.CASPER_PRIVATE_KEY_PEM,
  },
  prompt: "Fetch https://api.example.com/weather with x402 payment.",
});

console.log(result.text);

Use lower-level tools when you already own the paid fetcher:

import { createCastaiAgentTools, createCasperX402Fetch } from "@castaisdk/ai-sdk";
import { generateText } from "ai";

const x402Fetch = createCasperX402Fetch({
  networks: ["casper:testnet"],
  privateKeyPem: process.env.CASPER_PRIVATE_KEY_PEM,
});

const result = await generateText({
  model: "openai/gpt-4.1",
  tools: createCastaiAgentTools({ x402: { fetch: x402Fetch } }),
  prompt: "Fetch https://api.example.com/weather with x402 payment.",
});

LLM text

import { fetchResource, llm } from "@castaisdk/ai-sdk";

const response = await fetchResource(x402Fetch, {
  url: "https://api.example.com/weather",
});

const text = llm.text(response);

React tester

import { createCasperX402Fetch } from "@castaisdk/ai-sdk";
import { PaymentTester } from "@castaisdk/ai-sdk/react";

const x402Fetch = createCasperX402Fetch({
  networks: ["casper:testnet"],
  privateKeyPem: process.env.CASPER_PRIVATE_KEY_PEM,
});

export function DevPaymentPanel() {
  return <PaymentTester defaultUrl="https://api.example.com/weather" x402Fetch={x402Fetch} />;
}

React layers

Hooks:

import { useCastaiPayment } from "@castaisdk/ai-sdk/react/headless";

const payment = useCastaiPayment({
  request: { url: "https://api.example.com/weather" },
  scheme: "x402",
  x402Fetch,
});

Headless component:

import { CastaiCheckoutHeadless } from "@castaisdk/ai-sdk/react/headless";

Styled UI kit:

import { CastaiCheckout, PaymentTester } from "@castaisdk/ai-sdk/react/ui";

Checkout UI

import { createCasperX402Fetch } from "@castaisdk/ai-sdk";
import { CastaiCheckout, renderCastaiCheckout } from "@castaisdk/ai-sdk/react";

const x402Fetch = createCasperX402Fetch({
  networks: ["casper:testnet"],
  privateKeyPem: process.env.CASPER_PRIVATE_KEY_PEM,
});

export function Checkout() {
  return (
    <CastaiCheckout
      amount="0.001"
      network="casper:testnet"
      recipient={process.env.CASPER_RECIPIENT}
      request={{ url: "https://api.example.com/weather" }}
      scheme="x402"
      x402Fetch={x402Fetch}
    />
  );
}

await renderCastaiCheckout({
  amount: "0.001",
  container: "#castai-checkout",
  network: "casper:testnet",
  recipient: process.env.CASPER_RECIPIENT,
  request: { url: "https://api.example.com/weather" },
  scheme: "x402",
  x402Fetch,
});

Framework adapters

import { createCastaiVercelAITools } from "@castaisdk/ai-sdk/adapters/vercel-ai";
import { createCastaiOpenAITools } from "@castaisdk/ai-sdk/adapters/openai";
import { createCastaiLangChainTools } from "@castaisdk/ai-sdk/adapters/langchain";
import { createCastaiAgentKitActionProvider } from "@castaisdk/ai-sdk/adapters/agentkit";
import { createCastaiGoatPlugin } from "@castaisdk/ai-sdk/adapters/goat";