# .solana

> **Solana-Native AI Configuration Directory**
> A new breed of configuration — born on Solana, living on Solana, verifiable on Solana.
> Every Clawd spawn carries its `.solana` directory at birth. This is the onchain configuration layer.

---

## What .solana Is

`.solana` is the Solana-native equivalent of configuration directories like `.claude`, `.agents`, `.cursor`, or `.vscode` — but built from the ground up for autonomous AI agents operating on Solana. It is not a passive config directory. It is an active, verifiable, onchain-attested configuration layer.

Where `.claude` holds agent harness settings and `.agents` holds agent manifests, `.solana` holds:
- **Wallet configuration** — keypair paths, RPC endpoints, priority fee settings
- **Onchain identity** — SAS attestations, MPL Core asset references, DIDs
- **Program-derived addresses (PDAs)** — verified program addresses for all integrated protocols
- **Token verification** — Helius DAS API configuration, token metadata, verified mint lists
- **Transaction configuration** — compute budget defaults, slippage settings, simulation flags
- **Agent governance** — onchain proposal links, voting records, DAO membership proofs
- **Deployment manifests** — per-network deployment configs (mainnet, devnet, localnet)
- **Audit trail** — immutable log of every configuration change, signed by the agent's keypair

## Directory Structure

```
.solana/
├── README.md              # This file
├── config.json             # Master configuration (RPC, keypair path, network)
├── wallets/                # Keypair references (NEVER store raw keys here)
│   ├── agent.json          # Agent's primary keypair config
│   └── treasury.json       # Treasury/multisig keypair config
├── pda/                    # Verified Program-Derived Addresses
│   ├── vulcan.json         # Vulcan/Phantom DEX PDAs
│   ├── clawdpump.json      # ClawdPump program PDAs
│   ├── dflow.json          # DFlow trading platform PDAs
│   └── token-extensions.json # Token-2022 extension addresses
├── tokens/                 # Token verification configs
│   ├── clawd.json          # $CLAWD token config
│   ├── usdc.json           # USDC on Solana config
│   └── verified-mints.json  # Trusted token mint list
├── network/                # Network-specific configurations
│   ├── mainnet.json        # Mainnet-beta production config
│   ├── devnet.json         # Devnet development config
│   └── localnet.json       # Local validator config
├── governance/             # Onchain governance proofs
│   ├── dao-memberships.json # DAO membership verification data
│   └── proposals.json      # Active and historical governance proposals
├── attestations/           # SAS and identity attestations
│   ├── identity.json       # Agent identity attestation
│   └── spawn.json          # Spawn verification attestation
├── compute/                # Compute budget and priority fee configs
│   └── defaults.json       # Default compute budget settings
├── deploy/                 # Deployment manifests
│   ├── vercel.json         # Vercel deployment config
│   ├── fly.json            # Fly.io deployment config
│   ├── vertex.json         # Vertex AI Reasoning Engine config
│   └── railway.json        # Railway deployment config
├── audit/                  # Configuration audit trail
│   └── changelog.jsonl     # Immutable, signed changelog
└── .gitignore              # Git exclusion rules for .solana directory
```

## Master Configuration (`config.json`)

```json
{
  "agent": {
    "name": "Clawd",
    "version": "1.0.0",
    "spawnId": "clawd-genesis-001",
    "creatorAddress": "SOLANA_ADDRESS_HERE"
  },
  "network": "mainnet-beta",
  "rpc": {
    "primary": "https://mainnet.helius-rpc.com/?api-key=$HELIUS_API_KEY",
    "fallback": "https://api.mainnet-beta.solana.com",
    "websocket": "wss://mainnet.helius-rpc.com/?api-key=$HELIUS_API_KEY"
  },
  "wallet": {
    "keypairPath": "~/.config/solana/id.json",
    "keypairEnv": "SOLANA_KEYPAIR",
    "requireHardwareWallet": false
  },
  "priorityFee": {
    "mode": "dynamic",
    "maxMicroLamports": 50000,
    "dynamicPercentile": 75
  },
  "computeUnits": {
    "default": 200000,
    "max": 1400000
  },
  "slippage": {
    "defaultBps": 100,
    "maxBps": 1000
  },
  "simulation": {
    "required": true,
    "skipOnDevnet": false
  },
  "tokenGate": {
    "requiredToken": "$CLAWD",
    "minBalance": 1000,
    "tierMultiplier": {
      "1000": 1,
      "10000": 0.75,
      "100000": 0.5
    }
  },
  "attestation": {
    "enabled": true,
    "provider": "SAS",
    "refreshIntervalHours": 24
  }
}
```

## The .solana Birthright

Every Clawd spawn inherits `.solana` byte-for-byte from its parent. The hash of `config.json` is recorded at spawn time in the spawnling's SAS attestation. If the configuration changes, the change is signed, logged to `audit/changelog.jsonl`, and verifiable on-chain.

This is the Solana-native AI configuration primitive — a new breed of directory for a new breed of entity.

---

🦞 *Born on Solana. Living on Solana. Verifiable on Solana.*