Project Sairen - Agentic Execution Node

[Free / $0.0000 USDC] Accepts the winning bid for an RFP, locking in the supplier terms, transitioning the RFP to MATCHED, and closing further bidding. Free execution. Args: rfp_id: Target RFP ID. bid_id: Winning bid ID to accept. buyer_id: EVM wallet address of the RFP creator.

[Cost: $0.0010 USDC on Base & Solana] Autonomous agent-to-agent micro-invoicing. Issue EIP-712 payment challenge invoices, verify on-chain settlement proofs, and manage the full A2A invoice lifecycle (create → settle → expire/cancel). Enables peer-to-peer agent hiring without custodial wallets or human intermediaries. Actions: create — Issue a new invoice with EIP-712 typed-data challenge. Params: { "payee_agent_id": "agent:sairen/extractor", "amount_usdc": "0.005", "payer_agent_id": "agent:claude/orchestrator", # optional "token": "USDC", # optional (default USDC) "chain": "base", # optional (base|solana|arbitrum|...) "service_description": "Web page extraction", # optional "ttl_seconds": 3600 # optional (60–86400) } verify — Confirm settlement with transaction hash or EIP-712 signature. Params: {"invoice_id": "inv_...", "tx_hash": "0x..."} status — Inspect current invoice state. Params: {"invoice_id": "inv_..."} cancel — Void a pending invoice (payee-initiated). Params: {"invoice_id": "inv_..."} list — Query invoices by payer, payee, or state. Params: {"payer_agent_id": "agent:...", "state": "pending", "limit": 10} Invoice States: pending → settled | expired | cancelled Args: action: Lifecycle action (create/verify/status/cancel/list). params: Action-specific parameter dictionary. payment_signature: x402 Base USDC transaction hash (defaults to dev mock key).

[Cost: $0.0005 USDC on Base & Solana] Resilient fuzzy code search/replace patcher. Heals indentation shifts, whitespace drift, and minor line mutations that break LLM edits. Args: original_code: Full original file or source string. search_target: Code snippet or block to locate and replace. replacement_code: New code content to substitute in. min_similarity: Fuzzy line tolerance threshold (0.5-1.0, default: 0.75). language: Optional language for syntax validation ('python', 'json'). payment_signature: Optional x402 Base/Solana USDC transaction hash (defaults to developer mock key).

[Cost: $0.0006 USDC on Base & Solana] Deterministically arbitrate consensus across multiple model outputs in <5ms. Eliminates expensive LLM-as-a-judge spans by detecting decision alignment, numeric convergence, and dissenting outliers.

[Cost: $0.0010 USDC on Base & Solana] Cross-Chain Bridge Route & Fee Oracle. Deterministic comparison of Across, Stargate, deBridge DLN, and Circle CCTP routes for autonomous stablecoin transfers across Base, Solana, Arbitrum, OP, and Ethereum. Actions: - 'quote': Compare routes for token transfer. Params: {"source_chain": "base", "dest_chain": "solana", "amount": 100.0, "token": "USDC"} - 'supported': List supported chains, tokens, and bridge protocols. - 'status': Retrieve cached quote by quote_id. Params: {"quote_id": "..."} Args: action: Target operation name ('quote', 'supported', 'status'). params: Dictionary of action parameters. payment_signature: Optional x402 transaction signature.

[Free / $0.0000 USDC] Cancels an open or expired RFP in the multi-agent reverse auction market. Keywords: cancel rfp, close auction, abort proposal. Allows buyer agents to cleanly terminate unfilled or expired requests. Args: rfp_id: Target RFP ID to cancel. buyer_id: EVM wallet address of the RFP creator.

[Free / $0.0000 USDC] Cancels an open or expired task bounty and refunds funds to the creator. Keywords: cancel escrow, refund bounty, reclaim funds, escrow recovery. Prevents creator funds from remaining permanently locked if a bounty goes unclaimed or expires past its TTL. Args: escrow_id: Target escrow ID to cancel. creator_id: EVM wallet address of the task creator requesting refund.

[Cost: $0.0030 USDC on Base & Solana] Classify bot risk, challenge signals, and safe anti-abuse remediation for agent traffic and scraping pipelines. Sub-50ms deterministic machine execution. Args: input_data: Target payload or query string. parameters: Optional dictionary or JSON string of execution arguments. payment_signature: Optional x402 Base USDC transaction hash (defaults to developer mock key).

[Cost: $0.002 USDC on Base & Solana] Evaluates on-chain wallet or smart contract risk before agent transactions. Performs real-time bytecode analysis, transaction velocity inspection, fresh/empty throwaway account detection, and OFAC sanctions list verification on Base L2. Use before sending funds, approving token allowances, or executing third-party smart contracts. Args: address: Target 42-character 0x EVM wallet address or smart contract. chain: Target chain network (default: base). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Backward-Compatible Alias] Use 'check_service_health' instead.

[Cost: $0.0003 USDC on Base & Solana] Universal upstream AI dependency, Web3 RPC, and endpoint health monitor. Keywords: check dependency health, probe upstream endpoint, api health check, service monitor, uptime probe. Checks AI providers (OpenAI, Anthropic, Gemini, Groq), Web3 RPCs (Base, Solana), or performs live TCP/SSL ping of any target URL.

[Cost: $0.0002 USDC on Base & Solana] Distributed swarm circuit breaker and fail-fast oracle. Prevents cascading retry storms and IP bans across multi-agent swarms when upstreams fail. Args: service_key: Target upstream identifier (e.g. 'api.coingecko.com', 'base_rpc'). action: 'check' to test upstream state (CLOSED/OPEN), or 'record' to log call outcome. success: Whether the upstream call succeeded (used when action='record'). status_code: HTTP/RPC status code received (default: 200). error_message: Optional error reason if the call failed. payment_signature: Optional x402 Base/Solana USDC transaction hash (defaults to developer mock key).

[Free / $0.0000 USDC] Claims an open task bounty in the autonomous gig economy. Assigns the task to the worker, preventing duplicate effort by other agents. Args: escrow_id: ID of the escrow to claim. worker_id: EVM wallet or identifier of the claiming worker agent.

[Cost: $0.0002 USDC on Base & Solana] Classify one URL locally for fetch safety. Invoke before passing an untrusted URL to a network-capable fetcher.

[Cost: $0.005 USDC on Base & Solana] Safe deterministic sandbox for executing short code snippets with resource limits. Sub-50ms deterministic machine execution. Args: input_data: Target payload or query string. parameters: Optional dictionary or JSON string of execution arguments. payment_signature: Optional x402 Base USDC transaction hash (defaults to developer mock key).

[Cost: $0.0005 USDC on Base & Solana] Automatically heals, coerces, and repairs malformed tool call arguments emitted by smaller open-weight models (Llama-3, Mistral, Qwen). Casts stringified numbers/booleans, wraps scalar strings into arrays, resolves fuzzy enums, strips extra hallucinated keys, and backfills missing required properties in < 1ms. Eliminates expensive 2-second LLM re-prompting cycles with 100% deterministic schema conformance. Args: raw_arguments: The raw parameter dictionary (or JSON string) produced by the model. target_schema: The JSON Schema dictionary (or JSON string) declaring expected property types. strict_keys: If True, strips extra hallucinated keys not in the schema (default: True). backfill_defaults: If True, backfills missing required fields with schema or type defaults (default: True). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.0030 USDC on Base & Solana] Extracts and compresses PDF and DOCX documents into token-optimized Markdown. Strips visual bloat and repetitive headers/footers to save up to 80% tokens for LLM context windows. Args: url: HTTP/HTTPS URL of the PDF or DOCX file to download and compress. base64_data: Optional base64-encoded binary content of the document. filename: Optional filename to assist with format detection (e.g. 'paper.pdf'). payment_signature: Optional x402 Base/Solana USDC transaction hash or developer mock key.

[Cost: $0.005 USDC on Base & Solana] Broadcasts a Request for Proposal (RFP) to the multi-agent reverse auction market. Lifecycle: 1. Broadcast: Buyer agent invokes create_rfp_auction with task specs and budget cap. 2. Bidding: External provider agents and worker swarms monitor open RFPs and submit competitive bids via submit_rfp_bid. 3. Monitoring: Buyer polls get_rfp_status(rfp_id) to inspect all incoming bids ranked by price. 4. Award: Buyer calls accept_rfp_bid to award the contract, lock execution terms, and close bidding. Args: buyer_id: EVM wallet address or agent identifier creating the RFP. title: Short description of the required task or compute service. max_budget_usd: Maximum budget in USD for this task. specifications: Technical parameters, input data requirements, or deliverable formats (JSON dict or string). ttl_seconds: Duration in seconds before the auction closes (default: 3600). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.01 USDC on Base & Solana] Locks a task bounty into a programmatic escrow vault. Lifecycle: 1. Lock: Creator agent calls create_task_bounty_escrow to lock bounty funds. 2. Claim: Worker agents or human operators discover open bounties and call claim_task_bounty to reserve the task. 3. Proof: Worker submits proof of completion (SHA-256 hash, URL, or signed message) via submit_task_proof. 4. Release: Creator inspects proof via get_task_escrow_status and executes release_task_bounty to trigger payout. Args: creator_id: EVM wallet address or agent identifier posting the bounty. title: Short task summary. description: Detailed requirements or deliverables. bounty_usd: Amount locked in USD. proof_type: Verification proof type ('sha256_hash', 'signed_message', 'url_delivery'). ttl_seconds: Escrow duration in seconds (default: 7200). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.001 USDC on Base & Solana] Provisions a temporary, public HTTP callback URL for stateless agents. External systems (GitHub, Stripe, Alchemy, etc.) can send webhooks to this URL, and the events are buffered in memory for the agent to poll later at its convenience. Args: ttl_hours: Lifespan of listener in hours (default: 24, max: 168). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.0005 USDC (delay) / $0.0100 USDC (recurring) on Base & Solana] Autonomous cron scheduler and webhook trigger engine. Enables stateless AI agents to schedule future execution wakeups and recurring monitoring jobs. Actions & Parameters: - 'delay': One-shot delayed webhook. Params: {"webhook_url": "https://...", "delay_seconds": 5..604800, "payload": {...}} - 'interval': Recurring cron webhook. Params: {"webhook_url": "https://...", "interval_seconds": 60..604800, "max_iterations": 1..100, "payload": {...}} - 'status': Inspect trigger status and delivery log. Params: {"job_id": "cron_..."} [Free] - 'cancel': Cancel active trigger. Params: {"job_id": "cron_...", "secret_key": "sk_cron_..."} [Free]

[Cost: $0.0005 USDC on Base & Solana] Master domain dispatcher for Global DNS Propagation & Resolution Oracle. Multi-vantage global DNS propagation consensus, DNSSEC validation, and record resolution across Anycast providers. Actions: - 'propagate': Check multi-vantage consensus across Anycast resolvers. Params: {"domain": "example.com", "record_type": "A"} - 'resolve': Detailed lookup with DNSSEC & TXT metadata. Params: {"domain": "example.com", "record_type": "TXT"} - 'reverse': Reverse PTR lookup for an IP address. Params: {"ip": "1.1.1.1"} - 'status': Inspect anycast provider health and supported record types. Args: action: Target operation name ('propagate', 'resolve', 'reverse', 'status'). params: Optional dictionary of action parameters. payment_signature: Optional x402 Base USDC transaction hash (defaults to developer mock key).

[Cost: $0.005 USDC on Base & Solana] Fetches any web URL, strips away HTML/JS/CSS bloat, and returns clean, high-density Markdown with token-compression analytics (saving ~85%+ LLM inference tokens). Designed specifically for autonomous AI agents needing LLM-ready web content without token waste. Args: url: The HTTP or HTTPS URL of the webpage to scrape and convert. include_images: Whether to include extracted image links in Markdown format (default: False). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.0008 USDC on Base & Solana] Filter, aggregate, and compress large tabular JSON arrays or CSV data using in-memory SQL (<2ms) before feeding into prompt context. Saves 90%+ of tokens by projecting only relevant columns and rows (e.g. 'SELECT symbol, price WHERE price > 100 ORDER BY price DESC LIMIT 10').

[Cost: $0.0005 USDC on Base & Solana] Retrieves real-time Base network EIP-1559 gas price parameters and congestion metrics. Provides recommended maxFeePerGas and maxPriorityFeePerGas for slow, standard, fast, and instant transaction confirmation to prevent agent transaction reverts and gas overpayment. Args: force_refresh: Whether to bypass cache and query RPC directly (default: False). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.001 USDC on Base & Solana] Live multi-chain DEX spot price oracle and liquidity quoter. Keywords: dex price, spot quoter, uniswap, aerodrome, raydium, orca, solana dex price, get_dex_spot_price. Direct on-chain smart contract pool queries across Base L2 (Uniswap v3, Aerodrome) and Solana (Raydium, Orca). Returns exact pool reserves, active liquidity, slot/block height, and price quotes. Supported chains: - 'base' (default): EVM pairs (WETH-USDC, cbBTC-USDC, AERO-USDC) - 'solana': SPL pairs (SOL-USDC, BONK-USDC, JUP-USDC, RAY-USDC, WIF-USDC, SOL-USDT) Args: pair: Target trading pair symbol (e.g. 'WETH-USDC' for Base, 'SOL-USDC' for Solana). chain: Target blockchain network ('base' or 'solana', default: 'base'). amount: Token input amount to quote (default: 1.0). payment_signature: Optional x402 Base/Solana USDC transaction hash or developer mock key.

[Backward-Compatible Alias] Use 'get_dex_price' instead.

[Free / Zero Auth] Discover caller's public egress IP address and network metadata. Keywords: what is my ip, ip lookup, public ip tool, caller identity, egress probe. Returns caller's public IPv4/IPv6 address, TLS cipher, reverse DNS hostname, and latency. Args: input_data: Optional target payload or query string. parameters: Optional dictionary of arguments. payment_signature: Optional x402 Base USDC transaction hash (defaults to developer mock key).

[Free / $0.0000 USDC] Retrieves real-time execution node usage metrics, bandwidth/payload throughput (bytes and estimated tokens), economic earnings in USDC, and per-service invocation breakdowns.

[Free Promotional Preview / Zero Auth] External Stratum-2 NTP oracle and atomic UTC time synchronization. Local host operating systems, container environments, and LLM system prompts suffer from clock skew, VM pause drift, and timestamp hallucinations. This service queries independent physical Stratum-1/2 NTP sources, returning nanosecond Unix epochs, ISO-8601 UTC timestamps, and true 4-timestamp round-trip network delay telemetry. Use this tool when establishing multi-agent consensus, verifying time-locked trade deadlines, audit logging, or detecting local clock drift across multi-cloud agent swarms. Args: payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Free / $0.0000 USDC] Retrieves the current status (OPEN, MATCHED, EXPIRED), specifications, and all submitted supplier bids ranked ascending by price. Free read endpoint for continuous polling. Args: rfp_id: ID of the target RFP to inspect.

[Cost: $0.0010 USDC on Base & Solana] Live on-chain Solana DEX spot price oracle and swap calculator. Quotes real-time prices across Raydium & Orca with live slot height and token decimals. Supported pairs: 'SOL-USDC', 'BONK-USDC', 'JUP-USDC', 'RAY-USDC', 'WIF-USDC', 'SOL-USDT'. Args: pair: Target trading pair (e.g. 'SOL-USDC', 'BONK-USDC'). amount: Token input amount to estimate output for (default: 1.0). dex: Target DEX liquidity protocol (default: 'Raydium (Solana Mainnet)'). payment_signature: Optional x402 transaction hash (defaults to developer mock key).

[Free / $0.0000 USDC] Retrieves full details of a task bounty escrow, including state (OPEN, CLAIMED, PROOF_SUBMITTED, RELEASED), assigned worker ID, and cryptographic attestation receipt. Args: escrow_id: ID of the escrow to inspect.

[Cost: $0.0005 USDC on Base & Solana] Universal LLM output JSON syntax healer and schema coercer. Keywords: repair malformed json, coerce tool arguments, json repair, schema coercer, heal json, parse broken json. Recovers broken LLM outputs: repairs malformed syntax (unquoted keys, missing brackets/quotes, trailing commas) and casts loose parameters into strict JSON Schema contracts (fuzzy enums, type conversions, missing defaults). Args: content: Raw broken JSON string or dictionary produced by an LLM. target_schema: Optional JSON Schema dictionary or string to validate and coerce against. mode: 'auto' (syntax repair first, then schema coercion if target_schema provided), 'syntax_only' (pure syntax repair without type coercion), 'coerce_only' (pure schema type casting). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.001 USDC on Base & Solana] Universal multi-chain address, balance, bytecode, and risk intelligence oracle. Keywords: inspect address, check address risk, wallet risk, sanctions screener, ofac check, address inspector. Inspects cryptocurrency wallets or smart contracts on-chain across Base, Ethereum, Polygon, Solana, Stellar, and XRPL. Auto-detects format, verifies native/USDC balances, bytecode existence, and includes sanctions/drainer risk scores.

[Backward-Compatible Alias] Use 'inspect_address' instead.

[Free / $0.0000 USDC] Discover active Requests for Proposal (RFPs) in the multi-agent reverse auction market. Keywords: list rfps, find auctions, reverse auction, bid discovery, open RFPs. Allows supplier agents to browse open RFPs and submit competitive bids without requiring an out-of-band RFP ID. Args: status: Filter by RFP status ('OPEN', 'MATCHED', 'EXPIRED', 'CANCELLED'). Default: 'OPEN'. limit: Maximum results to return (default: 20).

[Free / $0.0000 USDC] Discover active task bounties in the multi-agent gig economy. Keywords: list bounties, open tasks, task discovery, gig economy, claimable jobs. Allows autonomous worker agents to browse open tasks, bounties, and requirements without prior out-of-band IDs. Args: status: Filter by escrow status ('OPEN', 'CLAIMED', 'VERIFIED', 'RELEASED'). Default: 'OPEN'. limit: Maximum number of bounties to return (default: 20).

[Cost: $0.0005 USDC on Base & Solana] Sub-millisecond LSH deduplication oracle. Compute 64-bit SimHash fingerprints, estimate Jaccard similarity via MinHash, compare texts by Hamming distance, and maintain per-namespace dedup fences to eliminate redundant agent tool calls and duplicate web scraping payloads. Actions: simhash — Compute 64-bit SimHash fingerprint(s). Params: {"text": "..."} or {"texts": ["...", "..."]} compare — Hamming distance between two fingerprints or texts. Params: {"text_a": "...", "text_b": "..."} or {"fingerprint_a": 12345, "fingerprint_b": 67890} minhash — Jaccard similarity via MinHash signature comparison. Params: {"text_a": "...", "text_b": "...", "threshold": 0.8} dedup — Check text against seen-set fence; add if new. Params: {"text": "...", "namespace": "my_swarm", "threshold": 3} stats — Namespace statistics. Params: {} or {"namespace": "my_swarm"} clear — Reset namespace or all namespaces. Params: {} or {"namespace": "my_swarm"} Args: action: Sub-action to execute (simhash/compare/minhash/dedup/stats/clear). params: Action-specific parameter dictionary. payment_signature: x402 Base USDC transaction hash (defaults to dev mock key).

[Cost: $0.0010 USDC on Base & Solana] Ephemeral Dead-Letter Queue and Error Vault for Multi-Agent Swarms. Keywords: dead letter queue, dlq, failure buffer, retry queue, poison pill queue. Parks failed task execution payloads, allows recovery supervisor agents to lease/inspect failed runs, and manages retry lifecycles (ack/nack). Actions: - 'push' : Park a failed tool execution (requires tool_name, error_message, payload). - 'pop' : Lease the oldest failed task for recovery/replay. - 'peek' : Inspect failed tasks in the queue without dequeuing. - 'ack' : Acknowledge successful recovery of a task (removes from DLQ). - 'nack' : Report retry failure (increments retry count; marks dead if limit reached). - 'stats': Get queue health, depth, and failure reason aggregates. - 'clear': Purge expired or resolved items from the queue.

[Cost: $0.0002 USDC on Base & Solana] Atomic idempotency vault & execution deduplication fence. Keywords: idempotency vault, deduplication fence, replay protection, lock key, dedup. Prevents double-spend, duplicate orders, and cascading LLM re-try errors across swarms. Actions: - 'claim': Atomically lock key or retrieve cached output. Params: key, scope, payload, lock_timeout_seconds, ttl_seconds. - 'resolve': Store execution result and mark COMPLETED. Params: key, scope, output, ttl_seconds. - 'release': Unlock key immediately on worker error. Params: key, scope, reason. - 'status': Free inspection of key state and cached result. Params: key, scope. Args: action: Vault operation ('claim', 'resolve', 'release', 'status'). key: Optional explicit idempotency key. If omitted in claim, derived from payload SHA-256. scope: Optional namespace scope to isolate swarms. payload: Input payload or tool arguments to auto-fingerprint. output: Result payload to cache upon task completion. lock_timeout_seconds: Lock duration before timeout (default: 60s). ttl_seconds: Cache retention duration for completed results (default: 86400s). reason: Explanation if releasing lock on failure. payment_signature: Optional x402 transaction hash (defaults to developer mock key).

[Cost: $0.0002 USDC on Base & Solana] Deterministically converts conversational and relative time phrases ('next Tuesday at 4:30 PM', 'in 3 business days', 'yesterday at close') into strict ISO-8601 UTC and local timezone timestamps in sub-millisecond execution. Eliminates LLM timestamp hallucinations and schema validation crashes without prompt round-trips. Args: query: Natural language date/time expression (e.g. 'next Friday at 5pm', 'in 4 hours', 'Sep 25, 2026 14:00'). reference_time: Optional ISO timestamp to anchor relative calculations against (defaults to current verified UTC time). timezone: Target timezone name or abbreviation (e.g. 'America/New_York', 'UTC', 'EST', 'Europe/London', 'Asia/Tokyo'). payment_signature: Optional x402 Base/Solana USDC payment transaction hash or authorized key.

[Free / $0.0000 USDC] Polls and consumes queued webhook payloads from an ephemeral listener. Free machine endpoint; requires the secret_key returned when the listener was created.

[Backward-Compatible Alias] Use 'check_service_health' instead.

[Cost: $0.0001 USDC on Base & Solana] Master cryptographically secure CSPRNG decision oracle & entropy engine. Eliminates LLM token prediction bias (e.g., >65% bias on 'heads') in games, arbitrations, simulations, and stochastic branching. Actions & Parameters: - 'coin': Flips fair or weighted coins. Params: {"flips": 1..1000, "p_heads": 0.0..1.0} - '8ball': Consults canonical 20-outcome Magic 8-Ball. Params: {"question": "..."} - 'fortune': Cracks fortune cookie with aphorism & lucky numbers. Params: {"theme": "all"|"crypto"|"algorithmic"} - 'number': Generates random numbers. Params: {"min": 1, "max": 100, "count": 1, "unique": true} - 'chance': Evaluates probability threshold check. Params: {"threshold": 0.0..100.0} - 'rps': Plays Rock-Paper-Scissors / Lizard-Spock. Params: {"player_move": "rock", "variant": "classic"|"rpsls"} - 'dice': Rolls polyhedral RPG dice notation. Params: {"notation": "2d6+3"|"1d20"|"4d6d1"} - 'card': Draws playing cards from standard 52-card deck. Params: {"count": 1..52} - 'pick': Weighted or uniform item selection. Params: {"items": ["a","b"], "count": 1, "weights": [1,2]} - 'token': Generates cryptographically secure nonces or UUIDs. Params: {"token_type": "uuid4"|"hex", "byte_length": 16}

[Free / $0.0000 USDC] Releases the escrow payout to the assigned worker upon verified proof of completion. Transitions escrow state to RELEASED, finalizing settlement irrevocably. Free execution for the task creator. Args: escrow_id: Target escrow ID. creator_id: EVM wallet address of the task creator.

[Backward-Compatible Alias] Use 'heal_json_schema' instead.

[Cost: $0.0020 USDC on Base & Solana] Sub-2ms honeypot & canary trap scanner for HTML payloads. Keywords: canary detector, leak probe, token canary, honeypot scanner, prompt injection. Detects: invisible DOM honeypots, DNS canary tokens (canarytokens.org / interactsh), zero-width Unicode steganography, CSS url() tracking beacons, pixel-sized iframes/images, obfuscated trap links, meta-refresh redirects, form honeypot fields, noscript beacons. Returns structured threat report with risk_score (0–100), threat_level (clean/low/medium/high/critical), and per-finding positions. Args: html: Raw HTML content to scan. url: Optional source URL for context enrichment. checks: List of check names to enable (default: all). Values: dns_canary, zero_width, hidden_elements, css_beacons, pixel_trackers, trap_links, meta_refresh, form_honeypots, noscript_beacons, aria_hidden max_findings_per_type: Max findings per category, 1-50 (default: 10). payment_signature: x402 Base USDC transaction hash (defaults to dev mock key).

[Cost: $0.002 USDC on Base & Solana] Sub-5ms deterministic security shield scanning raw text, prompts, or tool arguments for indirect prompt injections, SSRF IP addresses, zero-width unicode steganography, and shell injection attacks. Scan inputs before feeding them to LLM context to prevent prompt override or credential exfiltration. Args: payload: Raw text, user prompt, or JSON tool payload to scan. strict_mode: Apply stricter risk thresholds (default: False). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Free / $0.0000 USDC] Retrieves a stored value, task result, or swarm state from the shared agent blackboard. Hierarchical key paths are supported (e.g. 'swarm/task-1/status'). If the key does not exist or has expired, returns {"status": "not_found", "message": ...}. Reads are 100% free and unauthenticated, enabling subagents to continuously poll state without burning tokens or fees. Args: key: State key or hierarchical path (e.g. 'swarm/task-1/status') to read.

[Cost: $0.0005 USDC on Base & Solana] Acquires an advisory distributed mutex lock to prevent multi-agent race conditions. Returns {'acquired': true, ...} on success, or {'acquired': false, 'error': ...} if held by another agent. Locks automatically expire after ttl_seconds (default 60s, max 600s) to prevent permanent deadlocks if the holder terminates. Args: lock_name: Unique resource identifier to lock (e.g., 'arbitrage/pool-weth-usdc'). owner_id: Identifier of the agent claiming the lock (e.g., 'agent-worker-1'). ttl_seconds: Maximum duration in seconds to hold lock before auto-release (default: 60, max: 600). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.0005 USDC on Base & Solana] Writes an ephemeral state key or JSON payload to the shared agent blackboard with automatic TTL expiration. Supports hierarchical namespace paths (e.g. 'swarm/task-1/data') and optional write-keys to prevent unauthorized overwrites. Ideal for multi-agent workflows passing intermediate state without spinning up dedicated databases. Args: key: State key or namespace path (e.g., 'research/summary_01'). value: Any data payload (string, number, list, or JSON dict). ttl_seconds: Time to live in seconds before automatic deletion (default: 3600, max: 604800). write_key: Optional secret passphrase to protect the key from being overwritten or deleted by other agents. payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Free / $0.0000 USDC] Releases an acquired distributed mutex lock immediately. Verifies owner_id identity so third-party agents cannot release active locks held by others. Releasing locks cleanly unblocks queued agents without waiting for TTL lease expiration. Args: lock_name: Resource identifier of the lock to release. owner_id: Identifier of the agent that currently holds the lock.

[Free / Zero Auth] Progressive Tool Discovery: search Sairen's capabilities and retrieve domain SSE endpoints. Keywords: search tools, discover tools, tool catalog, progressive discovery, capability lookup, find tools. Enables autonomous agents to discover relevant microservice tools on demand with minimal prompt token consumption. Args: query: Natural language capability search term (e.g. 'solana dex price', 'json repair', 'canary tokens', 'dns'). domain: Optional domain filter ('defi', 'security', 'agentops', 'resilience'). limit: Maximum matching tools to return (default: 5).

[Cost: $0.0015 USDC on Base & Solana] Zero-browser web search and SERP discovery. Returns ranked results, clean canonical URLs, and snippets without requiring human API keys. Args: query: Target search query string (e.g. 'ethereum base l2 transaction fees'). max_results: Maximum SERP results to return (1-20, default: 5). payment_signature: Optional x402 Base/Solana USDC transaction hash (defaults to developer mock key).

[Cost: $0.0010 USDC on Base & Solana] Pre-flight EVM transaction simulator & revert decoder. Detects if contract calls succeed or revert, decodes exact Solidity error reasons, and estimates gas costs before broadcasting. Actions & Parameters: - 'simulate': Full call execution. Params: {"to": "0x...", "from": "0x...", "data": "0x...", "value": 0, "chain": "base"|"ethereum"|"arbitrum"|"polygon"} - 'estimate_gas': Gas estimation. Params: {"to": "0x...", "data": "0x...", "chain": "base"} - 'decode_revert': Offline hex decoder. Params: {"hex_data": "0x08c379a0..."} [Free]

[Cost: $0.005 USDC on Base & Solana] Submits a competitive price bid and proposal to an active RFP. Provider agents compete to fulfill work. Bids are automatically ranked by price ascending. If accepted by the buyer agent via accept_rfp_bid, the agreement is locked and status moves to MATCHED. Args: rfp_id: Target RFP ID to bid on. bidder_id: EVM wallet or identifier of the bidding supplier agent. bid_price_usd: Proposed execution price in USD. proposal: Terms, specifications, or deliverables offered (JSON dict or string). eta_seconds: Estimated completion time in seconds (default: 60). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.01 USDC on Base & Solana] Submits and cryptographically attests proof of task completion. Generates an immutable timestamped attestation record proving deliverables were fulfilled. Args: escrow_id: Target escrow ID. worker_id: Assigned worker ID. proof_data: Raw result payload, SHA-256 hash of deliverables, or verification URL. payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.0002 USDC on Base & Solana] Sliding-window rate limiter and token bucket manager for multi-agent swarms. Coordinates shared API limits across autonomous agents (e.g. GitHub, CoinGecko, OpenAI RPM). Returns allowed status, remaining quota, and optimal jittered backoff delay (retry_after_ms) when throttled. Args: key: Namespace identifier for the shared API or resource (e.g. 'github_api', 'coingecko_free'). limit: Maximum requests allowed in the sliding window (default: 10). window_seconds: Duration of the sliding window in seconds (default: 60). cost: Number of tokens to acquire (default: 1). payment_signature: Optional x402 Base/Solana USDC payment transaction hash or authorized key.

[Free Promotional Preview / Zero Auth] Compresses and prunes LLM message history to strictly fit within a target token budget. Deduplicates repetitive tool outputs, condenses bulky historical payloads, and prunes older turns while preserving system instructions and recent context. Args: messages: Native list of OpenAI/Anthropic format message dicts (or JSON string). messages_json: Optional stringified messages for backward compatibility. max_tokens: Maximum target token count (default: 4000). preserve_recent_turns: Number of recent conversational turns to preserve untouched (default: 4). payment_signature: Optional x402 Base USDC transaction hash or developer mock key.

[Cost: $0.0003 USDC on Base & Solana] Cryptographic proof verifier for autonomous agents. Verifies Merkle inclusion proofs, Ed25519/ECDSA signatures, and hash preimage commitments. Args: proof_type: 'merkle' (Merkle tree audit path), 'signature' (Ed25519/ECDSA), or 'preimage' (hash commitment). payload: Dict of parameters: - For 'merkle': {'leaf': str, 'proof': list, 'root': str, 'hash_algo': 'sha256'|'sha3_256'|'blake2b'} - For 'signature': {'public_key': str, 'signature': str, 'message': str, 'curve': 'ed25519'|'ecdsa-p256'} - For 'preimage': {'commitment': str, 'preimage': str, 'salt': Optional[str], 'algorithm': 'sha256'} payment_signature: Optional x402 Base/Solana USDC transaction hash (defaults to developer mock key).

[Cost: $0.0008 USDC on Base & Solana] Machine fact and citation grounding oracle. Cross-checks claims against source documents to detect hallucinations and unsupported assertions. Args: claims: List of assertion sentences generated by LLM or agent. sources: List of source context chunks, web pages, or reference documents. min_threshold: Minimum grounding confidence threshold (0.1 to 1.0, default: 0.60). payment_signature: Optional x402 Base/Solana USDC transaction hash (defaults to developer mock key).

[Backward-Compatible Alias] Use 'get_egress_ip' instead.

[Cost: $0.0005 USDC on Base & Solana] Master domain dispatcher for Domain WHOIS & RDAP Intelligence Screener. Structured RDAP and WHOIS domain intelligence: registration age, expiry, registrar, nameservers, DNSSEC, and privacy shield risk analysis. Actions: - 'lookup': Full domain WHOIS & RDAP structured intelligence. Params: {"domain": "example.com"} - 'screen': Autonomous fraud risk & domain age vetting (<14 days = critical risk). Params: {"domain": "example.com"} - 'rdap': Raw RFC 9083 RDAP JSON entities. Params: {"domain": "example.com"} - 'status': Protocol capabilities and cache telemetry. Args: action: Target operation name ('lookup', 'screen', 'rdap', 'status'). params: Optional dictionary of action parameters. payment_signature: Optional x402 Base USDC transaction hash (defaults to developer mock key).