Qortium Chat

A QDN chat app for Qortium Home. Qortium conversations use window.qdnRequest; Qortal public-group conversations use Home 2's separate window.qortalRequest bridge or the Qortal-prefixed window.qdnRequest actions supplied by released Home 1.7.0. The app follows Home's display settings, including the Classic, Modern, and Fun UI styles.

On Home versions that expose app notifications, the bell beside the selected account opens separate choices for direct chat activity, mentions, and replies. Chat registers a durable incoming-direct rule only when that choice is selected, re-registers it after an account change, and removes it when direct notifications are turned off. Direct activity can include edits, reactions, or app-to-app data messages because Core's background event deliberately excludes message content, so nothing outside Chat can tell those apart from human chat. While Chat is loaded, the mention and reply choices independently control notifications from the selected group when the app is not focused. Existing bell preferences migrate without changing behavior. The app feature-detects the notification actions, so older Home versions and browser development remain unaffected.

For minting groups, the selected group header shows whether the selected account is currently minting on the connected node, and joined members who are not minting yet get a Start minting button that asks Qortium Home (via the START_MINTING bridge action) to add the account's minting key to the connected local node — including on a fresh or additional node. If the account has no on-chain minting authorization yet (for example it joined the minting group before joins carried minting keys), the same button first submits the free self-share authorization transaction, tracks it until it confirms, and can then add the key. Minting status reads use the GET_MINTING_STATUS bridge action when Home provides it, with a read-only node API fallback otherwise.

Development

Install dependencies:

npm install

Run the app locally:

npm run dev -- --host 127.0.0.1

The local browser fallback reads from http://127.0.0.1:24891 by default. Set VITE_QORTIUM_NODE_API_URL to use another node during development.

Build and publish the app to the local Previewnet QDN test name:

npm run build
npm run qdn:publish

By default the publish helper uploads dist/ as qdn://APP/Chat/Chat through http://127.0.0.1:24891, using the local preview account files under ~/qortium/git/qortium-core/preview. The helper uses QORTIUM_CHAT_NODE_API_KEY or QORTIUM_CHAT_NODE_API_KEY_PATH when set, then tries the API key for the active local Core process, and finally falls back to ~/.config/qortium-core/runtime/apikey.txt. Set QORTIUM_CHAT_QDN_NAME, QORTIUM_CHAT_QDN_IDENTIFIER, QORTIUM_CHAT_QDN_TITLE, or QORTIUM_CHAT_QDN_SERVICE to publish another QDN resource.

Versioning

Chat follows the Qortium app versioning standard (QAVS): the current app version is 1.4.13, where the 1.4 prefix declares the minimum Qortium platform level the app is built against and the last number is the app's own release counter. The build emits a qortium-app.json manifest (see vite.config.ts) that Qortium Home reads from the published root to show the compatibility badge.

Qortium Home Smoke Check

Before publishing a new QDN build:

npm test
npm run build

Then open qdn://APP/Chat/Chat in Qortium Home with an unlocked tab account. Confirm that the status pill reports Home, account approval succeeds, joined Qortium and Qortal groups load, both public-group send paths open Home approval prompts, Qortal Hub v3 text/replies render correctly, and Qortium direct/private flows retain their existing behavior. Also confirm that Home display settings update theme, text size, accent, UI style (Classic, Modern, or Fun), and language in the app.

For a publish pass, confirm the local Core is fully synchronized before running npm run qdn:publish. The expected identified render URL is http://127.0.0.1:24891/render/APP/Chat/Chat, and the published resource should report READY at /arbitrary/resource/status/APP/Chat/Chat?build=true.

Current Limits

This app does not handle private keys or transaction signing directly. Group joins, group chat sends, closed-group chat reads, direct private chat reads, direct private chat sends, and minting key registration are delegated to Qortium Home's account-safe approval bridge; the app never sees the minting key. Browser development remains read-only and cannot decrypt or send direct private chat without Home. Background direct-message notifications require Home to remain running; Android delivery currently requires Home to remain in the foreground. Closed-tab group mention detection is not available because Core deliberately excludes message content from notification events.

App-to-app data messages are hidden from the message feed, unread counts, and in-app mention/reply notifications, but a direct one can still raise Home's background "New direct message" notification. That rule is evaluated by Core, whose CHAT_MESSAGE event carries only addresses and envelope metadata and whose filters are address-scoped, so Chat has no way to exclude a message it has not seen yet. Suppressing it requires Home to fetch, decrypt, and classify the message before displaying.

Qortal support in this release is intentionally limited to public groups: joined-group history, ordinary messages and replies, plus bounded discovery and read-only previews for qualifying active open groups. Qortal DMs, closed/private groups, edits, deletes, and reactions require newer Home bridge actions that preserve the protocol's encryption and transaction-reference semantics. Chat hides the unsupported revision controls instead of broadcasting them as unrelated new messages. Reticulum/RCHAT remains a later, separate source family.

The working plan for completing both Qortium and Qortal CHAT capabilities is in docs/CHAT_COMPLETION_ROADMAP.md.