starknet-id / starknet.quest

The on-chain quest tool of Starknet

Starknet Quest Client

Leading quests platform on Starknet to onboard your next million users. We provide a platform for users to discover new apps and for companies to pitch your products and new features to users and get user feedback.

About

Starknet Quest helps protocols attract and retain users by creating gamified quest experiences on Starknet.

Terms to help you get familiar with codebase -

Quests

• A Quest is a set of tasks which a user can do. On completing a quest they are eligible to get an NFT as proof of completion and possible tokens as a reward.
• Each Quest is created by one of the leading Dapps on starknet and are reviewed by the maintainers on the repo before publishing on the application.

Achievements

• An achievement are another type of tasks which are milestone based and long term.
• Each Achievement has certain milestones within them and on completing them they get rewarded with a building on the Starknet Quest Land (explained below)

Land

• Your land is the visual representation of your on-chain reputation which grows in size as you complete more quests and achievements on the platform.
• You can visit this to check your overall progress on the starknet quest platform and expand it by completing any new quests or achievements.

How to get started

Fork the repository and clone the forked repository to your local system

git clone https://github.com/starknet-id/starknet.quest.git

Install dependencies and run the development build

npm i
npm run dev

You should see something like this:

> [email protected] dev
> next dev

   ▲ Next.js 14.1.0
   - Local:        http://localhost:3000
   - Environments: .env

 ✓ Ready in 1431ms

🤝 Contribute

We're always looking for passionate developers to join our community and contribute to Starknet Quest. Check out our contributing guide for more information on how to get started.

To connect with us regarding any queries about contributing to the repo, feel free to join our telegram group here

Contributors

starknet.quest's Issues

Add a footer with infos

We need this infos to be here discord, twitter, study case & partnership page.

cursor not pointer on buttons and links

Describe the bug
The cursor is not a pointer on buttons, menus ...

We have to make it a pointer. Maybe there is some wrapper on top that enforce cursor or idk

Change starknet js v5 to this app

Update starknet id js v5 to this app

Doesn't build

./components/UI/modalWallet.tsx:9:10

11:25:08.733 | Type error: '"starknet"' has no exported member named 'CommonTransactionReceiptResponse'. Did you mean 'CommonTransactionResponse'?
11:25:08.733 |  
11:25:08.733 | 7 | import CopiedIcon from "./iconsComponents/icons/copiedIcon";
11:25:08.733 | 8 | import ClickableAction from "./iconsComponents/clickableAction";
11:25:08.733 | > 9 | import { CommonTransactionReceiptResponse } from "starknet";
11:25:08.733 | | ^
11:25:08.733 | 10 | import CloseIcon from "./iconsComponents/icons/closeIcon";
11:25:08.734 | 11 | import ArgentIcon from "./iconsComponents/icons/argentIcon";
11:25:08.734 | 12 | import theme from "../../styles/theme";
11:25:08.764 |  
11:25:08.764 | > Build error occurred
11:25:08.766 | Error: Call retries were exceeded
11:25:08.767 | at ChildProcessWorker.initialize (/vercel/path0/node_modules/next/dist/compiled/jest-worker/index.js:1:11661)
11:25:08.767 | at ChildProcessWorker._onExit (/vercel/path0/node_modules/next/dist/compiled/jest-worker/index.js:1:12599)
11:25:08.767 | at ChildProcess.emit (node:events:514:28)
11:25:08.767 | at ChildProcess._handle.onexit (node:internal/child_process:291:12) {
11:25:08.767 | type: 'WorkerError'
11:25:08.767 | }

Add timer in front-end

This feature will permit us to change the state of a quest base on a date, if the date is passed then the quest won't be displayed on the index page (disabled: false & hidden: false).

It'll permit us to add this urgency + to automate the fact of removing the quest once the date is passed.

You can find the design here

This issue is connected to it's back-end equivalent here starknet-id/api.starknet.quest#60

Get Reward should be disabled when it's already claimed

So I claimed my quest but I the reward button is not disabled so I can click and I have an error If I do

Update NFT contract to cairo 2

Wallets not showing

Wallets not showing when I type starknet.quest in my browser directly (hard refresh works well).

Add web wallet

Add argent web wallet to this app

Add profile page

Add profile to starknet lands

Add the profile to Starknet land and improve the lands.

Design https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?type=design&node-id=1352-1277&mode=dev

feat: update front to handle oauth verify endpoint

New quest page

Figma file : https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?type=design&node-id=1747%3A3831&mode=design&t=3bbmF3vpdJgO9vE6-1

Is the new quest page. A section for quest categories and trending quests has been added. You can click on a category to view the quests within that category

By clicking on an adventure, the user is directed to the list of quests that it contains. They can then choose a quest. Add back button.

Update token URIs

Starknet ID Tribe Shield ==> Stark Tribe Shield

• quest 4 nfts don't have uri rn

Add quests to starknet.quest

Quest à ajouter

1. Register a domain (main domain qui est un domaine racine).
2. Verify Twitter & discord
3. Follow @starknet_quest

NFTs & Achievements view on profil

Figma link : https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?type=design&node-id=1771%3A10524&mode=design&t=wPXjOrkqdbw0lnhJ-1

NFT Unlocked view
Here is the new view of the profile page. In the progress section, the user can see all the unlocked NFTs and completed achievements of the profile. The number in the chip corresponds to the number of NFTs or achievements. The user can view the achievements and click on them to access the achievements page.

Popup email

Figma link : https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?type=design&node-id=1769%3A6095&mode=design&t=9woRxaggPy7dHuUn-1

If a user hasn't shared their email yet, when they claim a reward or achievement, a popup appears suggesting that they share it with us, but it's not mandatory. The success feedback for the reward appears after the popup. If a user hasn't shared their email yet, when they claim a reward or achievement, a popup appears suggesting that they share it with us, but it's not mandatory. The success feedback for the reward appears after the popup.

Popup domain

Figma link : https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?type=design&node-id=1760%3A9193&mode=design&t=wPXjOrkqdbw0lnhJ-1

When the user wants to claim a reward after completing the quest or to connect wallet and doesn't have a domain, they are prompted to get one through a popup that redirects them to the Starknet ID page. When the user doesn't have a domain yet, a "Get Your Domain" button is visible on their profile.

Add a "Failed" state to verify button

Move lands to starknet Quest website

move the components made on land.starknet.quest to starknet.quest profile page to have the land act as a profile.

Client side error

Client-side error here when I connect here https://goerli.starknet.quest/bart1.stark

Add Braavos Analytics

Add braavos analytics to the profile.

Try to find a library like this that can handle the Starknet pro score

Add error message instead of infinite loading

if the ID never existed, we could add a real error message instead of an infinite loading.

example ==> https://starknet.quest/quest/21

Move Clickable social media to the indexer

https://goerli.api.starknet.id/domain_to_data?domain=fricoben.stark

We can now have Twitter and Github with id to data or domain to data so we do what we did on the app also here.

Change wording

LVL 1 = bronze
LVL 2 = silver
LVL 3 = gold

Example quest = StarkFighter

Change responsive navbar like on Starknet ID

Add automatic connection and disabled bug of wallets

Make the same thing as starknet-id/app.starknet.id#247

Create A/B testing and make it work

add starknetid & starkfighter api requests

People can still access finished quests

At least on the front end, everyone can still access the finished quest. Would like to have another parameter than finished to make it invisible to the public (after the quest when they are really finished).

We would need an error message component with a message saying This quest is finished with the photo of the NFT that was given. exemple here https://starknet.quest/quest/123

Create the achivement page

Create the achievement page by following the design.

Design: https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?node-id=1387%3A1460&mode=dev

Our goal is to add 3 achievements types for the moment:

• Starknet Quest NFT (based on the number of Starknet Quest NFT)
• Xplorer Argent NFT (based on the number of Xplorer NFT)
• Braavos Journey NFT (based on the number of Braavos Journey NFT)

In the future we'll have special partnerships with apps and protocols.

Connect to argent does not work

When I connect to the app for the first time with Argentx, I type my password and the wallet is not connected. I have to click again to connect. (Starknet react problem most probably).

add quiz_name endpoint_type: "quiz" & Option of quiz_name

This will also require some change in the server

Twitter tasks opens even if not connected

twitter tasks open the new window even if I'm not connected, should give me the feedback that I'm not connected like the other tasks.

Automatically set verify button status

Add the Quizz Feature.

Our goal is to add for this issue is to add a quiz feature to the quest [questPage].tsx following this figma template.

Here is some API documentation.

[To describe by @Th0rgal]

Land Starknet Quest x FrensLands

https://app.skiff.com/file/d8adf598-7e07-4081-98b7-a468d5034d89

Add severless functions for quest system

feat: update front to add StarknetID quest

Change My NFTs to Starknet achievement

Instead of my NFTs, I think we should say Starknet Achievements. The only NFT displayed here would be the argent, Braavos and Starknet quest collection.

Here are the collection that I want to see here (mainnet addresses).

NEXT_PUBLIC_QUEST_NFT_CONTRACT=0x076503062d78f4481be03c9145022d6a4a71ec0719aa07756f79a2384dc7ef16
NEXT_PUBLIC_XPLORER_NFT_CONTRACT=0x01b22f7a9d18754c994ae0ee9adb4628d414232e3ebd748c386ac286f86c3066
NEXT_PUBLIC_BRAAVOSSHIELD_NFT_CONTRACT=0x067c358ec1181fc1e19daeebae1029cb478bb71917a5659a83a361c012fe3b6b
NEXT_PUBLIC_BRAAVOS_JOURNEY_NFT_CONTRACT=0x57c4b510d66eb1188a7173f31cccee47b9736d40185da8144377b896d5ff3

Add tx manager

Add the same tx manager we have on the starknet id app

Verify domain not checking expiry of the domain

When we verify domains for quests we verify that the guy has a domain but we don't that this domain is not expired which is a big problem for long term sustainability if they don't renew at some point

Quests fix: wrong rewards

Update Old deFi quests

Update Zklend, Jediswap and AVNU old quest in order to make them available now.

Sequencer might be deprecated, maybe indexer too ...

Move to starknet js instead of starknet react

We have trouble with starknet react.

Could be cool to move everything to starknet js directly at some point.

Add possibility to make a quizz type of task

This quiz type of task should look like one task on the design (one bar) but when you click on it your whole screen is taken and you now have to answer the questions of the quiz.

Once all the questions are answered we verify the task and can continue with the rest of it.

Design Coming soon

Display is buggy on big screens

Quest card "done"

Figma file : https://www.figma.com/file/fh0OAvj4AS08kHoSxu3DkE/Starknet-Quest?type=design&node-id=1748%3A6635&mode=design&t=3bbmF3vpdJgO9vE6-1

When a quest has been completed, it is marked as 'done' on the card to differentiate it from quests that still need to be done.

feat: add skeleton on quest page

Add skeleton on front end when loading quests

Create Ekubo Quest

The quest to make

• Quiz on Ekubo
• Provide liquidity on Ekubo
• Join Ekubo Discord's

Cette quest fera partie des quests de l'achievement spéciale deFi ! Plus de précisions soon