RadixAgent API

new RadixAgent(config: RadixAgentConfig)

interface RadixAgentConfig {
  networkId: RadixNetwork;          // Network to connect to
  openaiApiKey?: string;            // OpenAI API key for AI features
  mnemonic?: string;                // Wallet mnemonic phrase
  wallet?: RadixWallet;             // Existing wallet instance
  model?: string;                   // LLM model (default: "gpt-4")
  temperature?: number;             // LLM temperature (default: 0.1)
  useMemory?: boolean;              // Enable conversation memory
  applicationName?: string;         // App name for Gateway
  customTools?: RadixTool[];        // Additional custom tools
}

async run(input: string): Promise\<string>

const response = await agent.run("What's my XRD balance?");
console.log(response); // "📊 Your account balances: • 1,250.50 XRD"

generateNewWallet(): { wallet: RadixWallet; mnemonic: string }

const { wallet, mnemonic } = agent.generateNewWallet();
console.log("Address:", wallet.getAddress());
console.log("Mnemonic:", mnemonic); // Save this securely!

setWallet(wallet: RadixWallet): void

const newWallet = RadixMnemonicWallet.fromMnemonic(mnemonic, config);
agent.setWallet(newWallet);

getWallet(): RadixWallet | null

const wallet = agent.getWallet();
if (wallet) {
  console.log("Current address:", wallet.getAddress());
}

getInfo(): AgentInfo

interface AgentInfo {
  networkId: RadixNetwork;
  walletAddress?: string;
  toolCount: number;
  hasMemory: boolean;
  model: string;
}

const info = agent.getInfo();
console.log(`Agent connected to ${info.networkId} with ${info.toolCount} tools`);

getTools(): RadixTool[]

const tools = agent.getTools();
tools.forEach(tool => console.log(tool.name));

addTool(tool: RadixTool): void

class MyCustomTool extends RadixTool {
  name = "my_tool";
  description = "Does something custom";
  
  async _call(input: string): Promise\<string> {
    return "Custom operation result";
  }
}

agent.addTool(new MyCustomTool(gateway, builder, wallet, networkId));

removeTool(toolName: string): boolean

const removed = agent.removeTool("my_tool");
console.log("Tool removed:", removed);

enum RadixNetwork {
  Mainnet = 1,
  Stokenet = 2
}

import "dotenv/config"; // Required for Node.js environments
import { RadixAgent, RadixNetwork } from "radix-agent-kit";

// Create agent with new wallet
const agent = new RadixAgent({
  networkId: RadixNetwork.Stokenet,
  openaiApiKey: process.env.OPENAI_API_KEY,
  useMemory: true
});

// Generate wallet
const { wallet, mnemonic } = agent.generateNewWallet();
console.log("Save this mnemonic:", mnemonic);

const agent = new RadixAgent({
  networkId: RadixNetwork.Stokenet,
  mnemonic: process.env.RADIX_MNEMONIC,
  openaiApiKey: process.env.OPENAI_API_KEY,
  model: "gpt-4",
  temperature: 0.1,
  useMemory: true,
  applicationName: "MyRadixApp"
});

// Agent remembers context across calls when useMemory: true
await agent.run("Create a token called MyToken with 1M supply");
await agent.run("Now send 1000 MyToken to Alice"); // Remembers MyToken
await agent.run("How much MyToken do I have left?"); // Still remembers

try {
  const response = await agent.run("Send 1000000 XRD to invalid_address");
  console.log(response);
} catch (error) {
  console.error("Agent error:", error.message);
  
  // Common error types:
  // - "Insufficient funds"
  // - "Invalid address format"
  // - "Network connection failed"
  // - "OpenAI API error"
}

class PriceCheckerTool extends RadixTool {
  name = "check_price";
  description = "Check token prices from external API";
  
  async _call(input: string): Promise\<string> {
    // Your custom price checking logic
    const price = await this.fetchTokenPrice(input);
    return `Current price: $${price}`;
  }
  
  private async fetchTokenPrice(token: string): Promise\<number> {
    // Implement price fetching logic
    return 1.23;
  }
}

// Add to agent
const priceChecker = new PriceCheckerTool(gateway, builder, wallet, networkId);
agent.addTool(priceChecker);

// Use in conversation
const response = await agent.run("Check price of XRD");