Engineering · source map
This page maps the repository as reviewed on 2026-11-04. It distinguishes adjacent packages, mock paths, and research folders instead of implying one connected production pipeline.
Source-level relationships
The diagram is a navigable source map. Its key distinguishes unverified relationships from a simulated path.
Interactive source map
Amber dashes mark source-level or unverified relationships; the red dash pattern marks a simulated path. Choose a node to inspect its evidence and boundary.
A React, TypeScript, and Vite app lives under LokiAi/. It contains portfolio, agent, and cross-chain views.
Boundary: Some displayed values and the cross-chain completion state are simulated. A rendered interface does not prove a wallet action or transaction occurred.
A React, TypeScript, and Vite app lives under LokiAi/. It contains portfolio, agent, and cross-chain views.
Boundary: Some displayed values and the cross-chain completion state are simulated. A rendered interface does not prove a wallet action or transaction occurred.
A separate Node/Express server defines API routes and Socket.IO setup, with MongoDB-related packages in its own manifest.
Boundary: No external database or deployed API was connected during this source review; secrets and local configuration are not part of this website.
The frontend service layer defines an orchestrator and specialist agent interfaces; a separate backend also contains agent modules.
Boundary: These modules are described as code areas, not a claim that every agent is deployed, funded, or connected to live market data.
The API server imports and configures Socket.IO alongside its HTTP service.
Boundary: A server-side event path is not a verified production feed or a source of live trading state.
A separate FastAPI application exposes Celery-backed task handling.
Boundary: The broker, worker, and app were not verified as a single running deployment in this review.
The Python engine calculates allocation deviations and produces candidate rebalance recommendations.
Boundary: Its execution method explicitly calls a simulated trade path; it is not evidence of a bridge or exchange transaction.
MongoDB-oriented client, service, and model files appear in separate packages; their external endpoint and integrated runtime were not verified.
Boundary: A dependency or model file is not evidence of a running production database. No connection string or credential is included here.
Arbitrage, yield, risk, and portfolio-rebalancing contract sources are present under loki-contracts/contracts/.
Boundary: Mock paths in source are not an audit, deployment, or guarantee of execution. No live address is presented here.
A React, TypeScript, and Vite app lives under LokiAi/. It contains portfolio, agent, and cross-chain views.
Boundary: Some displayed values and the cross-chain completion state are simulated. A rendered interface does not prove a wallet action or transaction occurred.
A separate Node/Express server defines API routes and Socket.IO setup, with MongoDB-related packages in its own manifest.
Boundary: No external database or deployed API was connected during this source review; secrets and local configuration are not part of this website.
The frontend service layer defines an orchestrator and specialist agent interfaces; a separate backend also contains agent modules.
Boundary: These modules are described as code areas, not a claim that every agent is deployed, funded, or connected to live market data.
The API server imports and configures Socket.IO alongside its HTTP service.
Boundary: A server-side event path is not a verified production feed or a source of live trading state.
A separate FastAPI application exposes Celery-backed task handling.
Boundary: The broker, worker, and app were not verified as a single running deployment in this review.
The Python engine calculates allocation deviations and produces candidate rebalance recommendations.
Boundary: Its execution method explicitly calls a simulated trade path; it is not evidence of a bridge or exchange transaction.
MongoDB-oriented client, service, and model files appear in separate packages; their external endpoint and integrated runtime were not verified.
Boundary: A dependency or model file is not evidence of a running production database. No connection string or credential is included here.
Arbitrage, yield, risk, and portfolio-rebalancing contract sources are present under loki-contracts/contracts/.
Boundary: Mock paths in source are not an audit, deployment, or guarantee of execution. No live address is presented here.
Source snapshot: https://github.com/THE-SHRIKS/WallStreet/tree/b7207a8177b4d9a564bf3596b8c450372d5d050b/. The links above are pinned to the reviewed commit; use the latest-source links in the footer for newer changes.
Three source paths
These are useful ways to read the source, not evidence that a live service is running.
Infrastructure and runtimes
Compose files, reverse-proxy configs, and service manifests describe alternatives. This review did not verify one all-in-one production topology.
Persistence and events
MongoDB-oriented service and model files sit alongside Socket.IO server setup. Neither presence establishes an external database connection or a deployed event feed.
Python and task processing
The rebalancer and FastAPI/Celery gateway have separate source and runtime requirements. A connected broker, worker, or end-to-end task path was not verified.
Compose and reverse proxy
Compose variants group different service sets, while NGINX files hold alternate serving and routing rules. Multiple root and LokiAi variants exist; none is a verified canonical startup recipe. Choose a package intentionally and verify its environment; this website starts none of them.
Contract tooling
The package declares Hardhat and Ethers with local compile, test, and deployment scripts. This site build does not run them, and their presence does not verify a chain address or release.
Solidity · four source files
Names below come from the repository. A local compile or passing unit test would not replace a security audit or establish a live deployment.
An arbitrage-oriented contract prototype with source-level mock execution paths.
Price and trade helpers are explicitly mocked. An event or recorded counter is not proof of a live route, executable liquidity, or net profitability.
A strategy-selection and yield-optimization contract prototype.
Selection and protocol execution are explicitly mocked, including a 1:1 output path. Stored fields do not represent current offers or realized yield.
A contract prototype for risk-score thresholds and related state changes.
Some liquidity and volatility calculations are mocked. A threshold is not a security review, an oracle guarantee, or a promise that loss can be prevented.
A contract prototype that represents portfolio-rebalance operations.
Current-value and action paths are mocked. No exchange transfer, wallet read, or settled on-chain rebalance is claimed.
Commit-pinned code map
Every source link points to the reviewed snapshot. The repository link in the global navigation follows the latest default branch.
Evidence register
Every state below is a source-level description pinned to the reviewed commit, not an operational service check.
| Area | Status | Evidence boundary | Source |
|---|---|---|---|
| Browser application | Implemented | A React, TypeScript, and Vite application is present under LokiAi/. | LokiAi/package.json |
| API service | Prototype | A separate Node/Express service includes API and Socket.IO wiring. | LokiAi/backend/server.js |
| Database and persistence | Prototype | MongoDB-facing service and model modules are present; an external database connection was not verified during this review. | LokiAi/src/services/database/mongodb-service.ts |
| Portfolio workflow | Simulated | The Python rebalancer explicitly describes its trade path as simulated rather than a live DEX or bridge transaction. | portfolio_rebalancer/rebalance_engine.py |
| Solidity contracts | Simulated | Four contract sources are present. Their mock paths and tests do not establish a deployed, audited protocol. | loki-contracts/contracts/ArbitrageBot.sol |
| Deployment status | Not verified | This review did not verify a public production domain, deployed contract address, or audited release. | README.md |
Security and trust
Wallet, risk, and contract modules are engineering surfaces—not independently audited or verified production controls. This website excludes credential values and private configuration. Maintainers should review sensitive materials privately before a public release.