# Iris Chat
Iris Chat is an encrypted chat client built on the Iris shared Rust core.
This crate publishes the `iris` command line tool and the `iris_chat_core`
library used by the native apps.
## Install
```sh
cargo install iris-chat
```
## CLI
```sh
iris account create --name Alice
iris whoami
iris chat create <user-id>
iris send <chat-id> "hello"
iris read <chat-id>
iris listen
```
Use `--json` for scripts and agents.
Set `IRIS_CHAT_SAME_HOST_HASHTREE=1` to let the logged-in Chat FIPS endpoint
discover authenticated `hashtree.blob/1` providers over fixed loopback UDP.
Chat's local cache, one composite FIPS provider route, and its configured
Blossom sources share the canonical hash-verifying `BlobRouter`. Provider
misses, failures, or exit leave the other routes available, while attachment
writes remain application-owned and unchanged.
Process-level integration tests may set `IRIS_CHAT_FIPS_LOCAL_RENDEZVOUS_ADDR`
to an isolated non-zero IPv4 loopback address. Normal application runs leave
it unset and use the fixed FIPS same-host rendezvous address.
Multi-device sync uses the independent Osiris and LNVPS FIPS WebSocket seeds by
default. Set `IRIS_FIPS_WEBSOCKET_SEED_URLS` to replace them with a
comma-separated list of explicit `wss://.../fips` URLs, or set it to an empty
value for an isolated run. These are authenticated FIPS physical peers;
ordinary Nostr message servers remain Nostr event and discovery/signaling
relays and do not carry FIPS packets. Signed update notices use the shared
`nostr-pubsub` path over both connected FIPS peers and configured message
servers.
Primary development is on hashtree:
https://git.iris.to/#/npub1399g0q2gtwjcglyjcg3jw3rcllqhm375pwases5hkvqa56aqe5wsz2eaap/iris-chat-rs