back to home

vitorpamplona / amethyst

Nostr client for Android

1,482 stars
187 forks
259 issues
KotlinHTMLShell

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing vitorpamplona/amethyst in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/vitorpamplona/amethyst)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

Amethyst Nostr Client for Android Join the social network you control. Download and Install Supported Features • [x] Events / Relay Subscriptions (NIP-01) • [x] Follow List (NIP-02) • [x] OpenTimestamps Attestations (NIP-03) • [x] Private Messages (NIP-04 -- to be removed) • [x] DNS Address (NIP-05) • [x] Mnemonic seed phrase (NIP-06) • [ ] WebBrowser Signer (NIP-07, Not applicable) • [x] Old-style mentions (NIP-08) • [x] Event Deletion (NIP-09) • [x] Text Notes and Threads (NIP-10) • [x] Relay Information Document (NIP-11) • [x] Generic Tag Queries (NIP-12) • [x] Proof of Work Display (NIP-13) • [ ] Proof of Work Calculations (NIP-13) • [x] Events with a Subject (NIP-14) • [ ] Marketplace (NIP-15) • [x] Event Treatment (NIP-16) • [x] Private Direct Messages (NIP-17) • [x] Image/Video/Url/LnInvoice/Cashu Previews • [x] Reposts, Quotes, Generic Reposts (NIP-18) • [x] Bech32 Encoding support (NIP-19) • [x] Command Results (NIP-20) • [x] URI Support (NIP-21) • [x] Long-form Content (NIP-23) (view only) • [x] User Profile Fields / Relay list (NIP-24) • [x] Reactions (NIP-25) • [ ] Delegated Event Signing (NIP-26, Will not implement) • [x] Text Note References (NIP-27) • [x] Public Chats (NIP-28) • [ ] Relay-based Groups (NIP-29) • [x] Custom Emoji (NIP-30) • [x] Event alt descriptors (NIP-31) • [ ] Labeling (NIP-32) • [x] Git Stuff (NIP-34) • [x] Torrents (NIP-35) • [x] Sensitive Content (NIP-36) • [x] Drafts (NIP-37) • [x] User Status Event (NIP-38) • [x] External Identities (NIP-39) • [x] Expiration Support (NIP-40) • [x] Relay Authentication (NIP-42) • [ ] Relay Access Metadata and Requests (NIP-43) • [x] Versioned Encrypted Payloads (NIP-44) • [x] Event Counts (NIP-45) • [o] Nostr Connect (NIP-46) • [o] Wallet Connect API (NIP-47) • [ ] Proxy Tags (NIP-48, Not applicable) • [x] Encryption for import/export (NIP-49) • [x] Relay Search (NIP-50) • [x] Lists (NIP-51) • [o] Calendar Events (NIP-52) • [x] Live Activities & Live Chats (NIP-53) • [x] Wiki (NIP-54) • [x] Android Signer (NIP-55) • [x] Reporting (NIP-56) • [x] Lightning Tips • [x] Zaps (NIP-57) • [x] Zap Splits (NIP-57) • [x] Private Zaps (NIP-57 / Draft) • [x] Zapraiser (NIP-57 / Draft) • [x] Badges (NIP-58) • [x] Gift Wraps & Seals (NIP-59) • [ ] Cashu Wallets (NIP-60) • [ ] Nutzaps (NIP-61) • [x] Request to Vanish (NIP-62) • [x] Chess (NIP-64) • [x] Relay List Metadata (NIP-65) • [x] Relay Discovery and Monitoring (NIP-66) • [x] Picture-first feeds (NIP-68) • [ ] Peer-to-peer Orders (NIP-69) • [o] Protected Events (NIP-70) • [x] Video Events (NIP-71) • [x] Moderated Communities (NIP-72) • [x] External Content IDs (NIP-73) • [ ] Zap Goals (NIP-75) • [ ] Negentropy Syncing (NIP-77) • [x] Arbitrary Custom App Data (NIP-78) • [ ] NIP-29 Threads (NIP-7D) • [x] Highlights (NIP-84) • [x] Trusted Assertions (NIP-85) • [ ] Relay Management API (NIP-86) • [ ] ECash Mint Discoverability (NIP-87) • [x] Polls (NIP-88) • [x] Relay Notify Request • [x] Recommended Application Handlers (NIP-89) • [x] Data Vending Machine (NIP-90) • [x] Inline Metadata (NIP-92) • [x] Verifiable file URLs (NIP-94) • [x] Binary Blobs (NIP-95/Draft) • [x] HTTP File Storage Integration (NIP-96) • [x] HTTP Auth (NIP-98) • [x] Classifieds (NIP-99) • [x] Voice Messages (NIP-A0) • [x] Public Messages (NIP-A4) • [ ] Web Bookmarks • [x] Blossom (NIP-B7) • [ ] Nostr BLE Communications Protocol (NIP-BE) • [x] Code Snippets (NIP-C0) • [ ] NIP-29 Chats (NIP-C7) • [ ] MLS Protocol (NIP-EE) • [x] Audio Tracks (zapstr.live) (kind:31337) • [x] Push Notifications (Google and Unified Push) • [x] In-Device Automatic Translations • [x] Hashtag Following and Custom Hashtags • [x] Login with QR • [x] Bounty support (nostrbounties.com) • [x] De-googled F-Droid flavor • [x] Multiple Accounts • [x] Markdown Support • [x] Medical Data (NIP-xx/Draft) • [x] Embed events (NIP-xx/Draft) • [x] Edit Short Notes (NIP-xx/Draft) • [x] NIP Events (NIP-xx/Draft) • [ ] Relationship Status (NIP-xx/Draft) • [ ] Signed Filters (NIP-xx/Draft) • [ ] Key Migration (NIP-xx/Draft) • [x] Image Capture in the app • [x] Video Capture in the app • [ ] Local Database • [ ] Workspaces Privacy and Information Permanence Relays know your IP address, your name, your location (guessed from IP), your pub key, all your contacts, and other relays, and can read every action you do (post, like, boost, quote, report, etc) except for Private Zaps and Private DMs. While the content of direct messages (DMs) is only visible to you and your DM counterparty, everyone can see when you and your counterparty DM each other. If you want to improve your privacy, consider utilizing a service that masks your IP address (e.g. a VPN or Tor) from trackers online. The relay also learns which public keys you are requesting, meaning your public key will be tied to your IP address. Information shared on Nostr can be re-broadcasted to other servers and should be assumed permanent for privacy purposes. There is no way to guarantee the deletion of any content once posted. Development Overview This repository is split between Amethyst, Quartz, Commons, and DesktopApp: • **Amethyst** - Native Android app with Kotlin and Jetpack Compose • **Quartz** - Nostr-commons KMP library for protocol classes shared across platforms • **Commons** - Kotlin Multiplatform module with shared UI components (icons, robohash, blurhash, composables) • **DesktopApp** - Compose Multiplatform Desktop application reusing commons and quartz The app architecture consists of the UI, which uses the usual State/ViewModel/Composition, the service layer that connects with Nostr relays, and the model/repository layer, which keeps all Nostr objects in memory, in a full OO graph. The repository layer stores Nostr Events as Notes and Users separately. Those classes use LiveData and Flow objects to allow the UI and other parts of the app to subscribe to each Note/User and receive updates when they happen. They are also responsible for updating viewModels when needed. As the…