Hedera Smart Contract Service module
type: Ontology
created: 2024-10-01
creator: Bhash Ontology Working Group
description: Vocabulary describing Hedera Smart Contract Service artefacts, execution traces, and system contract integrations.
modified: 2025-09-30
imports: core
version info: 0.1.0-dev
editorial note: Phase 3 sprint module covering smart contract deployment, execution, and HTS precompile usage for CQ-DEV-005.

Contract account
type: Class
subclass of: Account
definition: Account generated for a deployed smart contract to receive funds and identify executions.
source document: contract-accounts

emits contract event
type: ObjectProperty
domain: Contract execution
range: Contract event
definition: Links a contract execution to events emitted during the call.

executes contract
type: ObjectProperty
domain: Contract execution
range: Smart contract
definition: Links a contract execution process to the contract being executed.

has bytecode
type: ObjectProperty
domain: Smart contract
range: Contract bytecode
definition: Connects a smart contract to the bytecode package it executes.

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

has function selector
type: DatatypeProperty
domain: Precompile invocation
range: string
definition: Hex-encoded selector identifying the precompile function invoked.

has gas breakdown
type: DatatypeProperty
domain: Opcode trace
range: string
definition: Summary of intrinsic, opcode, and surcharge gas components for analytics.

has gas limit
type: DatatypeProperty
domain: Contract execution
range: integer
definition: Maximum gas supplied to a contract execution.

has gas schedule
type: ObjectProperty
domain: Smart Contract Service
range: Gas fee schedule
definition: Associates the Smart Contract Service with the published gas fee schedule.

has gas used
type: DatatypeProperty
domain: Precompile invocation
range: integer
definition: Total gas consumed by a precompile invocation.

has invocation count
type: DatatypeProperty
domain: Smart contract
range: integer
definition: Number of times a contract has been executed in the sample dataset.

has opcode trace
type: ObjectProperty
domain: Contract execution
range: Opcode trace
definition: Links a contract execution to the opcode trace artefact exported by mirror nodes.

has result status
type: DatatypeProperty
domain: Contract execution
range: string
definition: Execution status such as SUCCESS, REVERTED, or INSUFFICIENT_GAS.

includes invocation
type: ObjectProperty
domain: Contract execution
range: Precompile invocation
definition: Associates a contract execution with the precompile invocations performed during the call.

invokes system contract
type: ObjectProperty
domain: Smart contract
range: System contract
definition: Indicates that a contract relies on a particular system contract during execution.

records log
type: ObjectProperty
domain: Contract event
range: Contract log
definition: Associates a contract event with the structured log entry captured by mirror nodes.

stores bytecode in
type: ObjectProperty
domain: Contract bytecode
range: File
definition: Indicates which File Service file contains the contract bytecode.

targets system contract
type: ObjectProperty
domain: Precompile invocation
range: Precompile
definition: Identifies which system contract precompile was invoked.

Contract log
type: Class
subclass of: Artefact
definition: Structured record describing indexed topics and data generated by a contract event.
source document: tag/Contracts

Gas fee schedule
type: Class
subclass of: Artefact
definition: Fee schedule that defines intrinsic and surcharge gas costs for smart contract operations.
source document: gas-and-fees

Precompile
type: Class
subclass of: System contract
definition: Entry point exposing native Hedera services (HTS, HCS) to smart contracts via reserved selectors.
source document: token-service-precompile

Smart Contract Service
type: Class
subclass of: Service
definition: Network service that executes EVM smart contracts and exposes system contract integrations.
source document: introduction

Contract bytecode
type: Class
subclass of: Artefact
definition: EVM bytecode package uploaded via File Service and linked to a deployed smart contract.
source document: deploy-contracts

Contract event
type: Class
subclass of: Event
definition: Event emitted by a contract execution and captured in mirror node logs.
source document: contract-log

Opcode trace
type: Class
subclass of: Artefact
definition: Detailed record of EVM opcodes executed during a contract execution.
source document: tag/Contracts

System contract
type: Class
subclass of: Smart contract
definition: Reserved contract deployed by Hedera for protocol operations such as HTS precompiles.
source document: system-contracts

Precompile invocation
type: Class
subclass of: Event
definition: Event capturing a contract execution invoking a specific system contract precompile.
source document: tag/Contracts

Contract execution
type: Class
subclass of: Process
definition: Process representing a transaction that executes a smart contract function.
source document: contract-call

Smart contract
type: Class
subclass of: Artefact
definition: Deployed EVM bytecode managed by the Smart Contract Service with an associated contract account.
source document: introduction