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

# Capabilities

> ILLA aggregates financial operations into a unified execution surface across chains, protocols, and asset types.

ILLA aggregates financial operations into a unified execution surface.

Instead of integrating with individual protocols directly, AI systems connect to ILLA and gain access to a growing set of financial capabilities across chains, protocols, and asset types.

Every capability flows through the same core pipeline:

* **[Intelligence](/illa/intelligence)** resolves the intent.
* **[Safety](/illa/safety-and-security)** simulates, verifies, and enforces policies.
* **[Engine](/illa/engine)** executes.

This means every new integration automatically inherits ILLA's full safety stack.

## Intent to execution

The power of ILLA's capability surface is composition. The intelligence layer takes a single intent and decomposes it into a coordinated, multi-step, multi-chain plan across multiple capabilities.

**Treasury operations.**

```
Pull enough from our earning balance to cover today's invoices,
consolidate to USDC, and pay each one on the required network.
```

<Steps>
  <Step title="Query">Queries portfolio balances and DeFi positions, calculates the required withdrawal amount</Step>
  <Step title="Withdraw">Withdraws from lending protocol</Step>
  <Step title="Swap">Swaps withdrawn assets to USDC</Step>
  <Step title="Bridge">Bridges to each recipient's network</Step>
  <Step title="Transfer">Executes individual transfers</Step>
</Steps>

**Take profit and redeploy.**

```
Sell half my ETH, put $800 into yield, and use the rest to bet
on the Fed holding rates.
```

<Steps>
  <Step title="Query">Queries balances, calculates 50% of ETH holdings</Step>
  <Step title="Swap">Executes swap to USDC</Step>
  <Step title="Supply">Calculates split, supplies the majority to lending protocol for yield</Step>
  <Step title="Bridge">Bridges remainder to prediction market network</Step>
  <Step title="Position">Resolves target market by natural language, places position</Step>
</Steps>

**Portfolio rebalance.**

```
Rebalance to 60% stablecoins in yield and 40% ETH, using the
best rates across chains.
```

<Steps>
  <Step title="Query">Queries full portfolio and existing positions</Step>
  <Step title="Calculate">Calculates target allocations against current holdings</Step>
  <Step title="Rebalance">Withdraws from existing lending positions, executes swaps to reach target ratios</Step>
  <Step title="Compare">Queries yield rates across chains and protocols</Step>
  <Step title="Supply">Supplies stablecoins to highest-yield protocol on optimal network</Step>
</Steps>

Each example is a single intent, multiple capability groups, multiple chains, one coordinated plan. The user sees the full plan, approves it once, and signs each transaction.

## Capability reference

What ILLA can execute today, and what's coming next.

### Transfers and payments

Move value between addresses, across chains, and between networks.

| Capability         | Description                                         |
| ------------------ | --------------------------------------------------- |
| Token Transfer     | Send any supported asset to any address             |
| Cross-Chain Bridge | Move assets between networks via aggregated routing |

Cross-chain bridging selects the optimal bridge path based on cost, speed, and liquidity.

### Trading

Exchange assets at the best available rate across aggregated liquidity.

| Capability | Description                                                                                                       |
| ---------- | ----------------------------------------------------------------------------------------------------------------- |
| Token Swap | Exchange any token for another. Same-chain or cross-chain. Supports batched multi-swap execution in a single plan |

Swaps route through aggregated DEX liquidity by default. Integrators can restrict routing to specific providers or pools.

### DeFi lending and yield

Supply assets to earn yield and manage positions across lending protocols.

| Capability | Description                                         |
| ---------- | --------------------------------------------------- |
| Supply     | Deposit assets into lending protocols to earn yield |
| Withdraw   | Retrieve supplied assets and accrued yield          |

When protocol is not specified, ILLA routes to the optimal provider based on yield, risk, and integrator preference.

### Prediction markets

Take positions on real-world events through decentralised prediction markets.

| Capability      | Description                                           |
| --------------- | ----------------------------------------------------- |
| Market Search   | Find markets and odds by topic using natural language |
| Buy Outcome     | Purchase outcome shares in an active market           |
| Sell Position   | Exit an existing position                             |
| Redeem Winnings | Claim returns from resolved markets                   |

Users describe the position they want to enter, and ILLA resolves the intent to the correct market and outcome.

### Perpetual futures

Open and manage leveraged long and short positions on perpetual markets.

| Capability            | Description                                        |
| --------------------- | -------------------------------------------------- |
| Open Position         | Open a leveraged long or short                     |
| Close Position        | Exit an open position, fully or partially          |
| Set Leverage          | Set or adjust leverage on a position               |
| Stop and Limit Orders | Set stop-loss, take-profit, and limit entry orders |

Users describe the position they want, and ILLA resolves the intent to the correct market, side, and size.

### Portfolio and positions

Query balances, positions, and portfolio state across chains and protocols.

| Capability             | Description                                       |
| ---------------------- | ------------------------------------------------- |
| Portfolio Balances     | View asset balances across all supported networks |
| DeFi Positions         | Query active lending and yield positions          |
| Supported Tokens       | Retrieve available tokens per network             |
| Supported Capabilities | Discover what ILLA can execute                    |

Read-only capabilities execute automatically without user approval. They feed context into the planning layer, enabling intents like "withdraw enough from my earning balance to cover today's invoices" where the system needs to know current balances to construct the plan.

### Market intelligence

Access real-time pricing, yield data, and market information.

| Capability        | Description                                         |
| ----------------- | --------------------------------------------------- |
| Token Prices      | Current and historical asset pricing                |
| DeFi Market Rates | Yield rates and lending conditions across protocols |
| Market Details    | Odds, volume, and status for prediction markets     |

Market intelligence capabilities are read-only and auto-executable. They inform both user queries and the planning layer's decision-making.

### Expansion

ILLA's capability set is expanding continuously. The integration pattern is repeatable: define capability mappings, implement protocol adapters, vet for security and reliability, and activate.

Capabilities in development include: fiat gateway (on-ramp and off-ramp between fiat and digital assets, fiat-to-fiat transfers via traditional rails) and tokenised equities (tokenised exposure to traditional equity markets).

As new asset types and financial products come online, ILLA integrates them.

### Supported networks

ILLA operates across multiple EVM-compatible networks. Capabilities are not chain-specific. A user can express intent without specifying a chain, and ILLA resolves the optimal execution path.

| Network   | Type |
| --------- | ---- |
| Ethereum  | L1   |
| Base      | L2   |
| Optimism  | L2   |
| Arbitrum  | L2   |
| Polygon   | L1   |
| Avalanche | L1   |
| BSC       | L1   |

Cross-chain operations are handled as coordinated multi-step plans. The user sees the full sequence and approves it as a single intent. The Engine handles cross-chain coordination underneath.

### Adding capabilities

Every new integration follows the same process. The protocol is evaluated for reliability and security. Capability mappings are defined. Protocol adapters are implemented and tested against ILLA's evaluation pipeline. The integration is activated and immediately inherits the full safety stack: simulation, verification, policy enforcement, and approval flows.

Integrators can scope their ILLA instance to specific capabilities, protocols, chains, or asset types. By default, ILLA routes through the full set of integrated protocols for optimal execution. These preferences are defined at the integration level and enforced by the Engine.
