vyperfun/vyper.fun

Cryptozombies for Vyper: Learn Vyper by building games!

Vyper Tutorials

Learn Vyper by building a Pokemon Game!

What is this?

This is an interactive tutorial website for learning Vyper while building games using smart contracts, similar to Cryptozombies.

Running tutorials locally

1. Clone the repo:

git clone https://github.com/vyperfun/vyper.fun

2. Download and Install Node.js.

3. Install docsify globally.

// you may need to use sudo
npm i docsify-cli -g

4. Run the tutorial locally.

docsify serve .

Contribution Guide

We're constantly in need of volunteers to help translate vyper.fun!

Given that Vyper.fun is a global project, we believe it's critical that Vyper.fun is accessible to everyone, regardless of their nationality or language. Our community has been working hard to make this vision a reality but we could use your help!

How to get involved

Check out contribution guide for instructions on how to get started as a translator. Don't see your language listed? Please comment here & we'll help get you set up.

Join our Discord server for collaboration & support.

Contributors

Forked from SubstrateKitties, the awesome substrate tutorial. Substrate is a modular framework that enables you to create purpose-built blockchains by composing custom or pre-built components. It also includes smart-contract bricks offering access to others languages, including Rust.

Thanks goes to these 109 wonderful people (emoji key):

Just some guy 👀 💵	Ben Hauser 💵	Defi Dad 💵	Andre Cronje 💵	spencernoon 💵	sassal 💵	banteg 💵
milkyklim 💵	vasa 💻	Nichanan Kesonpat 👀 💵	jacqueswww 💵	Shrutirupa 👀	Chloe Lewis 👀 💵	Anett Rolikova 💵
Julien Eluard 💻	Ricardo Rius 👀	slayorktc 💵	kingjacob 💵	scco 💵	apguerrera 💵	dsommer123 💵
harshrajat 💵	troopaloop8 💵	wmpea 💵	beaudelair 💵	rockmanr 💵	davis-ramsey 💵	bitcoinlouie 💵
neeradjgangapersad 💵	davbre 💵	heychristopher 💵	lalleclausen 💵	ppunktw 💵	hodldwon 💵	sc-jackie 💵
abvavgjoe 💵	happykennedy 💵	zu-ctrl 💵	vpepo 💵	tvist 💵	loanbrew 💵	substreight 💵
misterigl 💵	jiecut42 💵	lampshade9909 💵	koltenb 💵	naga2727 💵	evanz13 💵	evanmue 💵
i-van-kaz 💵	ethde 💵	katecallahan 💵	lescobar-driver 💵	isokasakissoja 💵	nazsi 💵	stobx 💵
larrypcdotcom 💵	darzyx 💵	darkghost7 💵	alanjds 💵	benny149 💵	deanchest 💵	austinlem6 💵
isaac-art 💵	manimechian 💵	ppostie 💵	karbonbased 💵	thomin1 💵	ninjasauce84 💵	cadilha 💵
eumarius 💵	xiv1605 💵	spcmank 💵	willk123 💵	pershingcube 💵	payraa 💵	bellinas 💵
qslnz 💵	5fiftyseven7 💵	PabloCGL 🤔	ranama 💵	maltaiso 💵	Gastón Zanitti 🌍	Markus Buhatem Koch 💵
Viktor Bunin 💵	odiblocha 💵	coopcode 💵	Yalor Arnold 💵	CleanApp 💵	Justin Leroux 💵	tjayrush 💵
Franco 💵	Kevin Park 💵	mfinestone 💵	ddwebdevv 🌍	AzogBiceps 🌍	rt 🌍	mds1 💵
shawnharmsen 💵	Manu Herrera 🌍	Elena Sacchi 🌍	Marc Mogdanz 🌍	Omicron 🌍	Michael Gangolf 🌍	Nicolas H. 🌍
Jose Rivera 🌍	Shamil Uzdenov 🌍	Martin Espericueta 🌍	cyvax 🌍

vyper.fun's Issues

Website translation in Chinese

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Training Review

Hey thank you for developing the training program, with the pokemon idea being fantastic honestly for this case.
Here are some comments coming from someone that knows a bit of python, but 0 Vyper:

• The self which is normally used in a class, can be used to access any variable defined at the class level... So what confused me, is that self is used to grab public storage variables and functions, but not used to grab constants? Which somewhat confused me a bit. Maybe https://vyper.fun/#/1/working_with_structs needs some clarification on where self is used and where it shouldn't, if constants don't need a self.
  Like in python the concepts of local and global variables, if can be added to the tutorial on how they look like in vyper would help alleviate my confusion.
• I spend quite a bit of time to try and understand https://vyper.fun/#/2/interfaces . Maybe this concept is quite important to grasp, but in the end I finally understood part of it. so probably need to mention that the interface needs to take in as a parameter, the address of the target contract (in which the function called lives), because for me the way it was written, given a contract address I did not know which contract was being referred to. Now on the second part of storage variables. I understood the implementation kind of, that interfaces can be defined in the init (kind of like when a class is imported in a different class as a variable), but then, where can we specify payable / nonpayable or view can be specified here? or is there something of a default on all contract functions. Like as in the example below, does self.car.getSpeed() have view/payable or which type of characteristic:

car: Car

@external
def __init__(car_address: address):
    self.car = Car(car_address)

@external
def getCarSpeed():
    self.car.getSpeed()

• One more point if possible... The use of the debugger. This is like kind of the most important thing of any coding language. If there was a chapter on that, it would be amazing.

Small chapter 5 correction

Hi. Tiny fix in the examples for mappings they are both called exampleMapping1, the second example should be exampleMapping2 as it is referred to in the explanation.

Thanks for building this resource :)

Add "hacktoberfest" as a topic for the repository

As part of the new Hacktoberfest guidelines, only PRs to repositories with the "hacktoberfest" topic will count towards the event. Please add it to the repository so PRs are properly counted.

Details: https://hacktoberfest.digitalocean.com/hacktoberfest-update

Website translation in Russian

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Website translation in French

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Unsigned integers example comment correction

The comment at https://vyper.fun/#/1/state_vars_and_ints?id=unsigned-integers-uint256 needs a correction:

actual:
"# This creates a constant uint256 with a value of 16"

Should be:
"# This creates a constant uint256 with a value of 10"

Chapter 1: Building your first Pokemon

The first chapter will include the core concepts of Vyper including:

• Structure of a contract
• Types
• Env variables and constants
• Statements
• Control Structures
• Scoping and declarations
• Built-in functions
• Interfaces
• Event Logging
• NatSpec Metadata

Using these concepts, the user will build their first pokemon.

Website translation in Italian

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Website translation in Spanish [COMPLETED]

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Remove suggestion to underscore internal function paramaters

The convention to add an underscore to the parameter names of internal function was removed in vyper in vyperlang/vyper#2166

Thus, this no longer applies and we should remove this statement in https://github.com/vyperfun/vyper.fun/blob/master/1/external_internal_functions.md .
Note that this does not affect internal function names, only their parameter names.

At the time of writing this however, due to a bug in vyper this still fails for function arguments, although it is fine for local variable names.

Possible ideas for the Applications/Games?

This issue is for pooling ideas for possible applications/games that we will build in a series of chapters using Vyper.

Some possible games:

1. Pokemon Collectibles: Collect, breed, upgrade, battle, and trade pokemons.
2. Dragon Ball Z Collectibles: Collect, upgrade, battle, and trade characters.

Some possible applications:

1. A sample auction.

Add your suggestions in the comments :)

Website translation in Portuguese

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Website translators needed!

We're constantly in need of volunteers to help translate vyper.fun!

Given that Vyper.fun is a global project, we believe it's critical that Vyper.fun is accessible to everyone, regardless of their nationality or language. Our community has been working hard to make this vision a reality but we could use your help!

How to get involved

Check out contribution guide for instructions on how to get started as a translator. Don't see your language listed? Please comment here & we'll help get you set up.

Join our Discord server for collaboration & support.

Data Discrepancy in `pokemonList` and `trainerToPokemon` HashMaps

Pokemon inpokemonList has never been updated after been added to this HashMap. Specifically, the battleWildPokemon function updates only the matches and wins data for Pokemon in trainerToPokemon HashMap, leading to a discrepancy between the values in pokemonList and trainerToPokemon.

Website translation in Japanese

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

Feedback on the first chapter

Hi. First of all, great job!
Like I said in the chat, I noticed some small issues while doing chaper 1:
In lesson 10, there is no mention that the function _generateRandomDNA must accept a String[32] as argument, so there is no way to know that the solution expects it.
In lesson 11: In line 4 from the instruction text there is a small typo ("hexidecimal"). The text also claims that converting a negative int128 to uint256 returns the positive counterpart, but the documentation linked states that conversion from a negative int to uint is not allowed. I did a quick test in Remix and the conversion did fail, but maybe I overlooked something and there's a way?

The last one is not so much an issue but a sugggestion: In lesson 9 we create the totalPokemonCount variable and use it to access the pokemonList. While doing it, it feels pretty obvious that we are "forgetting" to increment totalPokemonCount by 1 after creating a Pokemon. We end up adding in that part a couple of lessons later, but while you do the lesson it feels like an oversight from the tutorial. Also, the operator "+=" isn't explained before we use it...
So maybe explain += in lesson 4 together with the other operators, and then in lesson 9 put something like "Remember that += operator we saw before? Let's try it here" , so the function is feels finished (even though we are expanding it later)?

That's all! Anyway. I like what you are doing here a lot and I'd love to contribute. I'm learning Vyper myself, so there's probably not much I can do on the coding side of things, but I'd be glad to proofread, translate (spanish, german), or just be the first user :)

Website translation in Arabic

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together

https://vyper.fun is down

Website translation in German

PLEASE REFER TO CONTRIBUTION GUIDE TO SEE HOW TO CONTRIBUTE.

The following checklist represents the status of the translation of different chapters.

The chapters which are "unchecked" (do NOT have a tick mark) are ready to be translated. The chapters which is "checked" (have a tick mark) are NOT available for translation.

If you want to translate a chapter(s), you can COMMENT BELOW with the lesson and chapter numbers. The chapter(s) will be assigned to you.

You need to raise a Pull Request for the translations. After a review, your Pull request will be merged.

IF YOU SUBMIT A PULL REQUEST WITHOUT COMMENTING BELOW, YOUR PULL REQUEST WILL NOT BE ACCEPTED.

Lesson 1: Your first Pokémon

• Introduction
• Chapter 1: Contracts
• Chapter 2: State Variables, Integers & Constants
• Chapter 3: Math Operations
• Chapter 4: Structs
• Chapter 5: Mappings
• Chapter 6: Function Declarations
• Chapter 7: Working With Structs and Mappings
• Chapter 8: External / Internal Functions
• Chapter 9: Public Variables
• Chapter 10: More on Functions
• Chapter 11: Keccak256 and Typecasting
• Chapter 12: Putting It Together
• Chapter 13: Events

Lesson 2: Catch'em all

• Introduction
• Chapter 1: Addresses
• Chapter 2: Msg.sender
• Chapter 3: Wild Pokemons
• Chapter 4: Init Function
• Chapter 5: Create a Random Wild Pokemon
• Chapter 6: Comparison Operators and If-Else
• Chapter 7: Empty Function
• Chapter 8: Interfaces
• Chapter 9: Assert
• Chapter 10: Calling a Contract
• Chapter 11: Putting it Together