ACTUS Bond Platform

A production-ready Web3 DeFi application for issuing and managing ACTUS-compliant financial instruments on Radix DLT. This platform enables financial institutions to create, manage, and track blockchain-based financial instruments with ACTUS-standard cash flow calculations.

🚀 Quick Start

Prerequisites

Node.js 18+
Docker & Docker Compose
Radix Wallet (for blockchain interactions)

One-Command Setup & Deployment

# Clone the repository
git clone <repository-url>
cd bond-platform

# Run automated setup (Windows)
.\setup.ps1

# Or for Mac/Linux
chmod +x setup.sh
./setup.sh

# Start all services
docker-compose up -d --build

# Access the application
open http://localhost:3000

Development Mode (Alternative)

# Start ACTUS Engine
cd actus-engine && npm start

# Start Backend API (new terminal)
cd backend && npm run start:dev

# Start Frontend (new terminal)  
cd frontend && npm run dev

# Access at: http://localhost:5173

📋 What's Included

🏗️ Complete Platform Architecture

┌─────────────────────────────────────────────────────────────┐
│                    ACTUS Bond Platform                      │
├─────────────────────────────────────────────────────────────┤
│  Frontend (React)    Backend (NestJS)    ACTUS Engine       │
│  - Bond Issuance     - REST API          - Cash Flows       │
│  - Portfolio Mgmt    - Radix Integration - ACTUS Standards  │
│  - Analytics         - Database Layer    - Calculations     │
└─────────────────────────────────────────────────────────────┤
│                    Radix DLT Network                        │
│                  (Stokenet/Mainnet)                         │
└─────────────────────────────────────────────────────────────┘

✨ Key Features

🏦 Multi-Role Dashboards - Issuer, Investor, Compliance, Regulator
📊 ACTUS Compliance - Full implementation of ACTUS financial standards
🔗 Radix DLT Integration - Blockchain-ready smart contracts
💰 Cash Flow Simulation - Interactive charts and payment schedules
📈 Portfolio Analytics - Real-time tracking and reporting
🎯 Production Ready - Containerized, scalable, secure

🏗️ Project Structure

bond-platform/
├── 📁 frontend/                 # React TypeScript Frontend
│   ├── src/components/          # UI Components
│   ├── src/types/               # TypeScript definitions
│   ├── src/utils/               # Utilities & Radix integration
│   └── vite.config.ts           # Build configuration
├── 📁 backend/                  # NestJS Backend API
│   ├── src/controllers/         # REST API endpoints
│   ├── src/services/            # Business logic
│   ├── src/models/              # Data models
│   └── main.ts                  # Application entry point
├── 📁 scrypto-contracts/        # Radix Smart Contracts
│   ├── src/lib.rs               # Bond instrument blueprints
│   └── Cargo.toml               # Rust dependencies
├── 📁 actus-engine/             # ACTUS Calculation Service
│   └── server.js                # Financial calculations API
├── 📁 deployment/               # Production deployment
├── 📁 scripts/                  # Automation scripts
└── 📄 docker-compose.yml        # Container orchestration

🎯 Core Functionality

1. Bond Instrument Creation

ACTUS Contract Types: PAM, ANN, NAM, LAM, SWAP
Flexible Terms: Notional, interest rates, maturity, payment cycles
Real-time Validation: ACTUS-standard compliance checking

2. Cash Flow Simulation

Interactive Charts: Line charts, bar charts, payment timelines
Amortization Tables: Period-by-period breakdown
Export Capabilities: CSV, JSON data export

3. Portfolio Management

Dashboard Analytics: Total value, active instruments, performance
Instrument Tracking: Status, maturity, cash flows
Risk Metrics: Duration, convexity, yield calculations

4. Radix DLT Integration

Smart Contracts: Scrypto blueprints for bond instruments
Wallet Integration: Radix Wallet connectivity
Transaction Management: Deployment and execution on Radix network

🔧 Technical Stack

Frontend

React 18 with TypeScript
Vite for fast development builds
Tailwind CSS for styling
Recharts for data visualization
Radix UI components

Backend

NestJS framework with TypeScript
REST API with validation
Modular architecture with services and controllers
Error handling and logging

Blockchain

Radix DLT for blockchain layer
Scrypto smart contracts
Component-based architecture
Transaction manifest support

Infrastructure

Docker containerization
PostgreSQL for data persistence
Nginx for static file serving
Health checks and monitoring

📊 ACTUS Standards Implementation

Supported Financial Instruments

Type	Code	Description	Use Case
Principal at Maturity	PAM	Zero-coupon bond	Corporate bonds
Annuity	ANN	Fixed payments with amortization	Mortgages, loans
Negative Amortization	NAM	Growing principal	Student loans
Linear Amortization	LAM	Fixed principal reduction	Auto loans
Interest Rate Swap	SWAP	Fixed-for-floating exchange	Hedging

Cash Flow Types

IP - Interest Payment
PR - Principal Repayment
FP - Fee Payment
DV - Dividend Payment

🚀 Deployment

Local Development

# Using Docker (Recommended)
docker-compose up -d --build

# Using Development Servers
./start-dev.ps1  # Windows
./start-dev.sh   # Mac/Linux

Production Deployment

# Build and deploy
docker-compose -f docker-compose.prod.yml up -d

# Environment variables
cp .env.example .env
# Configure database, Radix network, API keys

Cloud Platforms

DigitalOcean App Platform (Recommended)
AWS ECS with Fargate
Kubernetes with Helm charts
Azure Container Instances

🔌 API Endpoints

Bond Management

POST /bonds
GET /bonds
GET /bonds/:id
PUT /bonds/:id/deploy

ACTUS Calculations

POST /actus/cashflows
GET /actus/contract-types
POST /actus/contracts/generate

Radix Integration

POST /radix/deploy
POST /radix/execute
GET /radix/component/:address

💾 Data Models

Bond Instrument

interface BondInstrument {
  id: string;
  terms: BondTerms;
  cashFlows: CashFlow[];
  componentAddress?: string;
  status: 'draft' | 'deployed' | 'active' | 'matured';
  createdAt: string;
}

Bond Terms

interface BondTerms {
  contractType: string;
  contractID: string;
  currency: string;
  notionalPrincipal: number;
  nominalInterestRate: number;
  maturityDate: string;
  statusDate: string;
  cycleAnchorDateOfInterestPayment: string;
  cycleOfInterestPayment: string;
}

🔒 Security Features

Input Validation with class-validator
CORS Configuration for cross-origin requests
Environment-based configuration
Error handling and logging
Rate limiting ready

📈 Performance

Frontend: Optimized React with code splitting
Backend: NestJS with efficient dependency injection
Database: PostgreSQL with connection pooling
Caching: Redis-ready architecture
Load Balancing: Horizontal scaling support

🧪 Testing

# Frontend tests
cd frontend && npm test

# Backend tests
cd backend && npm test

# E2E tests
npm run test:e2e

# Build verification
npm run build:verify

🔮 Roadmap

Phase 1: Core Platform ✅

Bond instrument creation
ACTUS cash flow calculations
Portfolio management
Basic Radix integration

Phase 2: Advanced Features 🚧

Secondary market trading
Risk analytics dashboard
Regulatory reporting
Multi-currency support

Phase 3: Enterprise Ready 🔮

OAuth2 authentication
Audit logging
Advanced risk modeling
Insurance integration

🤝 Contributing

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Development Guidelines

Follow TypeScript best practices
Write tests for new features
Update documentation
Use conventional commits

📄 License

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

🙏 Acknowledgments

ACTUS Foundation for financial standards
Radix DLT for blockchain infrastructure
NestJS for backend framework
React for frontend framework

📞 Support

Documentation: docs.actus-bond-platform.com
Issues: GitHub Issues
Discord: Community Chat
Email: support@actus-bond-platform.com

🚀 Getting Help

Common Issues

# Port already in use
docker-compose down
docker-compose up -d

# Build failures
docker system prune -a
docker-compose build --no-cache

# Database connection issues
docker-compose restart postgres

Debugging

# Check service logs
docker-compose logs frontend
docker-compose logs backend
docker-compose logs actus-engine

# Service health checks
curl http://localhost:3001/health
curl http://localhost:8083/actuator/health

# Database status
docker-compose exec postgres psql -U postgres -d actus_bond_platform

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
actus-engine		actus-engine
backend		backend
deployment		deployment
docs		docs
frontend		frontend
scripts		scripts
scrypto-contracts		scrypto-contracts
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
docker-compose.yml		docker-compose.yml
final-fix.ps1		final-fix.ps1
package.json		package.json
setup.ps1		setup.ps1
start-all-services.ps1		start-all-services.ps1

Folders and files

Latest commit

History

Repository files navigation

ACTUS Bond Platform

🚀 Quick Start

Prerequisites

One-Command Setup & Deployment

Development Mode (Alternative)

📋 What's Included

🏗️ Complete Platform Architecture

✨ Key Features

🏗️ Project Structure

🎯 Core Functionality

1. Bond Instrument Creation

2. Cash Flow Simulation

3. Portfolio Management

4. Radix DLT Integration

🔧 Technical Stack

Frontend

Backend

Blockchain

Infrastructure

📊 ACTUS Standards Implementation

Supported Financial Instruments

Cash Flow Types

🚀 Deployment

Local Development

Production Deployment

Cloud Platforms

🔌 API Endpoints

Bond Management

ACTUS Calculations

Radix Integration

💾 Data Models

Bond Instrument

Bond Terms

🔒 Security Features

📈 Performance

🧪 Testing

🔮 Roadmap

Phase 1: Core Platform ✅

Phase 2: Advanced Features 🚧

Phase 3: Enterprise Ready 🔮

🤝 Contributing

Development Guidelines

📄 License

🙏 Acknowledgments

📞 Support

🚀 Getting Help

Common Issues

Debugging

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages