System Architecture

ADK-TS Agent Architecture

ChainPilot is built on Anthropic's Agent Development Kit (ADK-TS), enabling stateful AI agents that persist conversation history and execute multi-chain blockchain operations. Our architecture combines modern web technologies with enterprise-grade blockchain infrastructure.

Agent Development Kit (ADK)
Powered by ADK-TS

Built on ADK-TS

ChainPilot leverages Anthropic's Agent Development Kit to create stateful, conversational agents that maintain context across sessions and execute complex blockchain workflows.

Session Persistence

ADK's SessionService enables persistent conversation history stored in PostgreSQL, allowing agents to maintain context across multiple interactions and browser sessions.

AgentBuilder Pattern

Structured agent creation using ADK's AgentBuilder with tool registration, instruction management, and streaming response capabilities built-in.

Tool Integration

Seamless integration of 88+ blockchain tools through ADK's tool registry system, with automatic parameter validation and error handling across all chains.

Streaming Responses

Real-time streaming of AI responses and tool execution results, providing instant feedback as complex blockchain operations are processed.

88+
Blockchain Tools
100%
ADK-Built Agent
15+
Supported Chains

System Overview

Conversational Interface

Natural language processing transforms user intent into blockchain operations through ADK's agent framework with 88+ specialized tools across EVM chains and Solana.

Stateful Agent System

ADK's SessionService maintains conversation context and state across sessions, enabling complex multi-step workflows and personalized interactions.

Multi-Chain Infrastructure

Unified access to 10+ EVM chains via Alchemy and Solana via Jupiter Ultra, with RainbowKit for seamless wallet connectivity across ecosystems.

Next.js Frontend
ADK-TS Agent
Multi-Chain APIs
Conversational Multi-Chain Operations

Architecture Layers

Presentation Layer

Layer 1

Next.js 15 App Router with React 19 RC providing modern SSR/SSG capabilities

Next.js App Router
React Server Components
Static Generation
Incremental Static Regeneration
Edge Runtime Support

UI/UX Layer

Layer 2

Component-driven architecture with Tailwind CSS and Framer Motion animations

Radix UI Primitives
Tailwind CSS Utilities
Framer Motion Animations
Dark/Light Theme System
Responsive Design Patterns

ADK-TS Agent Layer

Layer 3

Anthropic's Agent Development Kit powering stateful AI agents with session management

AgentBuilder Pattern
SessionService Integration
Tool Registry System
Streaming Responses
State Persistence

Multi-Chain Blockchain Layer

Layer 4

Unified interface for EVM chains via Alchemy and Solana via Jupiter APIs

RainbowKit Wallet Integration
Alchemy Multi-Chain APIs
Jupiter Ultra (Solana)
Transaction Management
Cross-Chain Routing

Data & Storage Layer

Layer 5

Multi-database architecture with ORM, caching, and external API integrations

Drizzle ORM
PostgreSQL Database
Session Persistence
Conversation History
External API Gateway

Multi-Chain Tool Registry

Our ADK-TS agent leverages 88+ specialized tools organized into functional categories. Each tool is designed for specific blockchain operations with intelligent error handling and validation.

EVM Chain Operations

25 tools

Comprehensive multi-chain wallet and account management via Alchemy

Token Balances
Transaction History
NFT Portfolios
Gas Estimation

Solana Operations

15 tools

Solana token data and DEX operations via Jupiter Ultra API

Token Info
Price Data
Swap Quotes
Liquidity Analysis

ENS & Name Services

8 tools

Ethereum Name Service resolution and reverse lookups

ENS Resolution
Reverse Lookup
Avatar Retrieval
Profile Data

Transaction Tools

12 tools

Transaction building, simulation, and execution across chains

Send Tokens
Transaction Status
Receipt Lookup
Gas Optimization

Analytics & Insights

10 tools

Real-time blockchain analytics and portfolio tracking

Portfolio Value
Token Analytics
Transaction Patterns
Chain Statistics

DeFi Operations

18 tools

Decentralized exchange and DeFi protocol interactions

Swap Quotes
Liquidity Pools
Yield Farming
Price Oracles

Technology Stack

ADKADK-TS Framework

Agent Development Kit
Latest

Anthropic's stateful agent framework

AgentBuilder
Core

Pattern for building conversational agents

SessionService
Core

Persistent session and state management

Frontend Framework

Next.js
15.3.0

React framework with App Router

React
19.0.0-rc

UI library with concurrent features

TypeScript
5.6.3

Type-safe development

Blockchain Infrastructure

Alchemy APIs
Latest

Multi-chain EVM data and APIs

Jupiter Ultra
v1

Solana token data and DEX aggregation

RainbowKit
2.0+

Multi-chain wallet connectivity

Database & Storage

Drizzle ORM
0.34.0

Type-safe database operations

PostgreSQL
Latest

Production database with session storage

Vercel Postgres
Latest

Managed database service

Security & Performance

Security Measures

Client-Side Wallet Integration
No private keys stored on servers
Multi-Chain Wallet Support
RainbowKit for secure cross-chain connectivity
Input Validation & Sanitization
Comprehensive data validation pipeline
API Key Security
Server-side API key management for Alchemy/Jupiter

Performance Features

Edge Runtime Support
Global distribution and low latency
ADK Streaming Responses
Real-time agent responses and tool execution
Session Caching
Optimized conversation history retrieval
Progressive Enhancement
Graceful degradation and error handling

ADK-TS Agent Data Flow

User Input

Natural language commands processed through conversational interface

ADK Agent Processing

AgentBuilder analyzes intent, maintains session state, and selects tools

Multi-Chain Execution

Tools execute across EVM chains (Alchemy) and Solana (Jupiter)

Streaming Response

Real-time results with session persistence for future context

1
2
3
4