​
Radix Agent Kit

Build AI agents that interact with the Radix blockchain using natural language. No complex blockchain code required.

​
What is Radix Agent Kit?

Radix Agent Kit lets you create AI agents that understand plain English commands and execute them on the Radix blockchain. Instead of writing complex transaction code, just tell your agent what to do. 
// Traditional blockchain development ❌
const manifest = transactionBuilder.createTransferManifest(...)
const intent = await transactionBuilder.buildTransactionIntent(...)
const signedTransaction = await wallet.signTransaction(...)
await gateway.submitTransaction(...)

// With Radix Agent Kit ✅
await agent.run("Send 100 XRD to account_tdx_...");

​
Core Components

🤖 AI Agent
  • Powered by GPT-4 for natural language understanding
  • 16 specialized tools for blockchain operations
  • Remembers conversation context (optional)
⚡ Direct API
  • TypeScript classes for all Radix operations
  • Use without AI when you need programmatic control
  • Full type safety and error handling
🛡️ Security
  • Encrypted key storage with AES-256-GCM
  • Transaction validation and rate limiting
  • Compatible with Radix Wallet mnemonics

​
Quick Example

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

// Create an agent
const agent = new RadixAgent({
  networkId: RadixNetwork.Stokenet,
  openaiApiKey: process.env.OPENAI_API_KEY,
  mnemonic: process.env.RADIX_MNEMONIC
});

// Natural language blockchain operations
await agent.run("What's my XRD balance?");
await agent.run("Send 100 XRD to account_tdx_...");
await agent.run("Create a token called GameCoin with 1M supply");
await agent.run("Stake 100 XRD with validator_tdx_...");

​
What Your Agent Can Do

💰 Account Management

Check balances, get account info, fund testnet wallets

🪙 Token Operations

Create tokens, mint NFTs, transfer assets between accounts

🥩 Validator Operations

Stake XRD, unstake positions, claim staking rewards

🏊‍♂️ DeFi Operations

Add liquidity, swap tokens, manage pools

🔧 Smart Contracts

Call component methods, inspect state, interact with dApps

🛠️ Developer Tools

Get epoch info, validate addresses, debug transactions

​
16 Specialized Tools

Your agent comes with tools organized by operation type:
CategoryCountTools
Account & Wallet3get_account_info, get_balances, fund_stokenet_wallet
Token Operations5create tokens, mint tokens, transfer assets
Validator Operations3stake_xrd, unstake_xrd, claim_xrd
DeFi Operations2add_liquidity, swap_tokens
Component Interaction2call_component_method, get_component_state
Utility1get_epoch

View All Tools

See detailed documentation for all 16 AI tools

​
Networks Supported

NetworkPurposeBest For
StokenetTestnetLearning, development, testing
MainnetProductionReal applications with real value
Always start with Stokenet for development. It’s free, safe, and you can’t lose real money.

​
How It Works

  1. You speak naturally: “Send 100 XRD to Alice”
  2. AI understands intent: Chooses the transfer_tokens tool
  3. Tool builds transaction: Creates proper Radix transaction
  4. Blockchain executes: Transaction is submitted and confirmed
  5. You get feedback: ”✅ Sent 100 XRD to account_tdx_…”

​
Security Features

🔐 Key Management
  • 24-word BIP-39 mnemonics (Radix Wallet compatible)
  • AES-256-GCM encryption for stored keys
  • Private keys never logged or exposed
🛡️ Transaction Safety
  • Address format validation
  • Balance checking before transfers
  • Configurable spending limits
  • Rate limiting to prevent spam
⚠️ Input Validation
  • All addresses validated against Radix format
  • Amount parsing with decimal precision
  • Parameter sanitization for security

​
Who Should Use This?

🆕 Blockchain Beginners
  • No need to learn complex blockchain APIs
  • Natural language interface
  • Built-in safety features
👩‍💻 Developers
  • Skip boilerplate blockchain code
  • Focus on your app logic
  • TypeScript with full type safety
🤖 AI Builders
  • Add blockchain capabilities to chatbots
  • Build crypto trading bots
  • Create DeFi automation tools

​
Getting Started

Quick Start

Install and create your first agent in 5 minutes

All Features

Complete overview of all capabilities

Examples

Real-world code examples and patterns

Security

Best practices for production usage

​
Simple Architecture

Your App
    ↓
AI Agent (GPT-4)
    ↓
16 Blockchain Tools
    ↓
Radix Gateway API
    ↓
Radix Network
The AI agent acts as a translator between natural language and blockchain operations, using specialized tools to execute your commands safely and efficiently.