🔧 How FlareFlow.link Works

Understanding the architecture behind Flare oracle integration, Flow blockchain billing, and LiteLLM API management

🏗️ System Architecture

🔥 Flare Oracle

Verifies LiteLLM usage data every 5 minutes via StateConnector and FDC

⚡ Flow Blockchain

Processes payments and manages subscriptions with smart contracts

🔑 LiteLLM API

Provides OpenAI-compatible endpoint with usage tracking

🔄 Data Flow Process

1

API Usage Occurs

User makes API calls to https://llm.p10p.io with their unique LiteLLM key

2

Real-time Display

Frontend shows immediate usage updates via WebSocket/polling (pending state)

3

FDC Connector Polls

Flare Data Connector polls LiteLLM every 5 minutes and aggregates usage data

4

Oracle Attestation

Flare StateConnector provides cryptographic proof of usage data authenticity

5

Billing Update

Flow smart contracts process verified usage and update billing entitlements

📋 Public Contracts & Oracles

⚡ Flow Blockchain Contracts

Main Account

0x6daee039a7b9c2f0 →

View all deployed contracts on FlowDiver

Contract Explorer

Contract Browser →

Search and verify Flow contracts

Core Smart Contracts

UsageBasedSubscriptionsDynamic pricing & billing logic
FlareOracleVerifierOracle data validation
SimpleUsageSubscriptionsBasic subscription management
FlareFDCTriggersFlare Data Connector integration

🔥 Flare Oracle Infrastructure

Flare Network

flare.network →

Main Flare network documentation

StateConnector

StateConnector Docs →

Oracle attestation system

Coston2 Testnet

Coston2 Explorer →

Testnet blockchain explorer

FDC Documentation

FDC Guides →

Flare Data Connector integration

🔑 LiteLLM API Infrastructure

API Endpoint

https://llm.p10p.io →

OpenAI-compatible API endpoint

LiteLLM Documentation

LiteLLM Docs →

Usage tracking and key management

OpenAI Compatibility

OpenAI API Reference →

Standard API format for all models

API Usage Example

curl -X POST https://llm.p10p.io/chat/completions
-H "Authorization: Bearer your-api-key"

🌊 Flow Ecosystem Resources

Flow Documentation

docs.onflow.org →

Complete Flow blockchain documentation

Cadence Language

cadence-lang.org →

Smart contract programming language

Flow Client Library

FCL on GitHub →

JavaScript SDK for Flow integration

Flow Port Wallet

port.onflow.org →

Official Flow wallet for transactions

🔧 Integration Guide

For Developers

Connect Flow wallet using FCL
Create subscriptions with FLOW deposits
Get unique LiteLLM API keys automatically
Monitor real-time usage via WebSocket
Verify billing through Flare oracle

For Users

Install Flow Port wallet
Fund wallet with FLOW tokens
Connect wallet to FlareFlow.link
Create subscription with deposit
Use API key with any OpenAI-compatible app