Documentation

How It Works

iStampit uses the OpenTimestamps protocol to create cryptographic proofs of when your files existed. These proofs are anchored to the Bitcoin blockchain, providing immutable timestamps that anyone can verify.

Hash-Only Verification

For sensitive files, you can verify using only the SHA-256 hash instead of uploading the full file.

Web Interface (Recommended)

iStampit provides a free, easy-to-use web interface for creating timestamps:

API Integration

For developers integrating timestamping into applications:

{
  "hash": "64-character-hex-sha256"
}

Command Line Tools

For power users and automation workflows:

pip install istampit-cli
istampit stamp --hash <sha256> --out receipt.ots

Automated Workflows

Use CI/CD workflows for automated stamping of project milestones.

# Example: Daily stamping workflow
name: Stamp Innovation
on:
  schedule:
    - cron: '0 12 * * *'

jobs:
  stamp:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Create timestamp
        run: |
          git rev-parse HEAD > current-commit.txt
          # Using iStampit API
          HASH=$(sha256sum current-commit.txt | cut -d' ' -f1)
          curl -X POST https://api.istampit.io/stamp \
            -H "Content-Type: application/json" \
            -d "{\"hash\":\"$HASH\"}" > receipt.json

The Public Ledger is a public registry of timestamped innovations.

Data Structure

{
  "id": "unique-identifier",
  "title": "Innovation Title",
  "hash": "sha256-hash",
  "timestamp": "2024-01-15T10:30:00Z",
  "status": "confirmed|pending",
  "txid": "bitcoin-txid",
  "blockHeight": 825000,
  "otsFile": "receipt.ots"
}

Basic Setup

Add timestamp verification to any website with a script tag and container div.

<script src="https://istampit.io/widget/v1.js" async></script>

<!-- Inline Mode -->
<div data-istampit-verify data-mode="inline" data-theme="light"></div>

<!-- Modal Mode -->
<div data-istampit-verify data-mode="modal" data-theme="dark">
  <button>🔍 Verify with iStampit</button>
</div>

Configuration

Event Handling

window.addEventListener('istampit-verified', (e) => {
  const {status, txid, blockHeight, hash} = e.detail;
  console.log('Result:', status, txid, blockHeight, hash);
});

Programmatic Control

const widget = window.iStampit.createWidget({
  mode: 'modal',
  theme: 'light'
});
widget.openModal();

Privacy Guarantees

Trust Model