feat(indexer): scaffold chain-indexer app with sandbox sync tracer bullet

Author: baktun14

apps/chain-indexer/README.md

@@ -0,0 +1,50 @@
+# Chain Indexer
+
+Rewrite of the Akash blockchain indexer as an encapsulated app with its own database and, eventually, its own public REST API. Design doc and discussion live in the Linear project (see CON-803).
+
+One codebase, several processes. The role is picked at runtime:
+
+```
+INDEXER_ROLE = sync | backfill | api | jobs
+NETWORK      = mainnet | sandbox | testnet
+```
+
+Currently implemented: `sync` (live tail with per-block atomic commits, advisory-lock leader election, parent-hash continuity check) and a minimal `api` (healthz + status). `backfill` and `jobs` exit with `ROLE_NOT_IMPLEMENTED`.
+
+## Running locally
+
+Create `env/.env` with at least:
+
+```
+NETWORK=sandbox
+POSTGRES_DB_URI=postgres://user:password@localhost:5432/chain-indexer
+```
+
+RPC endpoints default to the network's public nodes from `@akashnetwork/net`; override with a comma-separated `RPC_NODE_ENDPOINTS`. With no checkpoint in the database, sync starts at the current chain tip (set `SYNC_START_HEIGHT` to start elsewhere). Migrations run automatically on boot.
+
+```bash
+npm run dev
+```
+
+Then check progress:
+
+```bash
+curl localhost:3092/v1/status
+```
+
+The checkpoint height should advance as blocks land in `cosmos.blocks`, `cosmos.transactions`, and `cosmos.messages`.
+
+## Tests
+
+```bash
+npm test
+npm run lint -- --quiet
+```
+
+## Schema changes
+
+Edit `src/db/schema.ts`, then:
+
+```bash
+npm run migration:gen
+```

apps/chain-indexer/drizzle.config.ts

@@ -0,0 +1,12 @@
+import "@akashnetwork/env-loader";
+
+import { defineConfig } from "drizzle-kit";
+
+export default defineConfig({
+  schema: "./src/db/schema.ts",
+  out: "./drizzle",
+  dialect: "postgresql",
+  dbCredentials: {
+    url: process.env.POSTGRES_DB_URI ?? "postgres://offline:offline@localhost:5432/offline"
+  }
+});

apps/chain-indexer/drizzle/0000_nappy_james_howlett.sql

@@ -0,0 +1,46 @@
+CREATE SCHEMA "cosmos";
+--> statement-breakpoint
+CREATE TABLE "cosmos"."blocks" (
+	"height" bigint PRIMARY KEY NOT NULL,
+	"datetime" timestamp with time zone NOT NULL,
+	"hash" "bytea" NOT NULL,
+	"parent_hash" "bytea",
+	"proposer_address" text NOT NULL,
+	"tx_count" integer NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "indexer_state" (
+	"stream" text PRIMARY KEY NOT NULL,
+	"last_height" bigint NOT NULL,
+	"updated_at" timestamp with time zone NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "cosmos"."message_types" (
+	"id" "smallserial" PRIMARY KEY NOT NULL,
+	"type" text NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "cosmos"."messages" (
+	"height" bigint NOT NULL,
+	"tx_index" integer NOT NULL,
+	"index" integer NOT NULL,
+	"type_id" smallint NOT NULL,
+	"body" jsonb,
+	CONSTRAINT "messages_height_tx_index_index_pk" PRIMARY KEY("height","tx_index","index")
+);
+--> statement-breakpoint
+CREATE TABLE "cosmos"."transactions" (
+	"height" bigint NOT NULL,
+	"index" integer NOT NULL,
+	"hash" "bytea" NOT NULL,
+	"code" integer NOT NULL,
+	"gas_used" bigint NOT NULL,
+	"gas_wanted" bigint NOT NULL,
+	"fee" jsonb NOT NULL,
+	CONSTRAINT "transactions_height_index_pk" PRIMARY KEY("height","index")
+);
+--> statement-breakpoint
+ALTER TABLE "cosmos"."messages" ADD CONSTRAINT "messages_type_id_message_types_id_fk" FOREIGN KEY ("type_id") REFERENCES "cosmos"."message_types"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+CREATE UNIQUE INDEX "message_types_type_idx" ON "cosmos"."message_types" USING btree ("type");--> statement-breakpoint
+CREATE INDEX "messages_type_id_idx" ON "cosmos"."messages" USING btree ("type_id");--> statement-breakpoint
+CREATE INDEX "transactions_hash_idx" ON "cosmos"."transactions" USING btree ("hash");