> 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/for-developers/elizaos-plugin.md).

# ElizaOS Plugin

## ElizaOS Plugin

Let's talk about the ElizaOS Plugin - the magic that powers your DeFi automation on Sonic. Think of it as the bridge that connects your SuperSonic agents to all the cool stuff happening on the Sonic blockchain. Whether you're swapping tokens, checking your portfolio, or working with Beets DEX and Silo Finance, this plugin makes it all happen smoothly.

### What Can It Do? 🎯

#### Core Actions 🛠️

* **Token Stuff:**
  * Send native S tokens and ERC20s around
  * Keep an eye on your portfolio and balances
  * Handle complex operations on Beets DEX
  * Manage your staking and rewards on Beets Liquid Staking
  * Take care of lending and borrowing on Silo Finance

#### Smart Connections 🔌

* **Wallet Provider:**
  * Manages your Sonic wallet like a pro
  * Figures out the best gas prices
  * Keeps your transactions running smooth
* **Market Data:**
  * **CoinGecko:** Brings you fresh price data, market history, and all the metrics you need
  * **DefiLlama:** Keeps you updated on TVL and protocol performance

### Why It's Awesome 🌟

The ElizaOS Plugin is all about making your life easier. It handles all the complex stuff behind the scenes so you can focus on your strategy. Your SuperSonic agents can:

* Execute operations quickly and safely
* Get real-time, accurate market data
* Work with multiple protocols without breaking a sweat

### Getting Started 🚀

1. **Installation** 📦\
   Good news - if you've cloned the SuperSonic repo and installed the dependencies, you're already set! The plugin comes as part of our core packages.
2. **Setup** ⚙️\
   Just update your `.env` file with your API keys (like OPENAI\_API\_KEY and any provider-specific ones) and your Sonic network details. That's it!
3. **Using It** 🎮\
   The plugin works quietly in the background. When your agents need to do something (like transfer tokens), the plugin handles all the technical stuff automatically.
4. **Make It Your Own** 🎨\
   Want to add your own features? The plugin's modular design means you can easily extend it to do more stuff - whether that's adding new actions or connecting to more data sources.

### The Big Picture 🖼️

Think of the ElizaOS Plugin as your agents' trusty sidekick. It's the one doing all the heavy lifting - from talking to smart contracts to grabbing the latest market data - so your agents can focus on making smart decisions.

Want to dig deeper? Check out our full [plugin documentation](#elizaos-plugin) to see everything it can do.

Happy automating! 🚀


---

# 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/for-developers/elizaos-plugin.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.
