Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📜 ProofStamp

Notaris Digital Berbasis Blockchain untuk Era Modern


🎯 Masalah yang Dipecahkan

Individu dan UMKM sering membutuhkan bukti bahwa sebuah dokumen:

  • ✅ Ada pada waktu tertentu (timestamp)
  • ✅ Tidak pernah dimodifikasi (integritas)
  • ✅ Dapat diverifikasi secara independen (tanpa perantara)

Solusi tradisional seperti notaris konvensional:

  • ❌ Mahal
  • ❌ Tersentralisasi (bergantung pada satu pihak)
  • ❌ Rumit secara administratif
  • ❌ Tidak terjangkau oleh pelaku usaha kecil, freelancer, atau mahasiswa

💡 Solusi: ProofStamp

ProofStamp menawarkan cara sederhana untuk mencap dokumen Anda di blockchain:

  1. Upload dokumen (PDF, gambar, atau file lainnya)
  2. Hash kriptografis dihitung secara otomatis (Keccak-256)
  3. Stamp hash tersebut ke blockchain dengan satu klik
  4. Verifikasi kapan saja dengan mengupload ulang dokumen yang sama

🔑 Prinsip Utama: Blockchain hanya digunakan sebagai trust layer (jam netral permanen), bukan sebagai database. Semua logika dan UX tetap off-chain.


🏗️ Arsitektur Sistem

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    Frontend     │────▶│     Backend     │     │   Blockchain    │
│   (Next.js)     │     │   (Express.js)  │     │  (Base Sepolia) │
│                 │     │                 │     │                 │
│ • Upload file   │     │ • Hitung hash   │     │ • Simpan hash   │
│ • Tampilkan UI  │     │ • API endpoint  │     │ • Timestamp     │
│ • Connect wallet│     │                 │     │ • Event logs    │
└─────────────────┘     └─────────────────┘     └─────────────────┘
         │                                               │
         └───────────── User signs tx ──────────────────┘

Alur Data:

  1. User upload file ke Frontend
  2. Frontend kirim file ke Backend untuk dihitung hash-nya
  3. Backend mengembalikan hash (Keccak-256)
  4. User menandatangani transaksi via wallet (MetaMask/dll)
  5. Transaksi dikirim ke Smart Contract di blockchain
  6. Hash + timestamp + alamat pemilik disimpan secara permanen

🛠️ Tech Stack

Komponen Teknologi
Frontend Next.js 15, React, TypeScript
Backend Express.js, Node.js
Blockchain Base Sepolia (EVM Testnet)
Smart Contract Solidity 0.8.x, Foundry
Wallet RainbowKit + Wagmi
Hashing Keccak-256 (ethers.js)

📁 Struktur Proyek

ProofStamp/
├── contracts/          # Smart contract (Foundry)
│   ├── src/
│   │   └── ProofStamp.sol
│   ├── test/
│   │   └── ProofStamp.t.sol
│   ├── script/
│   │   └── Deploy.s.sol
│   └── .env            # Private key untuk deployment
│
├── backend/            # API server
│   ├── index.js
│   └── .env
│
├── frontend/           # Web application
│   ├── app/
│   │   ├── page.tsx           # Halaman utama (Stamp)
│   │   ├── verify/page.tsx    # Halaman verifikasi
│   │   ├── providers.tsx      # RainbowKit setup
│   │   └── contract_config.json
│   └── components/
│       ├── Header.tsx
│       └── FileUpload.tsx
│
└── README.md

🚀 Cara Menjalankan

1. Clone & Install Dependencies

# Clone repo
git clone <repository-url>
cd ProofStamp

# Install dependencies
cd contracts && forge install
cd ../backend && npm install
cd ../frontend && npm install

2. Konfigurasi Environment

contracts/.env:

PRIVATE_KEY=0x<your_private_key>
ETHERSCAN_API_KEY=<your_basescan_api_key>
RPC_URL=https://sepolia.base.org

backend/.env:

PORT=3001

3. Deploy Smart Contract

cd contracts
forge script script/Deploy.s.sol --rpc-url https://sepolia.base.org --broadcast

Alamat kontrak akan otomatis disimpan ke frontend/app/contract_config.json.

4. Jalankan Aplikasi

# Terminal 1: Backend
cd backend && node index.js

# Terminal 2: Frontend
cd frontend && npm run dev

Buka browser: http://localhost:3000


📋 Smart Contract

ProofStamp.sol

// Mapping: hash → timestamp (0 = belum terdaftar)
mapping(bytes32 => uint256) public timestamps;

// Mapping: hash → pemilik (yang pertama mendaftarkan)
mapping(bytes32 => address) public owners;

// Event yang dipancarkan saat dokumen dicap
event DocumentStamped(bytes32 indexed docHash, address indexed owner, uint256 timestamp);

// Fungsi untuk mendaftarkan hash
function register(bytes32 docHash) external;

// Fungsi untuk memverifikasi hash
function verify(bytes32 docHash) external view returns (bool registered, uint256 timestamp, address owner);

Karakteristik:

  • ✅ Tidak ada loop (gas efficient)
  • ✅ Tidak ada admin privileges
  • ✅ Tidak upgradeable (immutable)
  • ✅ Dapat diaudit oleh siapa saja

🔗 Contract Deployment

Network Address
Base Sepolia 0xA835B3CCc622Deb90f467908d649e495e0f0D794

Explorer: BaseScan


✅ Kriteria Sukses MVP

Proyek ini dianggap sukses jika:

  1. ✅ Dokumen yang diupload hari ini dapat diverifikasi tahun depan
  2. ✅ Verifikasi bisa dilakukan tanpa mempercayai backend
  3. ✅ Sistem dapat dipahami oleh pengguna non-teknis
  4. ✅ Komponen blockchain tidak terlihat tapi esensial

⛔ Yang TIDAK Termasuk dalam MVP

  • ❌ Tokenomics / Token sendiri
  • ❌ DAO / Governance
  • ❌ AI / Machine Learning
  • ❌ Penyimpanan file on-chain (IPFS)
  • ❌ Sistem autentikasi kompleks
  • ❌ Klaim legal (hanya "proof of existence")

🔮 Pengembangan Masa Depan

Fitur-fitur ini out of scope untuk MVP, namun dapat dikembangkan:

  • 📦 Integrasi IPFS untuk penyimpanan file
  • 💳 Paket berbayar untuk enterprise
  • ⚖️ Integrasi legal (e-signature)
  • 🌐 Dukungan multi-chain
  • 🏢 Compliance untuk enterprise

📄 Lisensi

MIT License


👨‍💻 Dibuat dengan ❤️

Dibangun di atas Base • Diamankan oleh Kriptografi

Releases

Packages

Contributors

Languages