Getting Started with zKPnote

zKPnote is a privacy-first note-taking app with blockchain-backed proof of originality. Your notes are encrypted end-to-end — only you can read them.

Creating Your Vault

Option A: Seed Phrase (Recommended)

Open zKPnote and click Create New Vault
You'll receive a 12-word seed phrase — this is your master key
Write it down and store it safely. If you lose it, your vault is gone forever. There is no password reset.
Confirm the seed phrase to unlock your vault

Your seed phrase generates both your encryption key (for securing notes) and your Solana wallet (for marketplace transactions). The same seed phrase produces the same Solana address as Phantom and all standard Solana wallets.

Option B: Phantom Wallet

If you already have a Solana wallet via the Phantom browser extension:

Click Connect with Phantom on the welcome screen
Approve the connection in Phantom
Sign the key derivation message (this does NOT spend SOL — it generates your encryption key)
Your vault is now linked to your Phantom wallet

Note: Your Phantom wallet must be a full wallet (not view-only). You'll need to approve two prompts: one to connect, one to sign the key derivation message.

Persistent sessions: Phantom sessions now persist across page refreshes. Once you approve the signature message, zKPnote caches it in your browser session so you won't need to re-approve every time you reload the page.

Seamless switching: Both login methods produce the same encryption key and vault. Log in with your 12 words or Phantom — you'll see the same notes either way.

Writing Notes

Click New Note in the sidebar (or press the + button)
Write in Markdown or Rich Text — toggle between modes using the toolbar. Rich Text gives you a familiar word-processor experience; your notes are stored as Markdown internally, so you can switch freely.
zKPnote supports GitHub Flavored Markdown including headings, lists, code blocks, tables, and more
Toggle between Edit and Preview mode using the view toggle in the toolbar
Toggle dark/light theme for the editor by clicking the sun/moon icon in the toolbar. Your preference is saved automatically.
Notes auto-save as you type

Proving a Note

zKPnote lets you prove you were the first person to create a piece of content — directly on the Solana blockchain.

Open the note you want to prove
Click the Prove button (purple shield icon) in the editor toolbar
zKPnote computes a SHA-256 hash of your note and registers it on Solana in a single transaction
Once confirmed, the shield icon turns green to indicate the note is proved
A banner appears at the top of the note with a link to the transaction on Solana Explorer

That's it. Your note's content fingerprint is now permanently recorded on-chain with a timestamp. If anyone ever questions who wrote it first, the blockchain has your receipt.

Cost: Each proof requires a small SOL transaction fee (fractions of a cent on mainnet).

Note Icons & Legend

Every note in the sidebar shows at least one icon before its title so you can see its status at a glance. A note can have up to two icons — one for its local status and one for its share status. Hover any icon in the app to see its meaning, or click Legend above the file tree for an in-app cheat sheet.

Status icons (always present — exactly one):

Padlock (dim white) — Local & private. The note has never left your device. It is encrypted locally and has no on-chain proof.
Shield (emerald green) — Proved on Solana. A SHA-256 hash of the note content is timestamped on-chain, giving you verifiable proof of authorship.

Share icons (optional — shown only if the note has been shared):

Globe (dim sky blue) — Shared publicly. Anyone with the share link can read the note, no wallet needed.
Eye (sky blue) — Shared with a standard agreement. Readers must connect a wallet and sign an on-chain "view agreement" before they can read the note.
Document with checkmark (amber) — Shared with an NDA. Readers must submit their name and sign an on-chain NDA contract, and you (the owner) must approve them before they can read the note.

Examples of combined icons:

Shield + NDA document — You proved the note on Solana, then shared it under NDA. Anyone who reads it has signed a binding on-chain agreement, and the blockchain has a timestamped proof that you wrote it first.
Shield + eye — Proved note shared with a standard view agreement.
Padlock alone — Pure private draft, no proof, no share. Safest state.

Only the highest-privilege share level is shown. If you share the same note first as public and then upgrade it to NDA, you'll see the NDA icon.

Organizing with Folders

Click the folder icon in the sidebar to create folders
Drag and drop notes between folders
Folders support nesting (folders within folders)
Right-click a folder to rename or delete it

Your Wallet

The wallet bar at the top shows your:

Solana address (click to copy)
SOL balance (auto-refreshes)
Send/Receive buttons for SOL transfers

If you're on a test network, the Airdrop button gives you free test SOL.

Syncing

zKPnote automatically syncs your encrypted vault to the cloud. You can also:

Manual sync: Click the sync button in the sidebar

Sync pushes your encrypted notes to Supabase so they're available across devices. Your actual note content is never readable by the server — only encrypted blobs are stored.

To prove individual notes on-chain, use the Prove button in the editor toolbar.

Locking Your Vault

Click Lock in the sidebar to clear all data from memory. You'll need your seed phrase (or Phantom wallet) to unlock again.

Backup & Restore

Export: Sidebar > Export — downloads an encrypted JSON file, or export individual notes as .md Markdown files.
Multi-select export: Click Select at the top of the sidebar, check the notes you want (Cmd-click or Shift-click for ranges), then Export .md — downloads a single .zip of markdown files.
Import: Sidebar > Import — restores from a previously exported JSON file. You can also drag .md / .docx / .pdf / .html / .txt files onto the sidebar to import as new notes.

Your backup file is encrypted with your key. Without your seed phrase, the backup is unreadable.

Tabs

Open multiple notes at once. Each appears as a tab above the editor. Drag to reorder. Middle-click or ⌘W closes. ⌘⇧T reopens the last closed tab. ⌘1…⌘9 jumps by index.

Find in Note

Press ⌘F while editing to open the find overlay. All matches highlight yellow; the active one is orange with a ring. Enter cycles forward, Shift+Enter back, Esc closes.

Wikilinks & Backlinks

Type [[ to start a wikilink. An autocomplete dropdown shows matching note titles — Enter or Tab inserts. In the rendered preview, hover any [[link]] for a 280ms popover with the target's title, tags, and first 400 characters. Click to jump.

The Backlinks panel below the editor shows every note that links to the current one (via [[wikilink]]), plus every outgoing link. Both work in Markdown and Rich Text modes.

History

Click the clock icon in the editor toolbar. zKPnote auto-saves a revision every 10 seconds while you edit, keeping the last 50 per note. View any revision inline, restore with confirm. History stays on your device — never synced.

Inline Images

Paste an image (⌘V) into the editor or click the image button in the toolbar. The image saves as an encrypted attachment in your vault and the markdown gets a short ![image](zkp-attach:<id>) reference instead of a long base64 string. Works in both Markdown and Rich Text modes.

Focus Mode & Quick Capture

Focus mode (⌘.) collapses sidebar, status bar, and tabs. Esc or Mode ▾ → Default to restore.
Typewriter mode (⌥⌘T) keeps your caret centered as you scroll.
Quick capture (⌘⇧N) — modal for dumping a thought without leaving your current note. ⌘⏎ saves.

Command Palette

Press ⌘K anywhere to open a unified launcher. Type to search notes by title or tag. Lists actions: New note, Quick capture, Prove on Solana, Sync vault, Toggle focus, Show shortcuts. Arrow keys navigate, Enter runs.

Settings

Press ⌘⇧, to open settings. Configure theme (follow system / dark / light), auto-sync delay, network info, export vault, lock vault. Includes a quick reference for all keyboard shortcuts.

Mobile

zKPnote works on phone browsers. The wallet bar and Send/Sell buttons hide automatically to keep the interface clean. Open the sidebar via the hamburger button.

Keyboard Shortcuts

Press ⌘/ anytime to see this list inside the app.

Shortcut	Action
⌘K	Command palette
⌘/	Show all shortcuts
⌘⇧N	Quick capture
⌘N	New note
⌘F	Find in note
⌘.	Focus mode
⌥⌘T	Typewriter mode
⌘B	Toggle sidebar
⌘⇧G	Toggle knowledge graph
⌘⇧,	Settings
⌘⏎ (in editor)	Prove on Solana
⌘⇧S	Sync vault now
⌘W	Close active tab
⌘⇧T	Reopen closed tab
⌘1…⌘9	Jump to tab
`[[` + type	Wikilink autocomplete