Overview
ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator (also referred to as Viewkit) is the developer-facing toolchain for defining, packaging, and deploying Shinzo ViewsView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs.. It provides a workflow for turning raw indexed blockchain data into reusable, versioned data APIs that can be executed and served by HostsHost The local Shinzo client that manages identity, encrypted storage, data syncing, and communication with the network from a user's device. across the Shinzo network.
At a high level, ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator bridges the gap between indexed primitive data and application-ready data interfaces. It allows developers to declaratively specify what data to ingest, how to transform it, and how to expose it, without managing infrastructure, execution environments, or deployment mechanics directly.
Purpose and Role in the Stack
Within the Shinzo ecosystem, ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator sits above the IndexerIndexer A client that reads blockchain data (blocks, transactions, logs), parses it, and writes normalized documents into defraDB. and alongside HostsHost The local Shinzo client that manages identity, encrypted storage, data syncing, and communication with the network from a user's device.:
- IndexerIndexer A client that reads blockchain data (blocks, transactions, logs), parses it, and writes normalized documents into defraDB. → produces normalized, deterministic primitive data
- ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator → defines how that data should be queried, transformed, and exposed
- HostHost The local Shinzo client that manages identity, encrypted storage, data syncing, and communication with the network from a user's device. → executes those definitions, serves results, and attests to correctness
Using ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator, developers write ViewsView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. as versioned bundles that describe a complete data pipeline. These viewsView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. are then deployed to a target environment (local, devnet, or future networks), where HostsHost The local Shinzo client that manages identity, encrypted storage, data syncing, and communication with the network from a user's device. execute them deterministically against indexed data and serve the results to consumers.
This separation enables:
- Rapid iteration on data models without re-indexingIndexing The process of parsing blockchain data and storing structured, schema-compliant documents in defraDB. chains
- Deterministic, reproducible data APIs
- Decoupling of data definition from execution and infrastructure
- Portable viewsView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. that can run on any compliant HostHost The local Shinzo client that manages identity, encrypted storage, data syncing, and communication with the network from a user's device.
Core Concepts
A ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. is the fundamental unit produced by ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator. Each viewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. is a self-contained, versioned bundle that may include:
- Queries – declarative definitions of the raw data shape to ingest from indexed primitives
- SDL (GraphQLGraphQL A query language and runtime used for retrieving structured data from defraDB, collections, and views within Shinzo.) – schemas describing how data is modeled, materialized, or exposed to consumers
- Lenses (WASM) – composable WebAssembly transforms for filtering, decoding, enriching, or reshaping data
- Wallet – cryptographic credentials used to sign and authorize deployments to a target network
Conceptually, a viewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. represents the pipeline:
indexed primitive data → query → lenses (WASM) → GraphQLGraphQL A query language and runtime used for retrieving structured data from defraDB, collections, and views within Shinzo. schema → consumable API
Developer Experience
ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator is distributed as a CLI and is designed for local-first development. It supports:
- Initializing and inspecting viewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. bundles
- Incrementally adding queries, schemas, and lenses
- Executing lenses locally for validation and preview
- Deploying viewsView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. to a local DefraDBdefraDB A NoSQL, document-oriented, edge-first database used by Shinzo to store encrypted or schema-defined data. instance with a GraphQLGraphQL A query language and runtime used for retrieving structured data from defraDB, collections, and views within Shinzo. Playground
- Signing and publishing viewsView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. to shared networks like devnet
By providing strong defaults, explicit versioning, and deterministic behavior, ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator enables developers to focus on data semantics and transformations, while Shinzo handles execution, distribution, and verification.
In summary, ViewView A curated representation of defraDB documents defined using SDL. Views transform raw data into structured outputs. Creator is the primary interface for developers to turn indexed blockchain data into reliable, composable, and verifiable data products within the Shinzo ecosystem.