Vetkeys Motoko DApp

1. Project Definition

What is this project?

Ini adalah DApp (Aplikasi Terdesentralisasi) full-stack yang berjalan di platform Internet Computer (ICP). Proyek ini dibuat menggunakan template dari ICP Ninja.

Fokus dari template ini kemungkinan adalah untuk mendemonstrasikan penggunaan vetKeys (Verifiable-Encrypted Threshold Keys), sebuah fitur kriptografi canggih di ICP, yang ditulis dalam bahasa Motoko.

Context: Migration from ICP Ninja

Proyek yang di-deploy melalui ICP Ninja bersifat sementara (biasanya 20 menit). Repositori ini berisi kode sumber yang telah diunduh agar dapat dilanjutkan pengembangannya secara lokal dan di-deploy secara permanen.

Dokumentasi ini akan memandu Anda melalui proses instalasi dan deployment lokal.

2. Tech Stack 🛠️

• Blockchain: Internet Computer (ICP)
• Backend Canister:
  • Bahasa: Motoko
  • Package Manager: Mops (diindikasikan oleh BUILD.md)
• Frontend Canister: HTML, CSS, JavaScript
• Development Tooling:
  • SDK: DFINITY Canister SDK (DFX)
  • Lingkungan: Node.js

3. Project Structure

Directory Structure

Struktur proyek ini mengikuti standar DApp ICP:

4. Local Setup & Installation 🚀

Initial Installation

Untuk menjalankan dan melanjutkan pengembangan proyek ini di komputer Anda, ikuti langkah-langkah berikut.

1. Clone Repositori

   git clone [https://github.com/Fortotest/vetkeys-motoko.git](https://github.com/Fortotest/vetkeys-motoko.git)
   cd vetkeys-motoko
   

2. Install DFX SDK Jika Anda belum memilikinya, install DFINITY Canister SDK (DFX).

   sh -ci "$(curl -fsSL [https://internetcomputer.org/install.sh](https://internetcomputer.org/install.sh))"
   

   Catatan: Di Windows, disarankan menggunakan WSL2.

3. Install Node.js Pastikan Anda memiliki Node.js (versi LTS direkomendasikan) terinstal, karena DFX membutuhkannya.

4. Install Mops (Motoko Package Manager) Proyek ini mungkin memerlukan dependensi Motoko. Install Mops untuk mengelolanya.

   npm install -g ic-mops
   

5. Running the DApp Locally

Local Environment Setup

Langkah-langkah ini akan menjalankan aplikasi di komputer Anda.

1. Buat Identitas Lokal (Sangat Direkomendasikan) Daripada menggunakan identitas default, buat identitas pengembangan baru yang aman.

   # Mulai replika lokal jika belum berjalan
   dfx start --background
       
   # Buat identitas baru (ganti NAMA_ANDA)
   dfx identity new NAMA_ANDA
   
   # Gunakan identitas baru tersebut
   dfx identity use NAMA_ANDA
   

   PENTING: Simpan seed phrase yang muncul di tempat yang aman!

2. Install Dependensi Node.js Jika Anda belum melakukannya, jalankan:

   npm install
   

3. Deploy Canister Secara Lokal Perintah ini akan membangun dan men-deploy semua canister (backend & frontend) ke replika lokal Anda.

   dfx deploy
   

4. Akses Frontend Setelah deploy berhasil, DFX akan memberikan URL untuk canister frontend Anda. Buka URL tersebut (biasanya http://127.0.0.1:4943/?canisterId=...) di browser Anda.

6. Mainnet Deployment

Acquiring Cycles

Deploy ke mainnet (jaringan publik ICP) membutuhkan "Cycles" untuk membayar komputasi dan penyimpanan.

• Anda bisa mendapatkan cycles gratis dari ICP Faucet untuk developer.
• Atau, Anda dapat mengonversi token ICP menjadi Cycles.

Deploying to 'ic' (Mainnet)

Setelah Anda memiliki Cycles di principal identity Anda, jalankan:

dfx deploy --network ic

7. Credits 👤

Builder

Rizky Fadil