KGKasGraphGitHub

docs overview

KasGraph documentation starts from the monorepo.

This site summarizes the live package and crate surfaces. The canonical implementation details remain in README.md, STATUS.md, PLAN.md, and docs/references inside GitHub.

clone and verify
git clone https://github.com/trillskillz/KasGraph
cd KasGraph
npm install
npm run verify
cli commands
npx kasgraph init my-subgraph
npx kasgraph codegen
npx kasgraph build
npx kasgraph deploy --database-url "$DATABASE_URL"
npx kasgraph deploy --node https://your-node
npx kasgraph status my-subgraph
npx kasgraph remove my-subgraph
npx kasgraph mcp-config

Developer path

Build your first KasGraph subgraph

Local-first tutorial for defining entities, compiling mappings, deploying to a registry, and querying GraphQL.

Run locally

Clone the monorepo, verify packages, build a subgraph, and run the Rust indexer node.

Demo preview

Static preview of the GraphQL query and response shape until a public hosted endpoint is validated.

Testnet soak status

Public status for the sustained testnet validation run, currently incomplete until real artifacts are captured.

Benchmarks

Placeholder structure for throughput, latency, storage, streaming, MCP, POI, and soak measurements.

Repo map

crates/kasgraph-node

Indexer binary: ingest, detect, map, persist, POI, fan-out, registry reload.

crates/kasgraph-rpc

Multi-RPC client with failover, health probes, and continuous wRPC recovery.

crates/kasgraph-store

Postgres adapter for migrations, schemas, registry, lineage, and reorg-safe unwind.

crates/kasgraph-detectors

OpenSilver, KCC20, KRC-20/KRC-721 pattern detectors and ledgers.

crates/kasgraph-mapping

Wasmtime runtime for deterministic AssemblyScript mapping handlers.

crates/kasgraph-poi

Proof of Indexing hash chain and verifier.

crates/kasgraph-stream

KasStream event delivery primitive.

sdk / cli / api / mcp

TypeScript SDK, CLI, GraphQL gateway, and MCP package surfaces.

Reference topics

The repo includes reference docs for KIP-20 Covenant ID queries, BlockDAG reorg semantics, The Graph compatibility, native KRC-20/KRC-721 shape, and the Kaspa RPC layer.

Operator docs

Hosted API

Endpoint paths, required environment variables, CORS, and protected deploy routes.

Mainnet readiness

Infrastructure, indexer, API, observability, security, and documentation gates.

Operator runbook

Deploy, rollback, restart, database health, secret rotation, and incident procedures.

Monitoring

Health, status, metrics, alerts, and log access policy.

Testnet soak plan

Minimum and preferred validation run requirements before public claims.

Sustained-run report

Publication template for real long-running proof-of-life artifacts.

Live soak dashboard

Explains live status, SSE, logs, metrics, and artifact fallbacks.

Sustained-run operator guide

Persistent-host workflow for starting, watching, restarting, and archiving a live soak.

Benchmarks methodology

Benchmark categories, required metadata, and current pending result table.