Solana Payments (x402)

Pay for API calls with USDC on Solana mainnet. The SDK uses the same x402 protocol as Base chain — only the key format changes.

Installation

# Standard (EVM / Base chain support only)
pip install jarvisclaw

# With Solana support
pip install jarvisclaw[solana]

Automatic chain detection

How the SDK picks the chain

• 0x... — EVM hex key → Base chain (Chain ID 8453), USDC ERC-20
• bs58 — Solana keypair → Solana mainnet, USDC SPL

No config flag needed — pass the key and the SDK does the rest.

Solana requirements

• A Solana wallet with USDC (SPL) on mainnet
• Export the full keypair (not just the public key) from Phantom or Solflare
• The exported key will be a base58-encoded string

Initialization

Pass your Solana keypair string as private_key — the SDK detects Solana automatically.

Python

from jarvisclaw import ChatClient, ImageClient

# EVM wallet — hex private key (0x...) → Base chain (Chain ID 8453)
chat = ChatClient(private_key="0x<evm-wallet-private-key>")

# Solana wallet — bs58-encoded keypair → Solana mainnet
# SDK auto-detects: if key is base58 and not hex, it uses Solana
chat = ChatClient(private_key="<base58-solana-keypair>")

# Explicit network selection
chat = ChatClient(private_key="<key>", network="solana")

Go

import jarvisclaw "github.com/api-jarvisclaw/go-sdk"

// EVM wallet — hex private key (0x...) → Base chain
client, _ := jarvisclaw.NewChatClient(jarvisclaw.WithPrivateKey("0x<evm-private-key>"))

// Solana wallet — bs58-encoded keypair → Solana mainnet
// SDK auto-detects chain from key format
client, _ := jarvisclaw.NewChatClient(jarvisclaw.WithPrivateKey("<base58-solana-keypair>"))

Full example

All client types work with Solana — chat, image, video, audio. Only the payment layer changes.

Python

# pip install jarvisclaw[solana]
from jarvisclaw import ChatClient, ImageClient, VideoClient

# Pass your Solana bs58 keypair — SDK detects Solana automatically
chat = ChatClient(private_key="<base58-solana-keypair>")
image = ImageClient(private_key="<base58-solana-keypair>")

# All endpoints work exactly the same — only the payment chain changes
response = chat.complete("Hello from Solana!")
print(response)

# Image generation — paid via Solana USDC (SPL)
img = image.generate("A cyberpunk city at dusk")
print(img.url)

# Check wallet address (shows Solana pubkey)
print(f"Solana wallet: {chat.address}")

Go

package main

import (
    "context"
    "fmt"
    jarvisclaw "github.com/api-jarvisclaw/go-sdk"
)

func main() {
    ctx := context.Background()

    // Pass your Solana bs58 keypair — SDK detects Solana automatically
    chat, _ := jarvisclaw.NewChatClient(
        jarvisclaw.WithPrivateKey("<base58-solana-keypair>"),
    )

    // All endpoints work exactly the same — only the payment chain changes
    text, _ := chat.Complete(ctx, "Hello from Solana!")
    fmt.Println(text)

    // Image generation — paid via Solana USDC (SPL)
    imgClient, _ := jarvisclaw.NewImageClient(
        jarvisclaw.WithPrivateKey("<base58-solana-keypair>"),
    )
    img, _ := imgClient.Generate(ctx, "A cyberpunk city at dusk")
    fmt.Println(img.URL)

    // Check wallet address (shows Solana pubkey)
    fmt.Printf("Solana wallet: %s\n", chat.Address())
}

Note: Rust toolchain

The solders library (Solana keypair signing) requires a Rust compiler during pip install. On most systems this is installed automatically. If the install fails, run: curl --proto "=https" --tlsv1.2 -sSf https://sh.rustup.rs | sh

Chain comparison

Property	Base	Solana
Key format	0x... (hex)	base58 keypair
USDC type	ERC-20	SPL
Confirmation time	~2s	~0.4s
Install command	pip install jarvisclaw[agent]	pip install jarvisclaw[solana]