Admin key
type: Class
subclass of: Token key
definition: Token key that can update core properties or delete the token.
source document: token-keys

Fixed fee
type: Class
subclass of: Custom fee
definition: Custom fee that transfers a fixed quantity of tokens or HBAR to the collector.
source document: fixed-fees

Fractional fee
type: Class
subclass of: Custom fee
definition: Custom fee deducting a fraction of the transferred amount and sending it to a collector.
source document: fractional-fees

Freeze controller role
type: Class
subclass of: Token compliance role
definition: Role responsible for freezing or unfreezing token accounts to maintain compliance.
source document: hip-540

Freeze key
type: Class
subclass of: Token key
definition: Token key that toggles whether accounts may transact the token.
source document: token-keys

Freeze key assignment
type: Class
subclass of: Token key assignment
definition: Assignment that links a freeze key to the actor authorised to halt or resume transfers.
source document: hip-540

KYC controller role
type: Class
subclass of: Token compliance role
definition: Role accountable for administering KYC approvals required before token transfers.
source document: hip-540

KYC key
type: Class
subclass of: Token key
definition: Token key that authorises marking accounts as KYC-compliant before they may transfer tokens.
source document: token-keys

KYC key assignment
type: Class
subclass of: Token key assignment
definition: Assignment that links a KYC key to the accountable controller enforcing onboarding checks.
source document: hip-540

Non-fungible token
type: Class
subclass of: Token
definition: Token representing unique serialised items with metadata and ownership tracked per serial.
source document: non-fungible-tokens

Pause key
type: Class
subclass of: Token key
definition: Token key that can pause and resume all token transfers regardless of account state.
source document: token-keys

Royalty fee
type: Class
subclass of: Custom fee
definition: Custom fee that distributes a percentage of NFT sales to the royalty collector.
source document: royalty-fees

Stablecoin token
type: Class
subclass of: Fungible token
definition: Fungible token profile following HIP-540 stablecoin controls, including explicit KYC and freeze governance.
source document: hip-540

Supply key
type: Class
subclass of: Token key
definition: Token key that authorises minting or burning supply for fungible and non-fungible tokens.
source document: token-keys

Supply key assignment
type: Class
subclass of: Token key assignment
definition: Assignment that links a supply key to the actor authorised to mint or burn supply.
source document: token-keys

Token burn event
type: Class
subclass of: Token event
definition: Event noting supply removed from circulation.
source document: token-burn-and-wipe

Token mint event
type: Class
subclass of: Token event
definition: Event noting additional supply minted for a token.
source document: token-create-and-mint

Token transfer event
type: Class
subclass of: Token event
definition: Event capturing debits and credits recorded for token relationships during a transfer.
source document: transaction-lifecycle

Token treasury role
type: Class
subclass of: Role
definition: Role fulfilled by the account safeguarding reserves and distributing supply on behalf of a token.
source document: treasury-and-supply

assigns key
type: ObjectProperty
domain: Token key assignment
range: Token key
definition: Links a key assignment to the specific token key being governed.

controls key
type: ObjectProperty
domain: Role
range: Token key
definition: States that a governance role exercises authority over a particular token key.

enforcement state
type: DatatypeProperty
domain: Token key assignment
range: string
definition: Narrative state of the key (e.g., present, removed, in escrow) supporting compliance attestation.

fee collector
type: ObjectProperty
domain: Custom fee
range: Account
definition: Identifies the account that receives assessed custom fees.

has allowance
type: DatatypeProperty
domain: Token relationship
range: decimal
definition: Approved allowance amount the account has granted to spenders.

has controller role
type: ObjectProperty
domain: Token key assignment
range: Role
definition: Connects a key assignment to the governance role describing its responsibilities.

has custom fee
type: ObjectProperty
domain: Token
range: Custom fee
definition: Associates a token with the custom fee schedule entries it enforces.

has decimals
type: DatatypeProperty
domain: Fungible token
range: integer
definition: Number of decimal places tracked for fungible token units.

has initial supply
type: DatatypeProperty
domain: Fungible token
range: decimal
definition: Initial supply minted at token creation.

has key assignment
type: ObjectProperty
domain: Token
range: Token key assignment
definition: Connects a token to artefacts describing who controls each of its keys.

has max supply
type: DatatypeProperty
domain: Token
range: decimal
definition: Maximum configured supply for a token.

has symbol
type: DatatypeProperty
domain: Token
range: string
definition: Ticker-style symbol for a token.

has token balance
type: DatatypeProperty
domain: Token relationship
range: decimal
definition: Balance of token units recorded for the relationship.

has token id
type: DatatypeProperty
domain: Token
range: string
definition: Ledger identifier for a token (e.g., 0.0.x).

has token relationship
type: ObjectProperty
domain: Token
range: Token relationship
definition: Relates a token to per-account state records.

has treasury
type: ObjectProperty
domain: Token
range: Account
definition: Identifies the treasury account responsible for token reserves and initial distribution.

is controlled by
type: ObjectProperty
domain: Token key assignment
range: Actor
definition: Indicates which actor holds operational control over a token key.

is frozen
type: DatatypeProperty
domain: Token relationship
range: boolean
definition: Flag indicating whether the account is currently frozen for the token.

is KYC approved
type: DatatypeProperty
domain: Token relationship
range: boolean
definition: Flag indicating whether the account has been marked as KYC compliant for the token.

manages token
type: ObjectProperty
domain: Token Service
range: Token
sub property of: managesArtefact
definition: Associates the Token Service with tokens under its lifecycle governance.

provenance trace
type: ObjectProperty
domain: Token
range: Entity
sub property of: wasDerivedFrom
definition: References source artefacts (HIPs, disclosures) demonstrating compliance provenance.

records event
type: ObjectProperty
domain: Token relationship
range: Token event
definition: Associates a token relationship with an event that affected its balances or status.

relates account
type: ObjectProperty
domain: Token relationship
range: Account
definition: Identifies the account whose state is described by a token relationship.

relates token
type: ObjectProperty
domain: Token relationship
range: Token
definition: Identifies the token associated with a relationship record.

submits token transaction
type: ObjectProperty
domain: Account
range: Token event
definition: Links an account to the token events it initiated via signed transactions.

tracks relationship
type: ObjectProperty
domain: Token Service
range: Token relationship
definition: Links the Token Service to the per-account relationship records it maintains.

Hedera Token Service module
type: Ontology
created: 2024-09-27
creator: Bhash Ontology Working Group
description: Service-specific vocabulary for modelling Hedera Token Service artefacts, compliance roles, and lifecycle events.
modified: 2024-09-27
imports: core
version info: 0.1.0-dev
editorial note: Phase 3 sprint module introducing token compliance semantics to support CQ-COMP-003.

Token compliance role
type: Class
subclass of: Role
definition: Role describing a governance responsibility over compliance-sensitive token keys.
source document: hip-540

Token Service
type: Class
subclass of: Service
definition: Network service responsible for minting, managing, and enforcing policy over fungible and non-fungible tokens.
source document: introduction

Fungible token
type: Class
subclass of: Token
definition: Token whose units are interchangeable and tracked via balances and allowances.
source document: fungible-tokens

Custom fee
type: Class
subclass of: Artefact
definition: Fee schedule entry defining royalty, fixed, or fractional fees assessed on token transfers.
source document: custom-fees

Token event
type: Class
subclass of: Event
definition: Event emitted by the Token Service reflecting mint, burn, or transfer outcomes.
source document: transaction-lifecycle

Token key
type: Class
subclass of: AccountKey
definition: Key material that authorises token-specific actions such as supply control, compliance, or metadata updates.
source document: token-keys

Token key assignment
type: Class
subclass of: Artefact
definition: Artefact capturing which actor controls a specific token key and for what governance purpose.
source document: hip-540

Token relationship
type: Class
subclass of: Artefact
definition: Per-account view of balances, KYC, freeze, and allowance states for a specific token.
source document: token-relationships

Token
type: Class
subclass of: Artefact
definition: Digital asset managed by the Token Service with associated supply, metadata, and key governance.
source document: introduction