@rougechain/sdk 0.9.0 → 1.0.0

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
   <strong>Build quantum-safe dApps on RougeChain</strong><br />
-  Transfers · DEX · NFTs · Shielded Transactions · Bridge · Rollups · Dynamic Fees · Finality Proofs · WebSocket · Mail · Messenger
+  Transfers · DEX · NFTs · Social · Shielded Transactions · Bridge · Rollups · Dynamic Fees · Finality Proofs · WebSocket · Mail · Messenger
 </p>
 
 <p align="center">
@@ -62,6 +62,7 @@ const { balance } = await rc.getBalance(wallet.publicKey);
 | **Shielded** | `rc.shielded` | Private transfers with zk-STARK proofs, shield/unshield XRGE |
 | **Bridge** | `rc.bridge` | ETH ↔ qETH, USDC ↔ qUSDC, XRGE bridge (Base Mainnet/Sepolia) |
 | **Rollup** | `rc` | zk-STARK batch proofs, rollup status, submit transfers |
+| **Social** | `rc.social` | Posts, timeline feed, reposts, likes, follows, comments |
 | **Mail** | `rc.mail` | On-chain encrypted email (`@rouge.quant`) |
 | **Messenger** | `rc.messenger` | E2E encrypted messaging with self-destruct |
 | **Address Resolution** | `rc` | O(1) rouge1↔pubkey resolution via on-chain index |
@@ -335,6 +336,79 @@ const batch = await rc.getRollupBatch(1);
 // { batch_id, transfer_count, proof_size_bytes, proof_time_ms, verified, ... }
 ```
 
+## Social (`rc.social`)
+
+On-chain social layer with posts, threaded replies, reposts, likes, follows, and comments. All write operations require a `wallet` parameter for ML-DSA-65 signed requests.
+
+### Posts & Timeline
+
+```typescript
+// Create a post (max 4000 chars)
+const { post } = await rc.social.createPost(wallet, "Hello RougeChain!");
+
+// Reply to a post (threaded)
+await rc.social.createPost(wallet, "Great point!", post.id);
+
+// Delete your own post
+await rc.social.deletePost(wallet, post.id);
+
+// Get a single post with stats
+const result = await rc.social.getPost(post.id, wallet.publicKey);
+// result.post, result.stats { likes, reposts, replies, liked, reposted }
+
+// Global timeline (all posts, newest first)
+const timeline = await rc.social.getGlobalTimeline(50, 0);
+
+// Following feed (posts from people you follow)
+const feed = await rc.social.getFollowingFeed(wallet, 50, 0);
+
+// User's posts
+const { posts, total } = await rc.social.getUserPosts(userPubKey);
+
+// Get replies to a post
+const replies = await rc.social.getPostReplies(post.id);
+```
+
+### Likes, Reposts & Follows
+
+```typescript
+// Like/unlike a post or track (toggle)
+await rc.social.toggleLike(wallet, postOrTrackId);
+
+// Repost/unrepost (toggle)
+await rc.social.toggleRepost(wallet, post.id);
+
+// Follow/unfollow (toggle)
+await rc.social.toggleFollow(wallet, artistPubKey);
+
+// Get stats
+const stats = await rc.social.getPostStats(post.id, wallet.publicKey);
+const artistStats = await rc.social.getArtistStats(pubkey, wallet.publicKey);
+```
+
+### Comments (Track-level)
+
+```typescript
+// Comment on a track
+const { comment } = await rc.social.postComment(wallet, trackId, "Fire track!");
+
+// Get comments
+const comments = await rc.social.getComments(trackId);
+
+// Delete your comment
+await rc.social.deleteComment(wallet, comment.id);
+```
+
+### Play Counts
+
+```typescript
+// Record a play (debounce client-side, one per session per track)
+await rc.social.recordPlay(wallet, trackId);
+
+// Get track stats (plays, likes, comments)
+const trackStats = await rc.social.getTrackStats(trackId, wallet.publicKey);
+```
+
 ## Mail (`rc.mail`)
 
 On-chain encrypted email with `@rouge.quant` / `@qwalla.mail` addresses. All write operations require a `wallet` parameter for ML-DSA-65 request signing — requests are authenticated via `/api/v2/` endpoints with anti-replay nonce protection.
@@ -364,7 +438,7 @@ const name = await rc.mail.reverseLookup(wallet.publicKey);
 // "alice"
 
 // Release a name (signed request)
-await rc.mail.releaseName(wallet, "alice", wallet.publicKey);
+await rc.mail.releaseName(wallet, "alice");
 ```
 
 ### Sending & Reading Mail
@@ -393,6 +467,25 @@ await rc.mail.markRead(wallet, messageId);
 await rc.mail.delete(wallet, messageId);
 ```
 
+### Unread Counts
+
+The SDK does not expose a dedicated unread-count endpoint. Derive unread totals client-side from inbox data:
+
+```typescript
+// Mail: count unread inbox items
+const inbox = await rc.mail.getInbox(wallet);
+const unreadMail = inbox.filter((m: any) => {
+  const label = m.label ?? {};
+  return !(label.is_read ?? label.isRead ?? true);
+}).length;
+
+// Messenger: sum unread_count across conversations
+const convos = await rc.messenger.getConversations(wallet);
+const unreadChats = convos.reduce((sum: number, c: any) => {
+  return sum + (c.unread_count ?? c.unreadCount ?? 0);
+}, 0);
+```
+
 ## Messenger (`rc.messenger`)
 
 End-to-end encrypted messaging with media and self-destruct support. All operations use ML-DSA-65 signed requests via `/api/v2/` endpoints with nonce-based anti-replay protection.
@@ -425,7 +518,7 @@ await rc.messenger.sendMessage(wallet, conversationId, encryptedContent, {
 const messages = await rc.messenger.getMessages(wallet, conversationId);
 
 // Delete a message (signed request)
-await rc.messenger.deleteMessage(wallet, messageId);
+await rc.messenger.deleteMessage(wallet, messageId, conversationId);
 
 // Delete a conversation (signed request)
 await rc.messenger.deleteConversation(wallet, conversationId);
@@ -450,7 +543,7 @@ const stats = await rc.shielded.getStats();
 // Check if a nullifier has been spent
 const { spent } = await rc.shielded.isNullifierSpent(note.nullifier);
 
-// Private transfer (requires STARK proof from Rust prover)
+// Private transfer (STARK proof generated by WASM prover in browser or Rust prover on node)
 await rc.shielded.transfer(wallet, {
   nullifiers: [note.nullifier],
   outputCommitments: [recipientCommitment],
@@ -548,6 +641,7 @@ import type {
   ShieldedNote,
   RollupStatus, RollupBatchResult, RollupSubmitParams, RollupSubmitResult,
   FeeInfo, FinalityProof, MintTokenParams, VoteMessage, WsSubscribeMessage,
+  SocialPost, PostStats, TrackStats, ArtistStats, SocialComment,
 } from "@rougechain/sdk";
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rougechain/sdk",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Official SDK for RougeChain — post-quantum Layer 1 blockchain secured by ML-DSA-65",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -35,7 +35,7 @@
   "homepage": "https://rougechain.io",
   "repository": {
     "type": "git",
-    "url": "https://github.com/cyberdreadx/quantum-vault",
+    "url": "https://github.com/cyberdreadx/rougechain-node",
     "directory": "sdk"
   },
   "license": "MIT",