跳转到内容

ak.schema.applet_registration_epoch_transcript.v1

← Schemas

Arkret Applet Registration Epoch Transcript
ak.schema.applet_registration_epoch_transcript.v1 · file: schemas/applet-registration-epoch-transcript.schema.json

Closed, normalized security transcript hashed to produce an Applet registration_epoch. The hash input is the UTF-8 domain separator arkret-applet-registration-epoch-v1\n followed by the JCS bytes of this object. Applet producer identity is restricted to versioned did:webvh or stable did:key so the same accepted state can form a historical Service signer root.

* $ · object
Closed, normalized security transcript hashed to produce an Applet registration_epoch. The hash input is the UTF-8 domain separator arkret-applet-registration-epoch-v1\n followed by the JCS bytes of this object. Applet producer identity is restricted to versioned did:webvh or stable did:key so the same accepted state can form a historical Service signer root.
* schema · const "ak.schema.applet_registration_epoch_transcript.v1"
enum: "ak.schema.applet_registration_epoch_transcript.v1"
* derived_registration · object · $ref #/$defs/derived_registration
* kind · const "ak.applet.registration"
enum: "ak.applet.registration"
* applet_id · string · $ref ./common-ids.schema.json#/$defs/applet_id
Stable canonical Applet installation identity. Applet service authority is carried separately by service_id.
pattern: ^ak:applet:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
* service_id · string · $ref ./common-ids.schema.json#/$defs/did_core_id
Canonical stable DID-derived identity core. The lowercase DID method name follows ak:did_core:, and the remaining method-adapter-defined core is opaque to generic consumers. The did:web v1 adapter uses the complete canonical method-specific-id, never a digest or truncated host. Principal-core and service-core equality is byte-for-byte equality of the complete did_core_id. Event actor and Realm membership equality instead use the complete closed ActorId, and account-scoped equality uses the complete AccountId; neither may be reduced to a principal core. A did_core_id is not a DID and cannot be resolved without a did or AuthenticatedServiceResolution.
pattern: ^ak:did_core:[a-z0-9]+:[^\s/?#]+$
* controller_principal_id · string · $ref ./common-ids.schema.json#/$defs/did_core_id
Canonical stable DID-derived identity core. The lowercase DID method name follows ak:did_core:, and the remaining method-adapter-defined core is opaque to generic consumers. The did:web v1 adapter uses the complete canonical method-specific-id, never a digest or truncated host. Principal-core and service-core equality is byte-for-byte equality of the complete did_core_id. Event actor and Realm membership equality instead use the complete closed ActorId, and account-scoped equality uses the complete AccountId; neither may be reduced to a principal core. A did_core_id is not a DID and cannot be resolved without a did or AuthenticatedServiceResolution.
pattern: ^ak:did_core:[a-z0-9]+:[^\s/?#]+$
* base_url · string (uri) · format=uri
pattern: ^https://
* protocols · array<$ref #/$defs/non_empty_string> · $ref #/$defs/string_set
items · string · $ref #/$defs/non_empty_string
* namespaces · object · $ref ./applet-package.schema.json#/$defs/applet_namespaces
* actors · array<$ref #/$defs/actor_namespace_entry>
items · $ref #/$defs/actor_namespace_entry · $ref #/$defs/actor_namespace_entry
* realms · array<$ref #/$defs/namespace_entry>
items · $ref #/$defs/namespace_entry · $ref #/$defs/namespace_entry
* handles · array<$ref #/$defs/namespace_entry>
items · $ref #/$defs/namespace_entry · $ref #/$defs/namespace_entry
* receive_events · boolean
* receive_signals · boolean
* rate_limited · boolean
* requested_scopes · array<$ref #/$defs/non_empty_string> · $ref #/$defs/string_set
items · string · $ref #/$defs/non_empty_string
* created_at · string (date-time) · format=date-time · $ref #/$defs/timestamp
Canonical Arkret-owned absolute instant. UTC Z form with exactly three millisecond digits. Whole seconds MUST use .000Z; offsets, missing/finer fractions, lowercase separators, leap seconds, and invalid Gregorian calendar dates are forbidden. Shape validation by this pattern is supplemented by semantic date validation.
pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]\.[0-9]{3}Z$
* service_did_document · object · $ref #/$defs/service_did_document
* did · string · $ref #/$defs/did
Canonical bare DID used for registration, DID method resolution and owner-published current resolution. It contains no path, query or fragment and MUST project through the registered method adapter to exactly one did_core_id.
pattern: ^did:[a-z0-9]+:[^\s/?#]+$
* document_digest · string · $ref #/$defs/digest
pattern: ^sha256:[0-9a-f]{64}$
* method_version · object · $ref #/$defs/did_method_version
oneOf · oneOf[0] · object
* method · string (enum)
enum: "did:webvh" "did:key"
* unversioned_refetch · const false
enum: false
oneOf · oneOf[1] · object
* method · const "did:webvh"
enum: "did:webvh"
* unversioned_refetch · const false
enum: false
* method · string
pattern: ^did:[a-z0-9]+$
version_id · allOf[2]
allOf · allOf[0] · string · $ref #/$defs/non_empty_string
allOf · allOf[1] · ? · $ref string-profiles.schema.json#/$defs/non_typed_identifier_floor
Lexical floor of every identifier value category that does NOT own the ak: namespace (opaque_correlation, document_local_symbol, external_system_identifier, registry_catalog_symbol, unregistered_object_identifier); see common-fields.md 2.1. The negative lookahead IS the floor: it mechanically proves the value cannot be an ak: typed id, which maxLength alone can never prove, while admitting every other value the field already accepted. It deliberately constrains nothing else - the per-field convergence direction (a registered typed kind, or a tighter opaque profile) is decided per object family, so a pattern-only floor composes with whatever profile the field already carries instead of pre-empting it.
pattern: ^(?!ak:)
version_time · string (date-time) · format=date-time · $ref #/$defs/timestamp
Canonical Arkret-owned absolute instant. UTC Z form with exactly three millisecond digits. Whole seconds MUST use .000Z; offsets, missing/finer fractions, lowercase separators, leap seconds, and invalid Gregorian calendar dates are forbidden. Shape validation by this pattern is supplemented by semantic date validation.
pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]\.[0-9]{3}Z$
* unversioned_refetch · boolean
* accepted_signing_keys · array<$ref #/$defs/accepted_signing_key>
items · object · $ref #/$defs/accepted_signing_key
* key_ref · string · $ref #/$defs/did_url
pattern: ^did:[a-z0-9]+:[^\s#?]+#[A-Za-z0-9._:-]+$
* public_key_digest · string · $ref #/$defs/digest
pattern: ^sha256:[0-9a-f]{64}$
* endpoint_policy · object · $ref ./applet-package.schema.json#/$defs/endpoint_policy
Supported Applet API endpoints and their auth requirement.
* endpoints · array<$ref #/$defs/endpoint_entry>
items · $ref #/$defs/endpoint_entry · $ref #/$defs/endpoint_entry
(^x_[a-z][a-z0-9_]{0,63}$) · any
* webhook_auth · object · $ref ./applet-package.schema.json#/$defs/webhook_auth
HTTP message signature verification policy for transaction push. key_ref is the Applet service DID URL used to verify the app/bridge->arkret inbound HTTP message signature. Verifiers MUST take its bare controller did, validate it with the registered method adapter, and require project(did) to equal service_id (did_core_id); direct DID/core-id string comparison is forbidden. The key is bound to the effective registration_epoch. accepted_signature_algorithms pins the acceptable RFC 9421 signature algorithms.
* key_ref · string · $ref #/$defs/did_url
DID URL under an Applet service did whose registered adapter projection equals service_id. For app/bridge->arkret inbound transaction push, Signature-Input keyid MUST equal this value. Node->Applet pushes verify the Arkret source service did/key binding selected by the Source-Service-ID did_core_id, not this field.
pattern: ^did:[a-z0-9]+:[^\s#?]+#[A-Za-z0-9._:-]+$
* accepted_signature_algorithms · array<$ref #/$defs/http_message_signature_algorithm>
items · $ref #/$defs/http_message_signature_algorithm · $ref #/$defs/http_message_signature_algorithm
signature_header · string · $ref #/$defs/non_empty_string
* kind · string (enum)
enum: "http_message_signature"
(^x_[a-z][a-z0-9_]{0,63}$) · any
* security_policy · object · $ref #/$defs/security_policy
* claimed_profiles · array<string>
items · string
pattern: ^ak\.profile\.[a-z0-9_.-]+\.v1$
* limits · object · $ref ./applet-package.schema.json#/$defs/limits
Service-side resource hints derived into the registration manifest.
max_transaction_events · integer
max_payload_bytes · integer
rate_limit_per_minute · integer
(^x_[a-z][a-z0-9_]{0,63}$) · any
* ghost_policy · object · $ref ./applet-package.schema.json#/$defs/ghost_policy
Ghost Actor support and accountability template. enabled defaults to false semantics; an explicit boolean is required.
* enabled · boolean
accountability_template · string · $ref #/$defs/non_empty_string
(^x_[a-z][a-z0-9_]{0,63}$) · any
* delegation_policy · object · $ref ./applet-package.schema.json#/$defs/delegation_policy
Delegated native-user acting request. Defaults to false; enabled MUST be explicit.
* enabled · boolean
(^x_[a-z][a-z0-9_]{0,63}$) · any
* e2ee_policy · object · $ref ./applet-package.schema.json#/$defs/e2ee_policy
MLS join request. Defaults to false; enabled MUST be explicit.
* enabled · boolean
mls_join_requested · boolean
(^x_[a-z][a-z0-9_]{0,63}$) · any
widget · object · $ref ./applet-widget-declaration.schema.json
Closed declaration for an Applet UI widget origin, CSP, scoped token capability scope, and consent gate.
* schema · const "ak.schema.applet_widget_declaration.v1"
enum: "ak.schema.applet_widget_declaration.v1"
* widget_origin · allOf[2]
Canonical HTTPS Web Origin only: lowercase scheme and host plus an optional valid non-default port. Userinfo, path (including a trailing slash), query, fragment, explicit :443, and out-of-range ports are forbidden.
allOf · allOf[0] · string (uri) · format=uri · $ref ./common-ids.schema.json#/$defs/web_origin
Canonical HTTP(S) Web Origin: lowercase scheme/host plus an optional valid non-default effective port. Userinfo, path (including a trailing slash), query, fragment, explicit :80 on HTTP, and explicit :443 on HTTPS are forbidden.
pattern: ^(?:http://(?:\[[0-9A-Fa-f:.]+\]|[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?)(?::(?!80$)(?:[1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?|https://(?:\[[0-9A-Fa-f:.]+\]|[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?)(?::(?!443$)(?:[1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?)$
allOf · allOf[1] · ?
pattern: ^https://
* csp · string
Content-Security-Policy that the host client MUST enforce for the widget document.
* token_scope · object
Maximum capability scope for the short-lived widget token.
* actions · array<string>
items · string
pattern: ^ak\.[a-z0-9_]+(\.[a-z0-9_]+)*$
* resources · array<$ref ./resource-selector.schema.json>
items · object · $ref ./resource-selector.schema.json
allOf · allOf[0] · ?
allOf · allOf[1] · ?
allOf · allOf[2] · ?
allOf · allOf[3] · ?
* kind · string (enum)
enum: "realm" "space" "circle" "strand" "message" "morph" "object" "relation" "view" "event" "actor" "schema" "policy" "invite" "notification" "read_cursor" "blob" "*"
realm_id · string · $ref ./common-ids.schema.json#/$defs/realm_id
Retyped ak.realm.create Event token. It therefore carries the same fixed current-v1 0x01/SHA-256 content-address identity and is not selected by Realm state.
pattern: ^ak:realm:[A-Za-z0-9_-]{44}$
space_id · string
pattern: ^ak:space:[A-Za-z0-9_-]{44}$
circle_id · string · $ref ./common-ids.schema.json#/$defs/circle_id
pattern: ^ak:circle:[A-Za-z0-9_-]{44}$
object_kind · string
object_ref · string
Canonical object reference. Acceptable typed-id kinds match the v1 resource selector kind enum (see resource-selector-grammar.md §3.1). Notably MUST NOT include 'actor_profile' (use the 'actor' selector with did pattern), nor non-canonical 'board' / 'list' / 'card' / 'subject' / 'room' kinds — board / list / swimlane / calendar bucket are Space objects and MUST use the 'space' kind together with the 'allowed_space_kinds' constraint to restrict which Space kinds the grant covers.
pattern: ^(?:ak:realm:[A-Za-z0-9_-]{44}|ak:(space|circle|strand|message|morph|relation|view|event|invite):[A-Za-z0-9_-]{44}|ak:(policy|blob):[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$
strand_id · string
pattern: ^ak:strand:[A-Za-z0-9_-]{44}$
message_id · string
pattern: ^ak:message:[A-Za-z0-9_-]{44}$
morph_id · string
pattern: ^ak:morph:[A-Za-z0-9_-]{44}$
morph_kind · string
relation_kind · string
relation_id · string
pattern: ^ak:relation:[A-Za-z0-9_-]{44}$
view_id · string
pattern: ^ak:view:[A-Za-z0-9_-]{44}$
event_id · string
pattern: ^ak:event:[A-Za-z0-9_-]{44}$
actor_id · oneOf[2] · $ref ./common-ids.schema.json#/$defs/actor_id
Complete protocol identity for an Event author or Realm member: account carries the exact AccountId for every Station-hosted principal; service identifies a service acting as itself. The discriminator is validated against accepted registration and admission evidence; it never authorizes itself. Account and service are distinct, and no comparison may fall back to a bare principal_id. Agent and integration classification, provisioning, controller binding and credential authorization are independently verified facts, not identity variants. Account actors at different Stations MUST NOT share or inherit authority merely because their principal_id, DID controller or signing key matches, including membership, capability, RealmCommit-signing and recovery authority.
oneOf · oneOf[0] · object
* kind · const "account"
enum: "account"
* account_id · $ref #/$defs/account_id · $ref #/$defs/account_id
oneOf · oneOf[1] · object
* kind · const "service"
enum: "service"
* service_id · $ref #/$defs/did_core_id · $ref #/$defs/did_core_id
schema_ref · string
policy_id · string
pattern: ^ak:policy:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
invite_id · string
pattern: ^ak:invite:[A-Za-z0-9_-]{44}$
blob_ref · string
pattern: ^ak:blob:(?:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|(?:sha256|blake3):[0-9a-f]{64})$
match_scope · string (enum)
Authorization selector breadth. exact matches only the named resource; realm_wide is valid only for the registered resource kinds with an explicit realm_id. Neither current navigation ancestry nor creation ancestry expands authorization. Hierarchy traversal belongs to queries, not grant matching. The normative algorithm is zh/authz/resource-selector-grammar.md section 6.
enum: "exact" "realm_wide"
realm_ids · array<$ref ./common-ids.schema.json#/$defs/realm_id>
items · string · $ref ./common-ids.schema.json#/$defs/realm_id
Retyped ak.realm.create Event token. It therefore carries the same fixed current-v1 0x01/SHA-256 content-address identity and is not selected by Realm state.
pattern: ^ak:realm:[A-Za-z0-9_-]{44}$
* expires_at · string (date-time) · format=date-time · $ref ./time.schema.json#/$defs/timestamp
Canonical Arkret-owned absolute instant. UTC Z form with exactly three millisecond digits. Whole seconds MUST use .000Z; offsets, missing/finer fractions, lowercase separators, leap seconds, and invalid Gregorian calendar dates are forbidden. Shape validation by this pattern is supplemented by semantic date validation.
pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]\.[0-9]{3}Z$
max_ttl_seconds · integer
(^x_[a-z][a-z0-9_]{0,63}$) · any
* consent_required · boolean
(^x_[a-z][a-z0-9_]{0,63}$) · any

Source