The Button Game: how was it made?

Aleksander Bączkowski
Aleph Zero Foundation
6 min readDec 14, 2023

The Button Game is now available to the Aleph Zero community. In this article, we’ll dive deeper into the design and production process for educational purposes.

Welcome to The Button, a smart-contract-based game deployed on the Aleph Zero blockchain.

Inspired by the famous Reddit game and social experiment, The Button utilizes ink! smart contracts and the lightning-fast finality of Aleph Zero to deliver a captivating gaming experience.

At its core, The Button features a timer countdown that decreases with each finalized block on the Aleph Zero blockchain. Players’ clicks on The Button reset the timer, ensuring its survival for 90,000 blocks (around 25 hours).

With three unique game modes, each governed by different rules, players need to strategically time their engagement to reap the largest possible rewards.

How it works?

Players utilize ticket tokens in PSP22 standard to enter The Button’s various game modes and earn reward tokens.These tokens open the doors to The Button’s Marketplace, where players can partake in a Dutch auction for ticket sales, taking advantage of fluctuating prices.

Additionally, the game introduces SimpleDex, a Decentralized Exchange that enables seamless swapping between reward tokens and the wAZERO token — a PSP22-wrapped native coin of Aleph Zero, ensuring liquidity and flexibility.

The integration of the Marketplace and Decentralized Exchange empowers players to devise winning strategies to optimize their rewards, taking advantage of the market conditions.

Aleph Zero’s rapid block finality, with blocks produced and finalized every 900 milliseconds on average, adds a time-sensitive dimension to gameplay, further fueling strategic thinking.

In the following sections, we will describe the key components that comprise The Button.

This introductory overview serves as a starting point for our series of technical deep-dives, where we will delve into each component.

Core Components

Here are the core components of The Button game:

  • The Button Contract
  • The Marketplace Contract
  • The SimpleDex Contract

The Button Contract: Governing Gameplay, Tracking Rewards, and Minting Tokens

At the heart of The Button lies The Button contract, a pivotal smart contract that governs the game’s rules, records player interactions, and mints the rewards.

Let’s dive into the inner workings of this crucial component, which forms the backbone of the game’s mechanics.

When players enter the game, their interaction with the contract begins by granting permission to The Button contract to spend one ticket token on their behalf.

This ticket token serves as the entry fee, granting players access to the thrilling gameplay that awaits them.

Upon receiving the ticket, The Button contract records the player’s score and initiates the payout of rewards based on the game’s specific rules.

The rewards themselves are PSP22 tokens, distinct from the ticket tokens used for entry.

The Button contract possesses a special role that grants it the authority to mint these rewards directly into the players’ accounts.

As players engage with the game, The Button contract diligently tracks all rewards disbursed throughout the lifespan of The Button.

This collection of rewards constitutes the coveted pool for The Pressiah — the individual fortunate enough to make the final click on The Button before its demise.

As the game progresses, The Button contract keeps a meticulous record of the rewards paid out, setting the stage for the climax as the countdown timer nears its end.

Once The Button’s life cycle concludes, and before the next round commences, the designated Pressiah account is bestowed with 50% of the total rewards minted during the preceding round.

To initiate a fresh round, the game can be reset by invoking a specific contract message.

This crucial action serves multiple purposes:

* Firstly, it rewards the Pressiah, acknowledging their achievement;

* Secondly, it transfers all the tickets held by The Button contract to the Marketplace, ensuring their availability for the upcoming round;

* And finally, it resets the state of the contract, effectively wiping the slate clean and paving the way for a new round to begin, brimming with exciting opportunities and heralding the potential rise of a new Pressiah.

As we journey deeper into The Button’s architecture, we will now unravel additional components that contribute to the gameplay.

The Marketplace Contract: Facilitating Ticket Sales and Dynamic Pricing

The Marketplace contract plays a pivotal role in The Button’s ecosystem by facilitating the sale of tickets to eager players through a Dutch auction mechanism. Let’s explore the inner workings of this contract, which ensures a fair and dynamic pricing model for ticket acquisition.

  • The primary function of the Marketplace contract is to sell tickets to players using a Dutch auction approach;
  • The pricing structure follows a linear decrease from a starting price with each block that is finalized on the blockchain;
  • This downward trajectory continues until the auction has spanned a specific number of blocks, at which point the price reaches its minimum threshold;
  • Once the minimum price is reached, tickets remain available for purchase at this fixed rate.

Additionally, the Marketplace contract tracks the average price of all tickets sold.

With each new auction, the contract sets the starting price based on the average price of tickets sold up to that point. This mechanism ensures that pricing remains responsive to market demand and reflects the collective value perceived by players.

By implementing a Dutch auction model and leveraging the average price as a starting point, the Marketplace contract establishes a fair and dynamic system for ticket sales.

This approach allows players to engage in the game at various stages and obtain tickets at a price that aligns with market trends and player participation.

The Marketplace contract serves as a cornerstone of The Button’s ecosystem, enabling players to enter the game and embark on their quest for rewards. Through its innovative auction mechanism and adaptive pricing strategy, the Marketplace ensures an equitable and engaging experience for all participants.

As we continue our exploration, we will uncover additional components that contribute to the vibrant and dynamic nature of The Button’s gameplay.

The SimpleDex Contract: Empowering Decentralized Token Swaps

The SimpleDex contract within The Button’s ecosystem introduces a decentralized exchange functionality, allowing players to seamlessly swap between the reward tokens.

SimpleDex utilizes a simplified version of the Uniswap V1 pricing mechanism.

Uniswap revolutionized decentralized exchanges by implementing an automated market maker (AMM) model. This model eliminates the need for traditional order books, and instead relies on a constant product formula to determine token prices. It ensures that trades occur based on the ratio of token reserves in a liquidity pool.

The SimpleDex contract maintains a single multi-token pool where all reward tokens for each game coexist alongside wAZERO (wrapped AZERO).

wAZERO acts as a representation of the native Aleph Zero token within the ecosystem, consistently exchangeable at a 1:1 ratio. However, due to legal considerations, a deliberate design choice was made to restrict swaps only from tokens to wAZERO, not the other way around.

It’s worth noting that on an anonymous blockchain, anyone can write and deploy additional contracts, such as an escrow contract, to enable trustless exchanges between AZERO and ticket tokens. As long as these contracts are developed by the community members and not directly associated with the Aleph Zero Foundation, it aligns with our core principles of decentralization and community-driven innovation.

Given the straightforward design of the game, there is no need for external liquidity providers within the SimpleDex contract. Liquidity for wAZERO is periodically topped up by the Foundation itself, while liquidity for reward tokens is sourced from the swaps executed by players themselves.

The pricing mechanism employed by the SimpleDex holds a strategic value within the game.

Players can leverage this mechanism to devise strategies that optimize their token swaps, providing them with a competitive edge in navigating The Button’s gameplay dynamics.

Conclusion

With this, we conclude our exploration of the core components that drive The Button, a captivating smart contract-based game deployed on the Aleph Zero blockchain.

We have delved into The Button contract, which governs gameplay and rewards, the Marketplace contract, which facilitates ticket sales, and the SimpleDex contract, empowering decentralized token swaps.

We plan to venture deeper into The Button’s design and uncover additional components and technical intricacies that made it possible. Stay tuned!

Get the source code

This article was first published on the Aleph Zero Blog on August 10th, 2023. Read the original entry here.

--

--