Crate holochain_state

The Holochain state crate provides helpers and abstractions for working with the holochain_sqlite crate.

Reads

The main abstraction for creating data read queries is the Query trait. This can be implemented to make constructing complex queries easier.

The source_chain module provides the SourceChain type, which is the abstraction for working with chains of actions.

The host_fn_workspace module provides abstractions for reading data during workflows.

Writes

The mutations module is the complete set of functions for writing data to sqlite in holochain.

In-memory

The scratch module provides the Scratch type for reading and writing data in memory that is not visible anywhere else.

The SourceChain type uses the Scratch for in-memory operations which can be flushed to the database.

The Query trait allows combining arbitrary database SQL queries with the scratch space so reads can union across the database and in-memory data.

Modules

• block
• chain_lock
• dna_def
• entry_def
• host_fn_workspace
• integrate
• mutations
• nonce
• prelude
• query
• schedule
• scratch
• source_chain
• test_utils
  Helpers for unit tests
• validation_db
  Validation Database Types
• validation_receipts
  Module for items related to aggregating validation_receipts
• wasm
• workspace
  Workspaces are a simple abstraction used to stage changes during Workflow execution to be persisted later

Macros

• here
  Produce file and line number info at compile-time
• sql_insert