ThesisLock Documentation
ThesisLock anchors a SHA-256 hash of any document on the Stacks blockchain, giving you a permanent, verifiable timestamp without ever exposing the file. These guides cover the contracts, the web app, and every way to integrate verification into your own tools.
Getting Started
What ThesisLock is, how anchoring works, and how to anchor your first document in under a minute.
Getting Started Tour
The interactive onboarding tour that walks first-time visitors through anchoring, history, search, groups, stats, and more, and how to restart it any time.
Command Palette
Open the command palette with Ctrl+K (Cmd+K on macOS) to jump to any page or run a common action with fuzzy search and the keyboard.
Navigation
Find your way around with breadcrumb trails, a context-aware back button, and a recently visited pages menu.
Empty States
What you see when a page has no data yet: a clear explanation of what belongs there and a button toward the next step.
Confirmation Dialogs
How destructive and irreversible actions ask first, the danger, warning, and info variants, and the useConfirm hook.
Animations
The fade-in, staggered list, and count-up animations, the micro-interactions, and how they respect reduced motion.
Favorites
Star hashes, wallets, groups, and pages for quick access from the favorites bar and the favorites page.
Hash Matching
File previews with thumbnails, and the hash matcher that confirms a file matches an anchored hash for integrity checks.
Input Validation
How fields validate hashes, addresses, labels, and names with clear errors, character counters, auto-formatting, and matching API checks.
Error Handling
How missing routes, invalid parameters, runtime errors, rate limits, and offline use each get a consistent, helpful page that guides you back.
Contracts
The five Clarity contracts, their mainnet addresses, function signatures, and direct Hiro API calls.
Contract Explorer
Browse all five contracts inside the app: functions grouped by access, maps and data variables, recent on-chain calls, an architecture diagram, and an interactive read-only function tester.
Web App Guide
Anchoring single files and batches, using groups, verifying, bulk checks, history export, and certificates.
Anchor Templates
Structured label formats for papers, legal documents, code releases, datasets, and certificates, plus the label encoding.
Activity Log
A unified per-wallet timeline of every contract interaction, with category filters and infinite scroll.
Live Updates
How the real-time event ticker and auto-updating feed, stats, and explorer work, what they poll, and how to pause or resume live updates.
Notifications
The unified notification center: how transaction, watchlist, protocol, and group events are aggregated, plus browser push, sound alerts, and per-type preferences.
Watchlist
Save document hashes, wallets, and groups you want to monitor, then track their on-chain status and new anchors in one place, with update badges across the app.
Collections
Organize anchored documents into named, browser-local collections. Create folders, add anchors by hash, file, or from your wallet, then share a collection as a link or import one someone sent you.
Tags
Add flexible tags to any anchor and filter by tag across history, feed, and search. Auto-suggestions from templates, a tag cloud, usage stats, and rename, merge, recolor, and delete, all stored in your browser.
Wallet Profiles
Public per-wallet profile pages with anchoring stats, recent anchors, document types, a JSON API, and an embeddable badge.
Anchor Comparison
Compare two anchored documents side by side: which was anchored first, the estimated time gap, and how their owner, label, source, and metadata differ, with shareable comparison links.
API Reference
The JSON REST API for verification, search, stats, badges, cards, and health.
SDK Guide
Install the TypeScript SDK, create a client, and call every verification and lookup method.
CLI Guide
Verify, hash, search, and check status from the terminal or a CI pipeline.
GitHub Action
Gate any CI pipeline on a document being anchored on Stacks, with inputs, outputs, and example workflows.
Verification Reports
Generate formal, multi-document verification reports proving a set of hashes were anchored on Stacks, exportable as HTML, JSON, or CSV.
API Keys
Create and manage scoped API keys in the developer portal, how they are stored, and what they are for.
Integration Guides
Copy-ready examples for verifying anchors from JavaScript, Python, cURL, GitHub Actions, and any CI/CD pipeline.
Performance Monitoring
In-browser Web Vitals, page load, and API response metrics with a local dashboard and a debug overlay, for spotting bottlenecks without any external analytics.
Audit Trail
A tamper-evident, browser-local record of every action, with SHA-256 integrity verification, filtering, and exportable JSON, CSV, and printable HTML compliance reports for academic and legal chain-of-custody.
System Status
The public status page: live health of all five contracts, the API endpoints, and the Hiro and Stacks dependencies, with response times, 24-hour uptime, incident tracking, a JSON API, and an embeddable status badge.
Calendar
Your anchoring activity as a GitHub-style contribution graph and a monthly calendar, with current and longest streaks, per-day anchor detail, and report generation for any day.
Feeds
Subscribe to protocol events in any reader: RSS 2.0, Atom 1.0, and JSON Feed endpoints, filterable by contract and wallet, with autodiscovery built in.
Webhooks
Subscribe to protocol events programmatically: the event types, the signed JSON payload format, HMAC-SHA256 signature verification, and the developer portal manager and tester.
Event Sync
How a Hiro Chainhook streams on-chain anchor events into a Supabase index in real time, with reorg-aware apply and rollback and a public read table.
Data Portability
Back up everything ThesisLock stores in your browser to one JSON file, restore it on another device with merge or replace, review storage usage, clear data, and control privacy and preferences from the settings page.
Sharing
Share verification results, profiles, groups, and protocol stats on X, LinkedIn, and Telegram, copy links, and let people scan an in-browser QR code to verify on mobile.
Loading States
How ThesisLock shows skeleton loaders shaped like each page's final layout while data loads, with a theme-aware shimmer that respects reduced-motion.
Changelog
Notable changes and improvements to ThesisLock, including the standardized copy interactions, truncated hash and address components, and the global clipboard toast.