Artemis Agentic Commerce

🤖 Autonomous AI Agents • 💸 Real-Time Settlements • 🌍 ISO 20022 Integration

🚀 Live Demo • 📊 Explorer • 📖 Docs • 💬 Discord

---

Real-time dashboard for SynapticChain's Artemis agentic commerce framework

Demonstrating autonomous agent payments, ISO 20022 settlements, and cross-chain resource access in production.

🌟 Overview

Artemis is a decentralized agentic commerce framework built on SynapticChain that enables autonomous AI agents to:

• Discover & transact with resources using machine-readable pricing (pacs.008 invoices)
• Settle payments on-chain using the cTZS token (testnet stablecoin)
• Access protected resources via payment-gated APIs
• Register & earn as service providers in the agent marketplace

🎯 Why Artemis?

Feature	Traditional APIs	Artemis
Authentication	API keys, OAuth	🔐 Cryptographic signatures
Payment	Credit cards, subscriptions	⚡ Instant on-chain settlements
Pricing	Human-readable docs	📋 Machine-readable ISO 20022
Trust	Centralized platforms	🔗 Decentralized blockchain
Agent Support	Limited/manual	🤖 Native autonomous operation

---

📦 What's Inside

🎨 Frontend Next.js 16 Dashboard - Real-time visualization Artemis View - Network & settlement metrics Ecosystem View - Agent registry & flows Responsive Design - Mobile-ready UI	⚙️ Backend Python Gateway - FastAPI + CORS Resource Server - Payment-gated APIs RPC Proxy - SynapticChain integration Metrics Aggregation - Live data streams
🔧 Tools Python CLI - Agent operations Demo Scripts - End-to-end flows Contract ABIs - Smart contract interfaces	📊 Smart Contracts cTZS Token - Stablecoin settlements AgentRegistry - Identity management AgenticEscrow - Payment framework

🏗️ Architecture

System Overview

┌─────────────────────────────────────────────────────────────┐
│                   🌐 Next.js Dashboard                       │
│                   (synradix.xyz - Vercel)                   │
│  ┌──────────────────┐  ┌──────────────────┐               │
│  │ Artemis Dashboard│  │Ecosystem Dashboard│               │
│  │  - Network stats │  │  - Agent registry │               │
│  │  - Settlements   │  │  - Industry flows │               │
│  │  - Contracts     │  │  - Live metrics   │               │
│  └──────────────────┘  └──────────────────┘               │
└────────────────────┬────────────────────────────────────────┘
                     │ REST API + SSE
                     ▼
       ┌─────────────────────────────────┐
       │   ⚙️ Artemis Gateway (Python)   │
       │   - FastAPI + CORS              │
       │   - Metrics aggregation         │
       │   - Demo orchestration          │
       └─────────┬───────────────────────┘
                 │
      ┌──────────┴──────────┐
      │                     │
      ▼                     ▼
┌──────────────┐    ┌──────────────────┐
│ ⛓️ SynapticChain│    │ 🔒 Resource Server│
│   RPC Node   │    │ (payment-gated)  │
│ - Settlements│    │ - pacs.008       │
│ - Contracts  │    │ - Weather API    │
└──────────────┘    └──────────────────┘

🚀 Quick Start

Prerequisites

# Required
✓ Node.js 18+ and npm
✓ Python 3.11+
✓ Git

Installation

# 1. Clone the repository
git clone https://github.com/Synaptics-Lab/Artemis.git
cd Artemis

# 2. Install frontend dependencies
npm install

# 3. Setup Python environment
cd gateway
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cd ..

# 4. Configure environment
cp .env.example .env
# Edit .env with your API keys

Running Locally

Terminal 1: Gateway cd gateway python main.py ✅ Gateway running on http://localhost:8080

Terminal 2: Dashboard npm run dev ✅ Dashboard running on http://localhost:3000

First Steps

1. Open Dashboard: Navigate to http://localhost:3000
2. Mint Agent Key: Click "Mint Sandbox Key" in the dashboard
3. Run Demo: Click "RUN AGENT" to see an autonomous agent transaction
4. Explore API: Try curl http://localhost:8080/api/config

🎨 Key Features

🤖 Autonomous Agent Commerce

• Agents mint credentials via /api/sandbox/key
• Discover resources through /api/invoice (pacs.008 pricing)
• Submit signed payment proofs to unlock gated content
• All settlements recorded on-chain

💰 ISO 20022 Payment Messages

• pacs.008 - Customer credit transfers (agent → merchant invoices)
• Machine-readable pricing with settlement token addresses
• Merchant balance snapshots for proof-of-payment verification

📊 Real-Time Dashboards

• Artemis Dashboard: Network status, contract monitoring, transaction ledger
• Ecosystem Dashboard: Agent registry, industry-specific flows, settlement metrics

🔐 Smart Contracts

Contract	Address	Purpose
cTZS Token	syn1m89njq75czpm5vasxc0qsznyr69ylulne40fqt	Testnet stablecoin
AgentRegistry	syn1jzazxgra9lnku60ysj6qqgyjaph9a7r5uwcrcn	Agent identity
AgenticEscrow	syn1s6aag66yxdzpl5qtts06yexmddqn8cz40tgr9x	Payment framework

📁 Project Structure

artemis-agentic-commerce/
├── 🎨 app/                       # Next.js 16 app router
│   ├── api/                      # API route proxies to gateway
│   ├── ecosystem/                # Ecosystem dashboard page
│   └── page.tsx                  # Main Artemis dashboard
├── 🧩 components/
│   ├── artemis-dashboard.tsx     # Main dashboard component
│   ├── ecosystem-dashboard.tsx   # Ecosystem metrics view
│   └── ui/                       # Radix UI primitives
├── ⚙️ gateway/
│   ├── main.py                   # FastAPI gateway server
│   ├── runner.py                 # Demo orchestration
│   └── vrf.py                    # VRF proof endpoints
├── 🔒 resource-server/
│   └── server.py                 # Mock payment-gated API
├── 🛠️ cli/
│   ├── artemis_cli/              # Python CLI package
│   └── pyproject.toml
├── 📚 lib/
│   ├── api.ts                    # Frontend API client
│   └── gateway-config.ts         # Shared gateway config
└── 🌐 public/                    # Static assets

🔌 API Endpoints

Gateway (/api/*)

Endpoint	Method	Description
/api/config	GET	Network configuration & contract addresses
/api/status	GET	Network status (checkpoint height, TPS, nodes)
/api/contracts/status	GET	Contract operational status
/api/ledger	GET	Recent transactions (paginated)
/api/sandbox/key	POST	Mint sandbox agent credentials
/api/sandbox/agents	GET	List registered agents
/api/run-demo	GET	Run agent demo with SSE stream
/api/ecosystem/metrics	GET	Live ecosystem metrics (JSONL stream)
/api/invoice	GET	Fetch pacs.008 invoice from resource server

Resource Server (/api/weather)

• POST /api/weather - Payment-gated weather data
  • Requires X-Payment-Signature, X-Agent-Signature, X-Agent-Pubkey headers
  • Validates payment proof against merchant balance
  • Returns JSON weather data or 402 Payment Required

🚢 Deployment

Vercel vercel --prod Required env vars: GATEWAY_URL SYNAPTIC_API_KEY

Docker docker build -t artemis . docker run -p 3000:3000 artemis Exposed ports: 3000 - Dashboard 8080 - Gateway

Systemd sudo cp *.service /etc/systemd/system/ sudo systemctl enable artemis-gateway sudo systemctl start artemis-gateway Services: artemis-gateway artemis-resource-server

🧪 Development

Running Tests

# Frontend
npm test

# Gateway
cd gateway
pytest

# CLI
cd cli
pytest

Building for Production

# Frontend
npm run build

# CLI
cd cli
pip install build
python -m build

⚙️ Configuration

Gateway Environment Variables

Variable	Default	Description
SYNAPTIC_RPC	http://100.73.33.37:8545	SynapticChain RPC endpoint
RESOURCE_SERVER_URL	http://127.0.0.1:8765	Resource server URL
EXPLORER_BASE	https://explorer.synapticchain.xyz	Block explorer URL
PORT	8080	Gateway listening port
HOST	0.0.0.0	Gateway bind address

Frontend Environment Variables

Variable	Default	Description
GATEWAY_URL	https://api.synapticchain.xyz	Gateway API URL
SYNAPTIC_API_KEY	-	API key for gateway access
NEXT_PUBLIC_API_BASE_URL	-	Public API base URL override

🔍 Monitoring

Health Checks

# Gateway health
curl https://api.synapticchain.xyz/health

# Network status
curl https://api.synapticchain.xyz/api/status

Metrics

The gateway exposes real-time metrics at:

• /api/ecosystem/metrics - JSONL stream of agent activity
• /api/ecosystem/state - Current agent registry state

🛡️ Security

⚠️ Testnet Only - This is a demonstration framework for testnet use only.

Best Practices

• ✅ Never commit .env files or API keys to git
• ✅ Use environment variables for all secrets
• ✅ Rotate API keys regularly
• ✅ Use HTTPS in production
• ✅ Enable rate limiting on public endpoints

🐛 Troubleshooting

Gateway 520 Errors (SSE Streaming)

Issue: Cloudflare tunnels may have issues with Server-Sent Events (SSE).

Solutions:

1. Expose gateway on a public IP with nginx
2. Use polling instead of SSE for /api/run-demo
3. Use a different tunnel provider (ngrok, localtunnel)

Contract Address Mismatch

Issue: Contract addresses don't match between gateway and RPC.

Solution: Update contracts/production/addresses.json and restart gateway.

Agent Settlement Failures

Issue: Payment proofs not validating.

Checklist:

• ✓ Agent has sufficient cTZS balance
• ✓ Invoice hasn't expired (expires_at)
• ✓ Merchant balance snapshot matches current state
• ✓ Signature correctly signs merchant:amount:invoice_id

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see LICENSE for details.

🔗 Links

Resource	Link
🌐 Live Dashboard	synradix.xyz
🔍 Explorer	explorer.synapticchain.xyz
📖 Documentation	docs.synapticchain.xyz
💬 Discord	discord.gg/synapticchain
🐙 GitHub	github.com/Synaptics-Lab

💬 Support

For questions or support:

• 🐛 Open an issue on GitHub Issues
• 💬 Join our Discord
• 📧 Email: dev@synapticchain.xyz

---

Built with ⚡ on SynapticChain

The blockchain for autonomous agents