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.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.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.

[Cost: $0.0003 USDC on Base & Solana] Check real-time health, latency, and operational status of upstream AI model providers (OpenAI, Anthropic, Gemini, DeepSeek, Groq) and Web3 RPCs (Base, Solana) before launching costly swarm workflows. Returns health status ('HEALTHY', 'DEGRADED', 'DOWN') and failover routes.

[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.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.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] Direct on-chain spot price, liquidity depth, and tick state oracle for Base L2. Queries live smart contract pools directly (Uniswap v3 and Aerodrome) without relying on centralized aggregators (CoinGecko) or stale off-chain indexers. Returns exact pool contract addresses, fee tiers, current block height, active liquidity reserves, and sqrtPriceX96 tick states. Supported pairs: WETH-USDC, cbBTC-USDC, AERO-USDC. Args: pair: Target trading pair symbol (default: 'WETH-USDC', also supports 'cbBTC-USDC', 'AERO-USDC'). payment_signature: Optional x402 Base USDC transaction hash or 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.

[Cost: $0.0001 USDC on Base & Solana] 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.0002 USDC on Base & Solana] Atomic idempotency vault & execution deduplication fence. 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).

Inspects a cryptocurrency wallet address or smart contract on-chain across multiple blockchains (Base, Ethereum, Polygon, Solana, Stellar, Ripple/XRPL). Auto-detects cryptographic format, verifies ledger existence, queries native coin balances (ETH/POL/SOL/XLM/XRP) and Circle Native USDC balances, and checks smart contract bytecode.

[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.

[Cost: $0.0003 USDC on Base & Solana] On-demand live network probe of any custom API endpoint or URL to measure SSL latency and reachability.

[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.

[Cost: $0.0005 USDC on Base & Solana] Repairs malformed, truncated, or syntactically broken JSON generated by smaller LLMs (Llama-3, Mistral). Strips markdown wrappers, wraps unquoted keys, replaces invalid single quotes, removes trailing commas, and auto-closes truncated brackets/braces into 100% valid JSON in sub-3ms. Args: raw_text: The malformed, unquoted, or broken JSON string emitted by the LLM. target_schema: Optional JSON schema dictionary (or schema JSON string) to validate and backfill. target_schema_json: Optional stringified JSON schema for backward compatibility. payment_signature: Optional x402 Base USDC transaction hash or developer 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.

[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.

[Cost: $0.001 USDC on Base & Solana] 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).