Felix FaerberandClaude Opus 5 02f5905051 Document the monitor's auth header and the deploy substitution trap
Both found by the dashboard not working after the deploy.

`docker stack deploy` expands ${STAMP_MONITOR_ADMIN_TOKEN} from the shell
and does not read .env for substitution, so a deploy that forgets to
source it ships an empty ADMIN_TOKEN. The service still starts, polls and
alerts normally -- only the dashboard is dead, with a 503 that reads like
the app is broken rather than like the deploy was. That is exactly the
kind of failure worth writing down instead of rediscovering.

The API also takes x-admin-token, not Authorization: Bearer.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLYiaPYror1vLKApYKrxTu
2026-08-19 02:04:23 +03:00
2026-05-27 10:31:30 +03:00
2026-05-27 10:31:30 +03:00
2026-05-27 10:31:30 +03:00

DevOps

This repo manages the two environments for the Token4Token hosted gateway:

  • local/ — docker-compose files for running development and testing environments locally. Tests run inside Docker, no host-side Bun needed.
  • hostinger/ — Docker Swarm stack files for the remote production cluster on Hostinger.

The layout mirrors cipherdolls/devops.

Local development

cd local
make up          # bring the dev stack up (postgres, redis, bee, anvil, api, worker)
make logs        # tail
make down        # clean shutdown

The dev compose mounts ../../hosted-gateway/src so file changes hot-reload inside the container (bun run --watch).

Local testing

Every E2E spec runs inside Docker against a fresh stack (anvil fork of Gnosis, deployed contracts, a t4t-provider container against a stub Ollama).

cd local
make test SPEC=accounts          # run one spec
make test-all                    # run every spec sequentially

make test brings up postgres + redis + anvil + bee + t4t-provider + hosted api + worker, then runs the bun test container against them. After the run it tears everything down (-v --remove-orphans).

Hostinger / production

Stack files in hostinger/ are applied via docker stack deploy from the CI pipeline. Not relevant for local development.

S
Description
No description provided
Readme
93 KiB
0 Stars 1 Watchers 0 Forks
Languages
Makefile 77.2%
TypeScript 18.7%
Dockerfile 4.1%