Ecosystem¶

LedgerFlow is designed to integrate with the broader AI and blockchain ecosystem. It works with existing agent frameworks, payment protocols, and settlement infrastructure.

Framework Integrations¶

MCP (Model Context Protocol)¶

LedgerFlow integrates with MCP as an authorization layer at the tool server boundary.

Agent → MCP Server → LedgerFlow Verifier → Tool Execution

The MCP server verifies warrant constraints against the tool invocation before execution.

A2A (Agent-to-Agent)¶

For multi-agent workflows, LedgerFlow's delegation model supports bounded authority transfer between agents:

Agent A (warrant, depth=2)
  → delegates to Agent B (warrant, depth=1)
    → delegates to Agent C (warrant, depth=0, terminal)

Each delegation narrows authority monotonically.

LangChain / LangGraph¶

LedgerFlow can be integrated as a middleware layer in LangChain chains and LangGraph workflows:

LLM Decision → LedgerFlow Gate → Tool Call → Payment

OpenAI Function Calling¶

For OpenAI-compatible APIs, LedgerFlow can gate function call payments:

LLM proposes function call → LedgerFlow verifies warrant → Execute + Pay

x402 Ecosystem¶

LedgerFlow is fully compatible with the x402 ecosystem:

Component	Compatibility
x402 Payment Headers	Full — LedgerFlow uses standard x402 headers
x402 Facilitator	Extended — adds rail routing
x402 Settlement Schemes	Full — LedgerFlow authorizes, x402 settles
x402 Transport	Full — LedgerFlow data in extensions only

Settlement Rail Support¶

Live / In Development¶

Rail	Status	Notes
EVM (Base, Ethereum)	Active	x402 smart contract settlement
Solana	Active	SPL token transfer
Binance	Active	Internal transfer via API
OKX	Active	Sub-account transfer

Planned¶

Rail	Timeline	Notes
Bybit	v2	Internal transfer
Stripe	v2	Fiat backstop
PayPal	v2	Fiat fallback
Coinbase	v2	Exchange integration

AI Agent Platforms¶

LedgerFlow can serve as the authorization layer for:

Autonomous research agents — bounded spending on data providers
Code generation agents — limited compute budget for sandbox execution
Trading agents — constrained delegation for exchange operations
Multi-agent systems — hierarchical authority delegation

Development Tools¶

CLI¶

# Issue a warrant
ledgerflow-cli issue-warrant [options]

# Build an x402 payment with LedgerFlow extension
ledgerflow-cli build-payment [options]

# Verify authorization
ledgerflow-cli verify [options]

# Generate sample fixtures
ledgerflow-cli sample-warrant
ledgerflow-cli sample-payment

Test Fixtures¶

The features/ directory contains Gherkin acceptance scenarios:

warrant_verification.feature — warrant signature and constraint verification
quote_binding.feature — proof binding to x402 accepted objects
replay_protection.feature — nonce-based replay detection
facilitator_routing.feature — multi-rail settlement routing