Skip to content

RuneLabsxyz/PonziLand

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,362 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PonziLand Logo

Fully Onchain, Token-Agnostic DeFi Metagame on Starknet

Documentation License: MIT TypeScript CairoLang GitHub stars Twitter Follow Discord

Quick StartGame DocsWidget SystemArchitecture

PonziLand

PonziLand is a fully onchain, token-agnostic DeFi metagame where you conquer lands, stake tokens, nuke rivals, and build your empire on Starknet. Every land is a battleground of strategy, risk, and reward—will you become a PonziLord or get rugged by your neighbors?


🚀 Quick Start

Clone the repo and run the client locally with the mainnet contract:

git clone git@github.com:RuneLabsxyz/PonziLand.git
cd PonziLand/client
bun install
bun dev:mainnet

Open your browser at https://localhost:3000 to start playing.


🕹️ What is PonziLand?

PonziLand is a blockchain-based game where players can own, trade, and earn from virtual land plots. Each plot can be purchased using different tokens and generates taxes from neighboring lands. Players must maintain sufficient stake to avoid having their land "nuked" (forcefully removed). The game is designed to be fully token-agnostic, allowing for a wide range of DeFi strategies and social gameplay.

Core Gameplay:

  • Conquer: Acquire land through Dutch auctions or by buying from other players.
  • Stake: Lock tokens as security to protect your land from being nuked.
  • Earn: Collect taxes from your neighbors and claim rewards.
  • Nuke: If your neighbors don't keep up, nuke their lands and expand your empire.
  • Upgrade: Level up your land and maximize your earnings.

PonziLand is a game of strategy, timing, and social maneuvering—where every day is a new scheme.


🏗️ Project Structure

  • client/ – SvelteKit front-end, including the modular widget system for UI extensions.
  • contracts/ – Cairo smart contracts for the PonziLand game logic.
  • crates/ – Rust backend and models, including the meta-indexer for Starknet data.
  • playtest/ – Scripts and tools for playtesting and analytics.

See GAMEJAM.md for a detailed guide on extending the UI with custom widgets.


🧩 Widget System

PonziLand's UI is built around a flexible widget system. You can add new widgets to the game interface without touching core logic. See the Widget System Overview for details and examples.


⚙️ Architecture

  • Onchain: All land, auctions, and core actions are managed by Cairo smart contracts on Starknet.
  • Meta-Indexer: A Rust-based service ingests and enriches blockchain data for fast, replay-safe queries.

See ARCHITECTURE.md for more technical details.


🏦 Core Actions

  • Auction: Bid on new land plots in Dutch auctions.
  • Buy: Purchase land from other players.
  • Claim: Collect taxes from your neighbors.
  • Increase Price/Stake: Adjust your land's price or stake to optimize strategy.
  • Level Up: Upgrade your land for greater rewards.

For a full list of smart contract actions and view functions, see contracts/DEVELOPMENT.md.


🛠️ Contributing

  • Fork and clone the repo.
  • See GAMEJAM.md for widget and UI modding.
  • Join the Discord for support and collaboration.

📣 Community & Links


📄 License

PonziLand is released under the MIT License. See LICENSE for details.


Stake your claim, become a PonziLord! Upgrade or get rugged—the choice is yours.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors