How sks006/halal-equity-catalyst works
Equity Catalyst is a Solana spot-liquidity and portfolio-rebalancing platform with Shariah screening, policy-controlled execution, vaults, and Meteora bonding-curve price discovery. The principal workflow is market/event observation → policy and risk evaluation → proposal validation and simulation → isolated signing and on-chain execution → audit/state recording. The README documents these stages and major capabilities; sampled source confirms key execution, stream-management, SDK, and worker boundaries, but not all route-to-service wiring.
Main entry points: execution_engine_service.rs Execution Service · routes API Routes · policy_worker.rs Policy Worker · decision_engine Decision Engine
Components 26
Web and SDK
- Web Application
apps/web/src/app - Web API Client
apps/web/src/lib/api-client.ts - TypeScript SDK
sdk/src/client.ts
API and Workers
- HTTP Router
apps/api/src/router.rs - API Routes
apps/api/src/routes - Policy Worker
apps/api/src/workers/policy_worker.rs - Execution Service
apps/api/src/services/execution_engine_service.rs - Oracle Service
apps/api/src/services/oracle_service.rs
Policy and Trading
- DBC Engine
apps/api/src/engines/dbc_engine - Policy Engine
apps/api/src/engines/policy_engine - Decision Engine
apps/api/src/engines/decision_engine - Risk Engine
apps/api/src/engines/risk_engine - Shariah Screening
crates/shared/src/shariah - Signing Pipeline
apps/api/src/engines/execution_signer/pipeline.rs
Solana and Providers
- Equity Vault Program
programs/equity_vault/src/lib.rs - Pyth Feeds
integrations/pyth/manager.rs - Solana Service
apps/api/src/services/solana_service.rs - Jupiter Integration
integrations/jupiter/client.rs - Meteora DBC SDK
sdk/src/meteora/service.ts
Persistence
- PostgreSQL
apps/api/src/repositories - Redis Queue
Other components
- Investor or Operator
- Solana Cluster
- Pyth Network
- Jupiter Provider
- Meteora DBC
Connections 28
- Investor or Operator → Web Application: uses
- Web Application → Web API Client: requests data
- Web API Client → API Routes: calls API
- TypeScript SDK → API Routes: calls API
- TypeScript SDK → Solana Cluster: reads chain
- HTTP Router → API Routes: dispatches
- API Routes → Oracle Service: requests prices
- API Routes → DBC Engine: requests simulation
- Policy Worker → Redis Queue: consumes events
- Policy Worker → PostgreSQL: loads and records
- Policy Worker → Decision Engine: evaluates event
- Decision Engine → Policy Engine: checks rules
- Decision Engine → Risk Engine: checks risk
- Policy Engine → Shariah Screening: checks eligibility
- Execution Service → Risk Engine: revalidates trade
- Execution Service → Oracle Service: checks prices
- Execution Service → DBC Engine: simulates trade
- Execution Service → Signing Pipeline: requests signature
- Execution Service → Solana Service: executes action
- Execution Service → PostgreSQL: records execution
- Signing Pipeline → Solana Service: submits signed transaction
- Solana Service → Solana Cluster: reads and submits
- Oracle Service → Pyth Feeds: normalizes prices
- Pyth Feeds → Pyth Network: streams prices
- API Routes → Jupiter Integration: requests quotes
- Jupiter Integration → Jupiter Provider: fetches quote or swap
- Equity Vault Program → Solana Cluster: executes on-chain
- Meteora DBC SDK → Meteora DBC: creates pools and swaps