Overview

This release delivers major improvements across the wallet, Telegram integration, and gasless transaction flows. Users get a smoother claiming experience, richer in-app feedback (confetti, haptics, skeleton loaders), clearer transaction messaging, and more robust backend support for Solana deposits, Telegram webhooks, and business connections.

Wallet & Gasless Transactions

Restored reliable gasless claim handling
- Fixed gasless claim transaction handling in both the wallet and API routes so fee-less claims process reliably.
- Updated the wallet UI to show accurate transaction status and clearer feedback during gasless operations.
Automatic claiming for incoming deposits
- Incoming transactions are now auto-claimed, replacing manual claim actions.
- A blinking “Claiming…” badge indicates progress, and successful claims trigger celebratory confetti and haptics.
Confetti & haptic feedback enhancements
- Increased confetti intensity and extended haptic bursts for a more impactful celebration when key actions (like successful claims) complete.
- Added confetti plus strong haptics specifically on successful claim events.
Gasless banner and claim UX
- Introduced a GaslessBanner component and new Molnia icons to highlight gasless status in wallet and summary views.
- Persisted gasless banner and free-transaction claim state to cloud storage so prompts and progress stay consistent across sessions.
- Restored visibility of the claim button after users complete the gasless task, preventing missed free-transaction claims.
- Updated the gas warning message to explicitly prompt users to join the channel to receive free transaction credits.
Gasless verification & APIs
- Added a gasless transaction claim API plus Solana-based verification to enable fee-less claim flows.
- Introduced a dedicated gasless claim API method and integrated it into the client library and wallet handling.
- Implemented a test suite for gasless Telegram verification initData storage, plus end-to-end tests for the full gasless Telegram verification flow to reduce regressions.
Gasless error handling
- Fixed issues in gasless claim transaction handling on the Telegram wallet page so submissions are reliable and wallet state updates correctly.
- Ensured gasless state is reset on verification failure and surfaced via a clear error modal, which is cleared when the modal is dismissed.

Wallet UX, Fees & Activity Views

Simplified fee and gas UI
- Removed explicit “gasless” transaction presentation where no longer applicable.
- Consolidated and simplified the transfer fee UI for clearer, more predictable transaction handling.
Improved transaction viewing & sharing
- Updated Telegram summary pages and wallet transaction sheets to streamline viewing, sending, and reviewing activity.
- Added inline message sharing for username-based deposits directly from transaction details.
- Updated gas warnings and inline messaging to encourage joining the channel for free transactions and to clarify when gas is required.
- Swapped sender and receiver references in Telegram share message text so the recipient is greeted correctly and the sender is accurately identified.
Skeleton loading states
- Added skeleton loaders for wallet transactions and incoming deposits in Activity views and the main wallet.
- Reduced perceived latency and layout shifts while transaction data loads.
Layout & spacing adjustments
- Refined wallet top-section spacing for a cleaner presentation.
- Fixed deposit username detection when sharing deposit transactions so recipient details are accurate.

Deposits, Cancellations & Refunds

Deposit cancellation & refund flows
- Added a Cancel button for deposit_for_username transactions in the UI; the cancellation logic will follow in a later update.
- Introduced cancel/refund support for deposit_for_username:
  - Fetches deposit details and exposes a conditional cancel action for positive deposits.
  - Executes refunds via the Solana program for consistent and safe returns.
Solana deposit reliability
- Created a webhook on Solana account changes for deposits to detect and process incoming funds in real time.
- Fixed Solana deposit refund and top-up logic to avoid incorrect balances and to ensure consistent follow-up operations.
- Corrected sorting logic in Solana deposits to avoid lint issues and guarantee stable ordering.
Explorers & network configuration
- Removed the devnet cluster parameter from blockchain explorer URLs, sending users to canonical explorer pages regardless of environment.
- Stopped requesting devnet API connections and ensured wallet, claim, and Telegram flows use the configured network only.

Telegram Mini-App, Bot & Messaging

Telegram webhook integration
- Added a Telegram webhook endpoint/route to receive and process bot updates in real time.
- Ensured bot commands are awaited correctly in the webhook handler to avoid unhandled promises and sequencing issues.
- Resolved lint errors in the webhook code, improving maintainability.
Business connections & schema
- Added a missing business connection ID field to the schema so records validate and identifiers persist as expected.
- Introduced a nildb schema for business connections to provide persistent, validated storage.
- Decoupled the bot start message from the webhook flow and added explicit handling for business connect/disconnect events for more resilient Telegram interaction logic.
Nillion-backed message storage
- Integrated Nillion for backend message storage to increase message durability and improve user/service orchestration around messaging.
Inline sharing & richer share experiences
- Enabled inline Telegram message sharing immediately after a successful transaction, streamlining post-transaction communication.
- Added an image to Telegram inline share messages for richer previews and better engagement.
- Introduced personalization and clearer button navigation in shared messages to make follow-up actions easier to discover.
Verification, emoji & channel checks
- Added Telegram handlers to set and verify:
  - Custom emoji status.
  - Channel join status (chat participation).
- Introduced runtime methods to:
  - Check Telegram chat participation.
  - Check custom emoji status.
- Enabled setting a user’s custom emoji status and sharing prepared inline messages from the Telegram mini-app, supporting emoji-based features and presence.

Chat UI, Navigation & Message Experience

Direct & Spam chat pages
- Added dedicated Direct and Spam message pages with:
  - Swipe-based navigation between tabs.
  - A native Reply action and clickable user links.
- Unified the bot banner across tabs, hid bottom navigation within chats for better immersion, fixed scrolling gradient issues, and added a wallet empty-state banner.
Swipe navigation & visual refinements
- Introduced left/right swipe navigation between conversation tabs with a subtle slide animation for more intuitive navigation.
- Enhanced message presentation:
  - Display usernames under display names.
  - Insert date separator bubbles.
  - Position timestamps more intelligently.
  - Adjust bubble corner radius for last messages in a sequence.

User Profiles & Installation

New Profile page
- Added a Profile view that shows:
  - Telegram avatar, name, and username.
  - A (currently disabled) language selector entry.
  - Mobile “Add to Home Screen” option.
  - Custom emoji toggle.
  - A support link to t.me/spacesymmetry.
- Added a Join Loyal channel card to user profiles to promote channel membership and unlock benefits like free transactions.
Add-to-home-screen reliability
- Implemented an Android fallback for the add-to-home-screen flow to improve installation success where native Telegram behavior may differ.

Sending, Safety & Device-Specific Fixes

Username safety warning
- During send confirmation, the UI now shows a compact warning that recipient usernames are case-sensitive, reducing the risk of misdirected transfers.
Clickable recipients & navigation
- Recipient “pills” in transaction views now open the recipient’s Telegram profile, simplifying verification and sharing.
iOS input and viewport fixes
- Fixed a bug where the iOS cursor would jump when reopening the keyboard, keeping it at the end of the input for more predictable typing.
- Prevented iOS viewport shifts during SendSheet step transitions by adjusting focus behavior, improving visual stability when entering amounts.

Summaries & Onboarding

Connect Loyal Bot modal
- Added a Connect Loyal Bot modal to the summaries page, including:
  - Step-by-step connection instructions.
  - A native Telegram button to copy the bot’s username.
- Simplifies onboarding and ensures users can easily enable full bot functionality.
Wallet & summary improvements
- Refined Telegram summary pages and wallet transaction sheets for clearer transaction detail presentation and smoother activity flows.
- Added a wallet empty-state banner to guide users when no activity is present.

Observability & Quality

Analytics integration
- Integrated Umami analytics across the app to track key flows (deposits, claims, bot interactions) and support data-driven improvements.
Testing & linting
- Added targeted test suites (including gasless Telegram verification and initData storage).
- Cleaned up lint errors (e.g., Telegram webhook route, Solana deposit sorting) and removed unused code for more stable builds and cleaner CI.

If you rely on gasless claims, Telegram sharing, or Solana deposits, these updates should provide a faster, clearer, and more reliable experience end-to-end.

Loyal changelog

Weeks 51-52: New Design and Mini App Updates

Week 50: Wallet, Telegram & Gasless Transactions

Week 47: NLP for skills

Week 46: Inline skills