> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elizaos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Operations Flow

> How DeFi operations work in the Solana plugin

## Overview

The Solana plugin processes DeFi operations through this flow:

```
User Message → Action Recognition → AI Parameter Extraction → Execution → Response
```

## Transfer Flow

### 1. User Intent

```
User: Send 1 SOL to alice.sol
```

### 2. Action Recognition

The plugin identifies transfer keywords (send, transfer, pay).

### 3. Parameter Extraction

AI extracts:

* Amount: 1
* Token: SOL
* Recipient: alice.sol (resolves to address)

### 4. Execution Steps

* Resolve .sol domain if needed
* Check balance
* Build transaction with priority fee
* Sign and send
* Wait for confirmation

### 5. Response

```
Agent: Successfully sent 1 SOL to alice.sol
Transaction: https://solscan.io/tx/[signature]
```

## Swap Flow

### 1. User Intent

```
User: Swap 10 SOL for USDC
```

### 2. Jupiter Integration

* Get quote from Jupiter API
* Calculate output amount
* Check price impact

### 3. Execution

* Build swap transaction
* Add priority fees
* Execute and monitor

### 4. Special Cases

* "Swap all" - calculates max balance
* Custom slippage - applies user preference
* Route selection - optimizes for best price

## Portfolio Flow

### 1. User Request

```
User: What's my portfolio worth?
```

### 2. Data Aggregation

* Fetch SOL balance
* Get SPL token balances
* Query prices from Birdeye API

### 3. Response Format

```
Total Value: $X,XXX.XX (XX.XX SOL)

Token Balances:
SOL: 10.5 ($850.50)
USDC: 250.25 ($250.25)
BONK: 1,000,000 ($45.20)
```

## Key Features

### Real-Time Updates

* WebSocket subscriptions for balance changes
* Automatic portfolio refresh every 2 minutes
* Instant transaction notifications

### Smart Token Resolution

* Common symbols (USDC, USDT, BONK) auto-resolved
* .sol domain support
* Token metadata caching

### Transaction Optimization

* Priority fees for faster confirmation
* Compute unit optimization
* Automatic retry on failure

## Error Handling

### Common Errors

* **Insufficient Balance**: Pre-checks prevent failed transactions
* **Token Not Found**: Clear error messages for unknown tokens
* **Network Issues**: Automatic retry with backoff
* **High Slippage**: Warns before executing

### Safety Features

1. Balance validation before execution
2. Address verification
3. Slippage protection
4. Transaction simulation when possible