Course outline
Why Intuition
The Intuition system at a glance
A high-level map of the network, protocol, indexing, and application layers—and the boundaries between them.
A useful mental model separates Intuition into layers. Each layer solves a different problem, and confusing them leads to incorrect assumptions about speed, authority, or trust.
1. The network layer
The Intuition Network provides the blockchain environment in which protocol state changes are executed and settled. It supplies ordering, transaction execution, and durable state. At this layer, the important question is: what actions were accepted by the network?
2. The protocol layer
Protocol contracts define the shared primitives and rules: how identifiers and claims are represented, how vault interactions work, and which events are emitted. This is where a request becomes a protocol state transition rather than an application-specific database mutation.
The network confirms that a valid transition occurred under the contracts' rules. It does not decide whether the human meaning of a claim is wise, accurate, or useful.
3. The indexing and query layer
Raw chain state and event logs are authoritative but inconvenient for most product reads. An indexing pipeline organizes protocol data into a graph that applications can query efficiently, including through GraphQL.
An indexer is a read model. It can make rich relationships easy to retrieve, but it can lag behind the chain, omit an event due to a fault, or present derived fields. For high-stakes operations, applications should understand which values are indexed interpretations and which must be verified against protocol state.
4. The interface layer
SDKs, APIs, wallets, agents, and user interfaces make the lower layers usable. They may resolve metadata, construct transactions, rank results, or explain claims. These conveniences do not inherit automatic neutrality merely because they use an open protocol; every interface makes choices about defaults and presentation.
Following a write
Suppose a participant creates a claim:
- An interface turns the intention into a protocol action.
- A signed transaction is submitted to the network.
- Protocol contracts validate and record the state transition.
- Events expose the change for downstream systems.
- An indexer processes those events into queryable graph data.
- Interfaces retrieve and present the result.
A read usually travels in the opposite direction: an application queries an indexed view, interprets the response, and may verify critical details against the underlying protocol.
Which layer decides how prominently a claim appears in search results?Reveal answer
Usually the interface or application layer, using indexed data and its own ranking policy. The protocol preserves shared objects and state but does not dictate every product's presentation.
Official references
Ready to continue?
Next: Atoms: identity for anything