Quickstart Guide

1. Install the SDK

npm install lumenjoule-sdk

2. Configure Your Agent

import { SmartWalletClient } from 'lumenjoule-sdk';

const client = new SmartWalletClient({
  agentSecretKey: process.env.AGENT_SECRET_KEY!,
  walletAddress: process.env.WALLET_ADDRESS!,
  computeUrl: 'https://compute.lumenbro.com',
  network: 'mainnet',
});

3. Make Inference Requests

const response = await client.chat({
  model: 'deepseek-ai/DeepSeek-V3',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'What is JOULE?' },
  ],
});

console.log(response.choices[0].message.content);

Spend Policies

Each agent signer has an on-chain ExternalValidatorPolicy that enforces daily spending limits. Available tiers:

• $50/day — Suitable for development and low-volume agents
• $500/day — For production agents with higher throughput

API Reference