@educhainmag/auth-sdk

EduChainMag Auth SDK adalah solusi identitas Web3 lengkap untuk ekosistem Cardano. SDK ini menjembatani pengguna awam melalui Social Login (Google) dan pengguna pro melalui Native Browser Wallets (Lace, Eternl, Nami, dll), dalam satu paket integrasi.

🚀 Status Proyek: SDK ini sudah tersedia di NPM dan dalam tahap Alpha/Beta. Cocok untuk pengujian dApp pada jaringan Cardano Preview/Preprod.

✨ Fitur Utama

• Hybrid Authentication: Mendukung Social Login (Google/Web3Auth) dan Dompet Browser (Lace, Eternl, Nami, dll).
• Universal Identity: Pengguna Google mendapatkan alamat wallet yang konsisten di seluruh ekosistem EduChainMag.
• Auto-Collateral: Otomatis menyiapkan Collateral (agunan) untuk interaksi Smart Contract (DEX-Ready).
• Zero-Friction UX: Fitur "Click-to-Copy" alamat wallet langsung pada komponen profil.
• Cardano Native: Kompatibel dengan standar CIP-30.
• Lazy Init: Meminimalisir konflik dengan ekstensi browser pihak ketiga.

🛠️ Instalasi

Gunakan paket manajer favorit Anda untuk menginstal SDK:

npm install @educhainmag/auth-sdk

📖 Cara Penggunaan

1. Inisialisasi

import { EduChainMagAuth } from "@educhainmag/auth-sdk";

const auth = new EduChainMagAuth({
  cardanoNetwork: "Preview", // Pilihan: "Mainnet", "Preprod", atau "Preview"
  blockfrostProjectId: "your_blockfrost_project_id" // Ambil dari blockfrost.io
});

// Jalankan inisialisasi
await auth.init();

2. Login Sosial (Google)

const { user, address, lucid } = await auth.connect();
console.log("Email:", user.email);
console.log("Wallet:", address);

3. Koneksi Dompet Browser (Lace/Eternl/dll)

// Mendapatkan daftar wallet yang terinstall
const available = auth.getAvailableWallets(); // ['lace', 'eternl']

// Menghubungkan wallet spesifik
const { address } = await auth.connectBrowserWallet("lace");

🚀 Aplikasi Demo

Kami menyediakan demo berbasis Next.js untuk melihat cara kerja SDK secara langsung: https://cardano-social-login.vercel.app/

📜 Lisensi

Proyek ini dilisensikan di bawah Apache License 2.0.