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

Add to your 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 (5 providers, 26 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

command: node /path/to/sdks/mcp/dist/index.js

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 ./...)

```

Quick reference

• You're a developer using Solvela's hosted gateway at api.solvela.ai → no license obligations on you, just use it.
• You're self-hosting the gateway internally for your own product → free under the Additional Use Grant if your gross annual revenue attributable to the gateway is under USD $1M.
• You're building a competing managed gateway service from this code → you need a commercial license. Contact partnerships@solvela.ai.
• Your annual revenue derived from the gateway will exceed USD $1M → you need a commercial license. Contact partnerships@solvela.ai.
• You're embedding the SDK or building on top of the protocol/router crates → standard Apache-2.0 obligations apply (preserve copyright/NOTICE attribution, state significant changes, no warranty). You receive an explicit patent grant. No payment to Solvela required.

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.

---