Skip to main content

Smart Contracts

usmewe’s protocol is built on 5 core smart contracts deployed on BASE (Ethereum L2).
All contracts are open source and have been audited. See our Security section for audit reports.

Contract Architecture

┌─────────────────────────────────────────────────────────────┐
│                        USER                                 │
└─────────────────────────────────────────────────────────────┘


┌─────────────────────────────────────────────────────────────┐
│                   SMART WALLET                              │
│              (ZeroDev Kernel + Safe)                        │
└─────────────────────────────────────────────────────────────┘

          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
    ┌───────────┐   ┌───────────┐   ┌───────────┐
    │  Trust    │   │   P2P     │   │  Social   │
    │  Vault    │   │   Loan    │   │  Vault    │
    └───────────┘   └───────────┘   └───────────┘
          │               │
          ▼               ▼
    ┌───────────┐   ┌───────────┐
    │ Insurance │   │Governance │
    │   Pool    │   │           │
    └───────────┘   └───────────┘

Core Contracts

Technology Stack

ComponentTechnology
LanguageSolidity 0.8.24
FrameworkFoundry
Account AbstractionZeroDev Kernel v3
Multi-sigSafe (Gnosis)
NetworkBASE (Mainnet & Sepolia)

Development

Prerequisites

# Install Foundry
curl -L https://foundry.paradigm.xyz | bash
foundryup

# Clone repository
git clone https://github.com/Topxl/UsMeWe.git
cd UsMeWe/contracts

Build & Test

# Build contracts
forge build

# Run tests
forge test

# Run tests with gas report
forge test --gas-report

# Generate coverage
forge coverage

Local Deployment

# Start local node
anvil

# Deploy to local
forge script script/Deploy.s.sol --rpc-url http://localhost:8545 --broadcast

Contract Verification

All contracts are verified on:

Security Considerations

These contracts handle real funds. Always review the audit reports before interacting.
Security MeasureStatus
External AuditCompleted
Bug BountyActive
Formal VerificationPartial
Penetration TestingCompleted

Bug Bounty

Report vulnerabilities and earn rewards

Quick Reference