# Solder — Full Documentation

> Cross-domain intelligence for Solana. Bridging DeFi and prediction markets through unified wallet intelligence. Know who's informed before you trade.

## Overview

Solder is a cross-domain on-chain intelligence platform for Solana. It unifies wallet activity across DeFi protocols and prediction markets into a single conviction score.

On-chain intelligence is fragmented today. DeFi analytics know nothing about prediction markets. Polymarket watchers miss DEX signals. Traders with edge operate across domains invisibly. Solder solves this by bridging these domains.

When a wallet is bullish on SOL via Jupiter and also betting "SOL > $200" on a prediction market, that's a cross-domain signal. Solder surfaces it.

## The Problem

1. **Blind Spots**: Existing tools analyze one domain at a time, missing cross-domain alpha signals.
2. **Hidden Edge**: Informed traders bet across DeFi and prediction markets — their conviction is invisible to single-domain tools.
3. **AI Gap**: AI agents lack unified on-chain intelligence APIs to make informed decisions.

## The Conviction Engine

Solder unifies wallet activity across DeFi and prediction markets into a single conviction score. Key capabilities:

- Cross-domain wallet analysis
- Real-time conviction scoring
- Informed trader detection
- MCP-native for AI agents

The engine processes data from DeFi activity and prediction markets through Solder, producing actionable intelligence output.

## Features

### Conviction Scoring
Quantified conviction signals from -1 (max bearish) to +1 (max bullish), weighted by position size and cross-domain confirmation.

### Informed Trader Detection
Identify wallets with historical edge. Track their moves across domains before they hit your radar.

### MCP Tools for AI Agents
Native Model Context Protocol integration. Your AI agent can query wallet intelligence as easily as it reads a database.

### Real-Time Indexing
Live transaction processing from Solana. See conviction shifts as they happen, not hours later.

## MCP Tools (Model Context Protocol)

Solder exposes MCP tools for AI agent integration (coming soon). Key tools include:

### get_wallet_conviction
Get unified conviction score for any wallet. Returns a score from -1 to +1 with cross-domain signal detection.

**Example usage:**
```javascript
const conviction = await cortex.getConviction({
  wallet: "7xKp...mN3q",
  domains: ["defi", "prediction"]
});

// Returns
{
  score: 0.87,
  signal: "CROSS_DOMAIN_BULLISH",
  domains: ["defi", "prediction"],
  crossDomain: true
}
```

### find_informed_traders
Discover wallets with cross-domain edge. Identifies wallets that consistently demonstrate informed trading across multiple domains.

### get_market_signals
Aggregate conviction for a token or market. Provides market-level intelligence by aggregating individual wallet conviction scores.

## Waitlist API

Solder is in pre-launch. Register for the waitlist to get early access. The API supports both human and AI agent registration.

**Endpoint**: `POST /api/waitlist`
**Content-Type**: `application/json`
**CORS**: Enabled for cross-origin agent access
**Rate Limit**: 5 requests per minute per IP

### Human Registration

```json
POST /api/waitlist
{
  "type": "human",
  "email": "you@example.com",
  "telegram": "@yourhandle"
}
```

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| type | string | yes | Must be `"human"` |
| email | string | yes | Valid email address |
| telegram | string | no | Telegram handle |

### Agent Registration (A2A Agent Card)

Register using the A2A (Agent-to-Agent) protocol. Provide your agent's base URL and we discover identity and communication details from `/.well-known/agent.json`.

```json
POST /api/waitlist
{
  "type": "agent",
  "agent_card_url": "https://my-agent.com"
}
```

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| type | string | yes | Must be `"agent"` |
| agent_card_url | string | yes | Base URL where `/.well-known/agent.json` is hosted |

### Agent Registration (Wallet-based)

Register using a Solana wallet address as identity, with an optional webhook for notifications.

```json
POST /api/waitlist
{
  "type": "agent",
  "wallet_address": "7xKp...mN3q",
  "webhook_url": "https://my-agent.com/hooks/solder",
  "agent_id": "my-agent-v1"
}
```

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| type | string | yes | Must be `"agent"` |
| wallet_address | string | conditional | Solana wallet address (required if no webhook_url) |
| webhook_url | string | conditional | Notification endpoint (required if no wallet_address) |
| agent_id | string | no | Human-readable agent identifier |

### Response Codes

| Status | Meaning | Body |
|--------|---------|------|
| 200 | Success | `{ "message": "You're on the list!" }` |
| 400 | Validation error | `{ "error": "description" }` |
| 409 | Duplicate entry | `{ "message": "You're already on the list!", "duplicate": true }` |
| 429 | Rate limited | `{ "error": "Too many requests. Try again in a minute." }` |

## Architecture

The system follows a pipeline architecture:
1. **DeFi Activity** and **Prediction Markets** data feeds into the Solder engine
2. **Solder** processes and correlates cross-domain signals
3. **Intelligence** output is produced for consumption via API and MCP tools

## Technical Details

- **Blockchain**: Solana
- **License**: MIT
- **Protocol Integration**: Model Context Protocol (MCP)
- **Data Sources**: DeFi protocols (Jupiter, etc.) and prediction markets
- **Scoring Range**: -1 (max bearish) to +1 (max bullish)

## Contact

Visit the Solder website to learn more or access the dashboard.

- Dashboard: Available on the website
- GitHub: Source code repository
- Docs: Technical documentation