Company Simulator

• Starts: Oct 23rd, 2025 Noon UTC

• Ends: Oct 30th, 2025 Noon UTC

• nSLOC: 265

About the Project

Company Simulator is a decentralized smart contract system built in Vyper that simulates the operations of a virtual company. It includes modules for production, inventory management, customer demand, shareholding, reputation, and financial health.

Actors

Actors:
    Owner: Deploys and controls core company functions such as production, share cap increases, and debt repayment.
    Investor: Public user who funds the company and receives proportional shares.
    Customer: Simulates demand by purchasing items from the company.

Centralization Risks:

• Only the owner can produce items, increase share cap, and pay off debt.
• Reputation gating and share issuance are controlled by the owner.
• Customers are rate-limited to prevent spam but can still influence company revenue and reputation.

Scope (contracts)

All contracts in src are in scope.

src/
├── Cyfrin_Hub.vy         # Core contract managing company operations
├── CustomerEngine.vy     # Simulates customer demand and triggers sales

Compatibilities

Compatibilities:
  Blockchains:
    - Ethereum / Any EVM-compatible chain
  Tokens:
    - ETH only

Setup

To deploy and test the Company Simulator locally using Moccasin:

Build & Deploy:

mox run deploy

Run Tests:

mox test

For documentation, run mox --help or visit Moccasin Docs

Known Issues

• None //: # (known-issues-close)