برنامه نویسی

ساده سازی ارتباطات بلاک چین با @hyperbitjs/rpc

اگر به دنبال راهی برای تعامل با یک گره بلاک چین راه دور هستید، @hyperbitjs/rpc یک بسته ساده است که می تواند کمک کند. این بسته یک راه راحت برای ارسال درخواست ها به گره بلاک چین و رسیدگی به پاسخ های موجود در برنامه شما فراهم می کند.

یکی از مزایای اصلی استفاده از @hyperbitjs/rpc این است که با هر بلاک چینی که از JSON-RPC API پشتیبانی می کند، سازگار است. این بدان معنی است که شما می توانید از یک کتابخانه برای تعامل با بلاک چین های مختلف بدون نیاز به یادگیری ابزارها یا زبان های جدید استفاده کنید.

شروع شدن

برای شروع کار با @hyperbitjs/rpc، باید یک گره بلاک چین راه اندازی و اجرا کنید. علاوه بر این، باید JSON-RPC API را در فایل پیکربندی گره خود فعال کنید. هنگامی که گره خود را راه اندازی و اجرا کردید، می توانید از @hyperbitjs/rpc برای ارسال درخواست به آن استفاده کنید. اگر مطمئن نیستید که چگونه می توانید یک گره بلاک چین را با فعال کردن API JSON-RPC دریافت کنید، به این آموزش نگاهی بیندازید: نحوه تنظیم یک API RPC برای یک گره بلاک چین

همچنین باید مطمئن شوید که Node.js را با انتخاب IDE خود روی رایانه خود نصب کرده اید. Visual Studio Code یک انتخاب عالی است، اما شما می توانید از هر ترمینال یا IDE برای شروع پروژه خود استفاده کنید.

نصب و راه اندازی

بیایید با نصب @hyperbitjs/rpc در پروژه فعلی خود شروع کنیم.

  1. ترمینال یا خط فرمان خود را باز کنید و به دایرکتوری پروژه خود بروید.

  2. دستور زیر را برای نصب @hyperbitjs/rpc وارد کنید و آن را به عنوان یک وابستگی در پروژه خود ذخیره کنید:

npm install @hyperbitjs/rpc
وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این دستور آخرین نسخه @hyperbitjs/rpc را دانلود و نصب می کند و آن را به فایل package.json شما اضافه می کند.

  1. پس از اتمام نصب، می توانید کتابخانه را با استفاده از کد زیر وارد پروژه خود کنید:
// CommonJS
const { Client } = require('@hyperbitjs/rpc');
وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

// ES6
import { Client } from '@hyperbitjs/rpc';
وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این به شما امکان دسترسی به شی Client را می دهد که شامل تمام روش هایی است که برای تعامل با یک گره بلاک چین نیاز دارید. بیایید از Client برای اتصال به گره بلاک چین و ارسال دستورات استفاده کنیم.

const client = new Client({
  url: '<host:port>', // http://127.0.0.1:9050
  username: '<username>',
  password: '<password>',
});
وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

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

  1. اولین مورد دستور RPC ما است که می توانید آن را در اسناد مربوط به هر بلاک چین پیدا کنید.
  2. مورد دوم آرایه ای از گزینه هایی است که یک دستور RPC برای برگرداندن داده ها بر اساس درخواست شما به آن نیاز دارد.

مثال 1: اطلاعات بلاک چین را دریافت کنید

client.request('getblockchaininfo', []).then(response  => {
    console.log('response', response);
});
// Expected response: { chain: ..., blocks: ..., headers: ..., etc: ...}
وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

مثال 2: هش بلاک را دریافت کنید

متد getblockhash هش یک بلوک خاص در یک بلاک چین را برمی گرداند. ما در این مثال از بلاک چین بیت کوین استفاده می کنیم و استفاده از مشتری را با آرگومان های اضافی نشان می دهیم.

client.request('getblockhash', [778174]).then(response  => {
    console.log('response', response);
});
// Expected response: 00000000000000000003b80c61f014682e4cddc5cde562f9b358b542097c636b
وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

متوجه خواهید شد که آرگومان دوم به صورت آرایه ارسال می شود. اکثر درخواست‌های RPC، بار بار را در این پیکربندی مدیریت می‌کنند، اگرچه استثناهایی نیز در این قاعده وجود دارد. این مشکلی ندارد زیرا @hyperbitjs/rpc به اندازه کافی انعطاف پذیر است که به شما امکان می دهد هر نوع (آرایه، شی، رشته) را به عنوان پارامتر دوم ارسال کنید تا زمانی که API مورد استفاده شما آن را بپذیرد.

نتیجه

به طور کلی، @hyperbitjs/rpc یک ابزار قدرتمند و انعطاف پذیر است که می تواند به شما کمک کند با هر گره بلاک چینی که از JSON-RPC API پشتیبانی می کند، ارتباط برقرار کنید. چه در حال ساخت یک برنامه غیرمتمرکز، تجزیه و تحلیل داده های بلاک چین یا توسعه یک پروتکل بلاک چین جدید باشید، @hyperbitjs/rpc می تواند به شما در برقراری ارتباط با گره های بلاک چین که نیاز به دسترسی دارید کمک کند.

امیدواریم این آموزش برای شما آموزنده و مفید بوده باشد. اگر سوال یا بازخوردی در مورد این مقاله دارید، لطفاً در زیر نظر خود را در نظر بگیرید. ما همیشه از شنیدن نظرات خوانندگان خود قدردانی می کنیم و خوشحالیم که در مورد هر مشکل یا نگرانی شما کمک می کنیم.

با تشکر دوباره برای خواندن، و کد نویسی مبارک!


اگر این را مفید یا مفید یافتید، لطفاً یک 💓، 🦄، یا 🔖 را به اشتراک بگذارید. با تشکر!

نوشته های مشابه

دیدگاهتان را بنویسید

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

دکمه بازگشت به بالا