SDK Overview
The @chaoslabs/ai-sdk is a TypeScript SDK for interacting with the Chaos AI API. It provides a simple, type-safe interface for building DeFi AI applications.
Features
| Feature | Description |
|---|---|
| Type-safe | Full TypeScript support with comprehensive type definitions |
| Two modes | WALLET_MODEL for DeFi operations, ASK_MODEL for research |
| Rich responses | Tables, charts, transactions, and interactive elements |
| Zod schemas | Built-in validation for block parsing |
| Error handling | ChaosError and ChaosTimeoutError classes |
| Helper functions | extractText(), extractBlocks(), hasRisks() |
Installation
npm install @chaoslabs/ai-sdkQuick Example
import { Chaos, WALLET_MODEL, extractText } from '@chaoslabs/ai-sdk';
const chaos = new Chaos({ apiKey: process.env.CHAOS_API_KEY! });
const response = await chaos.chat.responses.create({
model: WALLET_MODEL,
input: [{ type: 'message', role: 'user', content: "What's in my portfolio?" }],
metadata: { user_id: 'user-1', session_id: 'session-1', wallet_id: '0x...' },
});
console.log(extractText(response));Next Steps
- Quickstart - Complete tutorial with configuration and response handling
- Response Handling - Work with API responses
- Block Types - Understand tables, charts, transactions
- Conversations - Build multi-turn experiences
- Error Handling - Production-ready patterns