HushCircuits Docs

Appearance

Return to top
On this page
HUSH
CIRCUITS

Telegram Integration

HushCircuits supports a Telegram Mini App path with Telegram-native lifecycle and haptic support.

TELEGRAM LINK PROTOCOL

Secure handshake between web and mobile

🔑
GENERATE
📱
ENTER
🤝
VERIFY
✅
LINKED
1
GENERATE CODE

In the web app, go to Settings > Security & Telegram. Click "Generate Link Code" to get a one-time pairing code.

2
ENTER IN TELEGRAM

Open the HushCircuits Telegram bot. Enter the link code and your 6-digit PIN to initiate the handshake.

3
SECURE HANDSHAKE

The server verifies both the code and PIN. A cryptographic handshake links your Telegram account to your HushCircuits identity.

4
ACCOUNT LINKED

Your Telegram is now linked. You can use HushCircuits directly from Telegram with auto-authentication and haptic feedback.

HANDSHAKE: READY

What Telegram Mode Adds

  • Telegram WebApp initialization + initData auth path.
  • Haptic feedback integration (impact, selection, notification, dialpad-specific).
  • Viewport and close-protection handling for mobile stability.
  • Crash logging to Telegram CloudStorage fallback path.

Secure Linking Flow

From web terminal

  1. Open Settings -> Security & Telegram.
  2. Select GENERATE_LINK_VECTOR.
  3. Copy the temporary 8-character code.

From Telegram Mini App

  1. Open the Mini App.
  2. Enter vector code.
  3. Enter 6-digit PIN.
  4. Select INITIATE_HANDSHAKE.

Token + Session Behavior

  • Linked sessions authenticate through Supabase session tokens after verification.
  • PIN remains required for protected actions.
  • If token/session expires, reopen Mini App and repeat login path.

Haptic Configuration

Set in Settings -> Haptic Feedback:

  • SILENT
  • SUBTLE
  • TACTILE
  • IMPACT

Dialpad haptics can be toggled independently.