chore: initial commit for v0.0.1

DChain single-node blockchain + React Native messenger client.

Core:
- PBFT consensus with multi-sig validator admission + equivocation slashing
- BadgerDB + schema migration scaffold (CurrentSchemaVersion=0)
- libp2p gossipsub (tx/v1, blocks/v1, relay/v1, version/v1)
- Native Go contracts (username_registry) alongside WASM (wazero)
- WebSocket gateway with topic-based fanout + Ed25519-nonce auth
- Relay mailbox with NaCl envelope encryption (X25519 + Ed25519)
- Prometheus /metrics, per-IP rate limit, body-size cap

Deployment:
- Single-node compose (deploy/single/) with Caddy TLS + optional Prometheus
- 3-node dev compose (docker-compose.yml) with mocked internet topology
- 3-validator prod compose (deploy/prod/) for federation
- Auto-update from Gitea via /api/update-check + systemd timer
- Build-time version injection (ldflags → node --version)
- UI / Swagger toggle flags (DCHAIN_DISABLE_UI, DCHAIN_DISABLE_SWAGGER)

Client (client-app/):
- Expo / React Native / NativeWind
- E2E NaCl encryption, typing indicator, contact requests
- Auto-discovery of canonical contracts, chain_id aware, WS reconnect on node switch

Documentation:
- README.md, CHANGELOG.md, CONTEXT.md
- deploy/single/README.md with 6 operator scenarios
- deploy/UPDATE_STRATEGY.md with 4-layer forward-compat design
- docs/contracts/*.md per contract
This commit is contained in:
vsecoder
2026-04-17 14:16:44 +03:00
commit 7e7393e4f8
196 changed files with 55947 additions and 0 deletions

222
node/explorer/contract.html Normal file
View File

@@ -0,0 +1,222 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Contract | DChain Explorer</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
<link rel="stylesheet" href="/assets/explorer/style.css">
<script src="https://unpkg.com/lucide@latest"></script>
<script defer src="/assets/explorer/common.js"></script>
<script defer src="/assets/explorer/contract.js"></script>
</head>
<body>
<header class="topnav">
<div class="topnav-inner">
<a class="topnav-brand" href="/">
<span class="brand-gem"></span>
<span class="brand-name">DChain</span>
</a>
<nav class="topnav-links">
<a href="/">Explorer</a>
<a href="/tokens">Tokens</a>
<a href="/contract" style="color:var(--text)">Contracts</a>
<a href="/validators">Validators</a>
<a href="/relays">Relay Nodes</a>
</nav>
</div>
</header>
<!-- search bar strip -->
<div class="addr-searchbar">
<div class="addr-searchbar-inner">
<div class="hero-search" style="max-width:640px">
<i data-lucide="search" class="hero-search-icon"></i>
<input id="contractInput" type="text" placeholder="Contract ID (hex)…">
<button id="contractBtn" class="btn-hero">Load</button>
</div>
<div id="status" class="hero-status"></div>
</div>
</div>
<!-- ── Contracts list (shown when no contract is selected) ──────────────── -->
<main class="page-body" id="contractsList">
<div class="panel">
<div class="panel-header">
<span><i data-lucide="code-2" style="width:16px;height:16px;vertical-align:middle;margin-right:6px"></i>Deployed Contracts</span>
<span id="contractsCount" class="text-muted" style="font-size:0.85rem"></span>
</div>
<div id="contractsEmpty" style="padding:2rem 1.25rem;color:var(--muted);font-size:0.9rem;display:none">
No contracts deployed yet.
</div>
<div class="table-wrap" id="contractsTableWrap" style="display:none">
<table>
<thead>
<tr>
<th>Contract ID</th>
<th>Deployer</th>
<th style="width:7rem">Block</th>
<th style="width:6rem">WASM</th>
</tr>
</thead>
<tbody id="contractsBody"></tbody>
</table>
</div>
<div id="contractsLoading" style="padding:2rem 1.25rem;color:var(--muted);font-size:0.9rem">
Loading…
</div>
</div>
</main>
<main class="page-body" id="mainContent" style="display:none">
<!-- ── Banner ──────────────────────────────────────────────────────────── -->
<div class="tx-banner tx-banner-ok" id="contractBanner">
<div class="tx-banner-left">
<div class="tx-banner-icon tx-banner-ok">
<i data-lucide="code-2"></i>
</div>
<div class="tx-banner-body">
<div class="tx-banner-title">Smart Contract</div>
<div class="tx-banner-desc mono" id="bannerContractId"></div>
</div>
</div>
<div class="tx-banner-time" id="bannerDeployedAt"></div>
</div>
<!-- ── Main panel ───────────────────────────────────────────────────────── -->
<div class="panel tx-overview-panel">
<!-- tab row -->
<div class="tx-tabs">
<button class="tx-tab tx-tab-active" id="tabOverview">Overview</button>
<button class="tx-tab" id="tabState">State</button>
<button class="tx-tab" id="tabLogs">Logs</button>
<button class="tx-tab" id="tabRaw">Raw JSON</button>
</div>
<!-- ── Overview ── -->
<div id="paneOverview">
<div class="addr-kv-list">
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="hash"></i> Contract ID</div>
<div class="addr-kv-val">
<span class="mono" id="contractId"></span>
<button class="copy-btn" data-copy-id="contractId" title="Copy"><i data-lucide="copy"></i></button>
</div>
</div>
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="user"></i> Deployer</div>
<div class="addr-kv-val">
<span id="contractDeployer"></span>
<button class="copy-btn" data-copy-id="contractDeployerRaw" title="Copy pubkey"><i data-lucide="copy"></i></button>
<span id="contractDeployerRaw" style="display:none"></span>
</div>
</div>
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="layers-3"></i> Deployed at block</div>
<div class="addr-kv-val"><span id="contractDeployedBlock"></span></div>
</div>
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="package"></i> WASM size</div>
<div class="addr-kv-val"><span id="contractWasmSize"></span></div>
</div>
</div>
<!-- ABI methods -->
<div id="abiSection" style="display:none">
<div style="padding: 0 1.25rem 0.5rem; font-size:0.8rem; font-weight:600; text-transform:uppercase; letter-spacing:0.06em; color:var(--muted)">
<i data-lucide="braces" style="width:12px;height:12px;vertical-align:middle"></i> ABI Methods
</div>
<div class="table-wrap" style="margin: 0 0 1rem">
<table>
<thead><tr><th>Method</th><th>Arguments</th></tr></thead>
<tbody id="abiMethodsBody"></tbody>
</table>
</div>
</div>
</div>
<!-- ── State browser ── -->
<div id="paneState" style="display:none">
<div style="padding:1rem 1.25rem 0.5rem">
<div class="hero-search" style="max-width:480px">
<i data-lucide="key" class="hero-search-icon"></i>
<input id="stateKeyInput" type="text" placeholder="State key (e.g. counter)…">
<button id="stateLoadBtn" class="btn-hero">Query</button>
</div>
</div>
<div id="stateResult" style="display:none;padding:0 1.25rem 1rem">
<div class="addr-kv-list" style="margin-top:0.75rem">
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="key"></i> Key</div>
<div class="addr-kv-val"><span class="mono" id="stateKey"></span></div>
</div>
<div class="addr-kv-row" id="stateU64Row" style="display:none">
<div class="addr-kv-key"><i data-lucide="hash"></i> uint64</div>
<div class="addr-kv-val"><span class="mono" id="stateU64"></span></div>
</div>
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="binary"></i> hex</div>
<div class="addr-kv-val">
<span class="mono addr-pubkey-text" id="stateHex"></span>
<button class="copy-btn" data-copy-id="stateHex" title="Copy"><i data-lucide="copy"></i></button>
</div>
</div>
<div class="addr-kv-row">
<div class="addr-kv-key"><i data-lucide="file-text"></i> base64</div>
<div class="addr-kv-val">
<span class="mono addr-pubkey-text" id="stateB64"></span>
<button class="copy-btn" data-copy-id="stateB64" title="Copy"><i data-lucide="copy"></i></button>
</div>
</div>
<div class="addr-kv-row" id="stateNullRow" style="display:none">
<div class="addr-kv-key"><i data-lucide="circle-off"></i> Value</div>
<div class="addr-kv-val"><span class="text-muted">null (key not set)</span></div>
</div>
</div>
</div>
<div id="stateEmpty" style="padding:1.5rem 1.25rem; color:var(--muted); font-size:0.9rem">
Enter a state key and click Query.
</div>
</div>
<!-- ── Logs ── -->
<div id="paneLogs" style="display:none">
<div id="logsEmpty" style="padding:1.5rem 1.25rem; color:var(--muted); font-size:0.9rem">
No log entries yet. Logs are written by <code>env.log()</code> calls inside the contract.
</div>
<div class="table-wrap" id="logsTableWrap" style="display:none">
<table>
<thead>
<tr>
<th style="width:6rem">Block</th>
<th style="width:8rem">Tx</th>
<th style="width:3rem">#</th>
<th>Message</th>
</tr>
</thead>
<tbody id="logsBody"></tbody>
</table>
</div>
</div>
<!-- ── Raw JSON ── -->
<div id="paneRaw" style="display:none">
<pre id="contractRaw" class="raw tx-raw-pre">No data.</pre>
</div>
</div>
</main>
</body>
</html>