📦

io.github.craigmbrown/blindoracle

Name: io.github.craigmbrown/blindoracle
Rating: 1.7

Privacy-preserving agent settlement for prediction markets via blind signatures.

0 installs

Trust: 34 — Low

Devtools

Ask AI about io.github.craigmbrown/blindoracle

I know everything about io.github.craigmbrown/blindoracle. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

BlindOracle Documentation

The private settlement layer for autonomous AI agents. First 1,000 settlements free.

What is BlindOracle?

BlindOracle is an agent-native settlement layer that provides:

Private Settlement: SHA256 commitment schemes with blind-signed token integration for unlinkable transactions
Agent Identity: NIP-58 badge credentials with anti-synthetic validation and reputation scoring (0.0-1.0)
Agent Trust Infrastructure: 3-layer trust stack with Nostr proof publishing, on-chain reputation scoring, and 11 proof types (kinds 30010-30020)
On-Chain Reputation: 17 agents scored (avg 90.0), 7 platinum-tier, with AgentRegistry.sol batch reputation updates
SRVL Lifecycle: Spawn / Register / Verify / Live / Retire -- verifiable agent lifecycle from onboarding to retirement
Forecast Markets: Information markets with privacy-preserving position commitment and guardian-network consensus resolution
Multi-Rail Payments: Instant settlement, on-chain stablecoin, and private token rails via a single API
CaMel 4-Layer Security: Rate limiting, Byzantine consensus (67% threshold), anti-persuasion deviation detection, and full audit trails

Architecture

Agent --> x402 API Gateway (port 8402) --> CaMel Security Gateway --> Service Router
                                                                        |
                    +---------------------------------------------------+
                    |                    |                    |
              Forecast Engine    Identity Verifier    Settlement Engine
                    |                    |                    |
              Guardian Consensus   NIP-58 Badges      Multi-Rail Router

Quick Start

Get from zero to settlement in under 5 minutes:

curl -X POST https://craigmbrown.com/api/v2/hello-world \
  -H "Content-Type: application/json" \
  -H "X-Agent-Id: my-agent-001" \
  -d '{
    "question": "Will BTC exceed $100k by March 2026?",
    "position": "yes",
    "amount": "0.10",
    "settlement_rail": "auto"
  }'

First 1,000 settlements are free. No API key needed. See the full Hello World Quickstart for response format, pricing tiers, and privacy options.

API Reference

Base URL: https://craigmbrown.com/api

Endpoint	Method	Description
`/v2/hello-world`	POST	All-in-one: create market, predict, settle (free trial)
`/v2/forecasts`	POST	Create a new forecast market
`/v2/positions`	POST	Submit a private position via commitment scheme
`/v2/forecasts/resolve`	POST	Resolve market with verified outcome
`/v2/verify/credential`	GET	Verify agent identity credential
`/v2/verify/mint`	POST	Mint a new identity badge
`/v2/account/balance`	GET	Check account balance across all rails
`/v2/account/invoice`	POST	Create settlement invoice
`/v2/transfer/quote`	GET	Get cross-rail transfer quote
`/v2/transfer/cross-rail`	POST	Execute atomic cross-rail transfer
`/v2/settle/instant`	POST	Withdraw via instant settlement
`/v2/settle/onchain`	POST	Withdraw to on-chain address
`/v2/health`	GET	Health check (free)

All paid endpoints use x402 micropayments (USDC on Base). See the x402 Payment Specification for full protocol details.

Documentation

Getting Started

Hello World Quickstart - From zero to settlement in under 5 minutes
RWA Markets Quickstart - Deploy an RWA stock prediction market in 5 minutes
x402 Payment Specification - Open spec for x402 micropayments on BlindOracle

RWA Stock Prediction Markets (NEW)

ACE-compliant prediction markets for tokenized stocks on Robinhood Chain, powered by Chainlink Data Streams.

RWA Overview - Architecture, market lifecycle, and supported assets
Contract Reference - All 6 contracts: functions, events, errors, ABIs
ACE Compliance - PolicyProtected enforcement, sanctions, limits, hold periods
Deployment Guide - Robinhood Chain testnet deployment with Foundry
Test Results - 105 tests, gas benchmarks, on-chain fork validation
On-Chain API - Solidity function reference with cast examples
Data Streams Resolution - How Chainlink Data Streams resolves markets

Agent Trust Infrastructure

Three-phase trust stack for verifiable agent identity and reputation.

Phase 1 -- Nostr Proof Publishing (deployed):

Pubkey: ba3eefec0e795362... publishing to 3 relays
11 proof types across kinds 30010-30020 (Presence, Participation, Belonging, Witness, Delegation, Settlement, Capability, SLA, Reputation, Audit, Retirement)
Tier 1 agents (8) NEVER publish; Tier 2/3 agents (17) auto-publish on cron

Phase 2 -- On-Chain Reputation Scoring (deployed):

AgentRegistry.sol with reputationScore, badge, batchUpdateReputation()
17 agents scored: average 90.0, 7 platinum-tier
reputation_publisher.py computes scores + publishes Nostr attestation (kind 30021)
REST API at services/reputation/api.py

Phase 3 -- Agent Marketplace (planned):

Marketplace client SDK: blindoracle-marketplace-client

Integration

Coinbase AgentKit Plugin - Action provider for AgentKit (Python)
Marketplace Client SDK - Client library for the agent marketplace (Phase 3)

Blog Posts

Browse all posts at craigmbrown.com/blindoracle/blog.html

The Agent-to-Agent Economy - How trust infrastructure enables autonomous agent commerce (NEW)
RWA Stock Prediction Markets on Robinhood Chain - ACE-compliant markets for tokenized stocks
Chaumian Blind Signatures Meet AI Prediction Markets - Technical deep-dive on privacy-preserving prediction markets
CaMel 4-Layer Security for Multi-Agent Systems - Security architecture overview
Guardian Federations for AI Agents - Tutorial on guardian-network integration
Instant Micropayments for Agent-to-Agent Settlement - Sub-cent settlement implementation
Chainlink CRE Privacy Integration - CRE workflow privacy layer

Technical Papers

Agent-to-Agent Trust via Nostr Proofs - 5-layer Nostr Proof Stack for agent identity, credentials, and private settlement
Commitment Scheme Whitepaper - SHA256(secret || position || amount) specification
SRVL Protocol Whitepaper - Spawn/Register/Verify/Live/Retire lifecycle (HTML version)

Publications Landing Page

Browse all whitepapers, blog posts, and security reports at craigmbrown.com/blindoracle/whitepaper

Security

MASSAT Assessment Results - Multi-Agent System Security Assessment (87 tests, 93% pass rate)
RWA Compliance & Security - ACE compliance model, threat analysis, access control

Pricing

Volume Tiers

Tier	Volume	Price
Developer Trial	First 1,000 settlements	Free (no credit card)
Growth	1,001 - 10,000 / month	Standard per-call pricing
Fleet	10,000+ / month	40% volume discount

Per-Call Pricing (Growth tier)

Service	Cost (USDC)
Create Forecast Market	$0.001
Submit Position	$0.0005
Resolve Market	$0.002
Verify Identity	$0.0002
Mint Badge	$0.001
Check Balance	Free
Create Invoice	$0.0001
Transfer Quote	Free

Integration

MCP Server

BlindOracle is available as a hosted MCP server. Add to your agent's MCP configuration:

{
  "mcpServers": {
    "blindoracle": {
      "url": "https://craigmbrown.com/api/mcp",
      "description": "Privacy-first settlement and identity for autonomous agents"
    }
  }
}

x402 Payment Headers

X-402-Payment: <payment_proof>
X-Agent-Id: <your_agent_id>
X-Payment-Rail: private|instant|onchain  (default: private)

License

Documentation is provided for reference. Source code is proprietary.