Eliza Mode Example

with GOAT 🐐

This fork is a simplified example of Eliza focused on executing transactions onchain on Mode using GOAT. It's designed specifically for Mode, focusing on agents that handle complex onchain tasks. By using GOAT for all onchain functionality, this version removes unnecessary plugins for other blockchains and introduces a simpler character to start with that is tailored to doing actions on Mode.

Onchain actions: Mint NFTs, check the latest trending tokens, purchase, trade them, and much more.

Tech stack:

• Eliza - The AI agent framework
• GOAT - The open-source framework for connecting AI agents to any onchain app
• Mode - The L2

Support

• Discord

Running the project

Requirements

• Node.js 23.3.0+

Set up

1. Clone the repository

git clone https://github.com/goat-sdk/eliza-mode-example.git

2. Go into the project directory

cd eliza-mode-example

3. Install the dependencies

pnpm install

4. Run pnpm build

5. Copy the .env.example file to .env:

cp .env.example .env

6. Get an OpenAI API key and fill in the OPENAI_API_KEY in the .env file

Giving the agent a wallet

1. This example uses a key pair wallet to connect to Mode. Save the key and fill in the following in the .env file:
   • EVM_PRIVATE_KEY=your_private_key
   • EVM_PROVIDER_URL=https://mainnet.mode.network/ (more on Mode RPCs here)

Running the agent

1. You can now run the agent with the command pnpm start --character="characters/mode-hacker.character.json"
2. In a different terminal run pnpm start:client to start the chat interface
3. Go to http://localhost:5173 to chat with your agent

Configuring the project

The character

• You can see the definition of your character in the characters/mode-hacker.character.json file.
• This project gives you a simple example character to get you started. This allows you to easily add onchain actions and test them out while increasing the complexity of your agent step by step. Keep adding and modifying the bio and tone of the character to make it your own.

Eliza

• This is an Eliza fork so you can do pretty much everything you can do with Eliza. Check out the Eliza docs for more information on how to integrate your agent with Twitter, Discord, etc.

Onchain actions with GOAT

• The Crossmint plugin (packages/plugin-crossmint) uses GOAT to add all onchain functionality to the agent. Within the index.ts file of the plugin you can add any GOAT plugins you need or even create your own. Check out the GOAT docs for more information.

const actions = await getOnChainActions({
        wallet: walletClient,
        // Add plugins here based on what actions you want to use
        // See all available plugins at https://ohmygoat.dev/chains-wallets-plugins#plugins
        plugins: [
            // Add you EVM / Mode plugins here
            // coingecko({
            //  apiKey: getSetting("COINGECKO_API_KEY")
            // })
        ],
    });

Tips for troubleshooting

1. When making changes to any package (e.g the Crossmint plugin), remember to run pnpm build to update the project.
2. To see why the agent is making a certain decision, add console logs to see the prompts and responses that it is getting on every interaction. For example. if you are using the direct client that would be here.
3. You can also copy the agent prompts that you log and play with them in ChatGPT to see how you could improve them.