> For the complete documentation index, see [llms.txt](https://supersonic-ai.gitbook.io/supersonic-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://supersonic-ai.gitbook.io/supersonic-documentation/under-the-hood/system-overview.md).

# System Overview

## System Overview

Ready to peek under the hood of SuperSonic? Let's explore the tech that makes our platform tick. We'll walk you through our key design choices and the architecture that powers our AI-driven DeFi automation on Sonic.

### Core Design Principles

We built SuperSonic with four key principles in mind:

* **Modularity** 🧩\
  Everything's built in neat, swappable pieces. Need to add or update something? No problem - just plug it in!
* **Scalability** 📈\
  Thanks to Sonic's Layer 1 capabilities and EVM compatibility, we can handle growing demands and high transaction volumes without breaking a sweat.
* **Efficiency & Security** 🔒\
  Every transaction is optimized for speed and safety, with real-time data feeds and robust error handling built right in.
* **Smart Automation** 🤖\
  Our multi-agent system splits tasks among specialized helpers, making sure everything runs smoothly in parallel.

### Tech Stack

Here's what powers SuperSonic:

* **Core Tech:**
  * Node.js (v23+) for the runtime
  * TypeScript (with strict mode) for type safety
* **Key Frameworks:**
  * ElizaOS running the core operations
  * Next.js for our web framework
  * Shadcn UI & TailwindCSS making everything look good
  * Vite speeding up development
* **Blockchain & Data:**
  * Ethers.js/Web3.js talking to Sonic's blockchain
  * CoinGecko & DefiLlama feeding us real-time data
* **Workflow Magic:**
  * n8n orchestrating our multi-agent system

### How It All Fits Together

#### Action Framework

Think of this as SuperSonic's brain - it coordinates every task, whether you're swapping tokens or checking market stats. Everything happens efficiently and in the right order.

#### Provider System

This is how we connect to essential services:

* **Wallet Provider:** Handles your transactions safely
* **Token Provider:** Keeps track of token data and transfers
* **Data Providers:**
  * CoinGecko for price info
  * DefiLlama for TVL metrics and analytics

### Built for Flexibility

SuperSonic is designed to grow with you:

* **18 Specialized Agents:** Each one's an expert at specific DeFi tasks
* **Easy to Extend:** Add new features without breaking what's already working
* **Your Control:** Run your own instance and keep full control of your setup

### What's Next?

Want to see how our agents work together in real life? Check out our Technical Specifications for the nitty-gritty details.

Ready to dive deeper? Let's explore how our [Multi-Agent System (MAS)](/supersonic-documentation/under-the-hood/multi-agent-system.md) makes the magic happen!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://supersonic-ai.gitbook.io/supersonic-documentation/under-the-hood/system-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.