collection-overlay

Stand-alone 1Sat ordinal collection overlay server. Composes 1sat-stack as a library (same pattern as opns-overlay).

Tracks collections (tm_1sat_collection) and optional per-collection items (tm_col_{collectionId}). Mint-only; SIGMA required at admit. Does not put collection APIs on BSV21.

Run

Requires a 1sat-stack build that includes pkg/collection (see stack PR for OPL-2993). Local dev:

# go.mod replace points at ../1sat-stack during development
go run ./cmd/server

Config

config.yaml or COLLECTION_* env (e.g. COLLECTION_SERVER_PORT):

Key	Default	Purpose
server.port	8080	HTTP listen
data_dir	~/.1sat-collection	Local storage
stack.url	https://api.1sat.app/1sat	BEEF fallback
arcade.url	https://arcade.gorillapool.io	Broadcast
collection_ids	[]	Item topics to register at start

Endpoints

Base path /1sat:

Endpoint	Purpose
GET /1sat/health	Health
GET /1sat/collection	List collections
GET /1sat/collection/:collectionId	Collection metadata
GET /1sat/collection/:collectionId/items	Items
POST /1sat/collection/overlay/submit	Submit BEEF (x-topics)
GET /1sat/beef/...	BEEF
POST /1sat/tx	Broadcast

Linear

OPL-2993