Afrexai Web3 Engineering

# Web3 & Blockchain Engineering

Complete methodology for evaluating, designing, building, securing, and operating blockchain-based systems. Covers smart contract development, DeFi protocol design, token economics, security auditing, and production operations.

> Zero dependencies. Framework-agnostic. Works with any blockchain, any language, any AI agent.

---

## Phase 1: Should You Use Blockchain?

### The Database Test

Before writing a single line of Solidity, answer honestly:

```yaml
blockchain_evaluation:
  problem: "[describe the core problem]"
  
  requirements:
    multiple_untrusting_parties: true/false    # >1 org needs shared truth
    no_trusted_authority: true/false            # no single party everyone trusts
    immutability_critical: true/false           # history must be tamper-proof
    censorship_resistance_needed: true/false    # no entity should block access
    value_transfer_required: true/false         # moving assets between parties
    transparency_required: true/false           # all parties need verifiable state
  
  disqualifiers:
    single_org_controls_data: true/false        # → use a database
    data_deletion_required: true/false          # → GDPR conflict, careful
    high_throughput_low_latency: true/false     # → >10K TPS? consider L2 or database
    users_cant_manage_wallets: true/false       # → account abstraction or custodial
    trusted_authority_exists: true/false        # → database with audit log
  
  score: "[count true requirements - count true disqualifiers]"
  verdict: "blockchain / hybrid / database"
```

**Decision rules:**
- Score ≤ 0 → Use PostgreSQL with audit logs
- Score 1-2 → Hybrid (anchoring/notarization on-chain, logic off-chain)
- Score 3+ → Blockchain is justified

### Platform Selection Matrix

| Platform | TPS | Finality | Gas Cost | Best For |
|----------|-----|----------|----------|----------|
| Ethereum L1 | ~30 | ~12 min | $1-50+ | Settlement, high-value DeFi |
| Arbitrum | ~4,000 | ~1 sec (soft)...

# Web3 & Blockchain Engineering ⛓️

Complete methodology for evaluating, designing, building, securing, and operating blockchain-based systems. From "should I use blockchain?" to production DeFi protocols.

## Install

```bash
clawhub install afrexai-web3-engineering
```

## What's Inside

- **Database Test** — Decision framework: blockchain vs PostgreSQL
- **Platform Selection** — 10+ chains compared (Ethereum, Solana, Bitcoin, L2s)
- **Smart Contract Architecture** — Design patterns, upgrade strategies, Solidity standards
- **Token Economics** — Distribution, vesting, value accrual, red flag detection
- **DeFi Protocol Design** — AMMs, lending, security invariants
- **Security Auditing** — 100+ point checklist, vulnerability taxonomy, audit process
- **Testing Strategy** — Full pyramid (unit → fuzz → fork → formal verification)
- **Deployment & Ops** — Checklists, monitoring, incident response
- **Wallet Security** — Key hierarchy, multisig config, self-custody rules
- **L2 & Scaling** — Rollups, bridges, cross-chain security
- **Bitcoin & Lightning** — Integration patterns, self-custody, UTXO management
- **MEV Protection** — Sandwich attacks, front-running prevention
- **Account Abstraction** — ERC-4337, gasless UX, session keys
- **Regulatory Compliance** — US/EU/UK/Singapore frameworks, MiCA, Howey Test

Zero dependencies. Framework-agnostic. Works with any AI agent.

## Quick Start

```
> evaluate blockchain fit for our supply chain tracking
> design tokenomics for a governance token
> audit security on this Solidity contract
> plan deployment to Arbitrum
```

## ⚡ Level Up

This free skill gives you the engineering methodology. For complete industry-specific AI agent context packs with implementation playbooks:

**[AfrexAI Context Packs — $47 each](https://afrexai-cto.github.io/context-packs/)**

- 🏦 **Fintech Pack** — DeFi compliance, payment rails, regulatory frameworks
- 💻 **SaaS Pack** — Token-gated features, Web3 authentication, billing
- 🏗️ **Constr...