{"components":{"schemas":{"CapabilityFlag":{"properties":{"notes":{"type":["string","null"]},"status":{"enum":["unsupported","shadow","supported"],"type":"string"}},"required":["status","notes"],"type":"object"},"ChainPositionResponse":{"properties":{"block_hash":{"type":"string"},"block_number":{"type":"integer"},"chain_id":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["chain_id","block_number","block_hash","timestamp"],"type":"object"},"ChainPositions":{"additionalProperties":{"$ref":"#/components/schemas/ChainPositionResponse"},"type":"object"},"CollectionResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"items":{"$ref":"#/components/schemas/JsonObject"},"type":"array"},"declared_state":{"$ref":"#/components/schemas/JsonObject"},"last_updated":{"format":"date-time","type":"string"},"page":{"$ref":"#/components/schemas/HistoryPageResponse"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"$ref":"#/components/schemas/NullValue"}},"required":["data","declared_state","verified_state","coverage","chain_positions","consistency","last_updated","page"],"type":"object"},"CompactDomainSummary":{"properties":{"created_at":{"type":["object","array","string","integer","boolean","null"]},"expiry_date":{"type":["object","array","string","integer","boolean","null"]},"labelhash":{"type":["object","array","string","integer","boolean","null"]},"name":{"type":["object","array","string","integer","boolean","null"]},"namehash":{"type":["object","array","string","integer","boolean","null"]},"namespace":{"type":["object","array","string","integer","boolean","null"]},"normalized_name":{"type":["object","array","string","integer","boolean","null"]},"owner":{"type":["object","array","string","integer","boolean","null"]},"record_count":{"type":["object","array","string","integer","boolean","null"]},"record_summaries":{"type":["object","array","string","integer","boolean","null"]},"registrant":{"type":["object","array","string","integer","boolean","null"]},"registration_date":{"type":["object","array","string","integer","boolean","null"]},"resolver_address":{"type":["object","array","string","integer","boolean","null"]},"subname_count":{"type":["object","array","string","integer","boolean","null"]},"token_id":{"type":["object","array","string","integer","boolean","null"]}},"required":["namespace","name","normalized_name","namehash"],"type":"object"},"CompactEventsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompactHistoryEvent"},"type":"array"},"meta":{"$ref":"#/components/schemas/CompactMeta"},"page":{"$ref":"#/components/schemas/HistoryPageResponse"}},"required":["data","page"],"type":"object"},"CompactHistoryEvent":{"properties":{"block_number":{"type":["object","array","string","integer","boolean","null"]},"data":{"type":["object","array","string","integer","boolean","null"]},"log_index":{"type":["object","array","string","integer","boolean","null"]},"name":{"type":["object","array","string","integer","boolean","null"]},"namespace":{"type":["object","array","string","integer","boolean","null"]},"resource_id":{"type":["object","array","string","integer","boolean","null"]},"timestamp":{"type":["object","array","string","integer","boolean","null"]},"transaction_hash":{"type":["object","array","string","integer","boolean","null"]},"type":{"type":["object","array","string","integer","boolean","null"]}},"required":["type","name","namespace","block_number","timestamp","data"],"type":"object"},"CompactMeta":{"properties":{"inventory_source":{},"support_status":{"type":"string"},"total_count":{"minimum":0,"type":["integer","null"]},"unsupported_fields":{"items":{"type":"string"},"type":"array"},"unsupported_filters":{"items":{"type":"string"},"type":"array"},"value_source":{}},"type":"object"},"CompactNameRecordsResponse":{"properties":{"data":{"$ref":"#/components/schemas/CompactRecordSummary"},"meta":{"$ref":"#/components/schemas/CompactMeta"}},"required":["data"],"type":"object"},"CompactNamesResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompactDomainSummary"},"type":"array"},"meta":{"$ref":"#/components/schemas/CompactMeta"},"page":{"$ref":"#/components/schemas/HistoryPageResponse"}},"required":["data","page"],"type":"object"},"CompactRecordSummary":{"properties":{"avatar":{"type":["object","array","string","integer","boolean","null"]},"coin_addresses":{"type":["object","array","string","integer","boolean","null"]},"content_hash":{"type":["object","array","string","integer","boolean","null"]},"known_text_keys":{"type":["object","array","string","integer","boolean","null"]},"resolver_address":{"type":["object","array","string","integer","boolean","null"]},"text_records":{"type":["object","array","string","integer","boolean","null"]}},"required":["resolver_address","text_records","known_text_keys","avatar","content_hash","coin_addresses"],"type":"object"},"CompactResolverOverviewResponse":{"properties":{"data":{"$ref":"#/components/schemas/ResolverOverviewCompact"},"meta":{"$ref":"#/components/schemas/CompactMeta"}},"required":["data"],"type":"object"},"CompactRolesResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/RoleRow"},"type":"array"},"meta":{"$ref":"#/components/schemas/CompactMeta"},"page":{"$ref":"#/components/schemas/HistoryPageResponse"}},"required":["data","page"],"type":"object"},"Consistency":{"enum":["head","safe","finalized"],"type":"string"},"CoverageResponse":{"properties":{"enumeration_basis":{"type":"string"},"exhaustiveness":{"type":"string"},"source_classes_considered":{"items":{"type":"string"},"type":"array"},"status":{"type":"string"},"unsupported_reason":{"type":["string","null"]}},"required":["status","exhaustiveness","source_classes_considered","enumeration_basis","unsupported_reason"],"type":"object"},"ErrorBody":{"properties":{"code":{"type":"string"},"details":{"additionalProperties":{"type":"string"},"type":"object"},"message":{"type":"string"}},"required":["code","message","details"],"type":"object"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}},"required":["error"],"type":"object"},"ExactNameData":{"properties":{"binding_kind":{"type":["string","null"]},"canonical_display_name":{"type":"string"},"logical_name_id":{"type":"string"},"namehash":{"type":"string"},"namespace":{"type":"string"},"normalized_name":{"type":"string"},"resource_id":{"format":"uuid","type":["string","null"]},"token_lineage_id":{"format":"uuid","type":["string","null"]}},"required":["logical_name_id","namespace","normalized_name","canonical_display_name","namehash","resource_id","token_lineage_id","binding_kind"],"type":"object"},"ExactNameResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"$ref":"#/components/schemas/ExactNameData"},"declared_state":{"$ref":"#/components/schemas/JsonObject"},"last_updated":{"format":"date-time","type":"string"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"$ref":"#/components/schemas/NullValue"}},"required":["data","declared_state","verified_state","coverage","chain_positions","consistency","last_updated"],"type":"object"},"HealthResponse":{"properties":{"phase":{"type":"string"},"service":{"type":"string"},"status":{"type":"string"}},"required":["service","phase","status"],"type":"object"},"HistoryPageResponse":{"properties":{"cursor":{"type":["string","null"]},"next_cursor":{"type":["string","null"]},"page_size":{"minimum":0,"type":"integer"},"sort":{"type":"string"}},"required":["cursor","next_cursor","page_size","sort"],"type":"object"},"IdentityLookupInput":{"additionalProperties":false,"properties":{"inputs":{"items":{"additionalProperties":false,"properties":{"address":{"type":"string"},"coin_type":{"minimum":0,"type":"integer"},"cursor":{"type":["string","null"]},"id":{"type":"string"},"kind":{"enum":["name","address"],"type":"string"},"name":{"type":"string"},"page_size":{"default":1,"maximum":200,"minimum":1,"type":"integer"},"roles":{"items":{"enum":["owned","managed","registrant","effective_controller","both","any"],"type":"string"},"type":"array"}},"required":["id","kind"],"type":"object"},"maxItems":1000,"type":"array"},"namespace":{"default":"public","enum":["auto","public","ens","basenames"],"type":"string"},"profile":{"default":"detail","enum":["feed","detail","shadow"],"type":"string"}},"required":["inputs"],"type":"object"},"IdentityLookupPage":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"total_count":{"minimum":0,"type":["integer","null"]}},"required":["next_cursor","total_count","has_more"],"type":"object"},"IdentityLookupResponse":{"additionalProperties":false,"properties":{"results":{"items":{"additionalProperties":false,"properties":{"id":{"type":"string"},"input":{"additionalProperties":false,"properties":{"address":{"type":"string"},"coin_type":{"minimum":0,"type":"integer"},"name":{"type":"string"},"roles":{"items":{"type":"string"},"type":"array"}},"type":"object"},"kind":{"enum":["name","address"],"type":"string"},"normalization":{"$ref":"#/components/schemas/NormalizationInfo"},"page":{"$ref":"#/components/schemas/IdentityLookupPage"},"record":{"anyOf":[{"$ref":"#/components/schemas/NativeIdentityRecord"},{"$ref":"#/components/schemas/NullValue"}]},"records":{"items":{"$ref":"#/components/schemas/NativeIdentityRecord"},"type":"array"},"status":{"$ref":"#/components/schemas/IdentityStatus"}},"required":["id","kind","status","input"],"type":"object"},"type":"array"}},"required":["results"],"type":"object"},"IdentityStatus":{"enum":["success","not_found","unsupported","stale","unnormalizable_input"],"type":"string"},"IndexingStatusResponse":{"properties":{"chains":{"additionalProperties":{"properties":{"canonical_block":{"type":["integer","null"]},"finalized_block":{"type":["integer","null"]},"latest_projected_block":{"type":["integer","null"]},"latest_projected_timestamp":{"format":"date-time","type":["string","null"]},"projection_lag_blocks":{"type":["integer","null"]},"projection_lag_seconds":{"type":["integer","null"]},"safe_block":{"type":["integer","null"]}},"required":["canonical_block","safe_block","finalized_block","latest_projected_block","latest_projected_timestamp","projection_lag_blocks","projection_lag_seconds"],"type":"object"},"type":"object"},"status":{"enum":["ready","degraded","stale"],"type":"string"}},"required":["status","chains"],"type":"object"},"JsonObject":{"additionalProperties":true,"type":"object"},"NameProfileResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"oneOf":[{"$ref":"#/components/schemas/ProfileNameData"},{"$ref":"#/components/schemas/ExactNameData"}]},"declared_state":{"additionalProperties":true,"type":["object","null"]},"last_updated":{"format":"date-time","type":"string"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"additionalProperties":true,"type":["object","null"]}},"required":["data","declared_state","verified_state"],"type":"object"},"NameRecordStatus":{"enum":["success","not_found","unsupported","stale"],"type":"string"},"NamespaceData":{"properties":{"namespace":{"enum":["ens","basenames"],"type":"string"}},"required":["namespace"],"type":"object"},"NamespaceManifestEntry":{"properties":{"capability_flags":{"additionalProperties":{"$ref":"#/components/schemas/CapabilityFlag"},"type":"object"},"chain":{"type":"string"},"deployment_epoch":{"type":"string"},"manifest_version":{"minimum":1,"type":"integer"},"normalizer_version":{"type":"string"},"source_family":{"type":"string"}},"required":["manifest_version","source_family","chain","deployment_epoch","normalizer_version","capability_flags"],"type":"object"},"NamespaceManifestsDeclaredState":{"properties":{"manifests":{"items":{"$ref":"#/components/schemas/NamespaceManifestEntry"},"type":"array"}},"required":["manifests"],"type":"object"},"NamespaceManifestsResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"$ref":"#/components/schemas/NamespaceData"},"declared_state":{"$ref":"#/components/schemas/NamespaceManifestsDeclaredState"},"last_updated":{"format":"date-time","type":"string"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"$ref":"#/components/schemas/NullValue"}},"required":["data","declared_state","verified_state","coverage","chain_positions","consistency","last_updated"],"type":"object"},"NamespaceMetadataDeclaredState":{"properties":{"active_manifest_count":{"minimum":0,"type":"integer"},"active_source_families":{"items":{"type":"string"},"type":"array"},"chains":{"items":{"type":"string"},"type":"array"},"normalizer_versions":{"items":{"type":"string"},"type":"array"}},"required":["active_manifest_count","active_source_families","chains","normalizer_versions"],"type":"object"},"NamespaceMetadataResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"$ref":"#/components/schemas/NamespaceData"},"declared_state":{"$ref":"#/components/schemas/NamespaceMetadataDeclaredState"},"last_updated":{"format":"date-time","type":"string"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"$ref":"#/components/schemas/NullValue"}},"required":["data","declared_state","verified_state","coverage","chain_positions","consistency","last_updated"],"type":"object"},"NativeIdentityRecord":{"additionalProperties":false,"properties":{"coin_type_addresses":{"additionalProperties":{"type":"string"},"type":"object"},"expiration":{"type":"integer"},"is_primary":{"type":"boolean"},"manager_address":{"type":"string"},"name":{"type":"string"},"namehash":{"type":"string"},"namespace":{"type":"string"},"network":{"type":"string"},"owner_address":{"type":"string"},"primary_address":{"type":"string"},"relation_facets":{"items":{"enum":["owned","managed","registrant","effective_controller"],"type":"string"},"type":"array"},"resolver_address":{"type":"string"},"status":{"$ref":"#/components/schemas/NameRecordStatus"},"text_records":{"additionalProperties":{"type":"string"},"type":"object"},"token_id":{"type":"string"},"unsupported_fields":{"items":{"type":"string"},"type":"array"}},"required":["name","namespace","namehash","network","status"],"type":"object"},"NormalizationInfo":{"additionalProperties":false,"properties":{"changed":{"type":"boolean"},"input_name":{"type":"string"},"reason":{"enum":["case_normalized","invalid_normalized_name"],"type":"string"}},"required":["changed","input_name","reason"],"type":"object"},"NullValue":{"type":"null"},"PrimaryNameClaimedResult":{"oneOf":[{"additionalProperties":false,"properties":{"name":{"type":"string"},"provenance":{"$ref":"#/components/schemas/JsonObject"},"status":{"const":"success","type":"string"}},"required":["status","provenance"],"type":"object"},{"additionalProperties":false,"properties":{"status":{"const":"not_found","type":"string"}},"required":["status"],"type":"object"},{"additionalProperties":false,"properties":{"provenance":{"$ref":"#/components/schemas/JsonObject"},"status":{"const":"not_found","type":"string"}},"required":["status","provenance"],"type":"object"},{"additionalProperties":false,"properties":{"status":{"const":"unsupported","type":"string"},"unsupported_reason":{"type":"string"}},"required":["status"],"type":"object"},{"additionalProperties":false,"properties":{"provenance":{"$ref":"#/components/schemas/JsonObject"},"status":{"const":"unsupported","type":"string"}},"required":["status","provenance"],"type":"object"},{"additionalProperties":false,"properties":{"provenance":{"$ref":"#/components/schemas/JsonObject"},"raw_claim_name":{"type":"string"},"status":{"const":"invalid_name","type":"string"}},"required":["status","raw_claim_name","provenance"],"type":"object"}]},"PrimaryNameData":{"properties":{"address":{"type":"string"},"coin_type":{"type":"string"},"namespace":{"enum":["ens","basenames"],"type":"string"}},"required":["address","namespace","coin_type"],"type":"object"},"PrimaryNameDeclaredState":{"additionalProperties":false,"properties":{"claimed_primary_name":{"$ref":"#/components/schemas/PrimaryNameClaimedResult"}},"required":["claimed_primary_name"],"type":"object"},"PrimaryNameResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"$ref":"#/components/schemas/PrimaryNameData"},"declared_state":{"anyOf":[{"$ref":"#/components/schemas/PrimaryNameDeclaredState"},{"$ref":"#/components/schemas/NullValue"}]},"last_updated":{"format":"date-time","type":"string"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"anyOf":[{"$ref":"#/components/schemas/PrimaryNameVerifiedState"},{"$ref":"#/components/schemas/NullValue"}]}},"required":["data","declared_state","verified_state","coverage","chain_positions","consistency","last_updated"],"type":"object"},"PrimaryNameVerifiedResult":{"additionalProperties":true,"properties":{"provenance":{"$ref":"#/components/schemas/PrimaryNameVerifiedResultProvenance"},"status":{"type":"string"}},"required":["status"],"type":"object"},"PrimaryNameVerifiedResultProvenance":{"additionalProperties":false,"properties":{"execution_trace_id":{"type":"string"},"manifest_versions":{"items":{},"type":"array"}},"required":["manifest_versions","execution_trace_id"],"type":"object"},"PrimaryNameVerifiedState":{"additionalProperties":false,"properties":{"verified_primary_name":{"$ref":"#/components/schemas/PrimaryNameVerifiedResult"}},"required":["verified_primary_name"],"type":"object"},"ProfileNameData":{"additionalProperties":false,"properties":{"name":{"type":"string"},"namehash":{"type":"string"},"namespace":{"type":"string"},"resource_id":{"format":"uuid","type":["string","null"]}},"required":["name","namespace","namehash","resource_id"],"type":"object"},"Provenance":{"properties":{"derivation_kind":{"type":"string"},"execution_trace_id":{"type":["string","null"]},"manifest_versions":{"items":{},"type":"array"},"normalized_event_ids":{"items":{"type":"string"},"type":"array"},"raw_fact_refs":{"items":{},"type":"array"}},"required":["normalized_event_ids","raw_fact_refs","manifest_versions","execution_trace_id","derivation_kind"],"type":"object"},"PublicStatusResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/IndexingStatusResponse"}},"required":["data"],"type":"object"},"ResolutionResponse":{"properties":{"chain_positions":{"$ref":"#/components/schemas/ChainPositions"},"consistency":{"$ref":"#/components/schemas/Consistency"},"coverage":{"$ref":"#/components/schemas/CoverageResponse"},"data":{"$ref":"#/components/schemas/ExactNameData"},"declared_state":{"additionalProperties":true,"type":["object","null"]},"last_updated":{"format":"date-time","type":"string"},"provenance":{"$ref":"#/components/schemas/Provenance"},"verified_state":{"additionalProperties":true,"type":["object","null"]}},"required":["data","declared_state","verified_state"],"type":"object"},"ResolverData":{"properties":{"chain_id":{"type":"string"},"resolver_address":{"type":"string"}},"required":["chain_id","resolver_address"],"type":"object"},"ResolverOverviewCompact":{"properties":{"aliases":{"type":["object","array","string","integer","boolean","null"]},"chain_id":{"type":["object","array","string","integer","boolean","null"]},"counts":{"type":["object","array","string","integer","boolean","null"]},"events":{"type":["object","array","string","integer","boolean","null"]},"nodes":{"type":["object","array","string","integer","boolean","null"]},"resolver_address":{"type":["object","array","string","integer","boolean","null"]},"roles":{"type":["object","array","string","integer","boolean","null"]}},"required":["chain_id","resolver_address","counts"],"type":"object"},"ResourceLookupData":{"properties":{"name":{"type":["object","array","string","integer","boolean","null"]},"namespace":{"type":["object","array","string","integer","boolean","null"]},"normalized_name":{"type":["object","array","string","integer","boolean","null"]},"resource_hex":{"type":["object","array","string","integer","boolean","null"]},"resource_id":{"type":["object","array","string","integer","boolean","null"]}},"required":["namespace","name","normalized_name","resource_id","resource_hex"],"type":"object"},"ResourceLookupResponse":{"properties":{"data":{"$ref":"#/components/schemas/ResourceLookupData"},"meta":{"$ref":"#/components/schemas/CompactMeta"}},"required":["data"],"type":"object"},"RoleRow":{"properties":{"account":{"type":["object","array","string","integer","boolean","null"]},"effective_powers":{"type":["object","array","string","integer","boolean","null"]},"name":{"type":["object","array","string","integer","boolean","null"]},"resource_hex":{"type":["object","array","string","integer","boolean","null"]},"resource_id":{"type":["object","array","string","integer","boolean","null"]},"role_bitmap":{"type":["object","array","string","integer","boolean","null"]}},"required":["account","resource_id","effective_powers"],"type":"object"}}},"info":{"description":"Machine-readable publication of the currently shipped public API surface derived from apps/api/src/main.rs.","title":"bigname API v1","version":"phase-7"},"openapi":"3.1.0","paths":{"/v1/addresses/{address}/names":{"get":{"operationId":"address_names","parameters":[{"description":"Address anchor for the collection or history read. Addresses are normalized to lowercase.","in":"path","name":"address","required":true,"schema":{"type":"string"}},{"description":"Optional namespace filter.","in":"query","name":"namespace","required":false,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Optional relation facet filter.","in":"query","name":"relation","required":false,"schema":{"enum":["registrant","token_holder","effective_controller"],"type":"string"}},{"description":"Current collection dedupe basis.","in":"query","name":"dedupe_by","required":false,"schema":{"default":"surface","enum":["surface","resource"],"type":"string"}},{"description":"Optional collection expansions. `role_summary` is the only shipped expansion.","explode":false,"in":"query","name":"include","required":false,"schema":{"enum":["role_summary"],"type":"string"},"style":"form"},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Address-to-surface collection","tags":["Collections"]}},"/v1/coverage/{namespace}/{name}":{"get":{"operationId":"coverage_current","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Point-in-time selector for the exact-name snapshot. Mutually exclusive with `chain_positions`.","in":"query","name":"at","required":false,"schema":{"type":"string"}},{"description":"Explicit exact-name snapshot selector encoded as one JSON object using ChainPositions position objects. Mutually exclusive with `at`.","in":"query","name":"chain_positions","required":false,"schema":{"type":"string"}},{"description":"Snapshot consistency floor. Defaults to `head`.","in":"query","name":"consistency","required":false,"schema":{"default":"head","enum":["head","safe","finalized"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExactNameResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid snapshot selector"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Snapshot conflict or stale projection"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Single-name coverage and explain details","tags":["Coverage"]}},"/v1/events":{"get":{"operationId":"events","parameters":[{"description":"Optional namespace filter.","in":"query","name":"namespace","required":false,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name event anchor filter.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"Address relation event filter.","in":"query","name":"address","required":false,"schema":{"type":"string"}},{"description":"Opaque resource identifier filter.","in":"query","name":"resource","required":false,"schema":{"format":"uuid","type":"string"}},{"description":"Opaque resource identifier filter.","in":"query","name":"resource_id","required":false,"schema":{"format":"uuid","type":"string"}},{"description":"Normalized event type or compact type alias filter.","in":"query","name":"type","required":false,"schema":{"type":"string"}},{"description":"Optional app-facing relation facet filter.","in":"query","name":"relation","required":false,"schema":{"enum":["token_holder","registrant","effective_controller","any"],"type":"string"}},{"description":"Inclusive canonical block lower bound.","in":"query","name":"from_block","required":false,"schema":{"minimum":0,"type":"integer"}},{"description":"Inclusive canonical block upper bound.","in":"query","name":"to_block","required":false,"schema":{"minimum":0,"type":"integer"}},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactEventsResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing compact event search","tags":["History"]}},"/v1/explain/names/{namespace}/{name}/authority-control":{"get":{"operationId":"explain_authority_control_current","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Point-in-time selector for the exact-name snapshot. Mutually exclusive with `chain_positions`.","in":"query","name":"at","required":false,"schema":{"type":"string"}},{"description":"Explicit exact-name snapshot selector encoded as one JSON object using ChainPositions position objects. Mutually exclusive with `at`.","in":"query","name":"chain_positions","required":false,"schema":{"type":"string"}},{"description":"Snapshot consistency floor. Defaults to `head`.","in":"query","name":"consistency","required":false,"schema":{"default":"head","enum":["head","safe","finalized"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExactNameResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid snapshot selector"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Snapshot conflict or stale projection"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Current authority/control explain view for one exact name","tags":["Explain"]}},"/v1/explain/names/{namespace}/{name}/surface-binding":{"get":{"operationId":"explain_surface_binding_current","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Point-in-time selector for the exact-name snapshot. Mutually exclusive with `chain_positions`.","in":"query","name":"at","required":false,"schema":{"type":"string"}},{"description":"Explicit exact-name snapshot selector encoded as one JSON object using ChainPositions position objects. Mutually exclusive with `at`.","in":"query","name":"chain_positions","required":false,"schema":{"type":"string"}},{"description":"Snapshot consistency floor. Defaults to `head`.","in":"query","name":"consistency","required":false,"schema":{"default":"head","enum":["head","safe","finalized"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExactNameResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid snapshot selector"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Snapshot conflict or stale projection"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Current surface-binding explain view for one exact name","tags":["Explain"]}},"/v1/explain/resolutions/{namespace}/{name}/execution":{"get":{"operationId":"explain_resolution_execution_current","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Comma-separated record selectors. Required for the persisted execution explain lookup.","explode":false,"in":"query","name":"records","required":true,"schema":{"type":"string"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolutionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Persisted verified execution explain for one exact-name resolution request","tags":["Explain"]}},"/v1/history/addresses/{address}":{"get":{"operationId":"address_history","parameters":[{"description":"Address anchor for the collection or history read. Addresses are normalized to lowercase.","in":"path","name":"address","required":true,"schema":{"type":"string"}},{"description":"Optional namespace filter.","in":"query","name":"namespace","required":false,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Optional relation facet filter.","in":"query","name":"relation","required":false,"schema":{"enum":["registrant","token_holder","effective_controller"],"type":"string"}},{"description":"History scope selector.","in":"query","name":"scope","required":false,"schema":{"default":"both","enum":["surface","resource","both"],"type":"string"}},{"description":"Response view selector.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Address activity across related surfaces and resources","tags":["History"]}},"/v1/history/names/{namespace}/{name}":{"get":{"operationId":"name_history","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"History scope selector.","in":"query","name":"scope","required":false,"schema":{"default":"both","enum":["surface","resource","both"],"type":"string"}},{"description":"Response view selector.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Surface or combined history","tags":["History"]}},"/v1/history/resources/{resource_id}":{"get":{"operationId":"resource_history","parameters":[{"description":"Resource identifier anchor.","in":"path","name":"resource_id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"History scope selector.","in":"query","name":"scope","required":false,"schema":{"default":"both","enum":["surface","resource","both"],"type":"string"}},{"description":"Response view selector.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Resource history","tags":["History"]}},"/v1/identity:lookup":{"post":{"operationId":"identity_lookup","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityLookupInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityLookupResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Native slim identity lookup","tags":["Identity"]}},"/v1/manifests/{namespace}":{"get":{"operationId":"namespace_manifests","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceManifestsResponse"}}},"description":"Successful response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Active manifest versions and capabilities","tags":["Namespaces"]}},"/v1/names":{"get":{"operationId":"names","parameters":[{"description":"Optional namespace filter.","in":"query","name":"namespace","required":false,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Exact normalized-name lookup filter.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"Normalized-name prefix search filter.","in":"query","name":"prefix","required":false,"schema":{"type":"string"}},{"description":"Normalized-name contains search filter.","in":"query","name":"contains","required":false,"schema":{"type":"string"}},{"description":"Case-insensitive normalized-name contains search filter.","in":"query","name":"contains_nocase","required":false,"schema":{"type":"string"}},{"description":"Token-holder / owner address filter.","in":"query","name":"owner","required":false,"schema":{"type":"string"}},{"description":"Address relation filter anchor.","in":"query","name":"account","required":false,"schema":{"type":"string"}},{"description":"Registrant address filter.","in":"query","name":"registrant","required":false,"schema":{"type":"string"}},{"description":"Current declared resolver address filter.","in":"query","name":"resolver","required":false,"schema":{"type":"string"}},{"description":"Declared record-value equality filter when projected.","in":"query","name":"resolved_address","required":false,"schema":{"type":"string"}},{"description":"Optional app-facing relation facet filter.","in":"query","name":"relation","required":false,"schema":{"enum":["token_holder","registrant","effective_controller","any"],"type":"string"}},{"description":"Stable compact names sort key.","in":"query","name":"sort","required":false,"schema":{"default":"name","enum":["name","expiry_date","registration_date","created_at"],"type":"string"}},{"description":"Stable sort order.","in":"query","name":"order","required":false,"schema":{"default":"asc","enum":["asc","desc"],"type":"string"}},{"description":"Optional compact name expansions.","explode":false,"in":"query","name":"include","required":false,"schema":{"enum":["record_summaries","total_count"],"type":"string"},"style":"form"},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactNamesResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing compact name search and exact lookup","tags":["Names"]}},"/v1/names/{namespace}/{name}":{"get":{"operationId":"name_current","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Point-in-time selector for the exact-name snapshot. Mutually exclusive with `chain_positions`.","in":"query","name":"at","required":false,"schema":{"type":"string"}},{"description":"Explicit exact-name snapshot selector encoded as one JSON object using ChainPositions position objects. Mutually exclusive with `at`.","in":"query","name":"chain_positions","required":false,"schema":{"type":"string"}},{"description":"Snapshot consistency floor. Defaults to `head`.","in":"query","name":"consistency","required":false,"schema":{"default":"head","enum":["head","safe","finalized"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExactNameResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid snapshot selector"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Snapshot conflict or stale projection"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Exact name lookup","tags":["Names"]}},"/v1/names/{namespace}/{name}/children":{"get":{"operationId":"name_children","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Requested child surface classes. Only `declared` is currently supported.","explode":false,"in":"query","name":"surface_classes","required":false,"schema":{"default":"declared","type":"string"},"style":"form"},{"description":"Optional collection expansions. `counts` includes compact row `subname_count` or full-envelope `declared_state.subname_count`.","explode":false,"in":"query","name":"include","required":false,"schema":{"enum":["counts"],"type":"string"},"style":"form"},{"description":"Response view selector.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact","full"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Declared child collection by default","tags":["Collections"]}},"/v1/names/{namespace}/{name}/records":{"get":{"operationId":"name_records","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compact records read mode. `auto` uses declared cache when it can satisfy the requested values from replayable state, otherwise verified resolution for requested selectors. When no declared selectors are available, app-facing defaults probe only a bounded basic profile set.","in":"query","name":"mode","required":false,"schema":{"default":"declared","enum":["auto","declared","verified","both"],"type":"string"}},{"description":"Requested text record keys.","explode":false,"in":"query","name":"texts","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Whether to return projected known text-key inventory.","in":"query","name":"known_text_keys","required":false,"schema":{"type":"boolean"}},{"description":"Whether to request the avatar text convenience field.","in":"query","name":"avatar","required":false,"schema":{"type":"boolean"}},{"description":"Whether to request the content-hash selector.","in":"query","name":"content_hash","required":false,"schema":{"type":"boolean"}},{"description":"Requested textual coin-type selector keys.","explode":false,"in":"query","name":"coin_types","required":false,"schema":{"type":"string"},"style":"form"},{"description":"Optional compact record sections.","explode":false,"in":"query","name":"include","required":false,"schema":{"default":"resolver_address","enum":["resolver_address","known_text_keys","avatar","content_hash","coins"],"type":"string"},"style":"form"},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactNameRecordsResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing compact resolver records","tags":["Resolution"]}},"/v1/names/{namespace}/{name}/roles":{"get":{"operationId":"name_roles","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name within the namespace.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Effective permission subject filter.","in":"query","name":"account","required":false,"schema":{"type":"string"}},{"description":"Projected role bitmap filter when supported.","in":"query","name":"role_bitmap","required":false,"schema":{"type":"string"}},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactRolesResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing role rows for a name's current resource","tags":["Collections"]}},"/v1/namespaces/{namespace}":{"get":{"operationId":"namespace_metadata","parameters":[{"description":"Supported namespace identifier.","in":"path","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamespaceMetadataResponse"}}},"description":"Successful response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Namespace metadata and support status","tags":["Namespaces"]}},"/v1/primary-names/{address}":{"get":{"operationId":"primary_names","parameters":[{"description":"Address anchor for the collection or history read. Addresses are normalized to lowercase.","in":"path","name":"address","required":true,"schema":{"type":"string"}},{"description":"Primary-name namespace. Defaults to ENS for the app fast path.","in":"query","name":"namespace","required":false,"schema":{"default":"ens","enum":["ens","basenames"],"type":"string"}},{"description":"`coin_type` selector. Defaults to 60 for the app fast path.","in":"query","name":"coin_type","required":false,"schema":{"default":"60","pattern":"^[0-9]+$","type":"string"}},{"description":"Primary-name read mode.","in":"query","name":"mode","required":false,"schema":{"default":"declared","enum":["declared","verified","both"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrimaryNameResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Claimed and verified primary-name answer","tags":["Resolution"]}},"/v1/profiles/names/{name}":{"get":{"operationId":"name_profile","parameters":[{"description":"Name input normalized before namespace inference.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Point-in-time selector for the exact-name snapshot used by the profile read. Mutually exclusive with `chain_positions`.","in":"query","name":"at","required":false,"schema":{"type":"string"}},{"description":"Explicit exact-name snapshot selector encoded as one JSON object using ChainPositions position objects. Mutually exclusive with `at`.","in":"query","name":"chain_positions","required":false,"schema":{"type":"string"}},{"description":"Snapshot consistency floor. Defaults to `head`.","in":"query","name":"consistency","required":false,"schema":{"default":"head","enum":["head","safe","finalized"],"type":"string"}},{"description":"Full profile read mode. Defaults to `both` so app callers get declared profile state plus verified record results when supported.","in":"query","name":"mode","required":false,"schema":{"default":"both","enum":["declared","verified","both"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameProfileResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Snapshot conflict or stale projection"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing inferred-name full profile with declared and verified record results","tags":["Names"]}},"/v1/resolvers/{chain_id}/{resolver_address}/overview":{"get":{"operationId":"resolver_overview","parameters":[{"description":"Resolver chain identifier.","in":"path","name":"chain_id","required":true,"schema":{"type":"string"}},{"description":"Resolver address anchor. Addresses are normalized to lowercase.","in":"path","name":"resolver_address","required":true,"schema":{"type":"string"}},{"description":"Requested compact resolver overview sections.","explode":false,"in":"query","name":"include","required":false,"schema":{"default":"nodes,aliases,roles,events","enum":["nodes","aliases","roles","events"],"type":"string"},"style":"form"},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactResolverOverviewResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing compact resolver overview","tags":["Resolvers"]}},"/v1/resources/lookup":{"get":{"operationId":"resource_lookup","parameters":[{"description":"Required namespace identifier.","in":"query","name":"namespace","required":true,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Required normalized name to resolve to a current resource identity.","in":"query","name":"name","required":true,"schema":{"type":"string"}},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceLookupResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Requested resource was not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing lookup from name to current resource identity","tags":["Resources"]}},"/v1/resources/{resource_id}/permissions":{"get":{"operationId":"resource_permissions","parameters":[{"description":"Resource identifier anchor.","in":"path","name":"resource_id","required":true,"schema":{"format":"uuid","type":"string"}},{"description":"Optional subject filter for the current effective permissions rows.","in":"query","name":"subject","required":false,"schema":{"type":"string"}},{"description":"Optional scope filter. Accepts `root`, `registry`, `resource`, `resolver:{chain_id}:{resolver_address}`, `record_manager:{chain_id}:{manager_address}`, `migration_derived:{resource_id}`, or `transport_derived:{transport}`.","in":"query","name":"scope","required":false,"schema":{"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Resource-centric effective permissions","tags":["Collections"]}},"/v1/roles":{"get":{"operationId":"roles","parameters":[{"description":"Effective permission subject filter.","in":"query","name":"account","required":false,"schema":{"type":"string"}},{"description":"Opaque resource identifier filter.","in":"query","name":"resource_id","required":false,"schema":{"format":"uuid","type":"string"}},{"description":"Optional namespace filter.","in":"query","name":"namespace","required":false,"schema":{"enum":["ens","basenames"],"type":"string"}},{"description":"Normalized name lookup filter paired with namespace.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"Projected role bitmap filter when supported.","in":"query","name":"role_bitmap","required":false,"schema":{"type":"string"}},{"description":"Compact response view selector. `view=full` remains a compatibility-reserved value and returns `400 invalid_input`.","in":"query","name":"view","required":false,"schema":{"default":"compact","enum":["compact"],"type":"string"}},{"description":"Compact response metadata selector.","in":"query","name":"meta","required":false,"schema":{"default":"summary","enum":["none","summary","full"],"type":"string"}},{"description":"Replay-stable pagination cursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional page size. When supplied it must be between 1 and 200.","in":"query","name":"page_size","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompactRolesResponse"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"App-facing role rows by account, resource, or name filters","tags":["Collections"]}},"/v1/status":{"get":{"operationId":"status","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicStatusResponse"}}},"description":"Successful response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Internal error"}},"summary":"Projection indexing status by chain","tags":["Status"]}}}}