Lineage Graphs

About Lineage Graphs

A lineage graph is an interactive visualizer of a lineage manifest — a cryptographically verifiable record of how a dataset, model, or other asset was produced, generated by the EQTY SDK. It lets you trace and evidence every step of your workflow while flagging any assets that require further verification.

Lineage graphs render each asset and computation in a manifest as a node, and the connections between them as edges, so you can follow exactly how an output was derived from its inputs. Every node can be inspected for its registration details, verification status, and any metadata attached during creation.

Key concepts and actions associated with Lineage Graphs include:

• Understanding Lineage Graph scope
• Understanding node types
• Viewing a Lineage Graph
• Navigating a Lineage Graph
• Understanding verification statuses
• Viewing node instances

Understanding Lineage Graph scope

Lineage graphs live within a single project and cannot be shared or viewed across projects. A project can contain multiple lineage graphs, each corresponding to a manifest registered by the SDK.

Any project member with access to the project can view its lineage graphs.

Understanding node types

A Lineage Graph is made up of nodes connected by edges. Each node represents an asset or computation registered by the SDK. Node types include:

• Datasets
• Database
• Documents
• Models
• Computations
• Parameters
• Benchmarks
• Code
• Configurations
• Tools

An edge between two nodes indicates a direct relationship — for example, a computation node connected to a dataset node means that dataset was either an input to or an output of that computation.

Viewing a Lineage Graph

To view a project’s Lineage Graphs:

1. Select a project from Projects
2. Select the Lineage Graphs tab
3. Search for a graph by name or ID, or select one from the list
4. Select View Lineage

This opens the graph in an interactive canvas.

Navigating a Lineage Graph

Once a graph is open, you can:

• Pan and zoom the canvas to explore the graph’s structure
• Select a node to open its detail panel
• Toggle between graph and table view using the icons in the top-left corner of the canvas
• Download the lineage manifest as a JSON

Node detail panel

Selecting a node opens a detail panel with the following sections:

Registration

• Node ID: The node’s unique content identifier (CID).
• Timestamp: When the node was registered.
• Registered By: The signer who registered the node, including any attached user information (such as name or email).
• Statement: The verification status of the node’s underlying statement, with an option to View JSON.
• Credential: The verification status of the node’s credential, with an option to View JSON.

Metadata

Any additional metadata attached to the node during registration, such as description, contact information, license, or other domain-specific fields defined by the SDK user.

Understanding verification statuses

Each node’s Statement and Credential are independently verified in your browser to confirm they haven’t been tampered with. A node can show one of two statuses for each:

• Verified: The statement or credential’s cryptographic proof is valid.
• Unverified: The statement or credential’s cryptographic proof could not be validated.

An Unverified status should be investigated — it means the integrity of that particular statement or credential cannot be confirmed, even if the rest of the graph verifies successfully.

Viewing node instances

A node can have multiple instances if the underlying asset was registered more than once — for example, across separate runs. When a node has multiple instances, its detail panel includes an Instance dropdown listing each registration, along with the timestamp for each.

Selecting a different instance updates the detail panel to show that instance’s Registration and Metadata.