System Architecture

Stellar Studio Architecture

Stellar Studio employs a sophisticated multi-layer architecture designed for conversational smart contract deployment on Stellar. Our system combines modern web technologies, AI processing via MCP, and Soroban contract integration to deliver production-ready dApps at scale.

System Overview

Conversational Interface

Natural language processing transforms user intent into Stellar Soroban operations through our MCP-powered tool registry with 80+ specialized functions across 9 plugins.

Lightning Fast Deployment

Streaming AI responses with Stellar's 5-second finality ensure immediate feedback while smart contract deployments complete in real-time.

Production Ready

Client-side wallet integration, secure transaction signing, and factory-based deployment ensure production-ready contracts with Stellar best practices.

Web Frontend

MCP Server

Stellar SDK

Conversational Soroban Development

Architecture Layers

Presentation Layer

Layer 1

Next.js 15 App Router with React 19 providing modern SSR for Stellar dApp development

Next.js App Router

React Server Components

Tailwind CSS

Framer Motion

Dark/Light Theme

AI Integration Layer

Layer 2

MCP server with 80+ Stellar Soroban operation tools across 9 plugins

Model Context Protocol

Claude AI Integration

Tool Registry (80+ tools)

Streaming Responses

Context-Aware Processing

Blockchain Layer

Layer 3

Stellar SDK integration with Freighter wallet and Soroban smart contracts

Freighter Wallet Connect

Stellar SDK

Soroban Contract Calls

5-Second Finality

Testnet/Mainnet Support

Smart Contract Layer

Layer 4

Factory contracts for deploying tokens, NFTs, and governance on Stellar

Token Factory

NFT Factory

Governance Factory

Contract Registry

TypeScript Clients

Data & Storage Layer

Layer 5

Database architecture with user sessions and chat history

Drizzle ORM

PostgreSQL/SQLite

User Authentication

Chat History

Transaction Records

MCP Tool Registry

Our MCP server leverages 80+ specialized tools organized across 9 plugins for Stellar Soroban operations. Each tool is designed for specific factory and contract operations with intelligent error handling and validation.

Factory Operations

1 tool

Get deployed factory contracts

Factory Tracking

Token Deployment

5 tools

Deploy and query tokens via TokenFactory

Deploy Token

List Tokens

Filter by Type

Filter by Admin

Token Count

NFT Deployment

5 tools

Deploy and query NFT collections via NFTFactory

Deploy NFT

List NFTs

Filter by Type

Filter by Owner

NFT Count

Governance

5 tools

Deploy and query governance contracts

Deploy Governance

List Governance

Filter by Type

Filter by Admin

Governance Count

Registry

6 tools

Publish and deploy contracts via Stellar Registry

Publish Contract

Deploy Contract

Create Alias

List Published

Get Versions

Contract Info

Token Operations

15 tools

Token contract operations

Transfer

Mint

Burn

Approve

Balance

Total Supply

Pause/Unpause

NFT Operations

17 tools

NFT contract operations

Mint

Transfer

Burn

Approve

Owner Of

Token URI

Total Supply

Governance Voting

3 tools

MerkleVoting operations

Cast Vote

Check Voted

Get Results

Utilities

15 tools

Helper functions and builders

Merkle Trees

Validation

Config Builders

Amount Formatting

Salt Generation

Technology Stack

Frontend Framework

Next.js

v15.3.0

React framework with App Router

React

v19.0.0

UI library with concurrent features

TypeScript

v5.6.3

Type-safe development

AI & MCP

MCP SDK

v1.0.0

Model Context Protocol integration

Claude

vLatest

AI models for Soroban context

Tool Registry

vCustom

80+ Stellar tools

Blockchain

Stellar SDK

v14.1.1

Official Stellar JavaScript SDK

Freighter

vLatest

Stellar wallet integration

Soroban

v22

Stellar smart contract platform

Database & Storage

Drizzle ORM

vLatest

Type-safe database operations

PostgreSQL

vLatest

Production database

SQLite

vLatest

Development database

Security & Performance

Security Measures

Client-Side Wallet Integration

Private keys never leave Freighter wallet

Stellar Network Security

5-second finality with consensus protocol

Soroban Smart Contract Safety

Rust-based contracts with built-in safety

Input Validation & Sanitization

Comprehensive validation pipeline

Performance Features

5-Second Finality

Stellar's fast consensus mechanism

Streaming MCP Responses

Real-time data processing and display

Factory Pattern Optimization

Efficient contract deployment system

Progressive Enhancement

Graceful degradation and error handling

Data Flow Architecture

User Input

Natural language commands for Stellar contract deployment

MCP Processing

Claude AI analyzes intent and selects appropriate factory tools

Blockchain Execution

Stellar SDK deploys contracts with 5-second finality

Contract Deployed

Production-ready contracts with transaction receipt