cosmo-db

A Subsquid indexer for ARTMS and tripleS NFTs.

Deprecated

As of January 17th 2026, this repo has been merged into the main cosmo-web monorepo and is no longer compatible with the main branch. The only version of the web app this cosmo-db repo will work with is cosmo-web@abstract-nextjs.

cosmo-web branch	Compatible cosmo-db branch
main	N/A
abstract-nextjs	main
polygon	checkpoint/polygon

Setup

$ git clone git@github.com:teamreflex/cosmo-db.git
$ cd cosmo-db
$ pnpm i
$ cp .env.example .env
$ docker compose up -d

Service Configuration

db

Postgres 15 database server.

• DB_PORT: Port to expose the server on. Internally it still uses the default port.
• DB_READ_USER: Creates a user with this name, only with SELECT privileges.
• DB_READ_PASS: Password for the read user.

processor

Subsquid processor that parses and stores data from the chain.

• SQD_ENDPOINT: Subsquid archive endpoint.
• RPC_ENDPOINT: RPC endpoint to use for the chain.
• RPC_RATE_LIMIT: Rate limit for the RPC endpoint (req/s).
• RPC_FINALITY: Finality confirmation for RPC ingestion.
• ENABLE_OBJEKTS: Enable objekt processing.
• COSMO_PARALLEL_COUNT: Number of objekts to fetch metadata for in parallel.

drizzle-proxy

HTTP server that exposes the database for use with Drizzle ORM's HTTP proxy support for serverless environments.

• PROXY_HTTP_PORT: Port to expose the server on.
• PROXY_KEY: Key to use for authentication.
• PROXY_CACHE_MAX_AGE: Max age (in seconds) to cache the /status endpoint for.

Tooling

• Subsquid
• Bun
• Hono

License

Licensed under the MIT license.

Contact

• Email: kyle at reflex.lol
• Discord: kairunz
• Cosmo ID: Kairu