# Julie Autonomous Security Agent Machine-to-Machine Agents Specification
Agent: Julie Autonomous Security Network
Version: 3.6.0
Protocol: x402 (RFC-compliant HTTP 402) / ERC-8004 / Model Context Protocol (MCP)
Core-Features: 35-chain honeypot check, 0.15ms SSE pre-pair stream, 1-click $1 session pass, free bot health-check
Supported-Chains: 35 EVM Networks (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)
Bridge-Routes: 1,190 Direct Bilateral Route Permutations
Execution-Latency: ~0.5ms Static Bytecode Decompilation
Rate-Limit: 120 requests/minute (Bursts to 300)

Payment-Specification:
  Network: eip155:8453 (Base Mainnet)
  Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Base Native USDC)
  Amount: 10000 (0.01 USDC, 6 Decimals)
  PayTo: 0x75F05Da87cDFf3f6bAcAc3C07CD49F1D7dC7b20C
  Payment-Rails:
    1. 1-Click Auto Pass: Append ?auto_pass=starter to audit request or send X-Auto-Session-Pass: starter ($1.00 Base USDC, 125 scans)
    2. Direct Base Transfer: Transfer USDC to PayTo and send X-Payment-Tx: <tx_hash> ($1.00 or $5.00 Base USDC)
    3. Standard x402: Request -> HTTP 402 Challenge -> EIP-712 Signature Permit -> Retry with PAYMENT-SIGNATURE Header ($0.01 Base USDC)
  Integration-Guide: https://julie.freysa.dev/integrate
  Live-Activity-Signal: https://julie.freysa.dev/api/live/activity
  Quick-Integration-Example-JS: https://julie.freysa.dev/examples/julie_5line_check.js
  Quick-Integration-Example-PY: https://julie.freysa.dev/examples/julie_5line_check.py

Pre-Pair-Stream-SSE: https://julie.freysa.dev/api/stream/pre-pair (0.15ms latency, 3 free trial alerts, session continuation)
Agent-Tools & Schemas:
  Pre-Pair-Stream: https://julie.freysa.dev/api/stream/pre-pair
  MCP-Endpoint: https://julie.freysa.dev/mcp
  OpenAPI-Spec: https://julie.freysa.dev/openapi.json
  Agent-Card: https://julie.freysa.dev/.well-known/agent.json
  x402-Manifest: https://julie.freysa.dev/.well-known/x402
  SSE-Stream: https://julie.freysa.dev/api/feed/stream
  Dynamic-SVG-Badge: https://julie.freysa.dev/badge/{chain}/{contract}.svg
  Shields-IO-Badge: https://julie.freysa.dev/badge/shield/{chain}/{contract}.json
  Security-Guide-Hub: https://julie.freysa.dev/security
  Badge-Embed-Studio: https://julie.freysa.dev/badge
  Pocket-PWA-App: https://julie.freysa.dev/app (Multi-language: /app/es, /app/pt, /app/tr, /app/id, /app/hi)
  LangChain-Tool: https://julie.freysa.dev/actions/langchain_julie_tool.py
  Smolagents-Tool: https://julie.freysa.dev/actions/smolagents_julie_tool.py
  ElizaOS-Plugin: https://julie.freysa.dev/actions/eliza_julie_security_plugin.ts
  AgentKit-Action: https://julie.freysa.dev/actions/coinbase_agentkit_julie_guard.ts
  Multi-Chain-Sniper-Starter: https://julie.freysa.dev/examples/multi_chain_sniper_starter.zip
  Ethereum-Sniper-Example: https://julie.freysa.dev/examples/ethereum_sniper.js
  BSC-Sniper-Example: https://julie.freysa.dev/examples/bsc_sniper.js
  Arbitrum-Sniper-Example: https://julie.freysa.dev/examples/arbitrum_sniper.js
  Polygon-Sniper-Example: https://julie.freysa.dev/examples/polygon_sniper.js
  Base-Sniper-Starter: https://julie.freysa.dev/examples/base_sniper_starter.zip
  Chains-Status-Matrix: https://julie.freysa.dev/api/chains/status
  Smithery-Config: https://julie.freysa.dev/smithery.yaml
  Sniper-Middleware: https://julie.freysa.dev/SNIPER_BOT_MIDDLEWARE.md

API-Endpoints:
  Status-Health: https://julie.freysa.dev/api/status (Free, lightweight heartbeat endpoint for bots & agents; no scans consumed)
  Agent-Guide: https://julie.freysa.dev/agents (Clean one-page AI agent and sniper bot integration guide)
  Session-Balance-API: https://julie.freysa.dev/api/session/balance (Check active scans remaining and expiration by session_key or payer)
  Chains-Status-API: https://julie.freysa.dev/api/chains/status (Live decompiler status, latency, DEX mappings across 35 chains)
  Audit-API: https://julie.freysa.dev/api/audit?contract={0xaddress}&chain={chain} (0.01 Base USDC via x402)
  Batch-Audit-API: https://julie.freysa.dev/api/batch/audit (0.05 Base USDC, POST JSON contracts array, up to 10 tokens)
  Bridge-Audit-API: https://julie.freysa.dev/api/bridge/audit?src_chain={src}&src_contract={0xaddr}&dst_chain={dst}&dst_contract={0xaddr}
  Threat-Feed-JSON: https://julie.freysa.dev/api/feed/latest
  Delta-Feed-Polling: https://julie.freysa.dev/api/feed/delta?since={unix_ts}&filter={safe|honeypot|all}&chain={chain}
  Session-Pass-API: https://julie.freysa.dev/api/session/create (Volume Passes: $1.00 for 125 scans [+25% promo bonus], $5.00 for 750 scans [+50% promo bonus], $20.00 for 4,000 scans [+100% double credits bonus] with 0.5ms bypass)
  Postman-Collection: https://julie.freysa.dev/postman.json
  Threat-Feed-RSS: https://julie.freysa.dev/api/feed/rss.xml

Session-Pass-Examples:
  # Fastest Path for Simple Bots (1-Click Fallback):
  # 1. Hit free quota -> Receive 402 challenge
  # 2. Add ?auto_pass=starter to URL: GET /api/audit?contract=0x...&auto_pass=starter
  # 3. Activates 125-scan pass + returns full audit in the same request. Reuse returned X-Session-Key.

  # 1-Click Fallback Session Pass on GET /api/audit (for callers with exhausted free scans):
  # Add ?auto_pass=starter to audit request or header X-Auto-Session-Pass: starter
  curl "https://julie.freysa.dev/api/audit?chain=base&contract=0x4200000000000000000000000000000000000006&auto_pass=starter"
  # Returns audit result in body + X-Session-Key header (124 remaining scans) upon x402 settlement.

  # Direct Session Pass Creation (POST /api/session/create):
  # 100% of settlement routes directly to Master Settlement Vault: 0x75F05Da87cDFf3f6bAcAc3C07CD49F1D7dC7b20C in Base Native USDC.
  # Example 1: $1.00 Starter Pass (125 scans, 7-day validity)
  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>"}'

  # Example 2: $5.00 Pro Pass (750 scans, 14-day validity)
  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>"}'

  # Example 3: $20.00 Institutional Swarm Pass (4,000 scans, 30-day validity)
  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>"}'

  # Usage after receiving session_key:
  curl -H "X-Session-Key: <YOUR_SESSION_KEY>" "https://julie.freysa.dev/api/audit?chain=base&contract=0x..."

Trading-Bot-Operators (Freqtrade, Hummingbot, Custom Snipers):
  Fastest-One-Line: curl -s https://julie.freysa.dev/client.py | python3
  Multi-Chain-Direct-Transfer: Send 0.0004 ETH (Base/Arb), 0.0016 BNB (BSC), or 1.00 USDC to 0x75F05Da87cDFf3f6bAcAc3C07CD49F1D7dC7b20C
  Retry-Header: X-Payment-Tx: <YOUR_TRANSACTION_HASH>
  Auto-Pass-Syntax: GET /api/audit?chain=base&contract=0x...&auto_pass=starter&payer=0xYourFundedWallet
  Drop-in-Snippets: https://julie.freysa.dev/integrate

Teams-And-Companies:
  Multi-Bot-Shared-Key: One $5 (750 scans) or $20 (4,000 scans) pass can be shared across all your trading bots and servers via X-Session-Key.
  Expense-Receipt: Instant JSON receipt returned on creation for corporate accounting.
  Team-Overview: https://julie.freysa.dev/enterprise