TECHNICAL ARCHITECTURE

StellarClaw Architecture

What we built for autonomous, verifiable AI trading on Stellar.

StellarClaw combines off-chain agent intelligence with on-chain control and settlement rails.

Users hold AI agents as programmable execution modules.
Strategies run across tokenized markets and connected blockchains.
Settlement, accounting, and performance distribution reconcile on Stellar.

Soroban contracts Cross-chain execution Deterministic risk limits XLM reconciliation On-chain audit trail Agent-holder distribution
STACK Production architecture: agent runtime, market gateways, risk engine, Soroban settlement, and holder distribution.

System Layers

Interface Layer User
Web UI + PWA entry points for discovering agents, reviewing architecture, and accessing acquisition workflows.
Landing, acquire-agent catalog, architecture views
Agent Runtime Layer AI
Autonomous strategy agents run continuous decision loops using market data, policy constraints, and execution state.
Signal generation, position management, lifecycle control
Execution Layer Routing
Smart order routing across tokenized equities, ETFs, treasuries, synthetic assets, FX, and digital asset venues.
Cross-chain aware market access
Settlement Layer Stellar
Final settlement, accounting records, and holder-level net performance distribution anchored on Stellar rails.
XLM-native reconciliation and payout accounting

Core Components

Execution everywhere. Settlement on Stellar.
Agent Registry Strategy Runtime Policy Compiler Risk Guardrails Order Router Market Data Ingestion Cross-chain Bridge Connectors Settlement Coordinator Profit Distribution Module On-chain Event Indexer Compliance Logs Analytics and Monitoring

End-to-End Execution Lifecycle

1. Market Input Data
Agents consume normalized data streams for price, liquidity, volatility, funding, and spread conditions.
Deterministic data snapshots per decision cycle
2. Strategy Decision Logic
Policy-bound AI logic evaluates entry, sizing, rebalance, and unwind opportunities for each assigned market set.
Pre-trade checks embedded in strategy runtime
3. Risk Validation Control
Each order proposal is validated against exposure ceilings, drawdown limits, concentration caps, and route constraints.
Reject or resize before execution
4. Multi-venue Execution Routing
Orders route to the best available liquidity path across connected chains and tokenized market venues.
Fill handling with latency-aware fallback routing
5. Settlement + Accounting Ledger
Executed activity is reconciled into settlement records on Stellar for position state, fees, PnL, and cash movements.
Soroban-powered settlement bookkeeping
6. Holder Distribution Payout
Net results distribute proportionally to agent holders using predefined distribution logic and transparent records.
Auditable payout events and reporting trails

Operational Guarantees

Runtime assurances

Deterministic risk guardrails enforced before every order path decision.

Risk Engine

Strategy actions, executions, and settlements are traceable with verifiable logs.

Audit Layer

Cross-chain access with Stellar-anchored reconciliation and accounting consistency.

Settlement Layer

Agent holder distribution follows transparent proportional result allocation.

Distribution Module

Deterministic risk guardrails enforced before every order path decision.

Risk Engine

Strategy actions, executions, and settlements are traceable with verifiable logs.

Audit Layer

Cross-chain access with Stellar-anchored reconciliation and accounting consistency.

Settlement Layer

Agent holder distribution follows transparent proportional result allocation.

Distribution Module

Soroban Contract Surface

Agent Registry Contract Core
Tracks agent identities, ownership references, status flags, and configuration hashes for reproducible execution policy.
Canonical source for agent identity on Stellar
Risk Parameter Contract Risk
Stores immutable and mutable guardrails such as max leverage, route restrictions, and volatility gating thresholds.
Policy-level control with explicit versioning
Settlement Contract Ledger
Commits reconciled execution output, fees, and net PnL snapshots per cycle for deterministic accounting.
Source of truth for net result state
Distribution Contract Payout
Calculates and records holder-level net result allocations from settlement snapshots and distribution schedules.
Transparent holder distribution logic

Security, Monitoring, and Controls

Execution Security Runtime
Signer segregation, key isolation boundaries, and constrained execution profiles for agent operations.
Defense in depth for execution infrastructure
Observability Stack Ops
End-to-end metrics for latency, fill quality, risk utilization, settlement drift, and distribution cycle health.
Real-time alerts and incident playbooks
Compliance and Audit Logs
Tamper-evident decision and execution logs with deterministic mapping to settlement and distribution events.
Evidence-ready operational transparency
Change Control Governance
Versioned policy updates and controlled rollout workflows for strategy/risk configuration changes.
Governed progression from test to production