📘 KnurFi — The Context Layer for On-Chain Finance

KnurFi is a multi-chain treasury dashboard that lets teams attach encrypted, permanent context to on-chain transactions, payouts, and bridges.

🚀 The Problem

Blockchain transactions are cryptic. Months later, teams forget why 0.05 ETH was sent to 0x7a...9b. Existing tools are either centralized (data loss risk) or fully public (privacy risk).

💡 The Solution

KnurFi injects a Context Layer directly into block explorer + dashboard workflows.

• Write: Add notes to any Sepolia transaction (Chrome extension).
• Encrypt: Notes are AES-encrypted with a wallet signature (client-side).
• Store: Encrypted data is stored on-chain (Ethereum Sepolia).
• Manage: Ledger, batch payouts, ENS metadata, and bridge memos in one place.

✨ Key Features

• Profile + ENS (Sepolia): Resolve ENS and read/write com.knurfi.metadata.
• Ledger (Sepolia): Encrypted note history with CSV export.
• Payouts (Arc Testnet): Batch USDC payouts with memo hash logging.
• Bridge (LI.FI): Embedded widget with cross-chain memo capture.
• Chrome Extension: Write notes directly on Sepolia Etherscan tx pages.

🧭 Hackathon Scope

• Tracks used: ENS, Arc, LI.FI
• Uniswap track: intentionally not pursued (out of scope)

🛠️ Tech Stack

• Frontend: HTML/JS, Tailwind (CDN), Chrome Extension Manifest V3
• Blockchain: Ethereum Sepolia (ledger + ENS), Arc Testnet (payouts)
• Smart Contracts: Solidity (Hardhat)
• Libraries: Ethers.js, Crypto-JS

⚙️ How to Run Locally

1) Smart Contracts

cd contracts-backend
npm install
npx hardhat run scripts/deploy.js --network sepolia

Optional: deploy Arc batch payouts

npx hardhat run scripts/deploy_arc_batch.js --network arcTestnet

2) Extension

Open Chrome and go to chrome://extensions.

Enable "Developer Mode" (top right).

Click "Load Unpacked" and select the extension folder.

Supported explorers:

• Sepolia Etherscan: https://sepolia.etherscan.io/tx/*
• ArcScan: https://testnet.arcscan.app/tx/* (notes disabled, read-only)

3) Dashboard

Open docs/dashboard.html in your browser (via Live Server) or use the live link below.

✅ Smoke Tests

node tests/smoke.test.js

🔗 Links

• Live Demo: https://zh0403.github.io/KnurFi/dashboard.html
• Demo Video: (add link)
• Sepolia Contract: 0x3489864DC6ea7440FA54472662A50Bb26BBDD13F