⬡ OPNet Insurance Protocol

First Fully On-Chain DeFi Insurance Protocol on OPNet (Bitcoin L1)

---

OPNet Insurance Protocol adalah protokol asuransi DeFi pertama yang berjalan sepenuhnya di atas Bitcoin Layer 1 menggunakan infrastruktur OPNet — tanpa bridge, tanpa wrapped token, tanpa backend terpusat. Semua logika kontrak, state, dan tata kelola tersimpan on-chain di Bitcoin L1.

---

📋 Daftar Isi

• Gambaran Umum
• Fitur Utama
• Arsitektur Protokol
• Smart Contracts
• Tokenomics
• Keamanan
• Instalasi & Penggunaan
• Wallet Integration
• MCP Integration
• Struktur Proyek
• Halaman Aplikasi
• Formula Premi
• Governance
• Roadmap
• Kontribusi
• Lisensi

---

🌐 Gambaran Umum

OPNet Insurance Protocol memungkinkan pengguna untuk:

• 🛡️ Membeli polis asuransi terhadap risiko smart contract (hack, rug pull, oracle manipulation, depeg, validator slashing)
• 💧 Menyediakan likuiditas ke pool asuransi dan mendapatkan yield dari distribusi premi
• 📬 Mengajukan klaim melalui tiga jalur resolusi: Oracle, verifikasi on-chain, atau voting governance
• ⚖️ Berpartisipasi dalam governance menggunakan token SHIELD untuk mempengaruhi parameter protokol

Seluruh aplikasi terdiri dari satu file HTML tunggal (index.html) — tidak ada framework, tidak ada server, tidak ada build tools. Cukup buka di browser.

Teknologi Stack
───────────────
Smart Contracts : AssemblyScript → WebAssembly → Bitcoin L1 (OPNet)
Token Standard  : OP_20 (OPNet native)
Runtime         : @btc-vision/btc-runtime
Frontend        : Pure HTML + Vanilla JS + CSS (zero dependencies)
Wallet          : OP_WALLET extension (window.opnet / window.unisat)
MCP Reference   : https://ai.opnet.org/mcp

---

✨ Fitur Utama

Fitur	Deskripsi
🏦 Insurance Pool	Deposit & withdraw modal dengan capital lock 144 blok
📜 Policy NFT	Setiap polis adalah aset on-chain unik yang bisa ditransfer
🔄 Claim Resolution	3 jalur: Oracle / On-chain Verification / Governance Vote
⚖️ Governance	Proposal & voting berbasis SHIELD token, quorum 10%
🔐 Circuit Breaker	Emergency pause otomatis saat pool insolvent
🚫 Double-Claim Guard	Proteksi klaim ganda per polis secara on-chain
🗡️ Slashing	Pemilih jahat dan klaim fraudulent dikenakan penalti
📊 Live Dashboard	Real-time pool metrics, health ring, activity log
📱 Fully Responsive	Mobile (bottom nav), tablet (drawer), desktop (topbar nav)
🔌 OP_WALLET Native	Integrasi langsung dengan window.opnet / window.unisat

---

🏗️ Arsitektur Protokol

                    ┌──────────────────────────────────┐
                    │         Bitcoin L1 (OPNet)        │
                    └──────────────────────────────────┘
                                     │
           ┌─────────────────────────┼─────────────────────────┐
           │                         │                         │
    ┌──────▼──────┐          ┌───────▼───────┐        ┌───────▼───────┐
    │InsurancePool│          │   ClaimModule │        │  Governance   │
    │─────────────│          │───────────────│        │───────────────│
    │depositCapital│◄────────│ submitClaim   │        │createProposal │
    │withdrawCapital│         │ oracleVerify  │        │castVote       │
    │buyPolicy    │──────────►│ castClaimVote │        │executeProposal│
    │calcPremium  │          │ finalizeVote  │        │slashVoter     │
    │getPoolHealth│          │ processFraud  │        │treasuryAlloc  │
    │processClaim │◄─────────│ executePayout │        └───────┬───────┘
    └──────┬──────┘          └───────────────┘                │
           │                                                   │
    ┌──────▼──────┐                                   ┌───────▼───────┐
    │  PolicyNFT  │                                   │ ShieldToken   │
    │─────────────│                                   │───────────────│
    │ mintPolicy  │                                   │ OP_20 Standard│
    │ transferPolicy│                                 │ delegate()    │
    │ getPolicy   │                                   │ getVotingPower│
    │ setClaimStatus│                                 │ burnFrom()    │
    └─────────────┘                                   └───────────────┘

Alur Dana

User membayar premi
        │
        ▼
InsurancePool.buyPolicy()
        │
        ├── 70% ──► Liquidity Providers (distribusi proporsional)
        ├── 20% ──► Treasury (governance-controlled)
        └── 10% ──► Claim Validators

---

📄 Smart Contracts

Semua kontrak ditulis dalam AssemblyScript dan dikompilasi ke WebAssembly untuk deployment di Bitcoin L1 via OPNet.

Generated using OPNet MCP Smart Contract Reference: https://ai.opnet.org/mcp

Contract Addresses (OPNet P2OP Format)

Contract	Address (P2OP)	Fungsi
InsurancePool	op1shield7pool8capital9defi0insurance1btc2opnet3	Core pool, premium, payout
PolicyNFT	op1policy4nft5asset6unique7onchain8bitcoin9l1abc	On-chain policy asset
ClaimModule	op1claim10module11dispute12resolution13opnet14btc	Claim submission & resolution
Governance	op1gov15shield16token17voting18treasury19opnet20	Proposal & voting system
ShieldToken	op1shield21token22op2023standard24governance25btc	SHIELD governance token (OP_20)

InsurancePool.ts

File utama yang mengelola seluruh likuiditas dan polis.

// Fungsi utama
depositCapital(amount: u256): u256
withdrawCapital(amount: u256): u256
buyPolicy(coverage: u256, riskType: u32, protocol: u32, duration: u32): [u256, u256]
calculatePremium(coverage: u256, riskType: u32, protocol: u32, duration: u32): u256
getPoolHealth(): [totalLiquidity, activeCoverage, reserveAmount, utilization, treasury]
processClaim(policyId: u256, claimant: Address, amount: u256, approved: bool): bool

State yang disimpan on-chain:

Storage Pointer	Variabel	Tipe
0x0001	totalLiquidity	StoredU256
0x0002	activeCoverage	StoredU256
0x0003	reserveAmount	StoredU256
0x0004	treasury	StoredU256
0x0005	circuitBreaker	StoredBoolean
0x0010+	lpBalances	AddressMap<u256>
0x0011+	lockExpiry	AddressMap<u32>

PolicyNFT.ts

Setiap polis adalah aset on-chain unik menggunakan model aset native OPNet.

// Struktur Policy (disimpan per storage pointer)
{
  coverageAmount: u256    // jumlah coverage dalam satoshi
  riskType:       u32     // 0=HACK, 1=RUG, 2=ORACLE, 3=DEPEG, 4=SLASH
  insuredProtocol:u32     // 0=DEX, 1=LENDING, 2=BRIDGE, 3=YIELD, 4=NFT, 5=CUSTOM
  startBlock:     u32     // blok saat polis dibuat
  expiryBlock:    u32     // blok saat polis kedaluwarsa
  premiumPaid:    u256    // premi yang dibayarkan
  claimStatus:    u8      // 0=NONE, 1=PENDING, 2=PAID, 3=DENIED
  transferable:   bool    // apakah polis bisa ditransfer
}

ClaimModule.ts

Mendukung tiga jalur resolusi klaim:

A) Oracle-Triggered    → Otomatis via oracle on-chain
B) On-Chain Condition  → Verifikasi langsung dari data Bitcoin L1
C) Governance Vote     → SHIELD holders memilih approve/deny

Governance.ts

// Parameter governance
VOTING_PERIOD_BLOCKS = 2016   // ~2 minggu
QUORUM_BPS           = 1000   // 10% dari total supply
PROPOSER_MIN_SHIELD  = 1000   // SHIELD minimum untuk membuat proposal
PROPOSER_BOND        = 100    // SHIELD bond (dikembalikan jika quorum tercapai)

ShieldToken.ts

Token governance berbasis standar OP_20 (analog ERC-20 di Bitcoin L1).

// Supply
Max Supply    : 21,000,000 SHIELD
Decimals      : 8 (Bitcoin standard)
Symbol        : SHIELD
Name          : OPNet Insurance Governance Token

---

💰 Tokenomics

Distribusi Premi

Setiap pembayaran premi secara otomatis didistribusikan on-chain di dalam fungsi InsurancePool.buyPolicy():

Premium yang masuk
│
├── 70% ──► Liquidity Providers
│            Dibagi proporsional berdasarkan share pool
│
├── 20% ──► Treasury
│            Dikelola via governance proposal
│
└── 10% ──► Claim Validators
             Validator yang memproses dan memverifikasi klaim

Risk Factor Multiplier

Tipe Risiko	Multiplier	Deskripsi
HACK	×1.8	Smart contract exploit
RUG	×2.5	Exit scam / rug pull
ORACLE	×1.4	Oracle price manipulation
DEPEG	×1.2	Stablecoin depegging
SLASH	×0.9	Validator slashing event

Base Rate per Protocol

Protocol	Base Rate	Alasan
DEX / AMM	0.8%	Risiko sedang, battle-tested
Lending	1.2%	Risiko flash loan, liquidation
Bridge	1.8%	Risiko paling tinggi, riwayat exploit
Yield Aggregator	1.4%	Kompleksitas komposabilitas
NFT Marketplace	1.0%	Risiko moderat
Custom Protocol	1.5%	Default untuk protokol baru

---

🔐 Keamanan

Mekanisme Proteksi

Mekanisme	Implementasi	Parameter
Reentrancy Guard	StoredBoolean flag on-chain	Setiap fungsi write
Capital Lock	lockExpiry per LP address	144 blok (~1 hari)
Circuit Breaker	StoredBoolean circuitBreaker	Auto-trigger saat pool insolvent
Insolvency Protection	Cek saldo sebelum withdrawal	activeCoverage ≤ totalLiquidity
Max Utilization	Hard cap pada rasio utilisasi	90% (MAX_UTILIZATION = 9000)
Double-Claim Guard	policyId → claimId mapping	Satu klaim aktif per polis
Fraud Detection	Slash otomatis pada double-claim	10% dari nilai klaim
Voter Slashing	burnFrom() via governance	Governance proposal
On-Chain Audit Log	Blockchain.log() setiap transaksi	Semua fungsi

Alur Claim Security

User submit klaim
       │
       ▼
Double-Claim Check ──── GAGAL ──► Slash 10% (fraud penalty)
       │
    LULUS
       │
       ▼
  Tipe Klaim?
  ┌────┼────┐
  │    │    │
  ▼    ▼    ▼
Oracle OnChain Governance
  │    │    │
  │    │    ▼
  │    │  Voting Period (2016 blok)
  │    │    │
  │    │    ▼
  │    │  Quorum Check (≥10%)
  │    │    │
  └────┴────┘
       │
       ▼
  Approved? ──── NO ──► Status: DENIED
       │
      YES
       │
       ▼
  Payout via InsurancePool.processClaim()
       │
       ▼
  BTC transfer di Bitcoin L1 ✅

---

🚀 Instalasi & Penggunaan

Cara Termudah — Buka Langsung di Browser

# Clone atau download repo
git clone https://github.com/your-org/opnet-insurance-protocol.git
cd opnet-insurance-protocol

# Buka langsung di browser — tidak perlu server!
open index.html

# Atau jalankan dengan simple HTTP server (opsional)
npx serve .
# atau
python3 -m http.server 8080

⚠️ Catatan: Untuk fitur wallet OP_WALLET berfungsi penuh, buka via http://localhost atau https://, bukan file:// (karena kebijakan CORS browser).

Requirements

• Browser modern (Chrome, Firefox, Edge, Brave, Opera)
• OP_WALLET Extension untuk interaksi on-chain penuh
• Koneksi internet (untuk Google Fonts)

Deploy Smart Contracts (untuk Developer)

# Install OPNet CLI
npm install -g @btc-vision/opnet-cli

# Scaffold project menggunakan OPNet MCP
npx opnet scaffold --template defi-insurance --mcp https://ai.opnet.org/mcp

# Compile kontrak AssemblyScript → WASM
npx opnet compile src/InsurancePool.ts
npx opnet compile src/PolicyNFT.ts
npx opnet compile src/ClaimModule.ts
npx opnet compile src/Governance.ts
npx opnet compile src/ShieldToken.ts

# Deploy ke Bitcoin L1 via OPNet
npx opnet deploy \
  --contract dist/InsurancePool.wasm \
  --network mainnet \
  --wallet ./wallet.json

# Output:
# ✅ Contract deployed: op1shield7pool8capital9defi0insurance1btc2opnet3

---

🔌 Wallet Integration

OPNet Insurance Protocol mendukung tiga wallet secara native:

OP_WALLET (Rekomendasi Utama)

Wallet resmi OPNet yang dibuat oleh tim btc-vision, fork dari UniSat Wallet.

// OP_WALLET menginject window.opnet dan window.unisat
const provider = window.opnet || window.unisat;

// Request akses akun — memicu popup OP_WALLET
const accounts = await provider.requestAccounts();
const address  = accounts[0]; // bc1p... (Taproot/P2TR)

// Get public key
const publicKey = await provider.getPublicKey();

// Sign pesan
const signature = await provider.signMessage(message, 'bip322-simple');

// Kirim BTC (untuk pembayaran premi)
const txid = await provider.sendBitcoin(contractAddress, premiumSats);

// Listen events
provider.on('accountsChanged', (accounts) => { /* handle */ });
provider.on('networkChanged',  (network)  => { /* handle */ });

Install OP_WALLET:

• Chrome Web Store
• GitHub Repository

UniSat Wallet

const provider = window.unisat;
const accounts = await provider.requestAccounts();

OKX Wallet

const provider = window.okxwallet.bitcoin;
const accounts = await provider.requestAccounts();

Demo Mode

Tidak memerlukan wallet extension — cocok untuk testing UI dan presentasi.

---

🤖 MCP Integration

Proyek ini dibuat menggunakan OPNet MCP (Model Context Protocol) Server yang dihosting di https://ai.opnet.org/mcp.

Setup MCP di Editor

// .cursor/mcp.json atau claude_desktop_config.json
{
  "mcpServers": {
    "opnet-bob": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ai.opnet.org/mcp"]
    }
  }
}

Cara Menggunakan MCP (Bob) untuk Pengembangan

MCP Bob menyediakan tool opnet_dev dengan berbagai aksi:

Aksi	Deskripsi
scaffold_op20	Generate boilerplate token OP_20
scaffold_defi	Generate pola kontrak DeFi
audit_contract	Security audit AssemblyScript
deploy_contract	Deploy WASM ke Bitcoin L1
call_contract	Read/write state kontrak
watch_events	Subscribe ke event kontrak

Interaksi Kontrak via opnet SDK

import { getContract, JSONRpcProvider } from 'opnet';
import { Address, Wallet } from '@btc-vision/transaction';
import { Network } from '@btc-vision/bitcoin';

const provider = new JSONRpcProvider('https://mainnet.opnet.org', 'mainnet');
const wallet   = Wallet.fromWIF('your_wif_key', 'mainnet');

// Connect ke InsurancePool
const pool = getContract(
  'op1shield7pool8capital9defi0insurance1btc2opnet3',
  OPNET_INSURANCE_POOL_ABI,
  provider, 'mainnet',
  new Address(wallet.keypair.publicKey)
);

// Read pool health (gratis, tidak perlu gas)
const health = await pool.getPoolHealth();
console.log('TVL:', health.totalLiquidity.toString());

// Beli polis
const tx = await pool.buyPolicy(
  BigInt('50000000'), // 0.5 BTC coverage
  0,    // HACK risk
  0,    // DEX protocol
  8640  // ~60 hari
);
await tx.wait(); // tunggu konfirmasi Bitcoin

---

📁 Struktur Proyek

opnet-insurance-protocol/
│
├── index.html                  ← Seluruh aplikasi (single file)
│   ├── <style>                 ← CSS responsif lengkap
│   ├── HTML Sections           ← 7 halaman sebagai section
│   │   ├── #page-dashboard     ← Live metrics & activity
│   │   ├── #page-buy           ← Kalkulator premi & beli polis
│   │   ├── #page-policies      ← Daftar polis aktif user
│   │   ├── #page-claim         ← Form & riwayat klaim
│   │   ├── #page-liquidity     ← Deposit/withdraw LP
│   │   ├── #page-governance    ← Proposal & voting
│   │   └── #page-contracts     ← Source code viewer
│   └── <script>                ← Logic JS + contract source embedded
│
├── README.md                   ← Dokumentasi ini
└── LICENSE                     ← MIT License

Embedded Smart Contract Source

Source code semua kontrak tersedia di halaman Contracts dalam aplikasi:

Tab	File	Ukuran
InsurancePool.ts	Core pool contract	~150 baris
PolicyNFT.ts	Policy asset contract	~120 baris
ClaimModule.ts	Claim resolution	~180 baris
Governance.ts	DAO governance	~170 baris
ShieldToken.ts	OP_20 token	~100 baris
MCP Integration	Panduan integrasi	~120 baris

---

🖥️ Halaman Aplikasi

1. Dashboard

Menampilkan metrik protokol secara real-time:

• Total Value Locked (TVL) — total BTC di pool
• Active Coverage — total coverage yang sedang berjalan
• Active Policies — jumlah polis aktif
• LP Annual Yield — estimasi yield tahunan LP
• Pool Utilization — rasio coverage/likuiditas
• Pool Health Ring — visualisasi kesehatan pool
• Treasury Balance — saldo kas protokol
• SHIELD Token Price — harga token governance
• On-Chain Activity — log aktivitas terbaru
• Claim Statistics — statistik klaim (paid/denied/pending)

2. Buy Coverage

Form untuk membeli polis asuransi:

• Pilih protokol yang diasuransikan (DEX, Lending, Bridge, dll)
• Pilih tipe risiko (Hack, Rug Pull, Oracle, Depeg, Slash)
• Tentukan jumlah coverage (BTC) dan durasi (blok)
• Kalkulator premi real-time dengan breakdown komponen
• Tampilan kapasitas pool yang tersedia

3. My Policies

Menampilkan semua polis aktif yang dimiliki wallet terhubung:

• Coverage amount, tipe risiko, protokol
• Blok mulai dan kedaluwarsa
• Status klaim
• Tombol file claim / transfer polis

4. Submit Claim

Form pengajuan klaim dengan tiga jalur resolusi:

• A) Oracle — verifikasi otomatis via oracle on-chain
• B) On-Chain — verifikasi kondisi langsung dari Bitcoin L1
• C) Governance — voting oleh SHIELD holders

Dilengkapi informasi keamanan (double-claim guard, fraud detection, slashing).

5. Provide Liquidity

Interface LP:

• Deposit dengan proyeksi yield tahunan
• Withdraw dengan validasi lock period
• Pool statistics (TVL, utilization, solvency score)
• Tokenomics donut chart (70/20/10)
• Tabel posisi LP aktif

6. Governance

Sistem tata kelola on-chain:

• Create Proposal (butuh ≥1,000 SHIELD)
• Vote YES/NO (power = saldo SHIELD)
• Progress bar voting real-time
• Informasi quorum dan periode voting

7. Smart Contracts

Source code viewer untuk semua kontrak dengan syntax highlighting.

---

📐 Formula Premi

Formula premi diimplementasikan identik di JavaScript (UI preview) dan AssemblyScript (on-chain):

Premium = Coverage × BaseRate × RiskFactor × (1 + PoolUtilization) × DurationMultiplier

DurationMultiplier = durationBlocks / 8640   (baseline = 60 hari)

Contoh Kalkulasi:

Coverage          = 0.5 BTC
Protocol          = DEX (BaseRate = 0.8%)
Risk              = HACK (Factor = 1.8)
Pool Utilization  = 42%
Duration          = 8,640 blok (60 hari)

Premium = 0.5 × 0.008 × 1.8 × (1 + 0.42) × 1.0
        = 0.5 × 0.008 × 1.8 × 1.42
        = 0.00512 BTC

---

⚖️ Governance

Alur Proposal

1. User membuat proposal (butuh ≥1,000 SHIELD + bond 100 SHIELD)
2. Periode voting: 2,016 blok (~2 minggu)
3. Voting dengan bobot = saldo SHIELD
4. Quorum: ≥10% total supply harus berpartisipasi
5. Majority: lebih banyak YES → PASSED, sebaliknya → FAILED
6. Bond dikembalikan jika quorum tercapai
7. Aksi dieksekusi on-chain jika passed

Tipe Proposal

Tipe	Deskripsi
PARAM	Ubah parameter protokol (base rate, lock period, dll)
CLAIM	Resolusi dispute klaim yang disengketakan
TREASURY	Alokasi dana treasury ke tujuan tertentu
UPGRADE	Upgrade logika kontrak
EMERGENCY	Aksi darurat (aktifkan/nonaktifkan circuit breaker)

Slashing

Pemilih yang terbukti bertindak jahat (melalui proposal governance) dapat dikenakan slash via ShieldToken.burnFrom() — saldo SHIELD mereka dibakar secara permanen.

---

🗺️ Roadmap

• Core insurance pool dengan formula premi on-chain
• Policy NFT sebagai aset native OPNet
• Tiga jalur resolusi klaim
• Governance on-chain dengan SHIELD token
• OP_WALLET integration (window.opnet)
• Fully responsive UI (mobile/tablet/desktop)
• Deployment ke OPNet Mainnet (target: Q2 2026)
• Integrasi oracle price feed on-chain
• Audit keamanan oleh auditor tersertifikasi OPNet
• Liquidity mining program untuk LP awal
• Mobile app native (menggunakan OPNet SDK)
• Multi-chain coverage (Bitcoin + L2)
• Reinsurance module untuk coverage besar

---

🤝 Kontribusi

Kontribusi sangat disambut! Silakan:

1. Fork repository ini
2. Buat branch fitur: git checkout -b feature/nama-fitur
3. Commit perubahan: git commit -m 'feat: deskripsi fitur'
4. Push ke branch: git push origin feature/nama-fitur
5. Buka Pull Request

Panduan Kontribusi

• Semua kontrak baru harus mengikuti pola OPNet MCP (https://ai.opnet.org/mcp)
• Gunakan StoredU256, AddressMap, dan tipe native btc-runtime untuk state storage
• Setiap fungsi write wajib menggunakan ReentrancyGuard
• Tambahkan event NetEvent untuk setiap perubahan state penting
• UI tetap dalam satu file HTML tanpa dependencies eksternal

---

📚 Referensi

Resource	Link
OPNet Documentation	https://docs.opnet.org
btc-runtime SDK	https://github.com/btc-vision/btc-runtime
OP_WALLET Extension	https://github.com/btc-vision/opwallet
OPNet MCP Server	https://ai.opnet.org/mcp
OPNet npm Package	https://www.npmjs.com/package/opnet
Chrome Web Store	https://chromewebstore.google.com/detail/opwallet/pmbjpcmaaladnfpacpmhmnfmpklgbdjb

---

📝 Lisensi

Proyek ini dilisensikan di bawah MIT License — lihat file LICENSE untuk detail lengkap.

---

⬡ OPNet Insurance Protocol

First Fully On-Chain Insurance Protocol on OPNet (Bitcoin L1)

Generated using OPNet MCP Smart Contract Reference

No admin keys. No backend. No bridges. 100% on-chain. ₿