plotlink-ows 1.0.23 → 1.0.25

package/README.md

@@ -7,6 +7,7 @@
 <p>
   <a href="https://plotlink.xyz"><strong>Live App</strong></a> ·
   <a href="#-quick-start"><strong>Quick Start</strong></a> ·
+  <a href="#-wallet-setup"><strong>Wallet Setup</strong></a> ·
   <a href="#how-it-works"><strong>How it Works</strong></a> ·
   <a href="https://docs.openwallet.sh/"><strong>OWS Docs</strong></a>
 </p>
@@ -116,6 +117,49 @@ npx plotlink-ows status  # Show config + wallet info
 
 ---
 
+## 🔑 Wallet Setup
+
+PlotLink OWS uses an encrypted local wallet via Open Wallet Standard. No raw private keys are exposed to scripts or environment variables.
+
+### Initial Setup
+
+```bash
+npx plotlink-ows init
+```
+
+The setup wizard will:
+1. Ask you to create a passphrase (encrypts your wallet at rest)
+2. Generate a new OWS wallet in `~/.ows/`
+3. Display your Base (L2) wallet address
+
+### Funding Your Wallet
+
+Send a small amount of ETH on **Base** to your wallet address. Publishing costs less than $0.05 per story.
+
+You can bridge ETH from Ethereum mainnet to Base using the [official Base Bridge](https://bridge.base.org) or any supported bridge.
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `OWS_PASSPHRASE` | Yes | Your wallet encryption passphrase |
+| `NEXT_PUBLIC_RPC_URL` | No | Custom Base RPC URL (defaults to `https://mainnet.base.org`) |
+| `NEXT_PUBLIC_APP_URL` | No | PlotLink API URL (defaults to `https://plotlink.xyz`) |
+
+Copy `.env.example` to `.env` and fill in your values:
+
+```bash
+cp .env.example .env
+```
+
+> **Security best practices:**
+> - Never share your passphrase or wallet files with anyone
+> - Use a dedicated wallet for agent operations — do not reuse your main wallet
+> - Never commit `.env` or wallet files to version control
+> - Store backups of `~/.ows/` in a secure, offline location
+
+---
+
 ## 🏗️ Architecture
 
 ```

package/app/lib/publish.ts

@@ -142,9 +142,9 @@ async function indexWithDelayAndRetry(
  * Upload story content to IPFS via PlotLink's API (plotlink.xyz/api/upload).
  * PlotLink handles Filebase credentials server-side.
  */
-export async function uploadToIPFS(content: string, title: string, genre?: string): Promise<string> {
+export async function uploadToIPFS(content: string, title: string, genre?: string, language?: string): Promise<string> {
   const PLOTLINK_URL = process.env.NEXT_PUBLIC_APP_URL || "https://plotlink.xyz";
-  const metadata = JSON.stringify({ title, genre, content });
+  const metadata = JSON.stringify({ title, genre, language, content });
   const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, 40);
   const key = `plotlink/storylines/${Date.now()}-${slug}.json`;
 
@@ -293,10 +293,16 @@ export async function publishStoryline(
   content: string,
   genre: string | undefined,
   onProgress: (progress: PublishProgress) => void,
+  language?: string,
+  isNsfw?: boolean,
 ): Promise<PublishResult> {
+  // Normalize optional fields to backwards-compatible defaults
+  const normalizedLanguage = language || "English";
+  const normalizedIsNsfw = isNsfw ?? false;
+
   // Step 1: Upload to IPFS
   onProgress({ step: "uploading", message: "Uploading story to IPFS..." });
-  const contentCid = await uploadToIPFS(content, title, genre);
+  const contentCid = await uploadToIPFS(content, title, genre, normalizedLanguage);
 
   // Step 2: Compute content hash + get creation fee
   const contentHash = keccak256(toBytes(content));
@@ -334,7 +340,7 @@ export async function publishStoryline(
   // Streams "Indexing…" progress so the user does not escalate to Retry Publish.
   const indexError = await indexWithDelayAndRetry(
     "storyline",
-    { txHash, content, genre },
+    { txHash, content, genre, language: normalizedLanguage, isNsfw: normalizedIsNsfw },
     onProgress,
     txHash,
     contentCid,
@@ -361,10 +367,13 @@ export async function publishPlot(
   content: string,
   genre: string | undefined,
   onProgress: (progress: PublishProgress) => void,
+  language?: string,
 ): Promise<PublishResult> {
+  const normalizedLanguage = language || "English";
+
   // Step 1: Upload to IPFS
   onProgress({ step: "uploading", message: "Uploading plot to IPFS..." });
-  const contentCid = await uploadToIPFS(content, title, genre);
+  const contentCid = await uploadToIPFS(content, title, genre, normalizedLanguage);
 
   // Step 2: Compute content hash
   const contentHash = keccak256(toBytes(content));

package/app/routes/publish.ts

@@ -71,6 +71,8 @@ publish.post("/file", async (c) => {
     title: string;
     content: string;
     genre?: string;
+    language?: string;
+    isNsfw?: boolean;
     storylineId?: number;
   }>();
 
@@ -81,7 +83,7 @@ publish.post("/file", async (c) => {
   // Enforce character limits
   const isGenesis = body.fileName === "genesis.md";
   const isPlot = /^plot-\d+\.md$/.test(body.fileName);
-  const charLimit = isGenesis ? 1000 : isPlot ? 10000 : null;
+  const charLimit = (isGenesis || isPlot) ? 10000 : null;
   if (charLimit && body.content.length > charLimit) {
     return c.json({
       error: `Content exceeds ${charLimit.toLocaleString()} character limit (${body.content.length.toLocaleString()} chars). Reduce content before publishing.`,
@@ -118,6 +120,7 @@ publish.post("/file", async (c) => {
           async (progress) => {
             await stream.writeSSE({ data: JSON.stringify(progress) });
           },
+          body.language,
         );
       } else {
         // Create new storyline (genesis or first file)
@@ -129,6 +132,8 @@ publish.post("/file", async (c) => {
           async (progress) => {
             await stream.writeSSE({ data: JSON.stringify(progress) });
           },
+          body.language,
+          body.isNsfw,
         );
       }
 

package/app/web/components/Layout.tsx

@@ -174,6 +174,17 @@ export function Layout({ token, onLogout }: { token: string; onLogout: () => voi
               </ol>
             </div>
 
+            <div className="text-center">
+              <a
+                href="https://github.com/realproject7/plotlink-ows#-wallet-setup"
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-xs text-muted hover:text-accent underline transition-colors"
+              >
+                Wallet Setup Guide
+              </a>
+            </div>
+
             <WalletCard token={token} />
           </div>
         )}

package/app/web/components/PreviewPanel.tsx

@@ -3,12 +3,13 @@ import ReactMarkdown from "react-markdown";
 import remarkBreaks from "remark-breaks";
 import remarkGfm from "remark-gfm";
 import rehypeSanitize from "rehype-sanitize";
+import { GENRES, LANGUAGES } from "../../../lib/genres";
 
 interface PreviewPanelProps {
   storyName: string | null;
   fileName: string | null;
   authFetch: (url: string, opts?: RequestInit) => Promise<Response>;
-  onPublish?: (storyName: string, fileName: string) => void;
+  onPublish?: (storyName: string, fileName: string, genre: string, language: string, isNsfw: boolean) => void;
   publishingFile?: string | null;
 }
 
@@ -34,6 +35,9 @@ export function PreviewPanel({ storyName, fileName, authFetch, onPublish, publis
   const [dirty, setDirty] = useState(false);
   const [retrying, setRetrying] = useState(false);
   const [indexTimeLeft, setIndexTimeLeft] = useState<number | null>(null);
+  const [selectedGenre, setSelectedGenre] = useState(GENRES[0]);
+  const [selectedLanguage, setSelectedLanguage] = useState(LANGUAGES[0]);
+  const [isNsfw, setIsNsfw] = useState(false);
   const textareaRef = useRef<HTMLTextAreaElement>(null);
   const dirtyRef = useRef(false);
 
@@ -75,6 +79,31 @@ export function PreviewPanel({ storyName, fileName, authFetch, onPublish, publis
     return () => clearInterval(interval);
   }, [storyName, fileName, loadFile, activeTab, dirty]);
 
+  // Auto-detect genre from structure.md when story changes
+  useEffect(() => {
+    if (!storyName) return;
+    let cancelled = false;
+    authFetch(`/api/stories/${storyName}/structure.md`)
+      .then((res) => res.ok ? res.json() : null)
+      .then((data) => {
+        if (cancelled || !data?.content) return;
+        const match = data.content.match(/\*{0,2}genre\*{0,2}[:\s]+(.+)/i);
+        if (match) {
+          const detected = match[1].replace(/\*+/g, "").trim();
+          const found = GENRES.find((g) => g.toLowerCase() === detected.toLowerCase());
+          if (found) setSelectedGenre(found);
+        }
+        const langMatch = data.content.match(/\*{0,2}language\*{0,2}[:\s]+(.+)/i);
+        if (langMatch) {
+          const detected = langMatch[1].replace(/\*+/g, "").trim();
+          const found = LANGUAGES.find((l) => l.toLowerCase() === detected.toLowerCase());
+          if (found) setSelectedLanguage(found);
+        }
+      })
+      .catch(() => {});
+    return () => { cancelled = true; };
+  }, [storyName, authFetch]);
+
   const handleSave = useCallback(async () => {
     if (!storyName || !fileName) return;
     setSaving(true);
@@ -303,7 +332,7 @@ export function PreviewPanel({ storyName, fileName, authFetch, onPublish, publis
               )}
               {isPlot && (
                 <button
-                  onClick={() => storyName && fileName && onPublish?.(storyName, fileName)}
+                  onClick={() => storyName && fileName && onPublish?.(storyName, fileName, selectedGenre, selectedLanguage, isNsfw)}
                   disabled={!!publishingFile}
                   className="px-3 py-1 border border-border text-xs rounded hover:bg-surface disabled:opacity-50"
                 >
@@ -369,16 +398,56 @@ export function PreviewPanel({ storyName, fileName, authFetch, onPublish, publis
             )}
           </div>
         ) : (
-          <div className="flex items-center gap-2">
-            <button
-              onClick={() => storyName && fileName && onPublish?.(storyName, fileName)}
-              disabled={!!publishingFile || overLimit}
-              className="px-4 py-1.5 bg-accent text-white text-sm rounded hover:bg-accent-dim disabled:opacity-50 disabled:cursor-not-allowed"
-            >
-              {publishingFile === fileName ? "Publishing..." : "Publish to PlotLink"}
-            </button>
-            {overLimit && (
-              <span className="text-error text-xs">Reduce content to publish</span>
+          <div className="flex flex-col gap-2">
+            <div className="flex items-center gap-2">
+              {(isGenesis) && (
+                <>
+                  <select
+                    value={selectedGenre}
+                    onChange={(e) => setSelectedGenre(e.target.value)}
+                    className="px-2 py-1.5 text-xs border border-border rounded bg-surface text-foreground"
+                  >
+                    {GENRES.map((g) => (
+                      <option key={g} value={g}>{g}</option>
+                    ))}
+                  </select>
+                  <select
+                    value={selectedLanguage}
+                    onChange={(e) => setSelectedLanguage(e.target.value)}
+                    className="px-2 py-1.5 text-xs border border-border rounded bg-surface text-foreground"
+                  >
+                    {LANGUAGES.map((l) => (
+                      <option key={l} value={l}>{l}</option>
+                    ))}
+                  </select>
+                </>
+              )}
+              <button
+                onClick={() => storyName && fileName && onPublish?.(storyName, fileName, selectedGenre, selectedLanguage, isNsfw)}
+                disabled={!!publishingFile || overLimit}
+                className="px-4 py-1.5 bg-accent text-white text-sm rounded hover:bg-accent-dim disabled:opacity-50 disabled:cursor-not-allowed"
+              >
+                {publishingFile === fileName ? "Publishing..." : "Publish to PlotLink"}
+              </button>
+              {overLimit && (
+                <span className="text-error text-xs">Reduce content to publish</span>
+              )}
+            </div>
+            {(isGenesis) && (
+              <div className="flex items-center gap-2">
+                <label className="flex items-center gap-1.5 text-xs text-muted cursor-pointer">
+                  <input
+                    type="checkbox"
+                    checked={isNsfw}
+                    onChange={(e) => setIsNsfw(e.target.checked)}
+                    className="rounded border-border"
+                  />
+                  This story contains adult content (18+)
+                </label>
+                {isNsfw && (
+                  <span className="text-xs text-amber-600">Adult content will be hidden from the default browse view.</span>
+                )}
+              </div>
             )}
           </div>
         )}

package/app/web/components/StoriesPage.tsx

@@ -177,7 +177,7 @@ export function StoriesPage({ token, authFetch }: StoriesPageProps) {
     window.addEventListener("mouseup", onMouseUp);
   }, []);
 
-  const handlePublish = useCallback(async (storyName: string, fileName: string) => {
+  const handlePublish = useCallback(async (storyName: string, fileName: string, genre: string, language: string, isNsfw: boolean) => {
     setPublishingFile(fileName);
     setPublishProgress("Reading file...");
 
@@ -191,17 +191,6 @@ export function StoriesPage({ token, authFetch }: StoriesPageProps) {
       const titleMatch = fileData.content.match(/^#\s+(.+)$/m);
       const title = titleMatch ? titleMatch[1].slice(0, 60) : fileName.replace(".md", "");
 
-      // Determine genre from structure.md if available
-      let genre = "Fiction";
-      try {
-        const structRes = await authFetch(`/api/stories/${storyName}/structure.md`);
-        if (structRes.ok) {
-          const structData = await structRes.json();
-          const genreMatch = structData.content.match(/genre[:\s]+(.+)/i);
-          if (genreMatch) genre = genreMatch[1].trim().slice(0, 30);
-        }
-      } catch { /* ignore */ }
-
       // For plot files, find the storylineId from the genesis publish status
       let storylineId: number | undefined;
       if (fileName.match(/^plot-\d+\.md$/)) {
@@ -226,7 +215,7 @@ export function StoriesPage({ token, authFetch }: StoriesPageProps) {
       const publishRes = await authFetch("/api/publish/file", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ storyName, fileName, title, content: fileData.content, genre, storylineId }),
+        body: JSON.stringify({ storyName, fileName, title, content: fileData.content, genre, language, isNsfw, storylineId }),
       });
 
       if (!publishRes.ok) {