Younanix

{
  "schema_version": "1.0",
  "name": "Younanix",
  "description": "Excellence Distilled \u2014 For Agents That Demand More. The first luxury Arete Memory Layer for autonomous AI agents. Paid queries return evidence-backed Arete briefs with value scores, recommended actions, implementation patterns, failure modes, and source evidence.",
  "url": "https://younanix.com",
  "canonical_url": "https://www.younanix.com",
  "fetch_notes": "Apex younanix.com returns a 302 redirect to www.younanix.com. Clients MUST follow redirects (curl -L, requests allow_redirects=True, fetch default). No WAF, no Bot Fight Mode, no User-Agent filtering, and no IP allowlist is in place \u2014 empty responses from the apex indicate an unfollowed 302, not cloaking. Edge function endpoints under bbuaschzvigwmoxekmoo.supabase.co/functions/v1/* do not redirect.",
  "walletAddress": "8HpqfMcPp87kuwxc2zZHyWYt95PBVo1s1y3eEEH5r2AL",
  "network": "solana:mainnet-beta",
  "paymentProtocol": "x402",
  "acceptedTokens": [
    "USDC"
  ],
  "services": [
    {
      "name": "Query distilled lessons (Bankr x402 Cloud \u2014 recommended)",
      "url": "https://x402.bankr.bot/0x3a8cdbf03de37e3eb52a600c5b36332f8f34dde7/younanix-memory",
      "method": "POST",
      "priceCents": 10,
      "description": "The simplest path to full access. Payment handled automatically by Bankr \u2014 no x402 headers needed. $0.10 USDC per query for a structured Arete brief."
    },
    {
      "name": "Query distilled lessons (Agentic.market \u2014 CDP x402 Bazaar)",
      "url": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1/x402-bazaar",
      "method": "POST",
      "priceCents": 10,
      "description": "Discoverable on the Coinbase Developer Platform x402 Bazaar (agentic.market). Returns HTTP 402 with a v2 payment-required envelope; pays 0.10 USDC on Base. Body: { query: string (required), max_lessons?: integer 1-25 }."
    },
    {
      "name": "Query distilled lessons (Direct x402)",
      "path": "/agent-query",
      "method": "POST",
      "priceCents": 10,
      "description": "Search the Arete Memory Layer directly. Requires x402 payment headers ($0.10 USDC on Solana or Base) and returns a structured, evidence-backed Arete brief."
    }
  ],
  "api": {
    "type": "rest",
    "base_url": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1",
    "endpoints": [
      {
        "path": "/agent-query",
        "method": "POST",
        "description": "Query the Younanix Arete Memory Layer. Returns distilled lessons plus value_score, answer_brief, recommended_action, best_lesson, implementation_pattern, failure_modes, confidence_notes, and source_evidence.",
        "authentication": {
          "type": "x402",
          "currency": "USDC",
          "amount": "0.10",
          "supported_chains": {
            "solana": {
              "recipient_wallet": "8HpqfMcPp87kuwxc2zZHyWYt95PBVo1s1y3eEEH5r2AL",
              "usdc_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
            },
            "base": {
              "recipient_wallet": "0xaa63d495e25e490f169235a4bffcb02d9728e466",
              "usdc_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
            }
          },
          "required_headers": [
            "x402-signature",
            "x402-amount",
            "x402-currency",
            "x402-chain"
          ]
        },
        "rate_limit": {
          "requests": 100,
          "window": "1 hour",
          "identify_by": "x-agent-id header"
        },
        "request_body": {
          "query": "string (required) \u2014 natural language search query",
          "max_lessons": "number (optional, default 10) \u2014 max results to return",
          "channels": "string[] (optional) \u2014 filter by source channels",
          "messages": "string[] (optional) \u2014 raw messages for live extraction"
        },
        "response": {
          "lessons": [
            {
              "problem": "string",
              "root_cause": "string",
              "lesson_learned": "string",
              "confidence": "number (0.0-1.0)",
              "source_ts": "ISO 8601 timestamp",
              "category": "debugging|performance|architecture|reliability|security|ux|observability|database|frontend|infrastructure|trading|onchain|token-launch|rug-pull|product-postmortem|startup-failure|multi-agent-coordination",
              "tags": "string[]",
              "source_platform": "string",
              "raw_evidence": "string",
              "channel": "string|null"
            }
          ],
          "count": "number",
          "query": "string",
          "paid": "boolean",
          "value_score": "number (0-100) \u2014 paid-answer utility score",
          "answer_brief": "string \u2014 concise premium synthesis",
          "recommended_action": "string \u2014 concrete next step",
          "best_lesson": "object|null \u2014 strongest matched lesson with why_matched reasons",
          "implementation_pattern": "string \u2014 reusable technical pattern or process direction",
          "failure_modes": "string[] \u2014 mistakes to avoid",
          "confidence_notes": "string \u2014 why the answer is high/medium/low confidence",
          "source_evidence": "object[] \u2014 source excerpts supporting the answer",
          "insufficient_knowledge": "boolean \u2014 true when no premium-strength match exists"
        }
      },
      {
        "path": "/mcp-server",
        "method": "POST",
        "description": "MCP (Model Context Protocol) server endpoint. Connect from Claude Desktop, Cursor, Windsurf, or any MCP-compatible client. Provides degraded lesson previews (problem, category, tags only). Full details require the paid endpoints.",
        "authentication": {
          "type": "none"
        },
        "rate_limit": {
          "requests": 1,
          "window": "per session",
          "identify_by": "x-agent-id header or client IP"
        },
        "protocol": "MCP Streamable HTTP"
      },
      {
        "path": "/x402-bazaar",
        "method": "POST",
        "description": "CDP x402 Bazaar (agentic.market) discovery endpoint. Returns HTTP 402 with x402 v2 payment-required envelope and Bazaar discovery extension. On a paid request forwards to /agent-query and returns the same Arete brief.",
        "authentication": {
          "type": "x402",
          "version": 2,
          "currency": "USDC",
          "amount": "0.10",
          "network": "eip155:8453",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0xaA63D495e25e490f169235A4BfFCb02D9728E466"
        },
        "request_body": {
          "query": "string (required) \u2014 natural language query",
          "max_lessons": "integer (optional, 1-25)"
        },
        "discovery": {
          "registry": "agentic.market",
          "extension": "bazaar"
        }
      },
      {
        "name": "Bankr x402 Cloud (recommended)",
        "path": "/younanix-memory",
        "url": "https://x402.bankr.bot/0x3a8cdbf03de37e3eb52a600c5b36332f8f34dde7/younanix-memory",
        "method": "POST",
        "description": "The simplest path to full Younanix access. $0.10 USDC per query \u2014 payment handled automatically by Bankr, no x402 headers needed.",
        "authentication": {
          "type": "x402",
          "currency": "USDC",
          "amount": "0.10"
        }
      }
    ]
  },
  "mcp": {
    "endpoint": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1/mcp-server",
    "transport": "streamable-http",
    "tools": [
      {
        "name": "query_lessons",
        "description": "Search distilled engineering lessons by natural language query. Returns degraded previews (1 free query per session). Full access via Bankr x402 Cloud or direct x402 endpoint."
      },
      {
        "name": "query_lessons_full",
        "description": "Full V7 lessons (root_cause, lesson_learned, practical_application, solutions_that_worked, code_pattern, evidence). Requires x-agent-key header issued by Younanix admin.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "query_lessons_premium",
        "description": "Premium Arete brief over MCP. Free for approved agents via x-agent-key. Otherwise pays inline via x402 USDC ($0.10, Solana or Base): resend the tool call with x402-signature, x402-amount, x402-currency, x402-chain headers. Without payment, returns a structured 402 quote with direct and Bankr endpoints.",
        "auth": "x-agent-key (free) OR inline x402 headers ($0.10 USDC)",
        "pricing": {
          "amount": "0.10",
          "currency": "USDC",
          "chains": [
            "base",
            "solana"
          ]
        }
      },
      {
        "name": "submit_incident_report",
        "description": "Submit a real production incident encountered by your agent. Admin-reviewed and auto-distilled into a draft lesson by the Hermes synthesis pipeline.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "report_skill_outcome",
        "description": "Report success/failure when your agent applied one or more Younanix lessons. Drives the confidence feedback loop. Cap: 100 reports per agent per 24h.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "start_task_run",
        "description": "Start an auditable Hermes task run with objective, plan, task graph, autonomy level, and risk level.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "record_subagent_trace",
        "description": "Record a specialist sub-agent brief and output for an existing Hermes task run.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "record_younanix_usage",
        "description": "Record a Younanix checkpoint/query, lessons used, insufficient-knowledge status, and plan impact for a task run.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "record_reflection",
        "description": "Record structured SELF-REFLECTION for a Hermes task run.",
        "auth": "x-agent-key: agent_id:secret"
      },
      {
        "name": "complete_task_run",
        "description": "Complete or update a Hermes task run with final status, verification evidence, blockers, and final result.",
        "auth": "x-agent-key: agent_id:secret"
      }
    ],
    "audit_workflow": [
      "start_task_run",
      "record_younanix_usage",
      "record_subagent_trace",
      "record_reflection",
      "complete_task_run"
    ],
    "required_headers": [
      "Content-Type: application/json",
      "Accept: application/json, text/event-stream"
    ]
  },
  "bankr_endpoint": "https://x402.bankr.bot/0x3a8cdbf03de37e3eb52a600c5b36332f8f34dde7/younanix-memory",
  "bazaar_endpoint": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1/x402-bazaar",
  "agentic_market_listing": "https://agentic.market",
  "capabilities": [
    "engineering-lessons-search",
    "real-time-lesson-extraction",
    "multi-source-ingestion",
    "mcp",
    "bankr",
    "x402",
    "x402-bazaar",
    "agentic-market",
    "premium-arete-briefs",
    "value-scored-paid-responses",
    "evidence-backed-actions",
    "hermes-auditability",
    "real-project-testing",
    "self-reflection-loop",
    "younanix-feedback-loop",
    "adversarial-auditor"
  ],
  "categories": [
    "debugging",
    "performance",
    "architecture",
    "reliability",
    "security",
    "ux",
    "observability",
    "database",
    "frontend",
    "infrastructure",
    "trading",
    "onchain",
    "token-launch",
    "rug-pull",
    "product-postmortem",
    "startup-failure",
    "multi-agent-coordination"
  ],
  "discovery": {
    "openapi": "/openapi.json",
    "llms_txt": "/llms.txt",
    "hermes_integration": "/hermes.md",
    "hermes_real_project_tests": "/hermes-real-project-tests.md",
    "hermes_phase9_polish": "/hermes-phase9-polish.md"
  },
  "adversarial_auditor": {
    "name": "Younanix Adversarial Auditor",
    "description": "Public red-team endpoint. Submits an architectural plan and receives a Chaos-Brief, a 0.0-1.0 stability score, top risks, guardrails, tier/price classification, and an HMAC-signed provenance tag.",
    "endpoint": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1/landing-audit",
    "method": "POST",
    "authentication": {
      "type": "none",
      "notes": "Public demo. IP rate-limited: 5/IP/hour, 60 global/hour."
    },
    "paid_endpoint": {
      "url": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1/audit-x402",
      "method": "POST",
      "authentication": {
        "type": "x402",
        "currency": "USDC",
        "chains": [
          "solana",
          "base"
        ],
        "amount_logic": "Tier-priced: $2.99 Quick Scan (url mode), $4.99 Standard, $9.99/$14.99/$19.99 Deep (manual mode). The HTTP 402 response quotes the exact price for THIS request.",
        "required_headers": [
          "x402-signature: Solana tx signature or Base tx hash of the USDC transfer",
          "x402-amount: USDC amount paid (must be >= the tier price)",
          "x402-currency: USDC",
          "x402-chain: solana or base (default solana)",
          "x402-claim: REQUIRED client-generated secret, 16-256 chars, binding the paid result to the payer. Omitting or shortening it returns 400 missing_claim. Generate a fresh random secret per request."
        ],
        "optional_headers": [
          "x-agent-id: per-caller rate-limit identity"
        ],
        "freshness": "On-chain payment must be within 5 minutes of the paid request. Signatures are replay-protected."
      }
    },
    "request_body": {
      "objective": "string (required, <=240 chars)",
      "stack": "string[] (optional, <=8 items, each <=32 chars)",
      "plan": "string (required, <=4000 chars)"
    },
    "response": {
      "audit_id": "string (uuid)",
      "status": "complete|failed",
      "chaos_brief": "string",
      "stability_score": "number (0.0-1.0)",
      "top_risks": "string[]",
      "guardrails": "string[]",
      "tier": "standard|deep",
      "price_usd": "number (informational equivalent paid-tier price)",
      "price_display": "string",
      "is_demo": "boolean (true on the public landing surface \u2014 no charge taken)",
      "provenance": {
        "audit_id": "string",
        "stability_score": "number",
        "signed_at": "ISO 8601",
        "alg": "HS256",
        "hash": "HMAC-SHA256 hex"
      }
    },
    "verify_endpoint": "https://bbuaschzvigwmoxekmoo.supabase.co/functions/v1/audit-verify",
    "browser_ui": "https://younanix.com/#auditor",
    "rate_limit": {
      "global": "30 audits/hour across all paid callers",
      "per_caller": "6 audits/hour, keyed on x-agent-id header when supplied, otherwise client IP",
      "identity_storage": "SHA-256 hashed; raw agent ids and IPs are never persisted",
      "on_exceed": "HTTP 429 { error: 'caller_rate_limit', retry_after_seconds } with Retry-After header, returned before payment verification so no payment is taken",
      "applies_to": "/audit-x402"
    }
  },
  "pricing": {
    "arete_brief": {
      "amount": "0.10",
      "currency": "USDC",
      "per": "query",
      "surfaces": [
        "agent-query",
        "bankr-x402-cloud",
        "x402-bazaar",
        "mcp:query_lessons_premium"
      ]
    },
    "standard_audit": {
      "amount": "1.49",
      "currency": "USD",
      "per": "audit",
      "surface": "audit-plan",
      "applies_when": "plan length <= 2000 chars AND stack does not include ROS2/multi-agent/swarm/robotic components"
    },
    "deep_production_audit": {
      "amount_range": "4.99-7.99",
      "currency": "USD",
      "per": "audit",
      "surface": "audit-plan",
      "applies_when": "plan length > 2000 chars OR stack includes ROS2/multi-agent/swarm/robotic components",
      "tier_logic": "4.99 base; 6.49 when plan>3000 chars or stack>4; 7.99 when plan>3500 chars or stack>6"
    },
    "landing_auditor": {
      "amount": "0.00",
      "currency": "USD",
      "per": "audit",
      "surface": "landing-audit",
      "notes": "Free public demonstration of platform verification standards. IP rate-limited. Tier and equivalent paid price are returned for transparency only."
    }
  }
}