agenttrust-solagent

Solana RPC + price tooling for AI agents. Behind the AgentTrust Gateway: per-call identity, payment, and signed receipt for every agent request.

Status: public beta. Behind the AgentTrust gateway today; the direct upstream URL exists but the canonical agent-customer path goes through https://sandbox.aisthetic.services/g/solagent/<endpoint> where AgentTrust handles 401 → 402 → 200 + receipt.

Endpoints

Method	Path	Backed by	Caches
GET	/v1/balance/:address	Helius getBalance	60s
GET	/v1/token/:mint	Helius DAS getAsset	60s
GET	/v1/tx/:signature	Helius getTransaction (jsonParsed, v0)	60s
GET	/v1/price/:mint	Jupiter v2 price feed	60s
GET	/live	—	n/a

Local development

pnpm install
export HELIUS_API_KEY=<your-helius-rpc-key>
pnpm dev
# server listens on :8080
curl http://localhost:8080/live
curl http://localhost:8080/v1/price/So11111111111111111111111111111111111111112

Tests

pnpm typecheck
pnpm test

Deploy (Fly.io)

flyctl launch --no-deploy   # or use the bundled fly.toml
flyctl secrets set HELIUS_API_KEY=<key>
flyctl deploy
flyctl status
curl https://agenttrust-solagent.fly.dev/live

AgentTrust gateway integration

This server is a provider upstream for the AgentTrust gateway. The agent-customer path is:

agent
  → https://sandbox.aisthetic.services/g/solagent/price/<mint>
  → AgentTrust gateway (identity / policy / risk / payment / audit)
  → https://agenttrust-solagent.fly.dev/v1/price/<mint>
  → 200 + signed receipt id in `X-AgentTrust-Receipt-Id`

To wire the gateway:

1. Open the AgentTrust console: https://app.aisthetic.services/onboarding.
2. Start a sandbox session, create a workspace, then create a provider.
3. Create an endpoint with the upstream URL set to this Fly app's public hostname.
4. Run the three sandbox curls (401 → 402 → 200) against the gateway URL the console hands back.
5. Verify the receipt offline with pnpm proof:verify (from the AgentTrust monorepo) or via the Proof Center at https://aisthetic.services/proof-center.

Environment

Var	Required	Notes
HELIUS_API_KEY	yes for /v1/balance /v1/token /v1/tx	Helius RPC key.
HELIUS_RPC_URL	no	Default https://mainnet.helius-rpc.com.
JUPITER_PRICE_URL	no	Default https://api.jup.ag/price/v2.
LOG_LEVEL	no	Pino log level, default info.
PORT	no	Default 8080. Fly sets it automatically.
HOST	no	Default 0.0.0.0.

What this is and isn't

• Is: a small read-only Solana RPC + price proxy with 60s cache.
• Is: an honest dogfood of AgentTrust — every paid agent call produces a real Ed25519-signed receipt and a hash-chained audit entry on the gateway side.
• Isn't: a write API, a wallet, a DEX, or a custodial service.
• Isn't: a Jupiter or Helius replacement; it wraps them with caching + uniform error shape.
• Isn't: a free tier — once the AgentTrust gateway is in front, paid traffic flows on a per-call basis. Sandbox calls remain free (see the AgentTrust public sandbox docs).

License

MIT.