KasGraph turns Kaspa blocks, UTXOs, Covenant IDs, KRC assets, and BlockDAG activity into queryable data for wallets, explorers, dashboards, dApps, and AI agents.
query demo
Ask for covenant activity, token balances, indexed entities, or BlockDAG-aware history without parsing raw blocks and UTXO responses in every app.
query CovenantActivity($covenantId: String!) {
covenant(id: $covenantId) {
id
transactions {
hash
daaScore
acceptedAt
inputs
outputs
}
}
}what it solves
KasGraph gives developers a shared indexing layer for blocks, UTXOs, Covenant IDs, KRC assets, reorg-aware history, and application-specific entities. Wallets, explorers, dashboards, covenant apps, analytics systems, and AI agents can query the same data plane instead of each rebuilding parsers, storage, reconciliation, and RPC failover.
demo preview
PreviewLocal-firstNo public hosted endpoint is advertised yet. This is a static preview of the intended GraphQL shape until the hosted node, playground, and testnet soak are validated.
Network
preview
Indexed DAA
unavailable
POI
unavailable
GraphQL
not configured
query CovenantLineage($covenantId: String!) {
covenant(id: $covenantId) {
id
createdAtDaaScore
transactions {
hash
daaScore
acceptedAt
spendPath
}
currentUtxos {
txid
index
amount
address
}
}
}{
"data": {
"covenant": {
"id": "cov_8fa4b21...",
"createdAtDaaScore": 467579632,
"transactions": [
{
"hash": "3b2f9c...",
"daaScore": 467579812,
"acceptedAt": "2026-05-18T16:04:22Z",
"spendPath": "verifier_release"
}
],
"currentUtxos": [
{
"txid": "9ac41e...",
"index": 0,
"amount": "1250000000",
"address": "kaspatest:q..."
}
]
}
}
}proof of life
The latest checked-in testnet soak artifact is published with public-safe health, POI, logs, and restart-note references.
{
"status": "completed",
"runDate": "2026-06-01",
"duration": "24.0 hours",
"network": "kaspa-testnet-10",
"verdict": "Success: 24-hour testnet soak target reached."
}{
"artifact": "/docs/artifacts/testnet-soak/2026-06-01/public-log-tail.jsonl",
"indexedDaa": "479501516",
"blocksIndexed": "236759",
"note": "Sanitized public log tail is checked in with the soak artifact."
}{
"artifact": "/docs/artifacts/testnet-soak/2026-06-01/public-poi-checkpoints.jsonl",
"poiCheckpoints": "236759",
"latestPoiCheckpoint": "0x527695bea514e26112a755f48c18a4dbb581d25302a45cefab66a605e9506c93"
}DB stats: /docs/artifacts/testnet-soak/2026-06-01/public-db-stats.jsonl
Resource metrics: /docs/artifacts/testnet-soak/2026-06-01/public-resource-metrics.jsonl
Restart notes: /docs/artifacts/testnet-soak/2026-06-01/restart-recovery-notes.md
Restart recovery: Not measured
Known issues: KasGraph soak API ran on 127.0.0.1:4002 because 127.0.0.1:4000 was occupied by LiteLLM.; Root cause fixed before completion: local TN10 was stale kaspad v1.1.0 and root disk was too full for the Toccata pruning-point UTXO import; the completed run used kaspad v1.2.1-toc.3 with sufficient disk.; At the 24-hour completion point, kaspad still reported phase syncing live DAG and kaspadSynced false; KasGraph indexing, RPC audit, Postgres, GraphQL health, and POI checkpoints remained active through the completion target.example apps
These are concrete integration targets for the indexing layer, not claims of existing production deployments.
Problem: Token dashboards need supply, holders, transfers, and activity without custom inscription parsers.
KasGraph provides: Indexed KRC entities, transfer history, holder counts, and GraphQL queries.
tokens(first: 10) { ticker holdersCount totalSupply }Problem: NFT explorers need ownership, transfers, collections, and metadata timelines.
KasGraph provides: Collection and token entity schemas backed by KRC-721 detectors and mappings.
collections { id tokenCount ownersCount }Problem: Covenant apps need to follow spend paths, state transitions, and UTXO lineage.
KasGraph provides: Covenant ID indexing, lineage queries, and BlockDAG-aware history.
covenant(id: $id) { transactions { spendPath } currentUtxos { txid } }Problem: Verifier dashboards need SLA bonds, signatures, deadlines, releases, and slashes.
KasGraph provides: App-specific subgraphs with typed entities and POI-backed checkpoints.
bonds(where: { status: ACTIVE }) { id deadline verifier }Problem: Agents should not scrape explorers or infer raw RPC responses.
KasGraph provides: MCP tools for schema discovery, query execution, pattern search, and lineage reads.
get_covenant_lineage({ covenantId: "cov_..." })Problem: Wallets need fast access to balances, token holdings, activity, and app state.
KasGraph provides: Indexed wallet-facing entities, asset balances, transfer history, and subscriptions.
wallet(address: $addr) { assets { id balance } transfers { hash } }one data plane
Typed queries over indexed entities, covenant lineage, asset state, checkpoints, and subgraph schemas.
Agent tools for listing subgraphs, reading schemas, executing queries, searching patterns, and inspecting lineage.
Push updates for explorers, dashboards, wallets, and operational views that need fresh indexed state.
A low-latency stream of detected Kaspa activity for event-driven products and downstream pipelines.
architecture
The node ingests Kaspa RPC and wRPC streams, applies detectors and WASM mappings, writes PostgreSQL state, computes POI checkpoints, and serves GraphQL, MCP, KasStream, and WebSocket consumers.
Blocks, accepted transactions, virtual-chain changes, and continuous notifications.
Ingests Kaspa activity, tracks progress, handles reorg-aware state transitions, and dispatches work.
Recognizes KRC assets, Covenant IDs, app patterns, and runs deterministic mapping handlers.
Builds checkpoint hashes over indexed entity state so output can be independently compared.
Stores registry rows, schemas, lineage, checkpoints, and versioned application entities.
Serves query, developer, agent, subscription, and streaming interfaces.
Consumes indexed state without every product rebuilding a parser.
developer workflow
Scaffold a subgraph, generate TypeScript types from GraphQL SDL, compile the AssemblyScript mapping to WASM, deploy it to a registry, then query the gateway.
npx kasgraph init my-subgraph
cd my-subgraph
npx kasgraph codegen
npx kasgraph build
npx kasgraph deploy --database-url "$DATABASE_URL"
npx kasgraph status my-subgraphkaspa primitives
KasGraph is designed around UTXO state transitions, Covenant ID lineage, BlockDAG finality, KRC assets, and verifiable indexing output.
Model application state from inputs, outputs, spends, and lineage instead of forcing an account-based event-log shape.
Use stable consensus-tracked identifiers to query covenant history without recursive UTXO walking in every app.
Index legacy inscription activity and native covenant-era assets as first-class query targets.
Track committed and probabilistic block state with unwind semantics designed for Kaspa virtual-chain changes.
Store deployed subgraphs, schemas, checkpoints, lineage, and versioned entities in a durable relational model.
Maintain a blake2b-256 hash chain over indexed entity state so output can be independently verified.
ai-native
MCP is a first-class interface over the same indexed registry and gateway used by applications. Agents can discover schemas, execute queries, inspect Covenant ID lineage, and search detected Kaspa patterns with structured tool calls.
status
The build -> deploy -> index -> query pipeline is multi-tenant, hot-reloadable, verified end-to-end against real Postgres, and backed by a published 24-hour testnet soak. Remaining public-launch work includes hosted topology, log streaming, benchmarks, and deployment confirmation.
Read the full statusbenchmarks
This table separates the published testnet soak artifact from performance benchmarks that still need repeatable hosted measurements.
Pending measurement
Pending measurement
Pending measurement
Pending measurement
Pending measurement
Pending measurement
Pending measurement
24.0 hours
Not production-ready
| Metric | Current Result | Target | Status | Notes |
|---|---|---|---|---|
| Indexing throughput | Pending | TBD blocks/sec | Pending measurement | Requires repeatable benchmark run beyond the completed soak. |
| GraphQL query latency | Pending | TBD ms p95 | Pending measurement | Requires hosted endpoint and representative subgraphs. |
| Reorg handling latency | Pending | TBD seconds | Pending measurement | Needs controlled virtual-chain/reorg simulation. |
| PostgreSQL storage growth | Pending | TBD GB / million txs | Pending measurement | Depends on entity volume and indexing profile. |
| WebSocket/KasStream event latency | Pending | TBD ms p95 | Pending measurement | Requires live streaming deployment. |
| MCP tool response latency | Pending | TBD ms p95 | Pending measurement | Requires hosted MCP/gateway path. |
| Proof-of-Indexing checkpoint cost | Pending | TBD ms/checkpoint | Pending measurement | Depends on entity update volume. |
| Testnet soak duration | 24.0 hours | 24h minimum / 72h preferred | completed | Published 2026-06-01 artifact on kaspa-testnet-10 with 236759 blocks and 236759 POI checkpoints. |
| Mainnet readiness | Not validated | Defined checklist | Not production-ready | Requires monitoring, benchmarks, runbooks, and mainnet validation. |
contribute
KasGraph is open-source infrastructure. Useful contributions include indexing correctness, example subgraphs, benchmark harnesses, docs, and operational validation.