🎮 Algorand Coding Challenge - Volume 2: 🐍 Python Challenges

🚩 Challenge 2: How Do You Store States on the Python Contract?! 📀

When compiling my Python smart contract, it fails to build. There seems to be issues around how I am defining my states... 🤔

Inside of smart_contracts/counter/contract.py file, there is a simple counter smart contract written in Algorand Python.

It is a simple contract that has an opt_in method and an increment method and it keeps track of how many counts each user has in the count local state and the total amount of participants tracked in the counters global state.

However, if you try to build the smart contract by opening Docker Desktop, and then running:

algokit bootstrap all
algokit localnet start
algokit project run build # Compile the smart contract and get low-level TEAL code.

it will fail.

Find out what is wrong and fix the bug.

💬 Meet other hackers working on this challenge and get help in the Algorand Python Discord Channel!

Checkpoint 1: 🧰 Prerequisites

  1. Install Python 3.12 or higher
  2. Install AlgoKit.
  3. Install Docker. It is used to run a local Algorand network for development.

Checkpoint 2: 💻 Set up your development environment

  1. Fork this repository.
  2. Clone the repository
cd [DIRECTORY_OF_YOUR_CHOICE]
git clone [FORKED_REPO_URL]

Now you have 2 ways of opening your AlgoKit project.

With VSCode Workspaces

  1. Open the cloned repository with the code editor of your choosing.
  2. Open workspace mode by clicking open workspace inside of python-challenge-2.code-workspace file at the root level.
  3. Go inside of the challenge folder.
  4. To setup your dev environment using AlgoKit, run the below command:
algokit project bootstrap all #algokit bootstrap all is being deprecated. Use this command from now on.

This command will install all dependecies and also generate a .env file for you. 5. Activate Python virtual environment by running:

poetry shell

venv will automatically be activated the next time you open the project.

Please note, in addition to built-in support for VSCode Workspaces, the cli provides native support for monorepos called algokit workspaces. Refer to documentation for detailed guidelines for recommended project structures and ability to leverage custom command orchestration via algokit project run.

Without VSCode Workspaces

All AlgoKit projects initialized with --workspace option has the following directory structure:

├── projects
│   ├── smart-contract
│   └── frontend # doesn't exist for this project
│   └── ...
├── {several config files...}
├── ...
├── .algokit.toml # workspace-typed algokit project config
├── {project-name}.code-workspace
├── README.md

So to access a single project under the projects folder, it is recommended to cd into the project you want to work with and then open your code editor (alternatively refer to VSCode Workspace file at the root). If you are reading this and didn't open the challenge folder directly, go do that now!! 😁

  1. cd into projects/challenge then open the code editor
  2. To setup your dev environment using AlgoKit, run the below command:
algokit project bootstrap all #algokit bootstrap all is being deprecated. Use this command from now on.

This command will install all dependecies and also generate a .env file for you. 3. Activate Python virtual environment by running below inside of challenge folder:

poetry shell

venv will automatically be activated the next time you open the project.

Video walkthrough of forking and cloning this repository:

fork-clone-tutorial.mp4

Now you are ready to fix the bug!

Checkpoint 3: 🐞 Fix the bug 🧐

  1. Open Docker Desktop and launch Algorand localnet by running algokit localnet start in your terminal For more info click me!.
  2. Go to smart_contracts/counter/contract.py to see the source code of the counter smart contract.
  3. Try building the contract with algokit project run build. It will fail.
  4. Figure out what is wrong and fix the bug!
  5. After fixing the bug, build and run the deploy script with the below command:
algokit project run build
algokit project deploy localnet

OR if you are on VSCode, hit F5 or go to the Run and Debug tab and run the debug script.

If you see something like this in the console, you successfully fixed the bug! 😆 image

😰 Are you struggling?

Checkpoint 4: 💯 Submit your answer

  1. After fixing the bug, push your code to your forked Github repo and make a PR to the original repo.
  2. Inside the PR include:
    1. What was the problem?
    2. How did you solve the problem?
    3. Screenshot of your terminal showing the result of running the deploy script.

Checkpoint 5: 🏆 Claim your certificate of completion NFT! 🎓

The Algorand Developer Relations team will review the submission and "approve" the PR by labeling it Approved. Once it's approved, we will share the magic link to claim your certificate of completion NFT in the comment of the PR!

The certificate of completion NFT is a verifiable credential minted on the GoPlausible platform that follows the W3C standard for certificates and OpenBadges standard for badges.

The certificate of completion NFT for Python challenges were designed by Maars, an artist & a dev in web3. Definitely follow his work! It's awesome. 😆

🎉 Congratulations on completing the challenge Algodev! This was the final challenge of the 1st season of #AlgoCodingChallenge. Be on the lookout for the 2nd season of #AlgoCodingChallenge!

Below is the default readme of the Python AlgoKit Template. Read to learn more about this template.

This project has been generated using AlgoKit. See below for default getting started instructions.

Setup

Pre-requisites

Initial setup

  1. Clone this repository locally
  2. Install pre-requisites:
    • Make sure to have Docker installed and running on your machine.
    • Install AlgoKit - Link: The recommended version is 1.7.3. Ensure you can execute algokit --version and get 1.7.1 or later.
    • Bootstrap your local environment; run algokit bootstrap all within this folder, which will:
      • Install Poetry - Link: The minimum required version is ^1.7. Ensure you can execute poetry -V and get 1.2+
      • Run poetry install in the root directory, which will set up a .venv folder with a Python virtual environment and also install all Python dependencies
      • Copy .env.template to .env
    • Run algokit localnet start to start a local Algorand network in Docker. If you are using VS Code launch configurations provided by the template, this will be done automatically for you.
  3. Open the project and start debugging / developing via:
    • VS Code
      1. Open the repository root in VS Code
      2. Install recommended extensions
      3. Hit F5 (or whatever you have debug mapped to) and it should start running with breakpoint debugging.

        Note If using Windows: Before running for the first time you will need to select the Python Interpreter.

        1. Open the command palette (Ctrl/Cmd + Shift + P)
        2. Search for Python: Select Interpreter
        3. Select ./.venv/Scripts/python.exe
    • JetBrains IDEs (please note, this setup is primarily optimized for PyCharm Community Edition)
      1. Open the repository root in the IDE
      2. It should automatically detect it's a Poetry project and set up a Python interpreter and virtual environment.
      3. Hit Shift+F10|Ctrl+R (or whatever you have debug mapped to) and it should start running with breakpoint debugging. Please note, JetBrains IDEs on Windows have a known bug that in some cases may prevent executing shell scripts as pre-launch tasks, for workarounds refer to JetBrains forums.
    • Other
      1. Open the repository root in your text editor of choice
      2. In a terminal run poetry shell
      3. Run python -m smart_contracts through your debugger of choice

Subsequently

  1. If you update to the latest source code and there are new dependencies you will need to run algokit bootstrap all again
  2. Follow step 3 above

For guidance on smart_contracts folder and adding new contracts to the project please see README on the respective folder.

Tools

This project makes use of Algorand Python to build Algorand smart contracts. The following tools are in use:

  • Algorand - Layer 1 Blockchain; Developer portal, Why Algorand?
  • AlgoKit - One-stop shop tool for developers building on the Algorand network; docs, intro tutorial
  • Algorand Python - A semantically and syntactically compatible, typed Python language that works with standard Python tooling and allows you to express smart contracts (apps) and smart signatures (logic signatures) for deployment on the Algorand Virtual Machine (AVM); docs, examples
  • AlgoKit Utils - A set of core Algorand utilities that make it easier to build solutions on Algorand.
  • Poetry: Python packaging and dependency management. It has also been configured to have a productive dev experience out of the box in VS Code, see the .vscode folder.