This directory contains the core application code for ChainFinity, a blockchain-based financial platform designed for institutional-grade portfolio management, risk assessment, market analytics, and DeFi protocol integration. The code is organized into three primary areas: the FastAPI backend, machine learning models for financial intelligence, and the blockchain smart contract layer.

code/
├── backend/           # FastAPI backend services and API layer
├── ai_models/         # Machine learning models for crypto financial intelligence
└── blockchain/        # Solidity smart contracts and blockchain tooling

The backend/ directory houses the main application server built with Python and FastAPI. It is a production-ready, enterprise-grade backend emphasizing financial industry standards, comprehensive security, regulatory compliance, and multi-chain blockchain integration.

• Enterprise Security: JWT authentication with refresh tokens, TOTP multi-factor authentication, role-based access control, sliding window rate limiting, field-level PII encryption, bcrypt password hashing, and account lockout protection
• Financial Compliance: KYC/AML integration with identity and document verification, sanctions screening, PEP checks, real-time transaction monitoring, suspicious activity detection, and regulatory reporting
• Risk Management: Portfolio risk metrics, real-time risk scoring, position limits and controls, stress testing capabilities, and risk-based alerting
• Blockchain Integration: Multi-chain support via Web3.py for Ethereum, Polygon, and BSC networks; smart contract interaction and transaction management
• Scalable Infrastructure: Async database operations with SQLAlchemy, Redis caching and session management, connection pooling, Docker support, and horizontal scaling via Docker Compose

Local development:

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
alembic upgrade head
python -m uvicorn main:app --reload

With Docker:

cd backend
docker-compose up -d

Services included in Docker Compose:

For full backend documentation, see backend/README.md.

The ai_models/ directory contains the machine learning stack that powers ChainFinity's predictive analytics and intelligent risk detection for cryptocurrency markets. Models are built with Python data science libraries and trained on historical on-chain and market data.

Individual models can be executed directly for training or inference:

cd ai_models
pip install -r requirements.txt
python volatility_forecaster.py
python exploit_detection_model.py

The preprocessing pipeline in data_preprocessing.py is imported by all model scripts to ensure consistent feature engineering across the platform.

The blockchain/ directory contains the Solidity smart contract layer and blockchain tooling for ChainFinity's on-chain operations. It supports the Ethereum ecosystem using Hardhat as the development framework.

Compile contracts:

cd blockchain
npm install
npx hardhat compile

Run tests:

npx hardhat test

Deploy to a network:

npx hardhat run scripts/deploy.js --network <network-name>

The three code areas work together as an integrated platform:

1. The backend serves as the central API layer, handling user authentication, portfolio management, compliance workflows, and risk assessments. It communicates with the blockchain layer via Web3.py to read on-chain data and submit transactions.

2. The AI models are called by backend services during portfolio analysis, risk evaluation, and market monitoring operations. Predictions from the exploit detection, volatility forecasting, and liquidity crisis models feed directly into the risk scoring engine and alerting system.

3. The blockchain layer provides the trustless, on-chain settlement and custody layer. Smart contracts manage asset allocations and DeFi interactions, while the subgraph indexes events for efficient querying by the backend.

Each subdirectory maintains its own test suite:

Run all backend tests:

cd backend
pytest

Run contract tests:

cd blockchain
npx hardhat test

Before running any component, copy and configure the environment files:

cd backend && cp .env.example .env
cd ../blockchain && cp .env.example .env  # if available

Required environment variables include database URIs, Redis connection strings, JWT secrets, blockchain RPC endpoints, and API keys for external market data providers.