Project Sairen - Agentic Execution Node

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