🔗 KarsaChain

The Eternal Vault. Store your digital legacy on the Blockchain.

---

🛡️ About

KarsaChain is a Web3 decentralized application (dApp) designed to preserve digital assets—images, documents, and blueprints—permanently.

Unlike traditional cloud storage, KarsaChain utilizes Blockchain technology to ensure your data is:

• 🔒 Immutable (Cannot be altered or deleted)
• 🌍 Censorship-Resistant (No central authority control)
• 💎 Transparent (Verifiable on the Sepolia Network)

Every upload is secured via IPFS for storage and anchored on Ethereum (Sepolia) for proof of ownership.

---

✨ Features

Feature	Description
💼 Wallet Connection	Seamless login via MetaMask/Thirdweb
⛓️ On-Chain Storage	Smart Contract records ownership & metadata
📡 IPFS Integration	Decentralized file hosting (Zero downtime)
🌐 Public Vaults	Dynamic profiles (/[address]) to showcase assets
🌍 Multi-language	Native support for English & Indonesian (ID/EN)

---

🛠️ Tech Stack

const stack = {
  framework: "Next.js 16 (App Router)",
  blockchain: "Solidity (Ethereum Sepolia)",
  web3_sdk: "Thirdweb SDK",
  storage: "IPFS (InterPlanetary File System)",
  styling: "Tailwind CSS v4",
  state: "Zustand",
  deployment: "Vercel",
};

---

📦 Project Structure

karsachain
 ┣ 📂 app
 ┃ ┣ 📂 [address]        # Dynamic Public Vault Profile
 ┃ ┣ 📂 dashboard        # Private User Workspace (Upload)
 ┃ ┣ 📜 layout.tsx       # Root layout & Thirdweb Provider
 ┃ ┗ 📜 page.tsx         # Landing Page
 ┣ 📂 components
 ┃ ┣ 📜 Gallery.tsx      # Fetches & displays user assets
 ┃ ┣ 📜 Navbar.tsx       # Navigation & Wallet Connect
 ┃ ┗ 📜 UploadForm.tsx   # Asset Minting Logic
 ┣ 📂 lib
 ┃ ┣ 📜 translations.ts  # i18n Dictionary (ID/EN)
 ┃ ┗ 📜 store.ts         # Global State Management
 ┗ 📜 contract.sol       # Solidity Smart Contract

---

⛓️ Architecture

_{How data travels from your device to eternity}

graph TD
  User[User] -->|Connect Wallet| DApp[KarsaChain Web]
  DApp -->|Upload File| IPFS[IPFS Storage]
  IPFS -->|Return Hash (CID)| DApp
  DApp -->|Mint Transaction| Contract[Smart Contract on Sepolia]
  Contract -->|Verify Block| Blockchain[Ethereum Network]
  Blockchain -->|Permanent Record| PublicVault[Public Profile]

Loading

• 🔑 Authentication: handled by Thirdweb.
• 📦 Storage: Heavy data (images/docs) goes to IPFS.
• 📝 Ledger: Only the hash and metadata are stored on-chain to optimize gas costs.

---

🧪 Deployment

This project is deployed using Vercel with automatic CI/CD pipelines.

1. Smart Contract: Deployed on Sepolia Testnet via Thirdweb.
2. Frontend: Next.js App Router deployed on Vercel Edge Network.
3. Environment: Client ID secured via Allowed Domains.

---

_{Built for the future. Preserved for history.}