{ "components": { "schemas": { "V7AgeBandContract": { "additionalProperties": false, "properties": { "ageBandId": { "enum": [ "everyone", "teen", "mature", "adult_verified" ], "type": "string" }, "contentDescriptors": { "items": { "minLength": 1, "type": "string" }, "maxItems": 16, "type": "array" }, "minimumAge": { "maximum": 21, "minimum": 0, "type": "integer" }, "minorProtection": { "additionalProperties": false, "properties": { "directMessagesAllowed": { "type": "boolean" }, "monetizationAllowed": { "type": "boolean" }, "requiresGuardianConsent": { "type": "boolean" }, "voiceChatAllowed": { "type": "boolean" } }, "required": [ "requiresGuardianConsent", "voiceChatAllowed", "directMessagesAllowed", "monetizationAllowed" ], "type": "object" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" } }, "required": [ "schemaVersion", "ageBandId", "minimumAge", "contentDescriptors", "minorProtection" ], "type": "object" }, "V7CharacterContract": { "additionalProperties": false, "properties": { "ageBandId": { "enum": [ "everyone", "teen", "mature", "adult_verified" ], "type": "string" }, "balances": { "additionalProperties": false, "properties": { "bankMinor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "cashMinor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "societyMinor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "cashMinor", "bankMinor", "societyMinor" ], "type": "object" }, "characterId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "displayName": { "maxLength": 80, "minLength": 1, "type": "string" }, "employment": { "anyOf": [ { "additionalProperties": false, "properties": { "grade": { "maximum": 100, "minimum": 0, "type": "integer" }, "jobId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "onDuty": { "type": "boolean" } }, "required": [ "jobId", "grade", "onDuty" ], "type": "object" }, { "type": "null" } ] }, "oriId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "realmId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "state": { "enum": [ "creating", "active", "jailed", "dead", "archived" ], "type": "string" }, "updatedAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" } }, "required": [ "schemaVersion", "characterId", "oriId", "realmId", "displayName", "ageBandId", "state", "employment", "balances", "updatedAt" ], "type": "object" }, "V7Error": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "type": "object" }, "V7GovernanceContract": { "additionalProperties": false, "properties": { "appealRoute": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "endsAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "proposalId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "quorumBasisPoints": { "maximum": 10000, "minimum": 0, "type": "integer" }, "realmId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "startsAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "status": { "enum": [ "drafting", "deliberation", "voting", "executed", "appealed" ], "type": "string" }, "tier": { "enum": [ "platform", "game", "realm", "server", "guild" ], "type": "string" }, "votingModel": { "enum": [ "one-person-one-vote", "quadratic", "plural", "delegated" ], "type": "string" } }, "required": [ "schemaVersion", "proposalId", "realmId", "tier", "status", "votingModel", "quorumBasisPoints", "startsAt", "endsAt", "appealRoute" ], "type": "object" }, "V7IncidentContract": { "additionalProperties": false, "properties": { "assignedQueue": { "enum": [ "kuanyin", "themis", "sekhmet", "sre" ], "type": "string" }, "category": { "enum": [ "safety", "moderation", "economy", "availability", "security" ], "type": "string" }, "createdAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "evidenceRefs": { "items": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "maxItems": 32, "minItems": 1, "type": "array" }, "incidentId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "realmId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "reporterPseudonym": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "severity": { "enum": [ "low", "medium", "high", "critical" ], "type": "string" }, "status": { "enum": [ "open", "triaged", "mitigated", "escalated", "closed" ], "type": "string" } }, "required": [ "schemaVersion", "incidentId", "realmId", "reporterPseudonym", "category", "severity", "status", "evidenceRefs", "assignedQueue", "createdAt" ], "type": "object" }, "V7ListingContract": { "additionalProperties": false, "properties": { "ageBandId": { "enum": [ "everyone", "teen", "mature", "adult_verified" ], "type": "string" }, "collectionId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "listingId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "price": { "additionalProperties": false, "properties": { "amountMinor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "currency": { "enum": [ "USD", "EUR", "GBP", "JPY", "OSHUN_CREDITS" ], "type": "string" } }, "required": [ "amountMinor", "currency" ], "type": "object" }, "publishedAt": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ] }, "rightsAttested": { "type": "boolean" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "sellerPseudonym": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "status": { "enum": [ "draft", "pending_review", "listed", "delisted", "blocked" ], "type": "string" } }, "required": [ "schemaVersion", "listingId", "collectionId", "sellerPseudonym", "price", "status", "rightsAttested", "ageBandId", "publishedAt" ], "type": "object" }, "V7ModCollectionContract": { "additionalProperties": false, "properties": { "collectionId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "contentHash": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "createdAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "dependencyRefs": { "items": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "maxItems": 32, "type": "array" }, "distribution": { "enum": [ "private", "realm-whitelist", "marketplace" ], "type": "string" }, "license": { "enum": [ "oshun-standard-ugc", "creator-commercial", "private-realm-only" ], "type": "string" }, "realmId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "safetyScanReportId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "version": { "pattern": "^\\d+\\.\\d+\\.\\d+$", "type": "string" } }, "required": [ "schemaVersion", "collectionId", "realmId", "title", "version", "contentHash", "dependencyRefs", "safetyScanReportId", "license", "distribution", "createdAt" ], "type": "object" }, "V7PayoutContract": { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "properties": { "amountMinor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "currency": { "enum": [ "USD", "EUR", "GBP", "JPY", "OSHUN_CREDITS" ], "type": "string" } }, "required": [ "amountMinor", "currency" ], "type": "object" }, "beneficiaryPseudonym": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "listingId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "payoutId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "rail": { "enum": [ "aje-wallet", "bank-transfer", "creator-credit" ], "type": "string" }, "scheduledAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "status": { "enum": [ "scheduled", "held", "settled", "reversed" ], "type": "string" }, "taxInterviewRef": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" } }, "required": [ "schemaVersion", "payoutId", "listingId", "beneficiaryPseudonym", "amount", "rail", "status", "taxInterviewRef", "scheduledAt" ], "type": "object" }, "V7RealmContract": { "additionalProperties": false, "properties": { "ageBandId": { "enum": [ "everyone", "teen", "mature", "adult_verified" ], "type": "string" }, "createdAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "displayName": { "maxLength": 80, "minLength": 1, "type": "string" }, "gateway": { "additionalProperties": false, "properties": { "protocol": { "enum": [ "webtransport", "webrtc", "websocket" ], "type": "string" }, "publicHandle": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" } }, "required": [ "protocol", "publicHandle" ], "type": "object" }, "lifecycle": { "enum": [ "draft", "listed", "active", "suspended", "retired" ], "type": "string" }, "ownerPseudonym": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "realmId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "region": { "enum": [ "na", "eu", "apac", "latam" ], "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" }, "slug": { "pattern": "^[a-z0-9][a-z0-9-]{2,63}$", "type": "string" }, "trustTier": { "enum": [ "community", "official", "partner" ], "type": "string" }, "updatedAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" } }, "required": [ "schemaVersion", "realmId", "slug", "displayName", "ownerPseudonym", "ageBandId", "trustTier", "region", "lifecycle", "gateway", "createdAt", "updatedAt" ], "type": "object" }, "V7RealmLockContract": { "additionalProperties": false, "properties": { "artifactClosure": { "items": { "additionalProperties": false, "properties": { "artifactId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "artifactKind": { "enum": [ "layer", "collection", "material", "mesh", "script", "texture" ], "type": "string" }, "contentHash": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "dependencyRefs": { "items": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "maxItems": 64, "type": "array" }, "payloadHash": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" } }, "required": [ "artifactId", "artifactKind", "payloadHash", "contentHash", "dependencyRefs" ], "type": "object" }, "maxItems": 4096, "minItems": 1, "type": "array" }, "layers": { "items": { "additionalProperties": false, "properties": { "artifactRef": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "contentHash": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "dependencyRefs": { "items": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "maxItems": 64, "type": "array" }, "layerId": { "pattern": "^[a-z][a-z0-9.-]{2,79}$", "type": "string" }, "primitives": { "items": { "additionalProperties": false, "properties": { "color": { "additionalProperties": false, "properties": { "a": { "maximum": 1, "minimum": 0, "type": "number" }, "b": { "maximum": 1, "minimum": 0, "type": "number" }, "g": { "maximum": 1, "minimum": 0, "type": "number" }, "r": { "maximum": 1, "minimum": 0, "type": "number" } }, "required": [ "r", "g", "b", "a" ], "type": "object" }, "extentsCm": { "additionalProperties": false, "properties": { "x": { "type": "number" }, "y": { "type": "number" }, "z": { "type": "number" } }, "required": [ "x", "y", "z" ], "type": "object" }, "kind": { "enum": [ "cube", "plane", "pillar", "marker" ], "type": "string" }, "materialRole": { "pattern": "^[a-z][a-z0-9._-]{2,63}$", "type": "string" }, "primitiveId": { "pattern": "^[a-z][a-z0-9._-]{2,95}$", "type": "string" }, "transform": { "additionalProperties": false, "properties": { "location": { "additionalProperties": false, "properties": { "x": { "type": "number" }, "y": { "type": "number" }, "z": { "type": "number" } }, "required": [ "x", "y", "z" ], "type": "object" }, "rotation": { "additionalProperties": false, "properties": { "pitch": { "type": "number" }, "roll": { "type": "number" }, "yaw": { "type": "number" } }, "required": [ "pitch", "yaw", "roll" ], "type": "object" }, "scale": { "additionalProperties": false, "properties": { "x": { "type": "number" }, "y": { "type": "number" }, "z": { "type": "number" } }, "required": [ "x", "y", "z" ], "type": "object" } }, "required": [ "location", "rotation", "scale" ], "type": "object" } }, "required": [ "primitiveId", "kind", "transform", "extentsCm", "color", "materialRole" ], "type": "object" }, "maxItems": 2048, "minItems": 1, "type": "array" }, "priority": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": [ "layerId", "artifactRef", "contentHash", "dependencyRefs", "priority", "primitives" ], "type": "object" }, "maxItems": 256, "minItems": 1, "type": "array" }, "lockFileHash": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "realmId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "schemaVersion": { "const": 1, "type": "number" } }, "required": [ "schemaVersion", "realmId", "lockFileHash", "artifactClosure", "layers" ], "type": "object" }, "V7ScanReportContract": { "additionalProperties": false, "properties": { "blockedReasons": { "items": { "minLength": 1, "type": "string" }, "maxItems": 32, "type": "array" }, "collectionId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "createdAt": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "decision": { "enum": [ "approved", "needs_review", "blocked" ], "type": "string" }, "evidenceRefs": { "items": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "maxItems": 32, "type": "array" }, "riskScoreBasisPoints": { "maximum": 10000, "minimum": 0, "type": "integer" }, "scanner": { "enum": [ "sekhmet-static", "sekhmet-runtime", "kuanyin-human-review" ], "type": "string" }, "scanReportId": { "minLength": 3, "pattern": "^[a-z][a-z0-9-]*:[A-Za-z0-9][A-Za-z0-9:._-]*$", "type": "string" }, "schemaVersion": { "const": "v7.contract.1", "type": "string" } }, "required": [ "schemaVersion", "scanReportId", "collectionId", "scanner", "decision", "riskScoreBasisPoints", "blockedReasons", "evidenceRefs", "createdAt" ], "type": "object" } } }, "info": { "description": "V7 realm, character, Collection, marketplace, governance, safety, and incident contracts generated from canonical Zod schemas.", "title": "Oshun V7 Contract API", "version": "7.0.0" }, "openapi": "3.1.0", "paths": { "/api/v7/age-bands": { "post": { "description": "Age-band and minor-protection policy contract.", "operationId": "createV7AgeBand", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "ageBandId": "teen", "contentDescriptors": [ "mild-violence", "user-generated-content" ], "minimumAge": 13, "minorProtection": { "directMessagesAllowed": false, "monetizationAllowed": false, "requiresGuardianConsent": false, "voiceChatAllowed": true }, "schemaVersion": "v7.contract.1" } } }, "schema": { "$ref": "#/components/schemas/V7AgeBandContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7AgeBandContract" } } }, "description": "V7 AgeBand created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 AgeBand", "tags": [ "safety" ] } }, "/api/v7/age-bands/{id}": { "get": { "description": "Age-band and minor-protection policy contract.", "operationId": "getV7AgeBand", "parameters": [ { "description": "Value of ageBandId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7AgeBandContract" } } }, "description": "V7 AgeBand found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 AgeBand was not found." } }, "summary": "Get V7 AgeBand", "tags": [ "safety" ] } }, "/api/v7/characters": { "post": { "description": "Nana character projection backed by a V6 Ori identity.", "operationId": "createV7Character", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "ageBandId": "teen", "balances": { "bankMinor": 125000, "cashMinor": 2500, "societyMinor": 0 }, "characterId": "nana:alloy-market:abeni", "displayName": "Abeni Forge", "employment": { "grade": 2, "jobId": "job:blacksmith", "onDuty": true }, "oriId": "ori:v7:abeni", "realmId": "realm:mawu:alloy-market", "schemaVersion": "v7.contract.1", "state": "active", "updatedAt": "2026-06-01T00:00:00.000Z" } } }, "schema": { "$ref": "#/components/schemas/V7CharacterContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7CharacterContract" } } }, "description": "V7 Character created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 Character", "tags": [ "characters" ] } }, "/api/v7/characters/{id}": { "get": { "description": "Nana character projection backed by a V6 Ori identity.", "operationId": "getV7Character", "parameters": [ { "description": "Value of characterId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7CharacterContract" } } }, "description": "V7 Character found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 Character was not found." } }, "summary": "Get V7 Character", "tags": [ "characters" ] } }, "/api/v7/collections": { "post": { "description": "Ixchel mod or Collection artifact metadata.", "operationId": "createV7ModCollection", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "collectionId": "collection:alloy-market:smithy-props", "contentHash": "sha256:9e5d043212686164531ed1033f3e495fc900fae314294079966104b397d9513a", "createdAt": "2026-06-01T00:00:00.000Z", "dependencyRefs": [ "collection:alloy-market:base-materials" ], "distribution": "marketplace", "license": "oshun-standard-ugc", "realmId": "realm:mawu:alloy-market", "safetyScanReportId": "scan:smithy-props:001", "schemaVersion": "v7.contract.1", "title": "Smithy Props", "version": "1.0.0" } } }, "schema": { "$ref": "#/components/schemas/V7ModCollectionContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7ModCollectionContract" } } }, "description": "V7 ModCollection created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 ModCollection", "tags": [ "collections" ] } }, "/api/v7/collections/{id}": { "get": { "description": "Ixchel mod or Collection artifact metadata.", "operationId": "getV7ModCollection", "parameters": [ { "description": "Value of collectionId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7ModCollectionContract" } } }, "description": "V7 ModCollection found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 ModCollection was not found." } }, "summary": "Get V7 ModCollection", "tags": [ "collections" ] } }, "/api/v7/governance/proposals": { "post": { "description": "Eunomia governance proposal contract.", "operationId": "createV7Governance", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "appealRoute": "themis:appeal:realm-governance", "endsAt": "2026-06-08T00:00:00.000Z", "proposalId": "governance:alloy-market:curfew-001", "quorumBasisPoints": 2500, "realmId": "realm:mawu:alloy-market", "schemaVersion": "v7.contract.1", "startsAt": "2026-06-01T00:00:00.000Z", "status": "voting", "tier": "realm", "votingModel": "plural" } } }, "schema": { "$ref": "#/components/schemas/V7GovernanceContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7GovernanceContract" } } }, "description": "V7 Governance created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 Governance", "tags": [ "governance" ] } }, "/api/v7/governance/proposals/{id}": { "get": { "description": "Eunomia governance proposal contract.", "operationId": "getV7Governance", "parameters": [ { "description": "Value of proposalId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7GovernanceContract" } } }, "description": "V7 Governance found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 Governance was not found." } }, "summary": "Get V7 Governance", "tags": [ "governance" ] } }, "/api/v7/incidents": { "post": { "description": "Moderation, security, and availability incident contract.", "operationId": "createV7Incident", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "assignedQueue": "kuanyin", "category": "moderation", "createdAt": "2026-06-01T00:00:00.000Z", "evidenceRefs": [ "evidence:clip:alloy-market:001" ], "incidentId": "incident:alloy-market:001", "realmId": "realm:mawu:alloy-market", "reporterPseudonym": "user:player:8aa1", "schemaVersion": "v7.contract.1", "severity": "medium", "status": "triaged" } } }, "schema": { "$ref": "#/components/schemas/V7IncidentContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7IncidentContract" } } }, "description": "V7 Incident created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 Incident", "tags": [ "safety" ] } }, "/api/v7/incidents/{id}": { "get": { "description": "Moderation, security, and availability incident contract.", "operationId": "getV7Incident", "parameters": [ { "description": "Value of incidentId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7IncidentContract" } } }, "description": "V7 Incident found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 Incident was not found." } }, "summary": "Get V7 Incident", "tags": [ "safety" ] } }, "/api/v7/listings": { "post": { "description": "Abundantia marketplace listing contract.", "operationId": "createV7Listing", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "ageBandId": "teen", "collectionId": "collection:alloy-market:smithy-props", "listingId": "listing:smithy-props:001", "price": { "amountMinor": 499, "currency": "USD" }, "publishedAt": "2026-06-01T00:00:00.000Z", "rightsAttested": true, "schemaVersion": "v7.contract.1", "sellerPseudonym": "user:creator:4b2a", "status": "listed" } } }, "schema": { "$ref": "#/components/schemas/V7ListingContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7ListingContract" } } }, "description": "V7 Listing created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 Listing", "tags": [ "marketplace" ] } }, "/api/v7/listings/{id}": { "get": { "description": "Abundantia marketplace listing contract.", "operationId": "getV7Listing", "parameters": [ { "description": "Value of listingId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7ListingContract" } } }, "description": "V7 Listing found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 Listing was not found." } }, "summary": "Get V7 Listing", "tags": [ "marketplace" ] } }, "/api/v7/payouts": { "post": { "description": "Aje-settled creator payout contract.", "operationId": "createV7Payout", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "amount": { "amountMinor": 349, "currency": "USD" }, "beneficiaryPseudonym": "user:creator:4b2a", "listingId": "listing:smithy-props:001", "payoutId": "payout:smithy-props:001", "rail": "aje-wallet", "scheduledAt": "2026-06-01T00:00:00.000Z", "schemaVersion": "v7.contract.1", "status": "scheduled", "taxInterviewRef": "tax:creator:4b2a:2026" } } }, "schema": { "$ref": "#/components/schemas/V7PayoutContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7PayoutContract" } } }, "description": "V7 Payout created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 Payout", "tags": [ "marketplace" ] } }, "/api/v7/payouts/{id}": { "get": { "description": "Aje-settled creator payout contract.", "operationId": "getV7Payout", "parameters": [ { "description": "Value of payoutId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7PayoutContract" } } }, "description": "V7 Payout found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 Payout was not found." } }, "summary": "Get V7 Payout", "tags": [ "marketplace" ] } }, "/api/v7/realms": { "post": { "description": "Realm identity, hosting, trust, and gateway metadata.", "operationId": "createV7Realm", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "ageBandId": "teen", "createdAt": "2026-06-01T00:00:00.000Z", "displayName": "Alloy Market", "gateway": { "protocol": "webtransport", "publicHandle": "gateway:mawu:alloy-market" }, "lifecycle": "active", "ownerPseudonym": "user:realm-owner:9f7a", "realmId": "realm:mawu:alloy-market", "region": "na", "schemaVersion": "v7.contract.1", "slug": "alloy-market", "trustTier": "community", "updatedAt": "2026-06-01T00:00:00.000Z" } } }, "schema": { "$ref": "#/components/schemas/V7RealmContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7RealmContract" } } }, "description": "V7 Realm created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 Realm", "tags": [ "realms" ] } }, "/api/v7/realms/{id}": { "get": { "description": "Realm identity, hosting, trust, and gateway metadata.", "operationId": "getV7Realm", "parameters": [ { "description": "Value of realmId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7RealmContract" } } }, "description": "V7 Realm found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 Realm was not found." } }, "summary": "Get V7 Realm", "tags": [ "realms" ] } }, "/api/v7/realms/locks": { "post": { "description": "Deterministic Mawu realm lock-file and content-addressed artifact closure.", "operationId": "createV7RealmLock", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "artifactClosure": [ { "artifactId": "artifact:ixchel:base-materials", "artifactKind": "material", "contentHash": "sha256:72b9e911e3cfde2c43ff38bb931b8c794de91d9450dd15f7132a2a7135da9c0a", "dependencyRefs": [], "payloadHash": "sha256:ba01bf27200cac5b9fc51b48d90c9a02ac88b99cc8bae56556efc8b0e8d4b91a" }, { "artifactId": "artifact:ixchel:base-terrain", "artifactKind": "layer", "contentHash": "sha256:986f722a488bb30c29b88e69b0a11eab6f00281accb27e0452846ca8e3b0fdae", "dependencyRefs": [ "artifact:ixchel:base-materials" ], "payloadHash": "sha256:0bbd3eee989bb53d649ac95290b640f773e8893caac9d427d04accc3f17bbd3e" }, { "artifactId": "artifact:ixchel:civic-market", "artifactKind": "layer", "contentHash": "sha256:9e5d043212686164531ed1033f3e495fc900fae314294079966104b397d9513a", "dependencyRefs": [ "artifact:ixchel:base-materials" ], "payloadHash": "sha256:e49024c431ac5299a3307d8a510b70faaefc68151a9bbc5157db54ef35ca9f5b" }, { "artifactId": "artifact:ixchel:realm-beacons", "artifactKind": "layer", "contentHash": "sha256:920ee2a204180fab959e087987e8db545fe3f7622eb1a5f638ce2779f06fcd40", "dependencyRefs": [ "artifact:ixchel:base-materials" ], "payloadHash": "sha256:b843c659f8ca1fd74be662acc5bc67c797516ab19f7217408a54d72985f95793" } ], "layers": [ { "artifactRef": "artifact:ixchel:base-terrain", "contentHash": "sha256:986f722a488bb30c29b88e69b0a11eab6f00281accb27e0452846ca8e3b0fdae", "dependencyRefs": [ "artifact:ixchel:base-materials" ], "layerId": "ixchel.base-terrain", "primitives": [ { "color": { "a": 1, "b": 0.27, "g": 0.3, "r": 0.28 }, "extentsCm": { "x": 420, "y": 1400, "z": 120 }, "kind": "cube", "materialRole": "walkway", "primitiveId": "base.east-ramp", "transform": { "location": { "x": 1950, "y": 0, "z": 60 }, "rotation": { "pitch": 0, "roll": 0, "yaw": 8 }, "scale": { "x": 1, "y": 1, "z": 1 } } }, { "color": { "a": 1, "b": 0.21, "g": 0.22, "r": 0.18 }, "extentsCm": { "x": 4200, "y": 4200, "z": 8 }, "kind": "plane", "materialRole": "ground", "primitiveId": "base.plaza", "transform": { "location": { "x": 0, "y": 0, "z": 0 }, "rotation": { "pitch": 0, "roll": 0, "yaw": 0 }, "scale": { "x": 1, "y": 1, "z": 1 } } } ], "priority": 0 }, { "artifactRef": "artifact:ixchel:civic-market", "contentHash": "sha256:9e5d043212686164531ed1033f3e495fc900fae314294079966104b397d9513a", "dependencyRefs": [ "artifact:ixchel:base-materials" ], "layerId": "ixchel.civic-market", "primitives": [ { "color": { "a": 1, "b": 0.33, "g": 0.46, "r": 0.52 }, "extentsCm": { "x": 520, "y": 260, "z": 300 }, "kind": "cube", "materialRole": "timber", "primitiveId": "market.north-stall", "transform": { "location": { "x": -650, "y": -1100, "z": 150 }, "rotation": { "pitch": 0, "roll": 0, "yaw": 8 }, "scale": { "x": 1, "y": 1, "z": 1 } } }, { "color": { "a": 1, "b": 0.3, "g": 0.37, "r": 0.48 }, "extentsCm": { "x": 540, "y": 280, "z": 300 }, "kind": "cube", "materialRole": "timber", "primitiveId": "market.south-stall", "transform": { "location": { "x": 620, "y": 1180, "z": 150 }, "rotation": { "pitch": 0, "roll": 0, "yaw": -10 }, "scale": { "x": 1, "y": 1, "z": 1 } } } ], "priority": 20 }, { "artifactRef": "artifact:ixchel:realm-beacons", "contentHash": "sha256:920ee2a204180fab959e087987e8db545fe3f7622eb1a5f638ce2779f06fcd40", "dependencyRefs": [ "artifact:ixchel:base-materials" ], "layerId": "ixchel.realm-beacons", "primitives": [ { "color": { "a": 1, "b": 0.35, "g": 0.66, "r": 0.74 }, "extentsCm": { "x": 220, "y": 220, "z": 220 }, "kind": "marker", "materialRole": "civic", "primitiveId": "beacon.review-kiosk", "transform": { "location": { "x": -1420, "y": 860, "z": 130 }, "rotation": { "pitch": 0, "roll": 0, "yaw": 0 }, "scale": { "x": 1, "y": 1, "z": 1 } } }, { "color": { "a": 1, "b": 0.76, "g": 0.58, "r": 0.28 }, "extentsCm": { "x": 90, "y": 90, "z": 440 }, "kind": "pillar", "materialRole": "wayfinding", "primitiveId": "beacon.spawn", "transform": { "location": { "x": 0, "y": 0, "z": 220 }, "rotation": { "pitch": 0, "roll": 0, "yaw": 0 }, "scale": { "x": 1, "y": 1, "z": 1 } } } ], "priority": 40 } ], "lockFileHash": "sha256:0d3d8bb61176bad7641ba45561b6682ca2f51067cda5c07e1c91324dbc5058f0", "realmId": "mawu:dedicated-smoke:alloy-market", "schemaVersion": 1 } } }, "schema": { "$ref": "#/components/schemas/V7RealmLockContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7RealmLockContract" } } }, "description": "V7 RealmLock created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 RealmLock", "tags": [ "realms" ] } }, "/api/v7/realms/locks/{id}": { "get": { "description": "Deterministic Mawu realm lock-file and content-addressed artifact closure.", "operationId": "getV7RealmLock", "parameters": [ { "description": "Value of lockFileHash.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7RealmLockContract" } } }, "description": "V7 RealmLock found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 RealmLock was not found." } }, "summary": "Get V7 RealmLock", "tags": [ "realms" ] } }, "/api/v7/scan-reports": { "post": { "description": "Sekhmet and Kuanyin scan-report contract.", "operationId": "createV7ScanReport", "requestBody": { "content": { "application/json": { "examples": { "fixture": { "value": { "blockedReasons": [], "collectionId": "collection:alloy-market:smithy-props", "createdAt": "2026-06-01T00:00:00.000Z", "decision": "approved", "evidenceRefs": [ "evidence:scan:smithy-props:001" ], "riskScoreBasisPoints": 420, "scanner": "sekhmet-static", "scanReportId": "scan:smithy-props:001", "schemaVersion": "v7.contract.1" } } }, "schema": { "$ref": "#/components/schemas/V7ScanReportContract" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7ScanReportContract" } } }, "description": "V7 ScanReport created" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "The submitted V7 contract failed validation." } }, "summary": "Create V7 ScanReport", "tags": [ "safety" ] } }, "/api/v7/scan-reports/{id}": { "get": { "description": "Sekhmet and Kuanyin scan-report contract.", "operationId": "getV7ScanReport", "parameters": [ { "description": "Value of scanReportId.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7ScanReportContract" } } }, "description": "V7 ScanReport found" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V7Error" } } }, "description": "V7 ScanReport was not found." } }, "summary": "Get V7 ScanReport", "tags": [ "safety" ] } } }, "servers": [ { "description": "Production API base URL", "url": "https://api.oshun.example" } ], "tags": [ { "description": "Realm hosting and trust-boundary metadata.", "name": "realms" }, { "description": "Nana character contracts backed by V6 Ori.", "name": "characters" }, { "description": "Ixchel mod and Collection artifacts.", "name": "collections" }, { "description": "Abundantia listings and Aje payouts.", "name": "marketplace" }, { "description": "Eunomia proposals and voting state.", "name": "governance" }, { "description": "Age bands, scan reports, and incidents.", "name": "safety" } ] }