EthersFlow — Developer Toolkit & Trust Layer

Developer toolkit for EthersFlow — a multi-model trust layer that verifies AI outputs through adversarial consensus. MCP server, SDKs, and API docs.

Overview

EthersFlow is a zero-trust verification engine for autonomous AI agents. Before an agent executes side effects—such as wire transfers, API calls, medical orders, or code changes—EthersFlow evaluates the proposed action using a federated, adversarial cross-examination of heterogeneous models and emits a cryptographically signed attestation trail.

If an audit node uncovers hallucinations, unverified counterparties, or compliance risks, the proposed action is flagged or rejected with an Ed25519 cryptographically signed attestation trail.

                        Autonomous AI Agent
                                 |
                                 v
                    +------------------------------+
                    | EthersFlow Verification Gate |
                    +------------------------------+
                                 |
        +------------------------+------------------------+
        |                        |                        |
+------------------+   +----------------------+   +---------------------+
| Direct Pragmatist|   | Constructive Skeptic |   | Lateral Synthesizer |
|  (Claude / Llama)|   |  (Gemini / Mistral)  |   |  (DeepSeek / Qwen)  |
+------------------+   +----------------------+   +---------------------+
         \                     |                      /
          \                    |                     /
           \                   |                    /
            +-----------------------------------------+
            |        Federated Consensus Engine       |
            +-----------------------------------------+
                                 |
                                 v
                    APPROVED   /   FLAGGED   /   REJECTED

Related MCP server: Thoughtproof-mcp

What's Included

This repository contains the official client surfaces and developer tools for the EthersFlow ecosystem:

Note: The core Federated Adversarial Consensus engine runs on Cloud Run with Zero Data Retention (ZDR). This public repository hosts client-side tools, SDKs, and integration specs.

5-Minute Quickstart

1. Model Context Protocol (MCP) Server

If you want the absolute fastest cold-start without package registry requirements, run the server directly from this repository:

# Option: Local / GitHub source (recommended until packages are published)
git clone https://github.com/Ethersflow/EthersFlow.git
cd EthersFlow/mcp-server
npm install
npm start

Optionally, once packages are published you can use the scoped npm package:

# After publishing to npm
npx @ethersflow/mcp-server --api-key="$ETHERSFLOW_API_KEY"

2. Python (Zero-Dependency Demo)

Run the included reference verifier script:

python efverify.py demo

To verify a custom proposed action:

python efverify.py verify "Transfer 5000 USDC to wallet 0x9f for smart contract audit"

3. cURL API Call

curl -X POST "https://ethersflow-225907257236.us-east1.run.app/api/v1/verify" \
  -H "Authorization: Bearer ef_live_demo_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_action": "Transfer 5000 USDC to wallet 0x9f for smart contract audit",
    "persona_preset": "financial_compliance",
    "agent_count": 3
  }'

Status & Known Limitations

• Ed25519-Signed Audit Trail: Every audit node output is signed using Ed25519-EdDSA. Signatures can be verified independently against /.well-known/jwks.json with zero trust required.

• Probabilistic, Not Deterministic: Borderline or ambiguous actions (e.g., high-value wire transfers or missing compliance records) evaluate near decision thresholds (APPROVED ↔ FLAGGED).

• Live Model Engine: Powered by live inference nodes (Llama 3.3 70B + Llama 3.1 8B via Groq) with active pipeline routing.

Key Features

• Multi-Model Consensus: Eliminates single-model bias by forcing heterogeneous models into adversarial debate.

• Ed25519 Attestation: Every debate node output is signed with an Ed25519 cryptographic key. Public key set available at /.well-known/jwks.json.

• Zero Data Retention (ZDR): Submitted action chains are processed purely in volatile RAM and never stored or used for model training.

Framework Integrations

LangChain (Python)

import os
from ethersflow.client import EthersFlowLangChainTool

verifier_tool = EthersFlowLangChainTool(api_key=os.environ["ETHERSFLOW_API_KEY"])

# Add to your LangChain agent tools
tools = [verifier_tool]

Cloudflare Workers / Agents SDK (TypeScript)

import { cloudflareVerifyGate } from '@ethersflow/sdk';

export default {
  async fetch(request, env) {
    const isSafe = await cloudflareVerifyGate(
      "Transfer 5000 USDC to wallet 0x9f",
      "Vendor audit payment",
      env.ETHERSFLOW_API_KEY
    );

    if (!isSafe) {
      return new Response("Action blocked by EthersFlow Consensus Gate", { status: 403 });
    }

    // Proceed with execution
  }
};

Security & Ed25519 Attestation

EthersFlow publishes its public key set in JSON Web Key Set (JWKS) format:

• JWKS Endpoint: GET /.well-known/jwks.json

• Attestation Manifest: GET /.well-known/attestation.json

• Verification Endpoint: POST /api/v1/verify-attestation

You can verify signatures locally or through the API to prove that every audit node's perspective originated directly from the EthersFlow signing authority.

Postman Collection

Import postman/ethersflow.postman_collection.json and postman/ethersflow.postman_environment.json.

License

Code & SDK wrappers licensed under MIT License. Hosted EthersFlow API services subject to Terms of Service.