Quickstart

npm install @illalabs/sdk

import { IllaSDK } from '@illalabs/sdk'

const sdk = new IllaSDK({
  apiKey: process.env.ILLA_API_KEY!
})

const result = await sdk.sendMessage(
  'What can I do on Base today?',
  {
    userContext: {
      address: '0xYourAddress',
      // Optional: EOA signer for smart-account flows
      // signerWallet: '0xYourSignerAddress'
    }
  }
)

if (!result.response.isError) {
  console.log('Assistant:', result.response.data.text)
  console.log('Chat ID:', result.chatId) // Save this to continue the conversation

  // Check if there are pending tools to execute
  if (result.response.data.pendingTools) {
    console.log('Pending tools:', result.response.data.pendingTools)
  }
} else {
  console.error('Error:', result.response.error)
}

// Use the chatId from the previous message to continue
const followUp = await sdk.sendMessage(
  'Swap 1 ETH for USDC',
  { chatId: result.chatId }
)

if (!followUp.response.isError) {
  console.log('Assistant:', followUp.response.data.text)
}

import {
  Chat,
  ContextManager,
  CoreApiProvider,
  InMemoryCache,
  Prompt,
} from '@illalabs/sdk'

const provider = new CoreApiProvider({
  headers: { 'x-api-key': process.env.ILLA_API_KEY! },
})

const context = new ContextManager(new InMemoryCache())

const chat = new Chat({
  coreApiProvider: provider,
  contextManager: context,
  userContext: {
    address: '0xYourAddress',
    // Optional signer EOA for smart-account + signature flows
    // signerWallet: '0xYourSignerAddress'
  },
})

const prompt = new Prompt({ text: 'What can I do on Base today?' })
const res = await chat.sendMessage(prompt)

if (!res.response.isError) {
  console.log('Assistant:', res.response.data.text)
}