vtimestamp

Decentralized document timestamping on the Verus blockchain. Prove any document existed at a specific point in time — without uploading it anywhere.

Live App · Verify a Timestamp · How It Works · Compare

Status: Alpha MVP — functional on mainnet and testnet. Feedback and contributions welcome.

What Is vtimestamp?

vtimestamp creates cryptographic proof that a document existed at a specific point in time. Your browser computes a SHA-256 hash of your file locally — the document never leaves your device, is never uploaded, and is never stored anywhere. Only the hash is published to the Verus blockchain, permanently tied to your VerusID.

The result is a timestamp that:

• Can't be backdated — the block time is set by blockchain consensus
• Can't be altered — each identity update is immutable on-chain
• Can't be deleted — blockchain data is append-only and permanent
• Can be verified by anyone — no account, no login, no trust required

Your proof lives on the blockchain. If vtimestamp disappears tomorrow, your timestamps are still there and still verifiable by anyone running a Verus node.

Why This Matters

Timestamping proves one thing: this data existed before this moment.

• Intellectual property — prove you had an idea, design, or manuscript before a specific date
• Legal documents — establish when a contract, agreement, or notice was created
• Research data — record when experimental results or datasets were produced
• Creative work — prove authorship timing for music, art, code, or writing
• Compliance — demonstrate that records existed at required times

Traditional timestamping requires trusting a third party — a notary, a service, a company. If that party disappears, your proof disappears. vtimestamp removes the middleman.

How It Works

1. Hash Your Document

Your browser computes a SHA-256 hash using the Web Crypto API. This happens entirely on your device. The document is never transmitted.

2. Add Metadata

You provide a title (required) and optionally a description. Filename and file size are captured automatically for file uploads.

3. Sign with Your VerusID

vtimestamp constructs an identity update request containing your hash and metadata as VDXF data. You approve it in Verus Mobile — your wallet builds and broadcasts the updateidentity transaction.

4. Blockchain Confirmation

Once included in a block, your timestamp is permanent. The block provides the height, hash, consensus-verified time, and transaction ID. These values are immutable.

Verification

Anyone can verify — no login needed. Upload the same file (or paste the same text), enter the identity name, and the system searches the identity's blockchain history for a matching hash. If found, it returns the block time, height, and transaction details.

If the document has been modified by even a single byte, the hash won't match. This is by design.

Features

• Privacy-first — documents never leave your device; only a SHA-256 hash is published
• Self-sovereign — timestamps are stored on your own VerusID, which you own and control
• Permissionless verification — anyone can verify using just the file and the identity name
• Identity-bound — proof answers both "when" and "who" (unlike Bitcoin OP_RETURN)
• Structured metadata — title, description, filename, and file size stored on-chain alongside the hash
• Immutable — once in a block, the timestamp cannot be changed, backdated, or deleted
• Free to verify — verification requires no account and costs nothing
• Database-free — all data lives on the blockchain; no central server to compromise or maintain

Comparison with Alternatives

Compared to Other Blockchains

The key difference: on other chains, identity is an add-on. On Verus, identity is the foundation. Your timestamp is stored on your VerusID — a self-sovereign identity with a human-readable name. Verification looks up alice@, not 0x7a3b....

On-Chain Data Structure

Timestamps are stored under the proof.basic VDXF key on your VerusID's contentmultimap. Each timestamp is a group of DataDescriptor entries:

Block time and height are derived from the blockchain — they are not stored in the data but come from the block that contains the transaction.

Quick Start

Requirements

• Node.js >= 20.0.0
• Yarn
• A VerusID (for creating timestamps — verification requires nothing)

Development

git clone https://github.com/vdappdev2/vtimestamp.git
cd vtimestamp
cp .env.example .env    # Configure RPC endpoints and service identity
yarn install
yarn dev

Open http://localhost:5173.

Environment Variables

See .env.example for required configuration:

• Verus RPC endpoint (mainnet or testnet)
• Service identity for signing login challenges

Verify from the Command Line

You don't need vtimestamp (or any website) to verify a timestamp. Using the Verus CLI directly:

# 1. Get the identity's full history
./verus getidentityhistory "alice@" 0 999999999 0 999999999

# 2. Look for contentmultimap entries with the proof.basic VDXF key
# 3. Find the .sha256 label and compare with your document's hash
# 4. Get the block time from the blockhash in the history entry
./verus getblock "<blockhash>"

The proof is on the public blockchain. Any Verus node can verify it.

Tech Stack

• Frontend: SvelteKit + Svelte 5 + TypeScript
• Styling: Tailwind CSS
• Blockchain: Verus (verus-typescript-primitives, verusid-ts-client)
• Hashing: Web Crypto API (SHA-256, client-side)
• Deployment: Vercel

Privacy

The hash is a one-way function. Given the hash, no one can determine whether the original was a PDF, a photo, a text file, or a novel.

Contributing

Issues and pull requests welcome. See the issues page for open items.

To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes
4. Push to the branch and open a pull request

License

MIT

Built on Verus — a decentralized blockchain with native self-sovereign identity.