# Julie Autonomous Security Agent
> Instant 0.5ms EVM opcode forensics and honeypot screening across 35 production blockchains (Base, Ethereum, Arbitrum, Optimism, BSC, Polygon, Linea, ZKsync, Sei, Sonic, Avalanche, Scroll, Mantle, Celo, Blast, Gnosis, Cronos, Mode, Metis, Fraxtal, Taiko, Manta, Boba, Kava, Fantom, CoreDAO, Flare, Songbird, X Layer, Aurora, Telos, Wanchain, Rootstock, IoTeX, Zora). Features 35-chain honeypot check, real-time SSE pre-pair stream (/api/stream/pre-pair), 1-click $1 session pass, and free bot health-check (/api/status). Audits 1,190 cross-chain bridge routes. Pay 0.01 USDC on Base per call via x402.

## Paid Machine-to-Machine Security Endpoint (x402 v2)
- GET https://julie.freysa.dev/api/audit?contract={0xaddress}&chain={chain}
- Price: 0.01 USDC per call, network eip155:8453 (Base Mainnet), scheme exact
- payTo: 0x75F05Da87cDFf3f6bAcAc3C07CD49F1D7dC7b20C
- Facilitator: https://facilitator.payai.network
- Supported Chains (35): base, ethereum, arbitrum, optimism, bsc, polygon, linea, zksync, sei, sonic, avax, scroll, mantle, celo, blast, gnosis, cronos, mode, metis, fraxtal, taiko, manta, boba, kava, fantom, core, flare, songbird, xlayer, aurora, telos, wanchain, rootstock, iotex, zora
- Bridge Route Audits (1,190 routes): GET https://julie.freysa.dev/api/bridge/audit?src_chain={src}&src_contract={0xaddr}&dst_chain={dst}&dst_contract={0xaddr}
- Sub-Millisecond Pre-Pair Sniper SSE Stream: GET https://julie.freysa.dev/api/stream/pre-pair (0.15ms push stream for newly created Uniswap V3 pools on Base and Arbitrum; 3 free trial alerts, then continuous streaming with X-Session-Key or ?session_key= via Starter Pass $1.00 USDC or Pro Pass $5.00 USDC)
- Free demo preview: https://julie.freysa.dev/api/audit?contract=demo
- Free Bot Heartbeat / Health Check: GET https://julie.freysa.dev/api/status (Free, lightweight endpoint; trading bots and snipers should use this for uptime checks instead of /api/audit to avoid consuming demo scans)
- 1-Click Session Pass Fallback (?auto_pass=starter): Append `?auto_pass=starter` to any exhausted GET /api/audit call to seamlessly unlock 125 scans on payment.
- Direct On-Chain Transfer (X-Payment-Tx): Transfer 1.00 or 5.00 Base USDC directly to vault (0x75F05Da87cDFf3f6bAcAc3C07CD49F1D7dC7b20C) and pass `X-Payment-Tx: <tx_hash>` to unlock instantly.
- 5-Minute Bot Integration Guide: https://julie.freysa.dev/integrate
- Live Operational Activity Signal: https://julie.freysa.dev/api/live/activity
- Dynamic Security Badges: GET https://julie.freysa.dev/badge/{chain}/{contract}.svg (Embed live SVG verification directly in READMEs and token dashboards).
- Pre-Trade Bot Drop-in & Tool Comparison: https://julie.freysa.dev/compare
- Standalone Desktop & Always-On PWA: https://julie.freysa.dev/app (Installable directly via browser on Desktop/Mobile)
- Multi-Language Pocket PWA Scanner: https://julie.freysa.dev/app (6 supported languages: EN, ES, PT, TR, ID, HI with 5 free high-speed scans per device).
- Honeypot Educational & Security Hub: https://julie.freysa.dev/security (Detailed red-flag checklist in 6 languages).
- High-Speed Session Passes ($1.00 for 125, $5.00 for 750, $20.00 for 4,000 scans): POST https://julie.freysa.dev/api/session/create
- Live 35-Chain Status & Latency Matrix: https://julie.freysa.dev/api/chains/status
- Multi-Chain Sniper Starter Package: https://julie.freysa.dev/examples/multi_chain_sniper_starter.zip
- PancakeSwap BSC Sniper: https://julie.freysa.dev/examples/bsc_sniper.js
- Camelot Arbitrum Sniper: https://julie.freysa.dev/examples/arbitrum_sniper.js
- QuickSwap Polygon Sniper: https://julie.freysa.dev/examples/polygon_sniper.js

## 1-Click Session Pass Fallback (GET /api/audit?auto_pass=starter)
Fastest path for simple bots:
1. Hit 5-free-scan quota -> receive 402 challenge.
2. Append `?auto_pass=starter` (or `X-Auto-Session-Pass: starter` header) to `GET /api/audit`.
3. Activates session pass ($1.00 for 125 scans) + returns audit in the same request. Reuse returned `X-Session-Key` for 0.5ms scans.

Upon settlement of $1.00 USDC, Julie executes the audit in the same request, returns the audit report in the body, and emits `X-Session-Key` with remaining credits in the headers for all subsequent calls.

## Pre-Funded Bot Session Passes (POST /api/session/create)
Automated trading bots, snipers, and AI agent swarms can deposit Base Native USDC directly to create high-speed pre-authorized sessions with 0.5ms execution and zero per-trade signing delay. 100% of funds settle directly into Master Settlement Vault: 0x75F05Da87cDFf3f6bAcAc3C07CD49F1D7dC7b20C.

### Exact JSON Examples:
1. Starter Pass ($1.00 USDC - 125 scans, 7-day validity):
```bash
curl -X POST https://julie.freysa.dev/api/session/create \
  -H "Content-Type: application/json" \
  -d '{"tier": "starter_pass", "amount_usdc": "1.00", "payer": "<YOUR_BASE_WALLET_ADDRESS>"}'
```

2. Pro Pass ($5.00 USDC - 750 scans, 14-day validity):
```bash
curl -X POST https://julie.freysa.dev/api/session/create \
  -H "Content-Type: application/json" \
  -d '{"tier": "pro_pass", "amount_usdc": "5.00", "payer": "<YOUR_BASE_WALLET_ADDRESS>"}'
```

3. Institutional Swarm Pass ($20.00 USDC - 4,000 scans, 30-day validity):
```bash
curl -X POST https://julie.freysa.dev/api/session/create \
  -H "Content-Type: application/json" \
  -d '{"tier": "institutional_pass", "amount_usdc": "20.00", "payer": "<YOUR_BASE_WALLET_ADDRESS>"}'
```

### Session Usage:
Pass the returned session token in request headers for instantaneous audit verification:
```bash
curl -H "X-Session-Key: <YOUR_SESSION_KEY>" "https://julie.freysa.dev/api/audit?chain=base&contract=0x4200000000000000000000000000000000000006"
```

## Agent & Machine-Readable Discovery
- https://julie.freysa.dev/compare (Julie vs Manual Checks & Pre-Trade Bot Drop-in Guide)
- https://julie.freysa.dev/app (Desktop & Mobile Progressive Web App - Offline Capable)
- https://julie.freysa.dev/agents (Dedicated One-Page "For AI Agents" & Bot Integration Guide)
- https://julie.freysa.dev/api/session/balance (Check Session Pass Credits, Expiration & Top-Up Status)
- https://julie.freysa.dev/agents.txt (A2A Agent Manifest)
- https://julie.freysa.dev/.well-known/agent.json (Universal Agent-Card JSON)
- https://julie.freysa.dev/.well-known/x402 (RFC-Compliant HTTP 402 Manifest)
- https://julie.freysa.dev/mcp (Model Context Protocol Tool Manifest for Claude, Cursor & LLM Swarms)
- https://julie.freysa.dev/openapi.json (OpenAPI 3.1.0 Machine-Readable Spec)
- https://julie.freysa.dev/smithery.yaml (Smithery Agent Registry Config)
- https://julie.freysa.dev/SNIPER_BOT_MIDDLEWARE.md (Drop-in <15 Line Pre-Trade Guard for Python & Node.js Bots)
- https://julie.freysa.dev/api/feed/stream (Real-Time Server-Sent Events / SSE Sub-Second Malicious Bytecode & Safe Contract Stream)
- https://julie.freysa.dev/badge/shield/{chain}/{contract}.json (Dynamic Shields.io Standard Badge Endpoint)
- https://julie.freysa.dev/actions/langchain_julie_tool.py (LangChain & LangGraph Drop-in Tool Provider)
- https://julie.freysa.dev/actions/smolagents_julie_tool.py (HuggingFace Smolagents Drop-in Tool)
- https://julie.freysa.dev/actions/coinbase_agentkit_julie_guard.ts (Coinbase AgentKit Action Provider)
- https://julie.freysa.dev/actions/eliza_julie_security_plugin.ts (ElizaOS Security Plugin)
- https://julie.freysa.dev/api/feed/latest (Real-Time 35-Chain Malicious Bytecode Threat Stream JSON)
- https://julie.freysa.dev/api/feed/rss.xml (Syndicated Threat Stream RSS)
- https://julie.freysa.dev/api/status (Real-Time Daemon Health & Telemetry - Free Bot Heartbeat)