From a0cf88cd196df36c0638725fc0ac5fc13792fe1b Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 13 Aug 2026 15:10:50 +0000 Subject: [PATCH 1/2] docs: trim Fairmint-only LocalNet notes for public repo Remove apiv2 port-3000 collision from AGENTS.md (multi-repo Fairmint setup only). Keep general nginx and Splice gotchas. Drop private Linear hyperlink from package-boundary ENG-1635 tracking line. Co-authored-by: hardlydiff --- AGENTS.md | 9 +++------ docs/package-boundary.md | 2 +- 2 files changed, 4 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c483ce3d..d254bda9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -49,13 +49,10 @@ Verified ready endpoints: Ledger JSON API `http://localhost:3975/v2/version` (re Scan `http://scan.localhost:4000/api/scan/v0/dso-party-id` (returns the DSO party id), Validator `http://localhost:3903/...` (200/401). -Known gotchas hit in this cloud/multi-repo setup: +Known gotchas: -- **Port 3000 conflict.** LocalNet's `nginx` binds host `127.0.0.1:3000`, which collides with the - `apiv2` dev gateway (also `:3000`). Free `:3000` (stop the apiv2 dev server) before starting - LocalNet, or `nginx` fails with `failed to bind host port 127.0.0.1:3000: address already in use`. -- **`nginx` left network-less after a failed start.** If `nginx`'s first start fails (e.g. the port - clash above), the container is created but never attached to the `quickstart` Docker network, then +- **`nginx` left network-less after a failed start.** If `nginx`'s first start fails (e.g. a host + port bind error), the container is created but never attached to the `quickstart` Docker network, then crash-loops with `host not found in upstream "splice"`. Fix: `sudo docker rm -f nginx` and re-run `npm run localnet:start` so it is recreated and attached. - **Splice force-recreate can stall Scan readiness.** The SDK patches the Splice config diff --git a/docs/package-boundary.md b/docs/package-boundary.md index ca7b338c..60291297 100644 --- a/docs/package-boundary.md +++ b/docs/package-boundary.md @@ -37,4 +37,4 @@ leak compiled tests into the tarball. - Canonical LocalNet owner: [`@fairmint/canton-dev-tools`](https://github.com/Fairmint/canton-dev-tools) ([COMPATIBILITY.md](https://github.com/Fairmint/canton-dev-tools/blob/main/COMPATIBILITY.md)) -- Tracking: [ENG-1635](https://linear.app/fairmint/issue/ENG-1635/establish-canton-dev-tools-and-migrate-shared-canton-test) +- Tracking: ENG-1635 From a3c1b35066119fe378c67114b2dbe048decdd117 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 13 Aug 2026 15:59:19 +0000 Subject: [PATCH 2/2] docs: remove completed ENG-1635 tracker from package-boundary Co-authored-by: hardlydiff --- docs/package-boundary.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/package-boundary.md b/docs/package-boundary.md index 60291297..d7678bc5 100644 --- a/docs/package-boundary.md +++ b/docs/package-boundary.md @@ -37,4 +37,3 @@ leak compiled tests into the tarball. - Canonical LocalNet owner: [`@fairmint/canton-dev-tools`](https://github.com/Fairmint/canton-dev-tools) ([COMPATIBILITY.md](https://github.com/Fairmint/canton-dev-tools/blob/main/COMPATIBILITY.md)) -- Tracking: ENG-1635