5b64ef2560
Ships the client side of the v2.0.0 feed feature. Folds client-app/
into the monorepo (was previously .gitignored as "tracked separately"
but no separate repo ever existed — for v2.0.0 the client is
first-class).
Feed screens
app/(app)/feed.tsx — Feed tab
- Three-way tab strip: Подписки / Для вас / В тренде backed by
/feed/timeline, /feed/foryou, /feed/trending respectively
- Default landing tab is "Для вас" — surfaces discovery without
requiring the user to follow anyone first
- FlatList with pull-to-refresh + viewability-driven view counter
bump (posts visible ≥ 60% for ≥ 1s trigger POST /feed/post/…/view)
- Floating blue compose button → /compose
- Per-post liked_by_me fetched in batches of 6 after list load
app/(app)/compose.tsx — post composer modal
- Fullscreen, Twitter-like header (✕ left, Опубликовать right)
- Auto-focused multiline TextInput, 4000 char cap
- Hashtag preview chips that auto-update as you type
- expo-image-picker + expo-image-manipulator pipeline: resize to
1080px max-dim, JPEG Q=50 (client-side first-pass compression
before the mandatory server-side scrub)
- Live fee estimate + balance guard with a confirmation modal
("Опубликовать пост? Цена: 0.00X T · Размер: N KB")
- Exif: false passed to ImagePicker as an extra privacy layer
app/(app)/feed/[id].tsx — post detail
- Full PostCard rendering + detailed info panel (views, likes,
size, fee, hosting relay, hashtags as tappable chips)
- Triggers bumpView on mount
- 410 (on-chain soft-delete) routes back to the feed
app/(app)/feed/tag/[tag].tsx — hashtag feed
app/(app)/profile/[address].tsx — rebuilt
- Twitter-ish profile: avatar, name, address short-form, post count
- Posts | Инфо tab strip
- Follow / Unfollow button for non-self profiles (optimistic UI)
- Edit button on self profile → settings
- Secondary actions (chat, copy address) when viewing a known contact
Supporting library
lib/feed.ts — HTTP wrappers + tx builders for every /feed/* endpoint:
- publishPost (POST /feed/publish, signed)
- publishAndCommit (publish → on-chain CREATE_POST)
- fetchPost / fetchStats / bumpView
- fetchAuthorPosts / fetchTimeline / fetchForYou / fetchTrending /
fetchHashtag
- buildCreatePostTx / buildDeletePostTx
- buildFollowTx / buildUnfollowTx
- buildLikePostTx / buildUnlikePostTx
- likePost / unlikePost / followUser / unfollowUser / deletePost
(high-level helpers that bundle build + submitTx)
- formatFee, formatRelativeTime, formatCount — Twitter-like display
helpers
components/feed/PostCard.tsx — core card component
- Memoised for performance (N-row re-render on every like elsewhere
would cost a lot otherwise)
- Optimistic like toggle with heart-bounce spring animation
- Hashtag highlighting in body text (tappable → hashtag feed)
- Long-press context menu (Delete, owner-only)
- Views / likes / share-link / reply icons in footer row
Navigation cleanup
- NavBar: removed the SOON pill on the Feed tab (it's shipped now)
- (app)/_layout: hide NavBar on /compose and /feed/* sub-routes
- AnimatedSlot: treat /feed/<id>, /feed/tag/<t>, /compose as
sub-routes so back-swipe-right closes them
Channel removal (client side)
- lib/types.ts: ContactKind stripped to 'direct' | 'group'; legacy
'channel' flag removed. `kind` field kept for backward compat with
existing AsyncStorage records.
- lib/devSeed.ts: dropped the 5 channel seed contacts.
- components/ChatTile.tsx: removed channel kindIcon branch.
Dependencies
- expo-image-manipulator added for client-side image compression.
- expo-file-system/legacy used for readAsStringAsync (SDK 54 moved
that API to the legacy sub-path; the new streaming API isn't yet
stable).
Type check
- npx tsc --noEmit — clean, 0 errors.
Next (not in this commit)
- Direct attachment-bytes endpoint on the server so post-detail can
actually render the image (currently shows placeholder with URL)
- Cross-relay body fetch via /api/relays + hosting_relay pubkey
- Mentions (@username) with notifications
- Full-text search
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
94 lines
3.6 KiB
Markdown
94 lines
3.6 KiB
Markdown
# DChain Messenger — React Native Client
|
|
|
|
E2E-encrypted mobile/desktop messenger built on the DChain blockchain stack.
|
|
|
|
**Stack:** React Native · Expo · NativeWind (Tailwind) · TweetNaCl · Zustand
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
cd client-app
|
|
npm install
|
|
npx expo start # opens Expo Dev Tools
|
|
# Press 'i' for iOS simulator, 'a' for Android, 'w' for web
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- Node.js 18+
|
|
- [Expo Go](https://expo.dev/client) on your phone (for Expo tunnel), or iOS/Android emulator
|
|
- A running DChain node (see root README for `docker compose up --build -d`)
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
client-app/
|
|
├── app/
|
|
│ ├── _layout.tsx # Root layout — loads keys, sets up nav
|
|
│ ├── index.tsx # Welcome / onboarding
|
|
│ ├── (auth)/
|
|
│ │ ├── create.tsx # Generate new Ed25519 + X25519 keys
|
|
│ │ ├── created.tsx # Key created — export reminder
|
|
│ │ └── import.tsx # Import existing key.json
|
|
│ └── (app)/
|
|
│ ├── _layout.tsx # Tab bar — Chats · Wallet · Settings
|
|
│ ├── chats/
|
|
│ │ ├── index.tsx # Chat list with contacts
|
|
│ │ └── [id].tsx # Individual chat with E2E encryption
|
|
│ ├── requests.tsx # Incoming contact requests
|
|
│ ├── new-contact.tsx # Add contact by @username or address
|
|
│ ├── wallet.tsx # Balance + TX history + send
|
|
│ └── settings.tsx # Node URL, key export, profile
|
|
├── components/ui/ # shadcn-style components (Button, Card, Input…)
|
|
├── hooks/
|
|
│ ├── useMessages.ts # Poll relay inbox, decrypt messages
|
|
│ ├── useBalance.ts # Poll token balance
|
|
│ └── useContacts.ts # Load contacts + poll contact requests
|
|
└── lib/
|
|
├── api.ts # REST client for all DChain endpoints
|
|
├── crypto.ts # NaCl box encrypt/decrypt, Ed25519 sign
|
|
├── storage.ts # SecureStore (keys) + AsyncStorage (data)
|
|
├── store.ts # Zustand global state
|
|
├── types.ts # TypeScript interfaces
|
|
└── utils.ts # cn(), formatAmount(), relativeTime()
|
|
```
|
|
|
|
## Cryptography
|
|
|
|
| Operation | Algorithm | Library |
|
|
|-----------|-----------|---------|
|
|
| Transaction signing | Ed25519 | TweetNaCl `sign` |
|
|
| Key exchange | X25519 (Curve25519) | TweetNaCl `box` |
|
|
| Message encryption | NaCl box (XSalsa20-Poly1305) | TweetNaCl `box` |
|
|
| Key storage | Device secure enclave | expo-secure-store |
|
|
|
|
Messages are encrypted as:
|
|
```
|
|
Envelope {
|
|
sender_pub: <X25519 hex> // sender's public key
|
|
recipient_pub: <X25519 hex> // recipient's public key
|
|
nonce: <24-byte hex> // random per message
|
|
ciphertext: <hex> // NaCl box(plaintext, nonce, sender_priv, recipient_pub)
|
|
}
|
|
```
|
|
|
|
## Connect to your node
|
|
|
|
1. Start the DChain node: `docker compose up --build -d`
|
|
2. Open the app → Settings → Node URL → `http://YOUR_IP:8081`
|
|
3. If using Expo Go on physical device: your PC and phone must be on the same network, or use `npx expo start --tunnel`
|
|
|
|
## Key File Format
|
|
|
|
The `key.json` exported/imported by the app:
|
|
```json
|
|
{
|
|
"pub_key": "26018d40...", // Ed25519 public key (64 hex chars)
|
|
"priv_key": "...", // Ed25519 private key (128 hex chars)
|
|
"x25519_pub": "...", // X25519 public key (64 hex chars)
|
|
"x25519_priv": "..." // X25519 private key (64 hex chars)
|
|
}
|
|
```
|
|
|
|
This is the same format as the Go node's `--key` flag.
|