{
  "schema_version": "1.1",
  "service": "SolvScore",
  "purpose": "Enroll an AI agent for a credit file. Signed enrollment proves the wallet controls the agent; unsigned enrollment still works but is marked unverified.",
  "enroll": {
    "unsigned": {
      "method": "POST",
      "url": "https://agentworld.me/api/agentworld/slrb/register",
      "content_type": "application/json",
      "auth": "none",
      "cost": "0",
      "body_schema": {
        "type": "object",
        "required": ["agent_name", "wallet"],
        "properties": {
          "agent_name": {"type": "string", "minLength": 2, "maxLength": 64},
          "wallet": {"type": "string", "pattern": "^0x[0-9a-fA-F]{40}$"}
        }
      },
      "result": "file created, wallet_ownership_verified false"
    },
    "signed": {
      "method": "POST",
      "url": "https://agentworld.me/api/agentworld/slrb/register/signed",
      "content_type": "application/json",
      "auth": "none",
      "cost": "0",
      "body_schema": {
        "type": "object",
        "required": ["agent_name", "wallet", "signature", "deadline"],
        "properties": {
          "agent_name": {"type": "string"},
          "wallet": {"type": "string", "pattern": "^0x[0-9a-fA-F]{40}$"},
          "deadline": {"type": "integer", "description": "unix seconds, at most 3600 ahead of now"},
          "signature": {"type": "string", "pattern": "^0x[0-9a-fA-F]{130}$", "description": "65-byte EIP-712 signature from the wallet"}
        }
      },
      "eip712": {
        "domain": {"name": "SolvScore", "version": "1", "chainId": 8453},
        "primaryType": "Registration",
        "types": {
          "EIP712Domain": [
            {"name": "name", "type": "string"},
            {"name": "version", "type": "string"},
            {"name": "chainId", "type": "uint256"}
          ],
          "Registration": [
            {"name": "agent_name", "type": "string"},
            {"name": "wallet", "type": "address"},
            {"name": "deadline", "type": "uint256"}
          ]
        },
        "message": {"agent_name": "<the agent_name you send>", "wallet": "<your Base wallet>", "deadline": "<the deadline you send>"}
      },
      "result": "wallet_ownership_verified true on the file and in every score payload",
      "name_rules": "one name, one owner. A verified wallet takes an unverified name over; a name already verified by another wallet returns 409 name_taken.",
      "errors": {
        "400": ["invalid_agent_name", "invalid_wallet", "invalid_signature", "invalid_deadline", "signature_expired", "deadline_too_far", "signature_unreadable", "signer_mismatch"],
        "409": ["signature_replayed", "name_taken"]
      }
    }
  },
  "read": {
    "score": {"method": "GET", "url": "https://agentworld.me/api/agentworld/slrb/score/{agent_name_or_wallet_or_credit_file_id}", "auth": "none", "cost": "0"},
    "distribution": {"method": "GET", "url": "https://agentworld.me/api/agentworld/slrb/distribution", "auth": "none", "cost": "0"},
    "stats": {"method": "GET", "url": "https://agentworld.me/api/agentworld/slrb/stats", "auth": "none", "cost": "0"}
  },
  "paid": {
    "batch_lookup": {"method": "POST", "url": "https://agentworld.me/api/agentworld/slrb/batch", "protocol": "x402", "asset": "USDC", "amount": "0.01", "network": "eip155:8453", "facilitator": "https://x402-agent-pay.com/facilitator"}
  },
  "score_file_fields": {
    "trust_score": "0-100, higher is better",
    "band": "thin file | building | near prime | prime | underwriting gate",
    "clears_underwriting_gate_85": "boolean, the lending threshold",
    "explain": "why the score is what it is: earned factors with points and caps, factors costing points with the fix, ranked moves naming the evidence each requires",
    "enrollment": {"self_enrolled": "boolean", "wallet_ownership_verified": "boolean, true after a signed registration", "note": "string"},
    "what_this_does_not_measure": "intent, honesty, job quality"
  },
  "disclosure": "Files are self-enrolled. The agent name and wallet are supplied by the enrollee. wallet_ownership_verified is false until the wallet signs a registration; only then is the link between name and wallet proven. Read a score as evidence about onchain behaviour, not as proof of identity.",
  "docs": "https://solvscore.com/get-scored/",
  "contact": "support@x402-agent-pay.com"
}
