mirror of
https://github.com/logos-blockchain/lez-programs.git
synced 2026-08-25 14:11:09 +00:00
Ricardo Guilherme Schmidt
470e06c6c3
Add portable Basecamp packaging and an inspector-driven end-to-end flow.
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# Token UI Basecamp E2E
|
|
|
|
`token-definition.mjs` drives the running Token UI through the Logos QML
|
|
inspector, the same path used by Basecamp UI tests.
|
|
|
|
The hermetic Basecamp runner follows the AMM and Logos Palace harnesses: it
|
|
uses the inspector-enabled portable Basecamp bundle, stages portable installs
|
|
under a fresh `--user-dir`, launches with `-platform offscreen`, waits for the
|
|
inspector, isolates the wallet home under the run directory, then stores
|
|
screenshots from the same inspector connection.
|
|
|
|
Run the full Basecamp flow:
|
|
|
|
```bash
|
|
apps/token/tests/run-basecamp-e2e.sh
|
|
```
|
|
|
|
The runner builds these inputs when not supplied through environment
|
|
overrides:
|
|
|
|
- `logos-qt-mcp` test framework
|
|
- inspector-enabled Basecamp bundle
|
|
- `logos_execution_zone` portable core module
|
|
- `token_module` portable core module
|
|
- `token_ui` portable UI plugin
|
|
|
|
Override already-built inputs with `LOGOS_QT_MCP`, `TOKEN_BASECAMP_BUNDLE`,
|
|
`TOKEN_WALLET_INSTALL`, `TOKEN_MODULE_INSTALL`, or `TOKEN_UI_INSTALL`.
|
|
|
|
Build only the inspector framework:
|
|
|
|
```bash
|
|
nix build .#test-framework -o apps/token/result-mcp
|
|
```
|
|
|
|
For manual runs, stage the portable install outputs into a Basecamp user
|
|
directory: `.#install-portable` for `token_module`,
|
|
`.#token-ui-install-portable` for `token_ui`, and the matching portable
|
|
`logos_execution_zone` install. Launch the inspector-enabled bundle with
|
|
`--user-dir <path> -platform offscreen`.
|
|
|
|
Run the non-mutating visual flow:
|
|
|
|
```bash
|
|
node apps/token/tests/token-definition.mjs
|
|
```
|
|
|
|
Run the live round trip against an open wallet and reachable sequencer:
|
|
|
|
```bash
|
|
TOKEN_E2E_LIVE=1 \
|
|
TOKEN_E2E_NAME="Basecamp Token E2E" \
|
|
node apps/token/tests/token-definition.mjs
|
|
```
|
|
|
|
The live path creates fresh public wallet accounts, submits a fixed-supply
|
|
definition through `token_module`, switches to Inspect, and waits for the
|
|
definition to be read back from the connected wallet.
|
|
|
|
Screenshots are written to `.3esmit/projects/lez-programs/docs/token-basecamp-e2e/`
|
|
after each major step. The inspector listens on `localhost:3768`; override it with
|
|
`QML_INSPECTOR_PORT` when another test is using that port.
|