Skip to content

Use the Chat App to send 1:1 messages#308

Open
kashepavadan wants to merge 3 commits into
mainfrom
1-1-messaging
Open

Use the Chat App to send 1:1 messages#308
kashepavadan wants to merge 3 commits into
mainfrom
1-1-messaging

Conversation

@kashepavadan

Copy link
Copy Markdown
Contributor

Based on #299


This procedure shows how to use the Logos Chat app to exchange encrypted 1:1 messages between two running instances. The app is a QML and C++ UI built on top of the [`logos-chat-module`](https://github.com/logos-co/logos-chat-module), which wraps the [Logos Chat SDK](https://github.com/logos-messaging/logos-chat). It demonstrates the basic private-messaging capabilities of the Logos Chat Module: ephemeral identity, intro-bundle handshake, and encrypted messaging with no central server. Use this procedure to verify the setup works or to explore the messaging flow for development purposes.

> **Caution**

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **Caution**
> [!IMPORTANT]

https://github.com/orgs/community/discussions/16925


You need two running instances to complete this procedure. Each instance can use either of the options below independently.

> **Note**

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **Note**
> [!NOTE]

### Option A — Run in Logos Basecamp

1. Download and install the latest release of Logos Basecamp from `github.com/logos-co/logos-basecamp/releases`.
1. In the left bar, select **Package Manager**.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This step could do with a screenshot, until hover-over tooltips land in a release.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Even the following install step could benefit from a screenshot.


### Messages never arrive and the left panel shows "Waiting for connection…"

Both instances require a stable internet connection to reach a shared bootstrap peer. Verify that neither instance is behind a firewall or network that blocks the Logos network.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Shared bootstrap peer" has not been defined, so may be confusing.
Could either introduce it earlier if/when relevant, or mention here: eg " ... to reach a shared bootstrap peer to initially connect to the p2p network" (or whatever is most succinct & correct).

@kashepavadan

Copy link
Copy Markdown
Contributor Author

@jzaki ready for review again

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants