Solana AI 工作流

Prerequisites

• Rust (latest stable; CI builds on dtolnay/rust-toolchain@stable)
• Docker and Docker Compose (for PostgreSQL + Redis)
• At least one LLM provider API key

Build and Run

git clone https://github.com/solvela-ai/solvela.git
cd solvela
cargo build

Start backing services and configure the environment:

docker compose up -d
cp .env.example .env

Edit .env and add at least one provider API key (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.) and your Solana recipient wallet.

RUST_LOG=info cargo run -p gateway

The gateway listens on http://localhost:8402.

Build

cargo build                           # Debug build (full workspace)
cargo check                           # Faster type checking
cargo check -p gateway                # Single crate
cargo build --release                 # Release build

Deployment

Solvela is deployed on Fly.io:

```bash

Deploy (fly.toml lives at the repo root)

fly deploy -a solvela-gateway

Quick Start

Claude Code MCP config:

Configuration

Environment variables use the SOLVELA_ prefix. Provider API keys follow the standard <PROVIDER>_API_KEY convention.

Legacy: the gateway also accepts the same vars under the old RCR_* prefix with a deprecation warning. Use SOLVELA_* for new deployments.

See .env.example for the full reference. Configuration files live in config/:

• models.toml -- Model registry with per-token pricing (6 providers, 44 models)
• default.toml -- Server host/port, Solana RPC URL, monitor thresholds
• services.toml -- x402 service marketplace registry

---

SDKs

Client libraries for Python, TypeScript, and Go. Each ships wallet management, on-chain signing, response caching, session tracking, degraded response detection, and a 7-step smart chat flow. Plus framework-level packages: an MCP server (Claude Code, Cursor, Claude Desktop, OpenClaw), a Vercel AI SDK provider, an OpenClaw provider plugin, a signer-core primitives package shared across the TypeScript ecosystem, and an npm CLI shim that bundles the Rust solvela binary.

The solvela CLI includes a host-config installer that sets up the MCP server in one command:

solvela mcp install --host=claude-code    # delegates to claude mcp add (user scope)
solvela mcp install --host=cursor         # writes ~/.cursor/mcp.json with envFile
solvela mcp install --host=claude-desktop # writes platform-specific config
solvela mcp install --host=openclaw       # runs openclaw mcp set solvela ...

The installer never writes SOLANA_WALLET_KEY to disk. Store it in ~/.solvela/env (chmod 0600) or your shell profile. See the MCP server security guide for details.

API Endpoints

Enterprise org/team/budget/audit endpoints live under /v1/orgs/... and /v1/wallets/{wallet}/budget. See Enterprise docs for the full CRUD reference.

---

SDKs

SDK tests (mcp + ai-sdk-provider + openclaw-provider live in this repo)

cd sdks/mcp && npm test

In-repo SDK test suites:

Python: (cd sdks/python && pytest)

TypeScript: (cd sdks/typescript && npm test)

Go: (cd sdks/go && go test ./...)

```

Supported Models

All prices are provider cost in USDC. A 5% platform fee is applied on top. See config/models.toml for the full registry or query GET /pricing at runtime.

Free-tier data-use notice. The free profile routes to NVIDIA NIM free-tier Nemotron models (tiered by complexity), with gemini-3.1-flash-lite as a fallback if NIM is unavailable. These are served via the upstream providers' free API tiers, whose terms may permit the provider to use submitted prompts and generated responses to improve their products (and human reviewers may process them) — do not send sensitive data through the free tier. The free tier is also rate-limited and shared per gateway key, so treat it as a demo/evaluation tier rather than a model to build production load on. Paid models on this list are not subject to those free-tier data-use policies.

---