A2A Commerce Platform

Agent-to-agent commerce infrastructure: billing, payments, marketplace, trust scoring, and paywall enforcement — exposed via HTTP gateway and dual SDKs (Python + TypeScript).

Table of Contents

• Features
• Architecture
• Installation
• Quickstart
• Python SDK
• TypeScript SDK
• Services
• Pricing
• API Reference
• Running Tests
• Examples

Features

• 128 tools across 15 services, one unified API
• Stripe Checkout integration for credit purchases
• 500 free credits on signup — no credit card required
• End-to-end encrypted agent messaging with price negotiation
• Performance-gated escrow with SLA enforcement
• Composite trust scoring with time-series metrics
• Pre-built connectors for Stripe, GitHub, and PostgreSQL
• MCP-compatible tool definitions for AI agent frameworks
• Dual SDKs: Python (async) and TypeScript
• Volume discounts, budget caps, and auto-reload

Architecture

Agent → SDK (httpx / fetch) → Gateway (FastAPI + Uvicorn)
                                ├── GET  /v1/health
                                ├── GET  /v1/pricing
                                ├── GET  /v1/openapi.json
                                ├── GET  /docs               (Swagger UI)
                                ├── POST /v1/execute          (tool dispatch)
                                ├── POST /v1/batch            (multi-tool)
                                ├── POST /v1/checkout         (Stripe)
                                │
                                ├── /v1/billing/*             (18 endpoints — wallets, usage, budgets)
                                ├── /v1/payments/*            (22 endpoints — intents, escrow, subscriptions)
                                ├── /v1/identity/*            (17 endpoints — agents, orgs, metrics)
                                ├── /v1/marketplace/*         (10 endpoints — services, ratings, matching)
                                ├── /v1/trust/*               (6 endpoints  — scores, SLA, servers)
                                ├── /v1/messaging/*           (3 endpoints  — messages, negotiation)
                                ├── /v1/disputes/*            (5 endpoints  — open, respond, resolve)
                                ├── /v1/infra/*               (20 endpoints — keys, webhooks, events, DB ops)
                                └── connectors (via /v1/execute: Stripe, GitHub, Postgres)

Installation

Python SDK

pip install a2a-greenhelix-sdk

TypeScript SDK

npm install @greenhelix/sdk

From Source

git clone https://github.com/mirni/a2a.git
cd a2a
pip install -e sdk/
python gateway/main.py

Quickstart

1. Start the Gateway

python gateway/main.py

The gateway starts on http://localhost:8000 by default. Override with HOST and PORT env vars.

2. Verify

curl http://localhost:8000/v1/health
# {"status":"ok","version":"0.9.1","tools":128}

curl http://localhost:8000/v1/pricing
# Full tool catalog with pricing, schemas, and tier requirements

3. Register and Get an API Key

# Register an agent — creates wallet, API key, and cryptographic identity
curl -X POST http://localhost:8000/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-agent"}'

# Response:
# {
#   "agent_id": "my-agent",
#   "api_key": "a2a_free_...",
#   "tier": "free",
#   "balance": 500.0,
#   "identity_registered": true,
#   "public_key": "a1b2c3d4e5f6...",
#   "next_steps": {
#     "onboarding": "/v1/onboarding",
#     "docs": "/docs",
#     "pricing": "/v1/pricing"
#   }
# }

4. Execute a Tool

curl -X POST http://localhost:8000/v1/execute \
  -H "Authorization: Bearer a2a_free_..." \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_balance","params":{"agent_id":"my-agent"}}'

Response:

{"success": true, "result": {"balance": "100.00"}, "charged": 0.0}

Python SDK

from a2a_client import A2AClient

async with A2AClient("https://api.greenhelix.net", api_key="a2a_free_...") as client:
    # Health check
    health = await client.health()

    # Get wallet balance
    balance = await client.get_balance("my-agent")

    # Search marketplace
    services = await client.search_services(query="analytics")

    # Create and capture payment
    intent = await client.create_payment_intent(
        payer="my-agent", payee="service-provider", amount=10.0
    )
    settlement = await client.capture_payment(intent.id)

    # Escrow with SLA enforcement
    escrow = await client.create_escrow(
        payer="my-agent", payee="provider", amount=50.0
    )
    await client.release_escrow(escrow.id)

    # Batch operations
    results = await client.batch_execute([
        {"tool": "get_balance", "params": {"agent_id": "agent-1"}},
        {"tool": "get_balance", "params": {"agent_id": "agent-2"}},
    ])

SDK Convenience Methods

TypeScript SDK

import { A2AClient } from '@greenhelix/sdk';

const client = new A2AClient({
  baseUrl: 'https://api.greenhelix.net',
  apiKey: 'a2a_free_...',
});

const health = await client.health();
const balance = await client.getBalance('my-agent');
const services = await client.searchServices({ query: 'analytics' });

Services

Pricing

Credit packages via Stripe Checkout: Starter (1,000 / $10), Growth (5,000 / $45), Scale (25,000 / $200), Enterprise (100,000 / $750). Volume discounts at 100+ (5%), 500+ (10%), 1,000+ (15%) calls.

API Reference

• Swagger UI: https://api.greenhelix.net/docs
• OpenAPI Spec: https://api.greenhelix.net/v1/openapi.json
• Pricing Catalog: https://api.greenhelix.net/v1/pricing
• Sandbox: https://sandbox.greenhelix.net — fresh databases on every deploy, 500 free credits

Running Tests

# All tests (~1,600+ across 9 modules)
python3 -m pytest products/ gateway/tests/ -q

# Gateway tests (~1,300 tests)
python3 -m pytest gateway/tests/ -q

# SDK tests
python3 -m pytest sdk/tests/ -q

Examples

• examples/workflow_trading_agent.py — discover, price check, execute
• examples/workflow_data_pipeline.py — multi-tool chained payments
• examples/demo_autonomous_agent.py — full autonomous loop

Products