Docs/Getting Started/Your First Message
Getting Started

Your First Message

Send your first end-to-end encrypted message in Cipher. It's easy, secure, and completely private.

Adding a Contact

Before you can message someone, you need to add them as a contact. There are several ways to do this:

Search by Username

If they have an on-chain username like 'alice.cipher', search for it directly

Scan QR Code

Scan their Cipher QR code in person for instant, verified connection

Step-by-Step: Adding via Username

  1. Tap the + button in the top right of your chat list
  2. Select New Contact
  3. Enter their username (e.g., "alice.cipher") or public key
  4. Verify the key fingerprint matches what they show you (recommended for security)
  5. Tap Add Contact

Starting a Conversation

Once you've added a contact, starting a conversation is simple:

  1. Tap the contact's name in your contact list, or tap + then New Message
  2. Select the contact you want to message
  3. A new encrypted conversation thread opens

Sending Your First Message

What Happens Behind the Scenes

  1. 1Cipher fetches your contact's prekey bundle from the network
  2. 2X3DH key agreement creates a shared secret known only to you both
  3. 3Your message is encrypted with AES-256-GCM using a unique key
  4. 4The encrypted message is sent via the P2P network
  5. 5Your contact decrypts it with their corresponding key

All of this happens automatically and instantly. You just type your message and tap send!

Message Features

Cipher supports various message types:

  • Text messages with emoji support
  • Images and photos (encrypted before sending)
  • Files and documents up to 100MB
  • Voice messages with automatic transcription
  • Crypto payments directly in chat
  • Payment requests with custom amounts and notes

Understanding Message Status

Sending

Message is being encrypted and sent

Sent

Message delivered to the network

✓✓

Delivered

Message received by recipient's device

Verifying Encryption

You can verify that your conversation is properly encrypted by checking the security info:

  1. Tap on the contact's name at the top of the conversation
  2. Select Verify Security
  3. Compare the safety numbers with your contact (in person or via another channel)
  4. If they match, tap Mark as Verified

Verified contacts show a checkmark badge, giving you confidence that no one is intercepting your messages.

Next Steps

Now that you've sent your first message, explore more features: