Aegis RWA Contracts

Core smart contract infrastructure for the Aegis RWA Protocol. Built on the Stellar network using the Soroban SDK.

Overview

Aegis enables the fractional tokenization of Real-World Assets (RWAs). The contracts strictly enforce regulatory compliance at the ledger level, ensuring tokens can only be minted to and transferred between KYC-whitelisted addresses.

Prerequisites

• Rust (>= 1.71)
• Soroban CLI

Setup & Build

1. Install the Soroban WASM target (make build does this for you):

   rustup target add wasm32v1-none

   soroban-sdk requires wasm32v1-none. The older wasm32-unknown-unknown target is rejected by the Soroban environment on Rust 1.82+.

2. Build the contract:

   make build

Testing

Run the comprehensive test suite locally:

make test        # contract tests
make test-all    # contract + monitoring service tests

Real-Time Monitoring

Every state change emits a namespaced contract event (see docs/contract-spec.md). The monitoring/ service consumes them over Soroban RPC and provides live streaming, filtering and routing, pattern-based alerting, event persistence and replay, an analytics dashboard, and event-based triggers.

make monitor-install
make monitor-demo     # self-contained demo → http://127.0.0.1:4500
make monitor          # stream from a configured network

See monitoring/README.md for configuration and API details.

Contributing

Please see CONTRIBUTING.md for guidelines on how to submit pull requests, branch naming conventions, and testing requirements.