script (⏱,💰)

イントロダクション#

Node Guardians は、Solidity と Cairo の学習を目的としたウェブサイトです。美しいゲームインターフェースの裏には優れたコースデザインがあり、学習を強くお勧めします。このシリーズでは、コースを一歩ずつ進める方法を紹介します。

以下のウェブサイトを開くと、次のような画面が表示されます。各カードはテーマごとのタスクであり、タスクを完了すると報酬がもらえます。

ビルドチュートリアル：Cairo#

最初のタスクは「Setting Up: Cairo」から始まります。このタスクの目的は、Cairo の開発環境をセットアップし、タスクの提出方法を理解することです。ビルドチュートリアル：Cairo と CTF チュートリアル：Cairo があります。まずは「ビルドチュートリアル：Cairo」から始めましょう。右下のStart Questをクリックします。

まずは git と npm をインストールします。MacOS の場合は、brew install nodeとbrew install gitを入力してインストールできます。（ネットワークの問題がある場合はbrew のミラーを使用できます）Windows の場合は、インストール方法を検索してください。

インストールが完了したら、git -v && node -vと入力し、バージョンが表示されれば続行します。node のバージョンは 16 以降である必要があります。

GitHub のホームページで、ng-questplayという名前のプライベート（Private）リポジトリを作成します。

次に、GitHub Applicationのリンクをクリックして追加します。このアプリケーションは、将来の解答コードのアップロードがテストに合格するかどうかを検証するために使用されます。作成した ng-questplay にインストールするだけで、他のリポジトリにはインストールする必要はありません。

公式のリポジトリをクローンし、プライベートリポジトリにリンクします。

git clone [email protected]:Nodeguardians/ng-questplay.git
cd ng-questplay
git remote set-url origin [email protected]:{GITHUB_USERNAME}/ng-questplay.git
git push -u origin main

ng-questplay フォルダで、以下のコマンドを実行して必要な依存関係をインストールし、最初のコミットを行います。

npm run start-adventure
git add .
git commit -m "Install initial dependencies"

Cairo の開発には scrab をインストールする必要があります。これは Cairo のパッケージングとパッケージ管理ツールです。最新バージョンをインストールしてください。インストールガイドのリンク

次に、GitHub のトークンを設定してタスクをダウンロードします。

1. GitHub の右上のアイコンをクリックして、設定ページに移動します。
2. 左側のサイドバーで、Developer Settings（最後のオプション）> Personal Access Tokens をクリックします。
3. 新しいトークン（classic）を生成します（たとえば、「Node Guardians Questplay」という名前にします）。
4. このトークンに公開リポジトリへのアクセス権限を付与します。
5. トークンを生成します。

トークンをプロジェクトフォルダの.env ファイルにコピーし、GITHUB_TOKEN = "ghp_..."という名前で保存します。

quest find build-tutorial-cairoを実行して最初のタスクをダウンロードします。

次に、cd ./campaigns/starting-cairo/build-tutorial-cairoを実行してタスクのフォルダに移動します。

最初のタスクは、src/hello.cairo の hello_guardian () が'Hello Guardian'を返すようにする必要があります。

答えは提供しませんが、ヒントを提供します。Cairo は Rust の構文を使用しており、2 つのポイントがあります：

1. 関数の戻り値については、参考資料を参照してください。
2. Cairo の文字列型については、参考資料を参照してください。

quest test 3を入力して、コードにエラーがないかローカルでテストします。エラーがある場合は、エラーメッセージに基づいてコードを修正する必要があります。

次に、回答を提出します。自動的に提出することをお勧めします。まず、コードをコミットします。コミットメッセージは任意のものを入力してください。例えば、次のように入力します。

git add .
git commit -m "complete quest 3"

その後、quest submitを入力し、成功するまで待ちます。成功したら、ページに戻り、Verify をクリックします。いくつかのタスクには、非表示のテストケースがある場合がありますので、ローカルで完全にテストに合格していても、必ずしもタスクが完了しているわけではありません。提出が完了すると、Summary が表示され、学んだ重要なポイントを振り返ることができます。

獲得した経験値は、アカウントのレベルとグローバルランキングを向上させるために使用されます。ゴールドはキャラクターのアップグレードに使用されます（あまり意味はありません）。

CTF チュートリアル：Cairo#

次に、CTF タスクがあります。CTF タスクでは、テストネットにコントラクトをデプロイし、そのコントラクトとやり取りして、タスクの目標を達成する必要があります。ブロックエクスプローラとのやり取り、CLI を使用してトランザクションを送信、新しいコントラクトをデプロイして呼び出すなど、手段は問いません。

タスクを完了する前に、ウォレットの秘密鍵のエクスポート方法やコントラクトの作成とやり取り方法を学ぶことをお勧めします。公式ドキュメント https://docs.starknet.io/documentation/quick_start/environment_setup/ や中文のビデオチュートリアルを参考にしてください。

左下のdeploy sand devilをクリックし、ウォレットに接続し、Testnet に切り替え、トランザクションを送信すると、デプロイされたコントラクトのアドレスが表示されます。

このタスクでは、まず count の値を知る必要があります。その後、slay を呼び出し、引数に count と同じ値を減算すると、0 になります。最も簡単な方法は、ブラウザでデプロイしたアドレスにアクセスし、右側のread contractとwrite contractを使用してタスクを達成することです。

count を 0 に設定したら、Verifyをクリックしてタスクが完了します。

次のステップ#

次は、Cairo の詳細な内容に入り、難易度 2 の「Thinking in Cairo」を完了します。カテゴリはアルゴリズムとデータ構造です。