Getting Started

pip install substr8-langgraph substr8

from langgraph.graph import StateGraph
from substr8_langgraph import instrument_graph
import json
 
# Build your graph normally
graph = StateGraph(MyState)
graph.add_node("search", search_node)
graph.add_node("analyze", analyze_node)
graph.set_entry_point("search")
graph.add_edge("search", "analyze")
 
# Compile it
compiled = graph.compile()
 
# Wrap with Substr8 instrumentation (one line)
instrumented = instrument_graph(
    compiled,
    agent_id="my-agent",
    project="my-project",
)
 
# Run the agent
result = instrumented.invoke({"query": "..."})
 
# The result includes the proof
print(f"Run ID: {result['run_id']}")
print(f"Proof status: {result['proof_status']}")

# Save proof to runproof.json
with open("runproof.json", "w") as f:
    json.dump(result["proof"].model_dump(mode="json"), f, indent=2)

pip install substr8
 
substr8 proof verify runproof.json

╭─────────────────── Verification Result ───────────────────╮
│ ✓ RunProof: VALID                                         │
╰───────────────────────────────────────────────────────────╯

  Proof ID   proof_abc123...
  Run ID     run_xyz789...
  Agent      my-agent

Checks:
  ✓ schema
  ✓ hash_chain
  ✓ merkle_root
  ✓ signature

git clone https://github.com/Substr8-Labs/substr8-langgraph-demo
cd substr8-langgraph-demo
pip install -r requirements.txt
python demo_agent.py
substr8 proof verify runproof.json