alexohre/FlowIQ

โ˜… 0Forks 0GitHub โ†—Compare

README

FlowIQ

Intelligence for how money moves on Stellar

FlowIQ observes the network. Understands liquidity, fees, and reliability. And determines the best way for money to move.

In real time.


What is FlowIQ?

FlowIQ is a routing intelligence layer for the Stellar network.

It transforms fragmented payment corridors into a system that can be monitored, understood, and optimized automatically.

FlowIQ does not move funds. FlowIQ does not hold assets.

It simply answers one question:

What is the best path for this payment right now?


Why FlowIQ exists

Cross-border payments are unpredictable.

  • Routes change
  • Liquidity shifts
  • Fees fluctuate
  • Anchors fail

Yet most systems still rely on:

  • static routing rules
  • manual checks
  • incomplete data

This leads to:

  • failed transactions
  • hidden costs
  • unreliable delivery times
  • operational overhead

FlowIQ replaces guesswork with intelligence.


What FlowIQ does

๐Ÿงญ Routing Intelligence

Evaluates all possible paths for a transaction Balances cost, speed, and reliability in real time

๐Ÿ“ก Network Awareness

Observes live payment flows across corridors Tracks anchor performance and liquidity conditions

โš–๏ธ Reliability Scoring

Continuously scores anchors based on:

  • uptime
  • response time
  • historical success rates

๐Ÿ“Š Transaction Intelligence

Surfaces patterns, anomalies, and trends Across assets, corridors, and regions

โš ๏ธ Smart Alerts

Detects and notifies:

  • anchor downtime
  • unusual fees
  • slow transfers
  • liquidity risks

How it works

FlowIQ aggregates data from:

  • Stellar Horizon (real-time ledger data)
  • Anchor endpoints
  • Transaction flows

It processes this data into:

  • route comparisons
  • reliability scores
  • optimization decisions

All exposed via:

  • dashboard
  • API
  • webhooks

Example

const route = await fetch('https://flowiq.app/api/v1/route', {
  method: 'POST',
  headers: { Authorization: `Bearer ${API_KEY}` },
  body: JSON.stringify({
    sourceAsset: 'NGN:anchorX',
    destAsset: 'USD:anchorY',
    amount: 10000,
    optimize: 'cost' // or 'speed'
  })
})

/*
{
  "path": "anchorA โ†’ anchorB โ†’ anchorC",
  "cost": 2.5,
  "time": "45s",
  "reliability": 0.98,
  "liquidity": "sufficient"
}
*/

Core Capabilities

  • Real-time corridor monitoring
  • Anchor reliability scoring
  • Route optimization engine
  • Transaction analytics
  • Intelligent alerting

Who it's for

FlowIQ is built for:

  • remittance operators
  • fintech companies
  • payment processors
  • wallets and neobanks
  • financial infrastructure teams

Anyone moving money on Stellar at scale.


Philosophy

FlowIQ is not another dashboard.

It is a decision layer.

It does not replace existing systems. It makes them smarter.


Tech Stack

Frontend

  • Next.js
  • TypeScript
  • Tailwind CSS

Backend

  • Node.js
  • PostgreSQL (time-series)
  • Redis

Data Layer

  • Stellar Horizon API
  • WebSockets
  • Anchor integrations

Infra

  • Docker
  • CI/CD pipelines
  • Observability tooling

Getting Started

Prerequisites

  • Node.js 18+
  • PostgreSQL
  • Redis (optional)

Installation

git clone https://github.com/your-org/flowiq.git
cd flowiq

pnpm install

cp .env.example .env.local

pnpm run db:migrate
pnpm run dev

Visit: http://localhost:3000


Environment

STELLAR_NETWORK=public
STELLAR_HORIZON_URL=https://horizon.stellar.org

DATABASE_URL=postgresql://user:password@localhost/flowiq
REDIS_URL=redis://localhost:6379

MONITORED_ANCHORS=stellar.expert,flutterwave.com,anchorusd.com

Security

  • No custody of funds
  • No private keys stored
  • API authentication
  • Rate limiting
  • Role-based access

Roadmap

  • AI-based route prediction
  • Advanced reliability scoring
  • Compliance modules
  • Mobile interface
  • Cross-chain routing insights

Funding

FlowIQ is supported by Drips Network and built for the Stellar Development Foundation ecosystem.


Contributing

We welcome contributions.

  • Fork the repo
  • Create a feature branch
  • Submit a PR

Areas of interest:

  • performance optimization
  • UI/UX improvements
  • testing
  • regional integrations

License

MIT License


Closing

Money moves every second. But the network is constantly changing.

FlowIQ makes sure every payment takes the best path.


FlowIQ Intelligence for how money moves.

Contributors

alexohre

Issues