آموزش زمین بازی Starkex Spot

Starkex Spot Playground استقرار Starkex برای تجارت Spot در Goerli Testnet است که نمایش ساده ای از راه حل مقیاس پذیری Starkex را ارائه می دهد. می توانید از زمین بازی استفاده کنید:

• به راحتی معاملات را به Starkex ارسال کنید ،
• این معاملات را در یک دسته Starkex مشاهده کنید ، و
• تماشا کنید که چگونه دولت ، از جمله معاملات شما ، در قرارداد Starkex به صورت زنجیره ای به روز می شود.

اگر می خواهید چند مرحله را پرش کنید و برنامه خود را توسعه دهید ، Starkex SDK و Starkex Crypto SDK را ببینید.

اگر در هر مرحله سؤال دارید ، لطفاً با ما در info@starkware. co تماس بگیرید.

یک نمونه واقعی Starkex در مقایسه با زمین بازی

عناصر یک نمونه واقعی Starkex با زمین بازی متفاوت است ، همانطور که در یک نمونه واقعی Starkex در مقایسه با زمین بازی شرح داده شده است.

شما تنها اپراتور هستید. شما کنترل کامل نمونه Starkex خود را دارید.

چندین اپراتور وجود دارد.

شما تخصیص شناسه های طاق را به عنوان بخشی از برنامه خود مدیریت می کنید.

ارزش شناسه طاق که برای معامله خود انتخاب می کنید ممکن است توسط شخص دیگری اشغال شود.

شما تنها کسی هستید که معاملات را ارسال می کنید ، بنابراین نباید با get_first_unused_tx_id تماس بگیرید.

Starkex معاملات را به صورت متوالی ، بر اساس ارزش شناسه هر معامله ، پردازش می کند ، بنابراین شناسه های موجود در لیست معاملات شما باید شامل تمام عدد صحیح در محدوده مقادیر باشد.

به عنوان مثال ، برای لیستی از سه معامله ، لیست مقادیر شناسه معاملات نمی تواند 0،1،3 باشد ، باید 0،1،2 باشد. این لیست همچنین می تواند غیر پی در پی باشد ، مانند 0. 2،1. اگر لیست شامل یک عدد صحیح نباشد ، Starkex هنگام رسیدن به شناسه گمشده ، پردازش را متوقف می کند و منتظر ارسال آن است.

برای به دست آوردن شناسه معاملات بعدی ، باید با تماس با get_first_unused_tx_id از دروازه Starkex پرس و جو کنید ، زیرا سایر کاربران زمین بازی باید TX_ID بعدی را همگام سازی کنند.

توجه داشته باشید که Starkex دو معامله را با همان شناسه پردازش نمی کند و در صورت عدم پردازش معامله قبلی ، معامله را پردازش نمی کند.

Starkex را امتحان کنید: سپرده ، برداشت ، تسویه حساب و نعناع

بسته بازی Starkex لیستی از معاملات معتبر و از پیش آماده شده Starkex مانند سپرده ها ، برداشت ها ، شهرک ها و درخواست های نعنا را ارائه می دهد. شما همچنین یک اسکریپت بازیکن دریافت می کنید که این معاملات را به Starkex ارسال می کند.

به سادگی بازیکن را اجرا کنید و:

• معاملات را همانطور که از طریق Starkex پخش می کنند ، مشاهده کنید.
• query starkex برای دیدن آخرین دسته از زنجیره ای با معاملات خود در آن ، و
• تماشا کنید زیرا یک حالت جدید در زنجیره ای در قرارداد هوشمند Starkex تشکیل شده است.

برای اطلاعات بیشتر در مورد Starkex ، به نمای کلی سطح بالا مراجعه کنید.

تهیه بسته زمین بازی

روش

1. بارگیری Starkex_playground. zip.
2. onzip starkex_playground. zip.

بسته زمین بازی شامل پرونده های زیر است:

txs. json

لیستی از معاملات زنجیره ای ، از جمله سپرده ها ، شهرک ها و برداشت هایی که از محدوده طاق که به شما اختصاص داده شده است ، اجرا می شوند. این معاملات معتبر و توسط کاربران از پیش تعریف شده با کلید واضح عمومی خود امضا شده است. این به شما امکان می دهد بدون وارد شدن به جزئیات معامله دقیق برای هر عمل ، یک چرخه عملکرد کامل Starkex را مشاهده کنید.

یک اسکریپت پایتون که لیست معاملات مشخص شده در TXS. JSON را به قرارداد Starkex و سرویس Off Chain Starkex بررسی و ارسال می کند. این معاملات سپس به سرویس Starkex در زنجیره ای ارسال می شوند ، اعدام شده و به دسته ای اضافه می شوند که به عنوان یک کشور جدید در زنجیره ارسال می شود.

در حال اجرا در زمین بازی

پیش نیازها

• پیوند انتهای Infura برای Goerli TestNet. اگر یکی از آنها را ندارید ، لطفاً یک حساب Ethereum را در https://infura. io/ برای دستیابی به لینک باز کنید.
• داکربرای نصب Docker در Ubuntu Linux یا سایر توزیع های لینوکس مبتنی بر Debian ، دستور زیر را وارد کنید:

$ sudo apt نص ب-y docker. io

روش

1. تغییر به فهرست دایرکتوری Starkex_playground.
2. با اجرای دستورات زیر یک تصویر Docker را بسازید و اجرا کنید:

$ docker buil d-t.$ docker ru n-it

$ ./player. p y-txs txs. jso n-node_ur l-funder_private_ke y-verbose

شما می توانید کلید خصوصی Goerli خود را از Metamask صادر کنید:

1. جزئیات حساب را از منوی کنار آدرس حساب انتخاب کنید.
2. Export Private Key را انتخاب کنید و رمز عبور MetaMask خود را ارائه دهید.

این کلید برای تأمین بودجه سپرده های زنجیره ای لازم است و فقط به صورت محلی برای امضای معاملات مورد استفاده قرار می گیرد.

تجزیه و تحلیل خروجی

خروجی شامل دو نوع است:

1. توضیحات مربوط به سپرده های زنجیره ای از قرارداد Starkex با پیوندهای Etherscan. به معاملات زنجیره ای مراجعه کنید.
2. توضیحات معاملات Starkex خارج از زنجیره حاوی نوع معامله و TX_ID منحصر به فرد. به معاملات خارج از زنجیره مراجعه کنید.

شکل 1. معاملات زنجیره ای

شکل 2. معاملات خارج از زنجیره

تبریک می گویم! اولین معاملات Starkex خود را ارسال کرده اید. می توانید به روزرسانی حالت زنجیره ای را در عرض چند دقیقه مشاهده کنید.

خوب ، اینجا چه اتفاقی افتاد؟

کدام معاملات را ارسال کردم؟

پرونده txs. json شامل لیست صریح معاملات با فرمت API Starkex است.

بیایید به معامله سپرده زیر به عنوان نمونه نگاه کنیم:

• stark_key کلید رمزنگاری است که به شما امکان می دهد معاملات را امضا کنید
• مقدار مقدار انتقال است
• token_id شناسه ERC-20 Token Starkex است
• Vault_id شماره حساب در Starkex است که شما به آن واریز می کنید - این حساب باید حسابی باشد که با stark_key مشخص شده همراه باشد
• نوع نوع معامله ارسالی را در این مورد ، یک سپرده گذاری ارائه می دهد.

چگونه می توانم به روزرسانی حالت زنجیره ای را ببینم؟

شما می توانید ایالت را در قرارداد هوشمند Starkex Playground در https://goerli. etherscan. io/address/0x5731aea1809be0454907423083FB879079FB69DF بررسی کنید. اگر دسته شما قبلاً در زنجیره ای ارسال شده است (حدود 5 دقیقه اجازه دهید) ، یک معامله به روزرسانی دولتی را مشاهده خواهید کرد.

همچنین می توانید آنچه را که در قرارداد هوشمند تأیید کننده ، اثبات اثبات واضح ، در https://goerli. etherscan. io/address/0x8f97970ac5a8d130d35146f59c4aef57963 بررسی کرده اید ، بررسی کنید. خواهید دید که اثبات جدیدی برای تأیید ارسال شده است. پس از تأیید اثبات ، یک واقعیت جدید در زنجیره ای که تأیید اعتبار اثبات را تأیید می کند ، ثبت می شود. قرارداد Starkex قبل از به روزرسانی دولت ، این واقعیت را بررسی می کند.

چگونه می توانم توازن طاق های خارج از زنجیره را بخوانم؟

توازن طاق مستقیماً از تاریخچه معاملات ارسال شده به دسته های Starkex ناشی می شود. می توانید با استفاده از API Feeder Gateway Starkex ، این اطلاعات را خارج از زنجیره پرس و جو کنید.

شما نمی توانید آخرین دسته را تا زمانی که ایجاد نشده باشد پرس و جو کنید. بنابراین توصیه می شود که آخرین دسته را فقط در صورت پیگیری بروزرسانی حالت زنجیره ای پرس و جو کنید.

روش

1. آخرین batch_id را دریافت کنید:

$ wge t-n v-q -o- https://gw. playground-v2. starkex. co/v2/feeder_gateway/get_last_batch_id

خروجی این دستور یک شناسه منحصر به فرد است که باید از آن به عنوان ورودی برای دستور بعدی استفاده کنید.

$ wge t-n v-q -o- https://gw. playground-v2. starkex. co/v2/feeder_gateway/get_batch_info؟batch_id=

خطوط 2-14 اطلاعات مربوط به ریشه درخت سفارش و ریشه درخت طاق را ارائه می دهد ، که نمایانگر حالت است.

خطوط 21 به بعد اطلاعات مربوط به معاملات موجود در دسته را نمایش می دهد.

• شما می توانید معاملات خود را با استفاده از TX_ID که در خروجی اسکریپت پخش کننده مشاهده کرده اید ، مانند خط 27 مشاهده کنید. توجه زیادی به این زمینه داشته باشید.
• معاملات نامعتبر ، طبق معاملات اول و دوم در خطوط 28 و 40 از خروجی دروازه فیدر ، ارزش را درست می کنند.
• معاملات معتبر جایگزین نمی شوند و مقدار نادرست به آنها اختصاص داده می شوند ، طبق خروجی دروازه فیدر ، خط 52 ادامه دارد.
• زمین بازی Starkex پیکربندی شده است تا به جای جایگزینی آنها ، معاملات نامعتبر را پرش کند. با این حال ، در عمل ، این نشانگر خوبی است که آیا معامله انجام شده است یا خیر.

شکل 3. خروجی دروازه فیدر

شکل 4. خروجی دروازه فیدر ادامه دارد

این خیلی باحاله! چگونه می توانم برخی از معاملات خودم را ارسال کنم؟

اگر می خواهید آن را به یک درجه تبدیل کنید ، می توانید لیست معاملات توسط خودتان را تغییر داده یا یک لیست جدید ایجاد کنید. برای کسب اطلاعات بیشتر در مورد جریان Starkex ، به موضوعات زیر مراجعه کنید:

• جریان سپرده ، شامل اطلاعات مربوط به سوار شدن به یک کاربر جدید است
• جریان انتقال ، برای اطلاعات در مورد نقل و انتقالات خارج از زنجیره
• جریان تجارت
• جریان مینینگ خارج از زنجیره و ذوب یک نشانه خارج از زنجیره
• جریان خروج برای اطلاعات در مورد برداشت صندوق ها در زنجیره

منابع اضافی

• مرجع API Starkex REST
• JavaScript SDK برای Starkex
• برای ارسال معاملات خود ، باید بتوانید معاملات را با امضای واضح امضا کنید. شما می توانید جفت کلید stark خود را تولید کنید یا از جفت های کلیدی از پیش تعریف شده ما از player_data. py استفاده کنید. می توانید از Starkex Crypto SDK استفاده کنید یا از کتابخانه Crypto Python استفاده کنید ، که شامل نمونه ای از امضای یک سفارش محدود است.

وقتی معاملات را به زمین بازی Starkex ارسال می کنید ، آنها باید مطابق منطق تجاری Starkex معتبر باشند ، یا آنها رد می شوند. به عنوان مثال ، یک معامله نامعتبر یک معامله سپرده با کلید عمومی آلیس برای طاق است که مطابق با کلید عمومی باب است.

من به راهنمایی بیشتری احتیاج دارم ، می توانید به من کمک کنید؟

مطمئن! لطفا با ما در info@starkware. co تماس بگیرید.