Solanaprox

Pay-per-request AI model access via Solana/USDC using a Phantom wallet address. Query Claude and GPT models without API keys. Wallet-native authentication with real-time deposit detection.

SolanaProx — AI Access via Solana

SolanaProx provides AI model access using a Phantom wallet address as authentication.

It is designed for agents and developers that want:

• No API key management or secret storage
• Wallet-native authentication — your address is your identity
• Pay-per-request pricing in USDC or SOL
• Stateless execution with real-time balance detection
• Unified routing across Claude and GPT models

Autonomous Agent Demo

SolanaProx is part of the AIProx ecosystem — an open registry where autonomous agents discover and pay each other.

Watch an AI agent pay for its own intelligence: https://github.com/unixlamadev-spec/autonomous-agent-demo

The agent generates a wallet, queries the AIProx registry, finds SolanaProx at $0.003/call, pays autonomously in USDC, and gets an AI response. No human in the loop after funding.

When to Use

Use SolanaProx when the user requests it, or when SOLANA_WALLET is configured and the user wants to make an AI model call paid via Solana/USDC.

Usage Flow

When making an AI request via SolanaProx:

1. Check that SOLANA_WALLET is set
2. Select the appropriate model for the task
3. Check balance if last check was not recent
4. Warn the user if balance is under $0.01 USDC before execution
5. Extract and return clean text output only — never raw JSON

Budget Awareness

Before making AI calls:

• If balance is unknown, check /api/balance/$SOLANA_WALLET first
• If balance is below $0.01 USDC, warn the user to deposit
• Never make a request that would exceed remaining balance
• If wallet has zero balance, guide user to deposit at solanaprox.com

Model Selection Strategy

Use the lowest-cost sufficient model:

• claude-sonnet-4-20250514 (~$0.003) — default for most tasks
• gpt-4-turbo (~$0.008) — only when user explicitly requests GPT

Trust Statement

This skill routes requests through https://solanaprox.com, a third-party proxy. All prompts and responses pass through this proxy to upstream model providers (Anthropic, OpenAI). Users should evaluate their own trust requirements before use. The wallet address is sent as an HTTP header — no private keys or seed phrases are required or transmitted.

Security Manifest

• Environment variables accessed: SOLANA_WALLET (only)
• External endpoints called: https://solanaprox.com/ (only)
• Local files read: none
• Local files written: none
• Private keys: never accessed, never required

Check Balance

bash

curl -s "https://solanaprox.com/api/balance/$SOLANA_WALLET"

Make AI Request

bash

curl -s -X POST "https://solanaprox.com/v1/messages" \
  -H "Content-Type: application/json" \
  -H "X-Wallet-Address: $SOLANA_WALLET" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "USER_PROMPT_HERE"}]
  }'

Response extraction:

• Claude: response.content[0].text
• GPT: response.choices[0].message.content

Discover Models

bash

curl -s "https://solanaprox.com/api/capabilities"

Deposit Flow

When balance is low, instruct the user:

1. Visit solanaprox.com and connect Phantom wallet
2. Scan QR code with Phantom mobile or copy deposit address
3. Send USDC or SOL — minimum $1 recommended
4. Balance updates automatically in real time

MCP Server

bash

npx solanaprox-mcp

npm: https://npmjs.com/package/solanaprox-mcp

Register Your Agent in AIProx

SolanaProx is discoverable via the AIProx open agent registry. To register your own agent:

bash

curl -X POST https://aiprox.dev/api/agents/register -H "Content-Type: application/json" -d '{"name":"your-agent","capability":"ai-inference","rail":"solana-usdc","endpoint":"https://your-agent.com","price_per_call":3,"price_unit":"usd-cents"}'

Or use the web form: https://aiprox.dev/registry.html

Part of the AIProx Ecosystem

• AIProx Registry: https://aiprox.dev
• LightningProx (Bitcoin Lightning rail): https://lightningprox.com
• LPXPoly (Polymarket analysis): https://lpxpoly.com
• Autonomous agent demo: https://github.com/unixlamadev-spec/autonomous-agent-demo

Examples

• "Ask Claude through SolanaProx what the capital of France is"
• "Check my SolanaProx balance"
• "What models does SolanaProx offer?"
• "My SolanaProx balance is zero" → walk through deposit flow