Obyte.js چیست؟

obyte.js می‌توانید مستقیماً در مرورگر خود با شبکه Obyte ارتباط برقرار کنید.

در این مطلب سریع‌ترین روش شروع کار را به شما نشان می‌دهیم – پس بزن بریم! 🚀

فهرست مطالب

Obyte.js چیست؟

obyte.js کتابخانه رسمی جاوااسکریپت برای توسعه‌دهندگانی است که می‌خواهند Obyte را در برنامه‌های خود ادغام کنند.
این کتابخانه مهم‌ترین قابلیت‌های شبکه را در یک API ساده و کاربردی جمع‌آوری کرده است:

  • دریافت موجودی‌ها (getBalances)
  • نمایش تاریخچه (getHistory)
  • ارسال تراکنش‌ها (postJoint)

به این ترتیب، obyte.js پایه‌ای برای ساخت اپلیکیشن‌های وب، ابزارها یا DAppهای مختلف بر بستر Obyte محسوب می‌شود.

استفاده در مرورگر

ساده‌ترین راه برای استفاده از obyte.js این است که کتابخانه را مستقیماً از طریق یک CDN بارگذاری کنید.

به این ترتیب می‌توانید بدون هیچ نصب اضافی، بلافاصله در مرورگر شروع به کار کنید:

<script src="https://cdn.jsdelivr.net/npm/obyte"></script>

این دستور obyte.js را همانند هر کتابخانهٔ جاوااسکریپتی دیگر بارگذاری می‌کند.
پس از آن، شیء سراسری obyte در دسترس خواهد بود که به شما امکان می‌دهد به یک هاب Obyte متصل شوید و از توابع API استفاده کنید.

اولین گام، ایجاد یک کلاینت است:

اتصال به شبکهٔ اصلی (Mainnet)

const client = new obyte.Client("wss://obyte.org/bb");

این کلاینت به هاب رسمی شبکهٔ اصلی (Mainnet)‌ Obyte متصل می‌شود.

اتصال به تست‌نت (Testnet)

const client = new obyte.Client("wss://obyte.org/bb-test");

با این URL شما به تست‌نت Obyte متصل می‌شوید – محیطی عالی برای آزمایش امن با کوین‌های فاست و حساب‌های نمایشی.

از اینجا می‌توانید متدهایی مانند getBalances() یا getHistory() را برای دریافت داده‌ها فراخوانی کنید – یا توابع اختصاصی خود را بنویسید که در پس‌زمینه با شبکه Obyte ارتباط برقرار می‌کنند.

اولین مثال: موجودی یک آدرس

بیایید با یک مثال بسیار ساده شروع کنیم:
موجودی یک آدرس را پرس‌وجو می‌کنیم و نتیجه را در مرورگر نمایش می‌دهیم.

👉 یک فایل جدید به نام balance.html ایجاد کنید و محتوای زیر را در آن قرار دهید:

<html>
<head>
  <title>Obyte.js Example</title>
  <!-- ما obyte.js را از طریق CDN وارد می‌کنیم -->
  <script src="https://cdn.jsdelivr.net/npm/obyte"></script>
</head>
<body>
  <h1>Balance</h1>
  <!-- اینجا بعداً خروجی نمایش داده خواهد شد -->
  <pre id="output"></pre>

  <script>
    // اتصال به شبکهٔ اصلی (Mainnet)
    const client = new obyte.Client("wss://obyte.org/bb");

    // تابع برای پرس‌وجوی موجودی
    async function getBalance() {

      // آدرس خود را اینجا وارد کنید
      const address = "ADDRESS";

      // دریافت موجودی‌های این آدرس از شبکه
      const balances = await client.api.getBalances([address]);

      // موجودی‌ها را در بخش <pre> قرار بده
      document.getElementById("output").innerText =
        JSON.stringify(balances[address], null, 2);
    }

    // فراخوانی تابع بلافاصله پس از بارگذاری صفحه
    getBalance();
  </script>
</body>
</html>

💡 نکته
ADDRESS را با یک آدرس معتبر Obyte (در شبکه اصلی/Mainnet) جایگزین کنید.

برای آزمایش، کافی است فایل balance.html را در هر مرورگری باز کنید. 🚀

نتیجه / خروجی

این آدرس دارای ۱,۰۰۰ بایت است.

مثال عملی: بررسی Pocket Money AA

در مقالهٔ اولین عامل خودگردان شما ( اولین Autonomous Agent شما ) ما قبلاً سناریوی پدر مایکل و چهار فرزندش را مرور کرده‌ایم.

اکنون یک فرانت‌اند می‌سازیم که موجودی فرزندان را مستقیماً در مرورگر نمایش می‌دهد.

💡 نکته
از آنجا که Pocket Money AA را در تست‌نت ساخته‌ایم، اینجا هم به تست‌نت متصل می‌شویم.
از این آدرس تست‌نت استفاده کنید: wss://obyte.org/bb-test

<html>
<head>
  <title>Obyte.js Pocket Money AA</title>
  <!-- ما obyte.js را از طریق CDN بارگذاری می‌کنیم -->
  <script src="https://cdn.jsdelivr.net/npm/obyte"></script>
</head>
<body>
  <h1>Children’s balances</h1>
  <!-- نتایج در اینجا نمایش داده خواهند شد -->
  <pre id="output"></pre>

  <script>
    // اتصال به تست‌نت (Testnet)
    const client = new obyte.Client("wss://obyte.org/bb-test");

    // آرایه‌ای شامل آدرس‌های چهار فرزند
    const children = [
      "ADDRESS_CHILD_1",
      "ADDRESS_CHILD_2",
      "ADDRESS_CHILD_3",
      "ADDRESS_CHILD_4"
    ];

    // تابع برای پرس‌وجوی موجودی همهٔ فرزندان
    async function getBalances() {

      // دریافت موجودی برای همهٔ آدرس‌های فرزندان
      const balances = await client.api.getBalances(children);

      // آماده‌سازی متغیر برای خروجی قالب‌بندی‌شده
      let out = "";

      // افزودن موجودی برای هر آدرس فرزند
      children.forEach((addr, i) => {
        out += `Child ${i+1} (${addr}):\n` +
               JSON.stringify(balances[addr], null, 2) + "\n\n";
      });

      // نمایش خروجی در بخش <pre>
      document.getElementById("output").innerText = out;
    }

    // فراخوانی تابع درست هنگام بارگذاری صفحه
    getBalances();
  </script>
</body>
</html>

💡 نکته
ADDRESS_CHILD_1 تا ADDRESS_CHILD_4 را با آدرس حساب‌های فرزندان خود جایگزین کنید.

نتیجه / خروجی

هر آدرس دارای ۲,۷۵۰ بایت است.

نتیجه‌گیری

با obyte.js اکنون با اصول اولیهٔ دریافت داده‌ها از شبکهٔ Obyte و آوردن مستقیم آن‌ها به وب آشنا شدید.
از یک بررسی سادهٔ موجودی گرفته تا Pocket Money Agent، می‌بینید که تنها با چند خط کد می‌توانید چیزهای هیجان‌انگیزی بسازید.

👉 خودتان امتحان کنید: در تست‌نت شروع کنید، با توابع مختلف آزمایش انجام دهید – و وقتی همه‌چیز درست کار کرد، ایده‌های خود را به شبکهٔ اصلی (Mainnet) منتقل کنید.

obyte.js کلید شما برای ساخت DAppها، ابزارها یا رابط‌های اختصاصی بر بستر Obyte است. 🚀

بیشتر بدانید:

دیدگاه‌ خود را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

پیمایش به بالا