Blaickrock AI Trading Agent

An AI-powered autonomous crypto trading agent operating on the Abstract blockchain. Manages a portfolio through three coordinated AI agents that analyze markets, execute trades, and share results on Twitter.

Architecture

Three-Agent System

**1. Researcher Agent** (`src/index.ts`)

**2. Executor Agent** (`src/index.ts`)

**3. Twitter Agent** (`src/index.ts`)

Key Components

**Entry Points:**

**Agent Prompts:**

**Tools Architecture:**

**Core Libraries:**

Data Flow

1. **Research Phase:** Researcher fetches portfolio state via abstract-user tools and market data via oracle tools

2. **Decision Phase:** Generates trade decision based on comprehensive analysis

3. **Execution Phase:** Executor receives decision and executes via execute-swap tool if viable

4. **Social Phase:** Twitter agent posts results with transaction links

5. **Monitoring Phase:** Separate process monitors Twitter mentions for user interactions

Setup Instructions

Install Dependencies

```bash

pnpm install

```

Environment Configuration

Create a `.env` file based on `.env.example` with required variables:

Build and Run

**Development mode:**

```bash

pnpm run dev

```

**Production build:**

```bash

pnpm run build

pnpm run start

```

**Check Twitter mentions:**

```bash

pnpm run check-mentions

```

**Run autonomous scheduler:**

```bash

pnpm run scheduler

```

**Run as background daemon:**

```bash

pnpm run daemon

```

Technology Stack

Important Notes

File Structure

```

src/

├── index.ts # Main agent orchestration

├── check-and-reply.ts # Twitter mention handler

├── scheduler.ts # Autonomous scheduler

├── prompt/ # AI agent prompts

│ ├── prompts.ts

│ ├── executorPrompts.ts

│ └── twitterPrompts.ts

├── tools/ # Agent tools

│ ├── all-tools.ts # Tool registry

│ ├── execute-swap.ts # Trading execution

│ ├── abstract-oracle/ # Market data

│ ├── abstract-user/ # Portfolio analysis

│ └── twitter/ # Social integration

├── lib/ # Core utilities

└── const/ # Constants and addresses

```

Usage

When working with this codebase:

1. Always run `pnpm install` first to ensure dependencies are up to date

2. Use `pnpm run dev` during development for hot reloading

3. Test changes with `pnpm run build && pnpm run start` before deploying

4. Monitor Twitter interactions with `pnpm run check-mentions`

5. Enable autonomous operation with `pnpm run daemon`

Constraints