JSON-RPC API

একটি সফটওয়্যার অ্যাপ্লিকেশনকে Ethereum ব্লকচেইনের সাথে ইন্টারঅ্যাক্ট করার জন্য - তা ব্লকচেইন ডেটা পড়া হোক বা নেটওয়ার্কে লেনদেন পাঠানো হোক - এটিকে অবশ্যই একটি ইথিরিয়াম নোডের সাথে সংযুক্ত হতে হবে।

এই উদ্দেশ্যে, প্রতিটি Ethereum client একটি JSON-RPC specification (opens in a new tab) প্রয়োগ করে, যাতে নির্দিষ্ট নোড বা ক্লায়েন্ট ইমপ্লিমেন্টেশন নির্বিশেষে অ্যাপ্লিকেশনগুলি নির্ভর করতে পারে এমন একটি অভিন্ন মেথড সেট থাকে।

JSON-RPC (opens in a new tab) হলো একটি স্টেটলেস, লাইট-ওয়েট রিমোট প্রসিডিউর কল (RPC) প্রটোকল। এটি বেশ কয়েকটি ডেটা স্ট্রাকচার এবং তাদের প্রসেসিংয়ের নিয়মগুলি সংজ্ঞায়িত করে। এটি ট্রান্সপোর্ট অ্যাগনস্টিক, অর্থাৎ এর কনসেপ্টগুলো একই প্রসেসের মধ্যে, সকেটের মাধ্যমে, HTTP-এর মাধ্যমে, বা বিভিন্ন মেসেজ পাসিং এনভায়রনমেন্টে ব্যবহার করা যেতে পারে। এটি ডেটা ফরম্যাট হিসেবে JSON (RFC 4627) ব্যবহার করে।

ক্লায়েন্ট ইমপ্লিমেন্টেশন

JSON-RPC স্পেসিফিকেশন বাস্তবায়ন করার সময় ইথিরিয়াম ক্লায়েন্টগুলো প্রত্যেকে বিভিন্ন প্রোগ্রামিং ভাষা ব্যবহার করতে পারে। নির্দিষ্ট প্রোগ্রামিং ভাষা সম্পর্কিত আরও বিস্তারিত তথ্যের জন্য স্বতন্ত্র ক্লায়েন্ট ডকুমেন্টেশন দেখুন। সর্বশেষ API সাপোর্ট তথ্যের জন্য আমরা প্রতিটি ক্লায়েন্টের ডকুমেন্টেশন দেখার পরামর্শ দিই।

সুবিধাজনক লাইব্রেরি

যদিও আপনি JSON-RPC API-এর মাধ্যমে সরাসরি ইথিরিয়াম ক্লায়েন্টগুলোর সাথে ইন্টারঅ্যাক্ট করা বেছে নিতে পারেন, ডিএ্যাপ ডেভেলপারদের জন্য প্রায়শই আরও সহজ বিকল্প থাকে। JSON-RPC API-এর উপরে র‍্যাপার (wrappers) প্রদান করার জন্য অনেক JavaScript এবং backend API লাইব্রেরি রয়েছে। এই লাইব্রেরিগুলোর সাহায্যে, ডেভেলপাররা তাদের পছন্দের প্রোগ্রামিং ভাষায় সহজে বোধগম্য, এক-লাইনের মেথড লিখতে পারেন যা ইথিরিয়ামের সাথে ইন্টারঅ্যাক্ট করার জন্য (পর্দার আড়ালে) JSON-RPC রিকোয়েস্ট ইনিশিয়ালাইজ করে।

কনসেন্সাস ক্লায়েন্ট এপিআই

এই পৃষ্ঠাটি মূলত ইথিরিয়াম এক্সিকিউশন ক্লায়েন্ট দ্বারা ব্যবহৃত JSON-RPC এপিআই নিয়ে আলোচনা করে। তবে, কনসেন্সাস ক্লায়েন্টগুলোরও একটি RPC এপিআই রয়েছে যা ব্যবহারকারীদের সরাসরি একটি নোড থেকে নোড সম্পর্কে তথ্য অনুসন্ধান করতে, বিকন ব্লক, বিকন স্টেট এবং অন্যান্য কনসেন্সাস-সম্পর্কিত তথ্যের জন্য অনুরোধ করতে দেয়। এই এপিআইটি Beacon API ওয়েবপেজে (opens in a new tab) নথিভুক্ত করা আছে।

একটি নোডের মধ্যে আন্তঃ-ক্লায়েন্ট যোগাযোগের জন্যও একটি অভ্যন্তরীণ এপিআই ব্যবহৃত হয় - অর্থাৎ, এটি কনসেন্সাস ক্লায়েন্ট এবং এক্সিকিউশন ক্লায়েন্টকে ডাটা সোয়াপ করতে সক্ষম করে। একে 'Engine API' বলা হয় এবং এর স্পেসিফিকেশনগুলো GitHub (opens in a new tab)-এ পাওয়া যায়।

এক্সিকিউশন ক্লায়েন্ট স্পেক

GitHub-এ সম্পূর্ণ JSON-RPC API স্পেক পড়ুন (opens in a new tab)। এই API-টি Execution API ওয়েবপেজে (opens in a new tab) ডকুমেন্ট করা হয়েছে এবং এতে উপলব্ধ সমস্ত মেথডগুলো পরীক্ষা করে দেখার জন্য একটি ইন্সপেক্টর অন্তর্ভুক্ত রয়েছে।

নিয়মাবলী

হেক্স ভ্যালু এনকোডিং

JSON-এর মাধ্যমে দুটি মূল ডাটা টাইপ পাস করা হয়: আনফরম্যাটেড বাইট অ্যারে এবং পরিমাণ (quantities)। উভয়ই হেক্স এনকোডিংয়ের মাধ্যমে পাস করা হয় তবে ফরম্যাটিংয়ের জন্য এদের ভিন্ন ভিন্ন প্রয়োজনীয়তা রয়েছে।

পরিমাণ (Quantities)

পরিমাণ (পূর্ণসংখ্যা, সংখ্যা) এনকোড করার সময়: হেক্স হিসেবে এনকোড করুন, শুরুতে "0x" যুক্ত করুন, যা সবচেয়ে কমপ্যাক্ট রূপ (সামান্য ব্যতিক্রম: শূন্যকে "0x0" হিসেবে উপস্থাপন করা উচিত)।

এখানে কিছু উদাহরণ দেওয়া হলো:

• 0x41 (ডেসিমালে 65)
• 0x400 (ডেসিমালে 1024)
• ভুল: 0x (সর্বদা অন্তত একটি ডিজিট থাকতে হবে - শূন্য হলো "0x0")
• ভুল: 0x0400 (শুরুতে শূন্য থাকা যাবে না)
• ভুল: ff (শুরুতে 0x থাকতে হবে)

আনফরম্যাটেড ডাটা

আনফরম্যাটেড ডাটা (বাইট অ্যারে, একাউন্ট এডড্রেস, হ্যাস, বাইটকোড অ্যারে) এনকোড করার সময়: হেক্স হিসেবে এনকোড করুন, শুরুতে "0x" যুক্ত করুন, প্রতি বাইটের জন্য দুটি হেক্স ডিজিট ব্যবহার করুন।

এখানে কিছু উদাহরণ দেওয়া হলো:

• 0x41 (সাইজ 1, "A")
• 0x004200 (সাইজ 3, "0B0")
• 0x (সাইজ 0, "")
• ভুল: 0xf0f0f (ডিজিটের সংখ্যা জোড় হতে হবে)
• ভুল: 004200 (শুরুতে 0x থাকতে হবে)

ব্লক প্যারামিটার

নিচের মেথডগুলোতে একটি ব্লক প্যারামিটার রয়েছে:

• eth_getBalance
• eth_getCode
• eth_getTransactionCount
• eth_getStorageAt
• eth_call

যখন ইথিরিয়ামের স্টেট কোয়েরি করার জন্য রিকোয়েস্ট করা হয়, তখন প্রদত্ত ব্লক প্যারামিটারটি ব্লকের উচ্চতা (height) নির্ধারণ করে।

ব্লক প্যারামিটারের জন্য নিচের অপশনগুলো ব্যবহার করা যেতে পারে:

• HEX String - একটি পূর্ণসংখ্যা ব্লক নম্বর
• String "earliest" - সবচেয়ে প্রথম/জেনেসিস ব্লকের জন্য
• String "latest" - সর্বশেষ প্রস্তাবিত ব্লকের জন্য
• String "safe" - সর্বশেষ নিরাপদ হেড ব্লকের জন্য
• String "finalized" - সর্বশেষ চূড়ান্ত হওয়া ব্লকের জন্য
• String "pending" - পেন্ডিং স্টেট/লেনদেন এর জন্য

উদাহরণ

এই পৃষ্ঠায় আমরা কমান্ড লাইন টুল, curl (opens in a new tab) ব্যবহার করে স্বতন্ত্র JSON_RPC API এন্ডপয়েন্টগুলো কীভাবে ব্যবহার করতে হয় তার উদাহরণ প্রদান করি। এই স্বতন্ত্র এন্ডপয়েন্টের উদাহরণগুলো নিচে Curl উদাহরণ বিভাগে পাওয়া যাবে। পৃষ্ঠার আরও নিচের দিকে, একটি Geth নোড, JSON_RPC API এবং curl ব্যবহার করে একটি স্মার্ট কন্ট্রাক্ট কম্পাইল এবং ডিপ্লয় করার জন্য আমরা একটি এন্ড-টু-এন্ড উদাহরণ-ও প্রদান করি।

Curl এর উদাহরণ

একটি ইথিরিয়াম নোড-এ curl (opens in a new tab) রিকোয়েস্ট করার মাধ্যমে JSON_RPC API ব্যবহারের উদাহরণ নিচে দেওয়া হলো। প্রতিটি উদাহরণে নির্দিষ্ট এন্ডপয়েন্টের বিবরণ, এর প্যারামিটার, রিটার্ন টাইপ এবং এটি কীভাবে ব্যবহার করা উচিত তার একটি কার্যকরী উদাহরণ অন্তর্ভুক্ত রয়েছে।

curl রিকোয়েস্টগুলো কন্টেন্ট টাইপ সম্পর্কিত একটি এরর মেসেজ রিটার্ন করতে পারে। এর কারণ হলো --data অপশনটি কন্টেন্ট টাইপকে application/x-www-form-urlencoded হিসেবে সেট করে। যদি আপনার নোড এই বিষয়ে অভিযোগ করে, তবে কলের শুরুতে -H "Content-Type: application/json" বসিয়ে ম্যানুয়ালি হেডার সেট করুন। উদাহরণগুলোতে URL/IP এবং পোর্ট এর সংমিশ্রণ অন্তর্ভুক্ত করা হয়নি, যা curl-এ দেওয়া শেষ আর্গুমেন্ট হতে হবে (যেমন, 127.0.0.1:8545)। এই অতিরিক্ত ডেটাসহ একটি সম্পূর্ণ curl রিকোয়েস্ট নিচের রূপটি ধারণ করে:

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545

গসিপ, স্টেট, হিস্ট্রি

কয়েকটি মূল JSON-RPC মেথডের জন্য ইথিরিয়াম নেটওয়ার্ক থেকে ডেটার প্রয়োজন হয় এবং এগুলোকে সুন্দরভাবে তিনটি প্রধান ক্যাটাগরিতে ভাগ করা যায়: গসিপ, স্টেট এবং হিস্ট্রি। প্রতিটি মেথডে যেতে এই সেকশনগুলোর লিংক ব্যবহার করুন, অথবা মেথডগুলোর সম্পূর্ণ তালিকা দেখতে সূচিপত্র (table of contents) ব্যবহার করুন।

গসিপ মেথড

এই মেথডগুলো চেইনের হেড (head) ট্র্যাক করে। এভাবেই লেনদেন নেটওয়ার্ক এর চারপাশে তাদের পথ তৈরি করে, ব্লকস-এ তাদের জায়গা খুঁজে পায় এবং ক্লায়েন্টরা নতুন ব্লকস সম্পর্কে জানতে পারে।

• eth_blockNumber
• eth_sendRawTransaction

স্টেট মেথড

যে মেথডগুলো সংরক্ষিত সমস্ত ডেটার বর্তমান স্টেট রিপোর্ট করে। "স্টেট" হলো একটি বড় শেয়ার করা RAM-এর মতো, এবং এর মধ্যে একাউন্ট ব্যালেন্স, কন্ট্রাক্ট ডেটা এবং গ্যাস এস্টিমেশন অন্তর্ভুক্ত থাকে।

• eth_getBalance
• eth_getStorageAt
• eth_getTransactionCount
• eth_getCode
• eth_call
• eth_estimateGas

হিস্ট্রি মেথড

জেনেসিস (genesis) পর্যন্ত প্রতিটি ব্লক-এর ঐতিহাসিক রেকর্ড নিয়ে আসে। এটি একটি বড় অ্যাপেন্ড-অনলি (append-only) ফাইলের মতো, এবং এর মধ্যে সমস্ত ব্লক হেডার, ব্লক বডি, আঙ্কেল ব্লকস (uncle blocks) এবং লেনদেন রিসিপ্ট অন্তর্ভুক্ত থাকে।

• eth_getBlockTransactionCountByHash
• eth_getBlockTransactionCountByNumber
• eth_getUncleCountByBlockHash
• eth_getUncleCountByBlockNumber
• eth_getBlockByHash
• eth_getBlockByNumber
• eth_getTransactionByHash
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex
• eth_getTransactionReceipt
• eth_getUncleByBlockHashAndIndex
• eth_getUncleByBlockNumberAndIndex

JSON-RPC API প্লেগ্রাউন্ড

API মেথডগুলো আবিষ্কার করতে এবং পরীক্ষা করে দেখতে আপনি প্লেগ্রাউন্ড টুল (opens in a new tab) ব্যবহার করতে পারেন। এটি আপনাকে আরও দেখায় যে বিভিন্ন নোড প্রোভাইডার দ্বারা কোন মেথড এবং নেটওয়ার্কগুলো সমর্থিত।

JSON-RPC এপিআই মেথড

web3_clientVersion

বর্তমান ক্লায়েন্ট ভার্সন রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

String - বর্তমান ক্লায়েন্ট ভার্সন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// ফলাফল
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}

web3_sha3

প্রদত্ত ডাটার Keccak-256 (স্ট্যান্ডার্ডাইজড SHA3-256 নয়) রিটার্ন করে।

প্যারামিটার

1. DATA - SHA3 হ্যাসে রূপান্তর করার জন্য ডাটা

params: ["0x68656c6c6f20776f726c64"]

রিটার্নস

DATA - প্রদত্ত স্ট্রিংয়ের SHA3 ফলাফল।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// ফলাফল
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

বর্তমান নেটওয়ার্ক আইডি রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

String - বর্তমান নেটওয়ার্ক আইডি।

বর্তমান নেটওয়ার্ক আইডিগুলোর সম্পূর্ণ তালিকা chainlist.org (opens in a new tab)-এ পাওয়া যাবে। কিছু সাধারণ আইডি হলো:

• 1: ইথিরিয়াম মেইননেট
• 11155111: Sepolia টেস্টনেট
• 560048 : Hoodi টেস্টনেট

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// ফলাফল
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

net_listening

ক্লায়েন্ট যদি সক্রিয়ভাবে নেটওয়ার্ক কানেকশনের জন্য লিসেন করে, তবে true রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

Boolean - লিসেন করার সময় true, অন্যথায় false।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// ফলাফল
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

বর্তমানে ক্লায়েন্টের সাথে সংযুক্ত পিয়ারের সংখ্যা রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

QUANTITY - সংযুক্ত পিয়ারের সংখ্যার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// ফলাফল
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

বর্তমান ইথিরিয়াম প্রটোকল ভার্সন রিটার্ন করে। মনে রাখবেন যে এই মেথডটি Geth-এ উপলব্ধ নয় (opens in a new tab)।

প্যারামিটার

কোনোটি নয়

রিটার্নস

String - বর্তমান ইথিরিয়াম প্রটোকল ভার্সন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// ফলাফল
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

সিঙ্ক স্ট্যাটাস সম্পর্কিত ডাটা সহ একটি অবজেক্ট অথবা false রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

সঠিক রিটার্ন ডাটা ক্লায়েন্ট ইমপ্লিমেন্টেশনের উপর ভিত্তি করে পরিবর্তিত হয়। নোড সিঙ্ক না হলে সব ক্লায়েন্ট False রিটার্ন করে এবং সব ক্লায়েন্ট নিচের ফিল্ডগুলো রিটার্ন করে।

Object|Boolean, সিঙ্ক স্ট্যাটাস ডাটা সহ একটি অবজেক্ট অথবা সিঙ্ক না হলে FALSE:

• startingBlock: QUANTITY - যে ব্লক থেকে ইমপোর্ট শুরু হয়েছে (সিঙ্ক তার হেডে পৌঁছানোর পরেই কেবল রিসেট হবে)
• currentBlock: QUANTITY - বর্তমান ব্লক, eth_blockNumber এর মতই
• highestBlock: QUANTITY - আনুমানিক সর্বোচ্চ ব্লক

তবে, আলাদা ক্লায়েন্টগুলো অতিরিক্ত ডাটাও প্রদান করতে পারে। উদাহরণস্বরূপ Geth নিচের ডাটা রিটার্ন করে:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "currentBlock": "0x3cf522",
    "healedBytecodeBytes": "0x0",
    "healedBytecodes": "0x0",
    "healedTrienodes": "0x0",
    "healingBytecode": "0x0",
    "healingTrienodes": "0x0",
    "highestBlock": "0x3e0e41",
    "startingBlock": "0x3cbed5",
    "syncedAccountBytes": "0x0",
    "syncedAccounts": "0x0",
    "syncedBytecodeBytes": "0x0",
    "syncedBytecodes": "0x0",
    "syncedStorage": "0x0",
    "syncedStorageBytes": "0x0"
  }
}

যেখানে Besu রিটার্ন করে:

{
  "jsonrpc": "2.0",
  "id": 51,
  "result": {
    "startingBlock": "0x0",
    "currentBlock": "0x1518",
    "highestBlock": "0x9567a3",
    "pulledStates": "0x203ca",
    "knownStates": "0x200636"
  }
}

আরও বিস্তারিত তথ্যের জন্য আপনার নির্দিষ্ট ক্লায়েন্টের ডকুমেন্টেশন দেখুন।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": {
    startingBlock: '0x384',
    currentBlock: '0x386',
    highestBlock: '0x454'
  }
}
// অথবা যখন সিঙ্ক হচ্ছে না
{
  "id":1,
  "jsonrpc": "2.0",
  "result": false
}

eth_coinbase

ক্লায়েন্ট কয়েনবেস এডড্রেস রিটার্ন করে।

নোট: এই মেথডটি v1.14.0 থেকে বাতিল করা হয়েছে এবং আর সাপোর্ট করা হয় না। এই মেথডটি ব্যবহার করার চেষ্টা করলে "Method not supported" এরর দেখাবে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

DATA, 20 bytes - বর্তমান কয়েনবেস এডড্রেস।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// ফলাফল
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_chainId

রিপ্লে-প্রোটেক্টেড লেনদেন সাইন করার জন্য ব্যবহৃত চেইন আইডি রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

chainId, বর্তমান চেইন আইডির ইন্টিজারকে উপস্থাপনকারী স্ট্রিং হিসেবে হেক্সাডেসিমাল ভ্যালু।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// ফলাফল
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "0x1"
}

eth_mining

ক্লায়েন্ট যদি সক্রিয়ভাবে নতুন ব্লক মাইন করে, তবে true রিটার্ন করে। এটি শুধুমাত্র প্রুফ-অফ-ওয়ার্ক নেটওয়ার্কের জন্য true রিটার্ন করতে পারে এবং The Merge-এর পর থেকে কিছু ক্লায়েন্টে উপলব্ধ নাও থাকতে পারে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

Boolean - ক্লায়েন্ট মাইন করলে true রিটার্ন করে, অন্যথায় false।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'

{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

নোডটি প্রতি সেকেন্ডে কতগুলো হ্যাস দিয়ে মাইন করছে তা রিটার্ন করে। এটি শুধুমাত্র প্রুফ-অফ-ওয়ার্ক নেটওয়ার্কের জন্য true রিটার্ন করতে পারে এবং The Merge-এর পর থেকে কিছু ক্লায়েন্টে উপলব্ধ নাও থাকতে পারে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

QUANTITY - প্রতি সেকেন্ডে হ্যাসের সংখ্যা।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// ফলাফল
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

wei-তে প্রতি গ্যাসের বর্তমান মূল্যের একটি অনুমান রিটার্ন করে। উদাহরণস্বরূপ, Besu ক্লায়েন্ট ডিফল্টভাবে শেষ 100টি ব্লক পরীক্ষা করে এবং মিডিয়ান গ্যাস ইউনিট প্রাইস রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

QUANTITY - wei-তে বর্তমান গ্যাস প্রাইস এর ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// ফলাফল
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 ওয়েই
}

eth_accounts

ক্লায়েন্টের মালিকানাধীন এডড্রেসগুলোর একটি তালিকা রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

Array of DATA, 20 Bytes - ক্লায়েন্টের মালিকানাধীন এডড্রেসগুলো।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_blockNumber

সবচেয়ে সাম্প্রতিক ব্লকের নম্বর রিটার্ন করে।

প্যারামিটার

কোনোটি নয়

রিটার্নস

QUANTITY - ক্লায়েন্ট বর্তমানে যে ব্লক নম্বরে আছে তার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// ফলাফল
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getBalance

প্রদত্ত এডড্রেসে থাকা একাউন্টের ব্যালেন্স রিটার্ন করে।

প্যারামিটার

1. DATA, 20 Bytes - ব্যালেন্স চেক করার এডড্রেস।
2. QUANTITY|TAG - ইন্টিজার ব্লক নম্বর, অথবা স্ট্রিং "latest", "earliest", "pending", "safe", বা "finalized", block parameter দেখুন

params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

রিটার্নস

QUANTITY - wei-তে বর্তমান ব্যালেন্সের ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_getStorageAt

প্রদত্ত এডড্রেসের একটি স্টোরেজ পজিশন থেকে ভ্যালু রিটার্ন করে।

প্যারামিটার

1. DATA, 20 Bytes - স্টোরেজের এডড্রেস।
2. QUANTITY - স্টোরেজে পজিশনের ইন্টিজার।
3. QUANTITY|TAG - ইন্টিজার ব্লক নম্বর, অথবা স্ট্রিং "latest", "earliest", "pending", "safe", "finalized", block parameter দেখুন

রিটার্নস

DATA - এই স্টোরেজ পজিশনের ভ্যালু।

উদাহরণ সঠিক পজিশন গণনা করা নির্ভর করে কোন স্টোরেজটি রিট্রিভ করা হবে তার উপর। 0x391694e7e0b0cce554cb130d723a9d27458f9298 এডড্রেস দ্বারা 0x295a70b2de5e3953354a6a8344e616ed314d7251-এ ডিপ্লয় করা নিচের কন্ট্রাক্টটি বিবেচনা করুন।

contract Storage {
    uint pos0;
    mapping(address => uint) pos1;
    constructor() {
        pos0 = 1234;
        pos1[msg.sender] = 5678;
    }
}

pos0 এর ভ্যালু রিট্রিভ করা সহজ:

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}

ম্যাপের একটি এলিমেন্ট রিট্রিভ করা তুলনামূলক কঠিন। ম্যাপে একটি এলিমেন্টের পজিশন গণনা করা হয় এভাবে:

keccak(LeftPad32(key, 0), LeftPad32(map position, 0))

এর মানে হলো pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] এর স্টোরেজ রিট্রিভ করতে আমাদের পজিশন গণনা করতে হবে এভাবে:

keccak(
  decodeHex(
    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
      "0000000000000000000000000000000000000000000000000000000000000001"
  )
)

web3 লাইব্রেরির সাথে আসা geth কনসোলটি এই গণনার জন্য ব্যবহার করা যেতে পারে:

> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
undefined
> web3.sha3(key, {"encoding": "hex"})
"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"

এখন স্টোরেজ ফেচ করতে:

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}

eth_getTransactionCount

একটি এডড্রেস থেকে পাঠানো লেনদেনের সংখ্যা রিটার্ন করে।

প্যারামিটার

1. DATA, 20 Bytes - এডড্রেস।
2. QUANTITY|TAG - ইন্টিজার ব্লক নম্বর, অথবা স্ট্রিং "latest", "earliest", "pending", "safe" বা "finalized", block parameter দেখুন

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "latest", // সর্বশেষ ব্লকের স্টেট
]

রিটার্নস

QUANTITY - এই এডড্রেস থেকে পাঠানো লেনদেনের সংখ্যার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

প্রদত্ত ব্লক হ্যাসের সাথে মিলে যাওয়া একটি ব্লকের লেনদেনের সংখ্যা রিটার্ন করে।

প্যারামিটার

1. DATA, 32 Bytes - একটি ব্লকের হ্যাস

params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

রিটার্নস

QUANTITY - এই ব্লকের লেনদেনের সংখ্যার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getBlockTransactionCountByNumber

প্রদত্ত ব্লক নম্বরের সাথে মিলে যাওয়া একটি ব্লকের লেনদেনের সংখ্যা রিটার্ন করে।

প্যারামিটার

1. QUANTITY|TAG - একটি ব্লক নম্বরের ইন্টিজার, অথবা স্ট্রিং "earliest", "latest", "pending", "safe" বা "finalized", যেমনটি block parameter-এ আছে।

params: [
  "0x13738ca", // 20396234
]

রিটার্নস

QUANTITY - এই ব্লকের লেনদেনের সংখ্যার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getUncleCountByBlockHash

প্রদত্ত ব্লক হ্যাসের সাথে মিলে যাওয়া একটি ব্লকের আঙ্কেল (uncles) সংখ্যা রিটার্ন করে।

প্যারামিটার

1. DATA, 32 Bytes - একটি ব্লকের হ্যাস

params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

রিটার্নস

QUANTITY - এই ব্লকের আঙ্কেল সংখ্যার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

প্রদত্ত ব্লক নম্বরের সাথে মিলে যাওয়া একটি ব্লকের আঙ্কেল সংখ্যা রিটার্ন করে।

প্যারামিটার

1. QUANTITY|TAG - একটি ব্লক নম্বরের ইন্টিজার, অথবা স্ট্রিং "latest", "earliest", "pending", "safe" বা "finalized", block parameter দেখুন

params: [
  "0xe8", // 232
]

রিটার্নস

QUANTITY - এই ব্লকের আঙ্কেল সংখ্যার ইন্টিজার।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0" // 0
}

eth_getCode

প্রদত্ত এডড্রেসের কোড রিটার্ন করে।

প্যারামিটার

1. DATA, 20 Bytes - এডড্রেস
2. QUANTITY|TAG - ইন্টিজার ব্লক নম্বর, অথবা স্ট্রিং "latest", "earliest", "pending", "safe" বা "finalized", block parameter দেখুন

params: [
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "0x5daf3b", // 6139707
]

রিটার্নস

DATA - প্রদত্ত এডড্রেস থেকে কোড।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}

eth_sign

sign মেথডটি একটি ইথিরিয়াম নির্দিষ্ট সিগনেচার গণনা করে: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))) দিয়ে।

মেসেজে একটি প্রিফিক্স যোগ করার মাধ্যমে গণনা করা সিগনেচারটি ইথিরিয়াম নির্দিষ্ট সিগনেচার হিসেবে চেনা যায়। এটি অপব্যবহার রোধ করে যেখানে একটি ক্ষতিকারক ডিএ্যাপ ইচ্ছামতো ডাটা (যেমন, লেনদেন) সাইন করতে পারে এবং সিগনেচারটি ব্যবহার করে ভিকটিমের ছদ্মবেশ ধারণ করতে পারে।

নোট: সাইন করার এডড্রেসটি অবশ্যই আনলক করা থাকতে হবে।

প্যারামিটার

1. DATA, 20 Bytes - এডড্রেস
2. DATA, N Bytes - সাইন করার মেসেজ

রিটার্নস

DATA: সিগনেচার

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

একটি লেনদেন সাইন করে যা পরবর্তীতে eth_sendRawTransaction ব্যবহার করে নেটওয়ার্কে সাবমিট করা যেতে পারে।

প্যারামিটার

1. Object - লেনদেন অবজেক্ট

• type:
• from: DATA, 20 Bytes - যে এডড্রেস থেকে লেনদেন পাঠানো হয়।
• to: DATA, 20 Bytes - (নতুন কন্ট্রাক্ট তৈরি করার সময় ঐচ্ছিক) যে এডড্রেসে লেনদেন নির্দেশিত হয়।
• gas: QUANTITY - (ঐচ্ছিক, ডিফল্ট: 90000) লেনদেন এক্সিকিউশনের জন্য প্রদত্ত গ্যাসের ইন্টিজার। এটি অব্যবহৃত গ্যাস রিটার্ন করবে।
• gasPrice: QUANTITY - (ঐচ্ছিক, ডিফল্ট: To-Be-Determined) প্রতিটি পেইড গ্যাসের জন্য ব্যবহৃত gasPrice এর ইন্টিজার, Wei-তে।
• value: QUANTITY - (ঐচ্ছিক) এই লেনদেনের সাথে পাঠানো ভ্যালুর ইন্টিজার, Wei-তে।
• data: DATA - একটি কন্ট্রাক্টের কম্পাইল করা কোড অথবা ইনভোক করা মেথড সিগনেচার এবং এনকোড করা প্যারামিটারের হ্যাস।
• nonce: QUANTITY - (ঐচ্ছিক) একটি নন্স এর ইন্টিজার। এটি একই নন্স ব্যবহার করা আপনার নিজের পেন্ডিং লেনদেনগুলোকে ওভাররাইট করার অনুমতি দেয়।

রিটার্নস

DATA, নির্দিষ্ট একাউন্ট দ্বারা সাইন করা RLP-এনকোডেড লেনদেন অবজেক্ট।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// ফলাফল
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

নতুন মেসেজ কল লেনদেন বা একটি কন্ট্রাক্ট তৈরি করে, যদি ডাটা ফিল্ডে কোড থাকে, এবং from-এ নির্দিষ্ট করা একাউন্ট ব্যবহার করে এটি সাইন করে।

প্যারামিটার

1. Object - লেনদেন অবজেক্ট

• from: DATA, 20 Bytes - যে এডড্রেস থেকে লেনদেন পাঠানো হয়।
• to: DATA, 20 Bytes - (নতুন কন্ট্রাক্ট তৈরি করার সময় ঐচ্ছিক) যে এডড্রেসে লেনদেন নির্দেশিত হয়।
• gas: QUANTITY - (ঐচ্ছিক, ডিফল্ট: 90000) লেনদেন এক্সিকিউশনের জন্য প্রদত্ত গ্যাসের ইন্টিজার। এটি অব্যবহৃত গ্যাস রিটার্ন করবে।
• gasPrice: QUANTITY - (ঐচ্ছিক, ডিফল্ট: To-Be-Determined) প্রতিটি পেইড গ্যাসের জন্য ব্যবহৃত gasPrice এর ইন্টিজার।
• value: QUANTITY - (ঐচ্ছিক) এই লেনদেনের সাথে পাঠানো ভ্যালুর ইন্টিজার।
• input: DATA - একটি কন্ট্রাক্টের কম্পাইল করা কোড অথবা ইনভোক করা মেথড সিগনেচার এবং এনকোড করা প্যারামিটারের হ্যাস।
• nonce: QUANTITY - (ঐচ্ছিক) একটি নন্স এর ইন্টিজার। এটি একই নন্স ব্যবহার করা আপনার নিজের পেন্ডিং লেনদেনগুলোকে ওভাররাইট করার অনুমতি দেয়।

params: [
  {
    from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
    to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    gas: "0x76c0", // 30400
    gasPrice: "0x9184e72a000", // 10000000000000
    value: "0x9184e72a", // 2441406250
    input:
      "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
  },
]

রিটার্নস

DATA, 32 Bytes - লেনদেনের হ্যাস, অথবা লেনদেনটি এখনও উপলব্ধ না হলে জিরো হ্যাস।

আপনি যখন একটি কন্ট্রাক্ট তৈরি করেন, তখন লেনদেনটি একটি ব্লকে প্রস্তাবিত হওয়ার পর কন্ট্রাক্ট এডড্রেস পেতে eth_getTransactionReceipt ব্যবহার করুন।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

সাইন করা লেনদেনের জন্য নতুন মেসেজ কল লেনদেন বা একটি কন্ট্রাক্ট তৈরি করে।

প্যারামিটার

1. DATA, সাইন করা লেনদেনের ডাটা।

params: [
  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]

রিটার্নস

DATA, 32 Bytes - লেনদেনের হ্যাস, অথবা লেনদেনটি এখনও উপলব্ধ না হলে জিরো হ্যাস।

আপনি যখন একটি কন্ট্রাক্ট তৈরি করেন, তখন লেনদেনটি একটি ব্লকে প্রস্তাবিত হওয়ার পর কন্ট্রাক্ট এডড্রেস পেতে eth_getTransactionReceipt ব্যবহার করুন।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

ব্লকচেইনে কোনো লেনদেন তৈরি না করেই তাৎক্ষণিকভাবে একটি নতুন মেসেজ কল এক্সিকিউট করে। প্রায়শই রিড-অনলি স্মার্ট কন্ট্রাক্ট ফাংশন এক্সিকিউট করার জন্য ব্যবহৃত হয়, উদাহরণস্বরূপ একটি ERC-20 কন্ট্রাক্টের জন্য balanceOf।

প্যারামিটার

1. Object - লেনদেন কল অবজেক্ট

• from: DATA, 20 Bytes - (ঐচ্ছিক) যে এডড্রেস থেকে লেনদেন পাঠানো হয়।
• to: DATA, 20 Bytes - যে এডড্রেসে লেনদেন নির্দেশিত হয়।
• gas: QUANTITY - (ঐচ্ছিক) লেনদেন এক্সিকিউশনের জন্য প্রদত্ত গ্যাসের ইন্টিজার। eth_call শূন্য গ্যাস খরচ করে, তবে কিছু এক্সিকিউশনের জন্য এই প্যারামিটারটির প্রয়োজন হতে পারে।
• gasPrice: QUANTITY - (ঐচ্ছিক) প্রতিটি পেইড গ্যাসের জন্য ব্যবহৃত gasPrice এর ইন্টিজার
• value: QUANTITY - (ঐচ্ছিক) এই লেনদেনের সাথে পাঠানো ভ্যালুর ইন্টিজার
• input: DATA - (ঐচ্ছিক) মেথড সিগনেচার এবং এনকোড করা প্যারামিটারের হ্যাস। বিস্তারিত জানতে Solidity ডকুমেন্টেশনে ইথিরিয়াম কন্ট্রাক্ট ABI (opens in a new tab) দেখুন।

2. QUANTITY|TAG - ইন্টিজার ব্লক নম্বর, অথবা স্ট্রিং "latest", "earliest", "pending", "safe" বা "finalized", block parameter দেখুন

রিটার্নস

DATA - এক্সিকিউট করা কন্ট্রাক্টের রিটার্ন ভ্যালু।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

eth_estimateGas

লেনদেনটি সম্পন্ন করার জন্য কতটুকু গ্যাস প্রয়োজন তার একটি অনুমান তৈরি করে এবং রিটার্ন করে। লেনদেনটি ব্লকচেইনে যোগ করা হবে না। মনে রাখবেন যে ইভিএম মেকানিক্স এবং নোড পারফরম্যান্স সহ বিভিন্ন কারণে লেনদেনের দ্বারা প্রকৃতপক্ষে ব্যবহৃত গ্যাসের পরিমাণের চেয়ে অনুমানটি উল্লেখযোগ্যভাবে বেশি হতে পারে।

প্যারামিটার

eth_call প্যারামিটারগুলো দেখুন, তবে সব প্রপার্টি ঐচ্ছিক। যদি কোনো গ্যাস লিমিট নির্দিষ্ট করা না থাকে তবে geth পেন্ডিং ব্লক থেকে ব্লক গ্যাস লিমিটকে আপার বাউন্ড হিসেবে ব্যবহার করে। ফলস্বরূপ, যখন গ্যাসের পরিমাণ পেন্ডিং ব্লক গ্যাস লিমিটের চেয়ে বেশি হয় তখন কল/লেনদেন এক্সিকিউট করার জন্য রিটার্ন করা অনুমানটি যথেষ্ট নাও হতে পারে।

রিটার্নস

QUANTITY - ব্যবহৃত গ্যাসের পরিমাণ।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

হ্যাস দ্বারা একটি ব্লক সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. DATA, 32 Bytes - একটি ব্লকের হ্যাস।
2. Boolean - যদি true হয় তবে এটি সম্পূর্ণ লেনদেন অবজেক্টগুলো রিটার্ন করে, যদি false হয় তবে শুধুমাত্র লেনদেনের হ্যাসগুলো।

params: [
  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
  false,
]

রিটার্নস

Object - একটি ব্লক অবজেক্ট, অথবা কোনো ব্লক পাওয়া না গেলে null:

• number: QUANTITY - ব্লক নম্বর। পেন্ডিং ব্লক হলে null।
• hash: DATA, 32 Bytes - ব্লকের হ্যাস। পেন্ডিং ব্লক হলে null।
• parentHash: DATA, 32 Bytes - প্যারেন্ট ব্লকের হ্যাস।
• nonce: DATA, 8 Bytes - জেনারেট করা প্রুফ-অফ-ওয়ার্ক এর হ্যাস। পেন্ডিং ব্লক হলে null, প্রুফ-অফ-স্টেক ব্লকের জন্য 0x0 (The Merge এর পর থেকে)
• sha3Uncles: DATA, 32 Bytes - ব্লকে থাকা আঙ্কেল ডাটার SHA3।
• logsBloom: DATA, 256 Bytes - ব্লকের লগগুলোর জন্য ব্লুম ফিল্টার। পেন্ডিং ব্লক হলে null।
• transactionsRoot: DATA, 32 Bytes - ব্লকের লেনদেন ট্রাই (trie) এর রুট।
• stateRoot: DATA, 32 Bytes - ব্লকের চূড়ান্ত স্টেট ট্রাই এর রুট।
• receiptsRoot: DATA, 32 Bytes - ব্লকের রিসিপ্ট ট্রাই এর রুট।
• miner: DATA, 20 Bytes - বেনিফিশিয়ারির এডড্রেস যাকে ব্লক রিওয়ার্ড দেওয়া হয়েছিল।
• difficulty: QUANTITY - এই ব্লকের ডিফিকাল্টির ইন্টিজার।
• totalDifficulty: QUANTITY - এই ব্লক পর্যন্ত চেইনের মোট ডিফিকাল্টির ইন্টিজার।
• extraData: DATA - এই ব্লকের "extra data" ফিল্ড।
• size: QUANTITY - বাইটে এই ব্লকের সাইজের ইন্টিজার।
• gasLimit: QUANTITY - এই ব্লকে অনুমোদিত সর্বোচ্চ গ্যাস।
• gasUsed: QUANTITY - এই ব্লকের সব লেনদেন দ্বারা ব্যবহৃত মোট গ্যাস।
• timestamp: QUANTITY - ব্লকটি কখন কোলেট (collated) করা হয়েছিল তার ইউনিক্স টাইমস্ট্যাম্প।
• transactions: Array - লেনদেন অবজেক্টের অ্যারে, অথবা শেষ প্রদত্ত প্যারামিটারের উপর নির্ভর করে 32 Bytes লেনদেনের হ্যাস।
• uncles: Array - আঙ্কেল হ্যাসের অ্যারে।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
// ফলাফল
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "difficulty": "0x4ea3f27bc",
    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
    "gasLimit": "0x1388",
    "gasUsed": "0x0",
    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
    "nonce": "0x689056015818adbe",
    "number": "0x1b4",
    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x220",
    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
    "timestamp": "0x55ba467c",
    "totalDifficulty": "0x78ed983323d",
    "transactions": [
    ],
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "uncles": [
    ]
  }
}

eth_getBlockByNumber

ব্লক নম্বর দ্বারা একটি ব্লক সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. QUANTITY|TAG - একটি ব্লক নম্বরের ইন্টিজার, অথবা স্ট্রিং "earliest", "latest", "pending", "safe" বা "finalized", যেমনটি block parameter-এ আছে।
2. Boolean - যদি true হয় তবে এটি সম্পূর্ণ লেনদেন অবজেক্টগুলো রিটার্ন করে, যদি false হয় তবে শুধুমাত্র লেনদেনের হ্যাসগুলো।

params: [
  "0x1b4", // 436
  true,
]

রিটার্নস eth_getBlockByHash দেখুন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

ফলাফল eth_getBlockByHash দেখুন

eth_getTransactionByHash

লেনদেনের হ্যাস দ্বারা রিকোয়েস্ট করা একটি লেনদেন সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. DATA, 32 Bytes - লেনদেনের হ্যাস

params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

রিটার্নস

Object - একটি লেনদেন অবজেক্ট, অথবা কোনো লেনদেন পাওয়া না গেলে null:

• blockHash: DATA, 32 Bytes - যে ব্লকে এই লেনদেনটি ছিল তার হ্যাস। পেন্ডিং হলে null।
• blockNumber: QUANTITY - যে ব্লক নম্বরে এই লেনদেনটি ছিল। পেন্ডিং হলে null।
• from: DATA, 20 Bytes - প্রেরকের এডড্রেস।
• gas: QUANTITY - প্রেরক দ্বারা প্রদত্ত গ্যাস।
• gasPrice: QUANTITY - Wei-তে প্রেরক দ্বারা প্রদত্ত গ্যাস প্রাইস।
• hash: DATA, 32 Bytes - লেনদেনের হ্যাস।
• input: DATA - লেনদেনের সাথে পাঠানো ডাটা।
• nonce: QUANTITY - এর আগে প্রেরক দ্বারা করা লেনদেনের সংখ্যা।
• to: DATA, 20 Bytes - প্রাপকের এডড্রেস। কন্ট্রাক্ট তৈরির লেনদেন হলে null।
• transactionIndex: QUANTITY - ব্লকে লেনদেনের ইনডেক্স পজিশনের ইন্টিজার। পেন্ডিং হলে null।
• value: QUANTITY - Wei-তে ট্রান্সফার করা ভ্যালু।
• v: QUANTITY - ECDSA রিকভারি আইডি
• r: QUANTITY - ECDSA সিগনেচার r
• s: QUANTITY - ECDSA সিগনেচার s

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
// ফলাফল
{
  "jsonrpc":"2.0",
  "id":1,
  "result":{
    "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
    "blockNumber":"0x5daf3b", // 6139707
    "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
    "gas":"0xc350", // 50000
    "gasPrice":"0x4a817c800", // 20000000000
    "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
    "input":"0x68656c6c6f21",
    "nonce":"0x15", // 21
    "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
    "transactionIndex":"0x41", // 65
    "value":"0xf3dbb76162000", // 4290000000000000
    "v":"0x25", // 37
    "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
    "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
  }
}

eth_getTransactionByBlockHashAndIndex

ব্লক হ্যাস এবং লেনদেনের ইনডেক্স পজিশন দ্বারা একটি লেনদেন সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. DATA, 32 Bytes - একটি ব্লকের হ্যাস।
2. QUANTITY - লেনদেনের ইনডেক্স পজিশনের ইন্টিজার।

params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

রিটার্নস eth_getTransactionByHash দেখুন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

ফলাফল eth_getTransactionByHash দেখুন

eth_getTransactionByBlockNumberAndIndex

ব্লক নম্বর এবং লেনদেনের ইনডেক্স পজিশন দ্বারা একটি লেনদেন সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. QUANTITY|TAG - একটি ব্লক নম্বর, অথবা স্ট্রিং "earliest", "latest", "pending", "safe" বা "finalized", যেমনটি block parameter-এ আছে।
2. QUANTITY - লেনদেনের ইনডেক্স পজিশন।

params: [
  "0x9c47cf", // 10241999
  "0x24", // 36
]

রিটার্নস eth_getTransactionByHash দেখুন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'

ফলাফল eth_getTransactionByHash দেখুন

eth_getTransactionReceipt

লেনদেনের হ্যাস দ্বারা একটি লেনদেনের রিসিপ্ট রিটার্ন করে।

নোট পেন্ডিং লেনদেনের জন্য রিসিপ্ট উপলব্ধ নয়।

প্যারামিটার

1. DATA, 32 Bytes - লেনদেনের হ্যাস

params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

রিটার্নস Object - একটি লেনদেন রিসিপ্ট অবজেক্ট, অথবা কোনো রিসিপ্ট পাওয়া না গেলে null:

• transactionHash : DATA, 32 Bytes - লেনদেনের হ্যাস।
• transactionIndex: QUANTITY - ব্লকে লেনদেনের ইনডেক্স পজিশনের ইন্টিজার।
• blockHash: DATA, 32 Bytes - যে ব্লকে এই লেনদেনটি ছিল তার হ্যাস।
• blockNumber: QUANTITY - যে ব্লক নম্বরে এই লেনদেনটি ছিল।
• from: DATA, 20 Bytes - প্রেরকের এডড্রেস।
• to: DATA, 20 Bytes - প্রাপকের এডড্রেস। কন্ট্রাক্ট তৈরির লেনদেন হলে null।
• cumulativeGasUsed : QUANTITY - ব্লকে এই লেনদেনটি এক্সিকিউট হওয়ার সময় ব্যবহৃত মোট গ্যাসের পরিমাণ।
• effectiveGasPrice : QUANTITY - প্রতি ইউনিট গ্যাসের জন্য প্রদত্ত বেস ফি এবং টিপের যোগফল।
• gasUsed : QUANTITY - শুধুমাত্র এই নির্দিষ্ট লেনদেন দ্বারা ব্যবহৃত গ্যাসের পরিমাণ।
• contractAddress : DATA, 20 Bytes - তৈরি করা কন্ট্রাক্ট এডড্রেস, যদি লেনদেনটি একটি কন্ট্রাক্ট তৈরি করে থাকে, অন্যথায় null।
• logs: Array - লগ অবজেক্টের অ্যারে, যা এই লেনদেনটি জেনারেট করেছে।
• logsBloom: DATA, 256 Bytes - লাইট ক্লায়েন্টদের দ্রুত সম্পর্কিত লগগুলো রিট্রিভ করার জন্য ব্লুম ফিল্টার।
• type: QUANTITY - লেনদেনের ধরনের ইন্টিজার, লিগ্যাসি লেনদেনের জন্য 0x0, এক্সেস লিস্ট টাইপের জন্য 0x1, ডায়নামিক ফির জন্য 0x2।

এটি আরও রিটার্ন করে যেকোনো একটি :

• root : DATA 32 bytes পোস্ট-ট্রানজেকশন স্টেট রুট (Byzantium এর আগে)
• status: QUANTITY হয় 1 (সফল) অথবা 0 (ব্যর্থ)

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
// ফলাফল
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash":
      "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",
    "blockNumber": "0xeff35f",
    "contractAddress": null, // ঠিকানাটি তৈরি করা হলে তার স্ট্রিং
    "cumulativeGasUsed": "0xa12515",
    "effectiveGasPrice": "0x5a9c688d4",
    "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",
    "gasUsed": "0xb4c8",
    "logs": [{
      // getFilterLogs ইত্যাদি দ্বারা রিটার্ন করা লগ
    }],
    "logsBloom": "0x00...0", // 256 বাইট ব্লুম ফিল্টার
    "status": "0x1",
    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "transactionHash":
      "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
    "transactionIndex": "0x66",
    "type": "0x2"
  }
}

eth_getUncleByBlockHashAndIndex

হ্যাস এবং আঙ্কেল ইনডেক্স পজিশন দ্বারা একটি ব্লকের আঙ্কেল সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. DATA, 32 Bytes - একটি ব্লকের হ্যাস।
2. QUANTITY - আঙ্কেলের ইনডেক্স পজিশন।

params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

রিটার্নস eth_getBlockByHash দেখুন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

ফলাফল eth_getBlockByHash দেখুন

নোট: একটি আঙ্কেলে আলাদা কোনো লেনদেন থাকে না।

eth_getUncleByBlockNumberAndIndex

নম্বর এবং আঙ্কেল ইনডেক্স পজিশন দ্বারা একটি ব্লকের আঙ্কেল সম্পর্কে তথ্য রিটার্ন করে।

প্যারামিটার

1. QUANTITY|TAG - একটি ব্লক নম্বর, অথবা স্ট্রিং "earliest", "latest", "pending", "safe", "finalized", যেমনটি block parameter-এ আছে।
2. QUANTITY - আঙ্কেলের ইনডেক্স পজিশন।

params: [
  "0x29c", // 668
  "0x0", // 0
]

রিটার্নস eth_getBlockByHash দেখুন

নোট: একটি আঙ্কেলে আলাদা কোনো লেনদেন থাকে না।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

ফলাফল eth_getBlockByHash দেখুন

eth_newFilter

স্টেট পরিবর্তন (লগ) হলে নোটিফাই করার জন্য ফিল্টার অপশনের উপর ভিত্তি করে একটি ফিল্টার অবজেক্ট তৈরি করে। স্টেট পরিবর্তন হয়েছে কিনা তা চেক করতে, eth_getFilterChanges কল করুন।

টপিক ফিল্টার নির্দিষ্ট করার বিষয়ে একটি নোট: টপিকগুলো অর্ডার-নির্ভর। [A, B] টপিক সহ একটি লগের লেনদেন নিচের টপিক ফিল্টারগুলোর সাথে মিলে যাবে:

• [] "যেকোনো কিছু"
• [A] "প্রথম পজিশনে A (এবং এরপর যেকোনো কিছু)"
• [null, B] "প্রথম পজিশনে যেকোনো কিছু এবং দ্বিতীয় পজিশনে B (এবং এরপর যেকোনো কিছু)"
• [A, B] "প্রথম পজিশনে A এবং দ্বিতীয় পজিশনে B (এবং এরপর যেকোনো কিছু)"
• [[A, B], [A, B]] "প্রথম পজিশনে (A অথবা B) এবং দ্বিতীয় পজিশনে (A অথবা B) (এবং এরপর যেকোনো কিছু)"
• প্যারামিটার

1. Object - ফিল্টার অপশনগুলো:

• fromBlock: QUANTITY|TAG - (ঐচ্ছিক, ডিফল্ট: "latest") ইন্টিজার ব্লক নম্বর, অথবা সর্বশেষ প্রস্তাবিত ব্লকের জন্য "latest", সর্বশেষ নিরাপদ ব্লকের জন্য "safe", সর্বশেষ চূড়ান্ত ব্লকের জন্য "finalized", অথবা এখনও ব্লকে না থাকা লেনদেনের জন্য "pending", "earliest"।
• toBlock: QUANTITY|TAG - (ঐচ্ছিক, ডিফল্ট: "latest") ইন্টিজার ব্লক নম্বর, অথবা সর্বশেষ প্রস্তাবিত ব্লকের জন্য "latest", সর্বশেষ নিরাপদ ব্লকের জন্য "safe", সর্বশেষ চূড়ান্ত ব্লকের জন্য "finalized", অথবা এখনও ব্লকে না থাকা লেনদেনের জন্য "pending", "earliest"।
• address: DATA|Array, 20 Bytes - (ঐচ্ছিক) কন্ট্রাক্ট এডড্রেস বা এডড্রেসগুলোর একটি তালিকা যেখান থেকে লগগুলো উৎপন্ন হওয়া উচিত।
• topics: Array of DATA, - (ঐচ্ছিক) 32 Bytes DATA টপিকের অ্যারে। টপিকগুলো অর্ডার-নির্ভর। প্রতিটি টপিক "or" অপশন সহ DATA এর একটি অ্যারেও হতে পারে।

params: [
  {
    fromBlock: "0x1",
    toBlock: "0x2",
    address: "0x8888f1f195afa192cfee860698584c030f4c9db1",
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      null,
      [
        "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
        "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",
      ],
    ],
  },
]

রিটার্নস QUANTITY - একটি ফিল্টার আইডি।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_newBlockFilter

নতুন ব্লক আসলে নোটিফাই করার জন্য নোডে একটি ফিল্টার তৈরি করে। স্টেট পরিবর্তন হয়েছে কিনা তা চেক করতে, eth_getFilterChanges কল করুন।

প্যারামিটার কোনোটি নয়

রিটার্নস QUANTITY - একটি ফিল্টার আইডি।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// ফলাফল
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_newPendingTransactionFilter

নতুন পেন্ডিং লেনদেন আসলে নোটিফাই করার জন্য নোডে একটি ফিল্টার তৈরি করে। স্টেট পরিবর্তন হয়েছে কিনা তা চেক করতে, eth_getFilterChanges কল করুন।

প্যারামিটার কোনোটি নয়

রিটার্নস QUANTITY - একটি ফিল্টার আইডি।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// ফলাফল
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_uninstallFilter

প্রদত্ত আইডি সহ একটি ফিল্টার আনইনস্টল করে। যখন আর ওয়াচ করার প্রয়োজন নেই তখন এটি সর্বদা কল করা উচিত। এছাড়া একটি নির্দিষ্ট সময়ের জন্য eth_getFilterChanges দিয়ে রিকোয়েস্ট করা না হলে ফিল্টারগুলো টাইমআউট হয়ে যায়।

প্যারামিটার

1. QUANTITY - ফিল্টার আইডি।

params: [
  "0xb", // 11
]

রিটার্নস Boolean - ফিল্টারটি সফলভাবে আনইনস্টল হলে true, অন্যথায় false।

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// ফলাফল
{
  "id":1,
  "jsonrpc": "2.0",
  "result": true
}

eth_getFilterChanges

একটি ফিল্টারের জন্য পোলিং মেথড, যা শেষ পোলের পর থেকে ঘটা লগগুলোর একটি অ্যারে রিটার্ন করে।

প্যারামিটার

1. QUANTITY - ফিল্টার আইডি।

params: [
  "0x16", // 22
]

রিটার্নস Array - লগ অবজেক্টের অ্যারে, অথবা শেষ পোলের পর থেকে কিছু পরিবর্তন না হলে একটি খালি অ্যারে।

• eth_newBlockFilter দিয়ে তৈরি ফিল্টারের জন্য রিটার্ন হলো ব্লক হ্যাস (DATA, 32 Bytes), যেমন, ["0x3454645634534..."]।

• eth_newPendingTransactionFilter দিয়ে তৈরি ফিল্টারের জন্য রিটার্ন হলো লেনদেনের হ্যাস (DATA, 32 Bytes), যেমন, ["0x6345343454645..."]।

• eth_newFilter দিয়ে তৈরি ফিল্টারের জন্য লগগুলো হলো নিচের প্যারাম সহ অবজেক্ট:

  • removed: TAG - চেইন রিঅর্গানাইজেশনের কারণে লগটি রিমুভ করা হলে true। এটি একটি ভ্যালিড লগ হলে false।
  • logIndex: QUANTITY - ব্লকে লগের ইনডেক্স পজিশনের ইন্টিজার। পেন্ডিং লগ হলে null।
  • transactionIndex: QUANTITY - যে লেনদেনের ইনডেক্স পজিশন থেকে লগটি তৈরি করা হয়েছিল তার ইন্টিজার। পেন্ডিং লগ হলে null।
  • transactionHash: DATA, 32 Bytes - যে লেনদেন থেকে এই লগটি তৈরি করা হয়েছিল তার হ্যাস। পেন্ডিং লগ হলে null।
  • blockHash: DATA, 32 Bytes - যে ব্লকে এই লগটি ছিল তার হ্যাস। পেন্ডিং হলে null। পেন্ডিং লগ হলে null।
  • blockNumber: QUANTITY - যে ব্লক নম্বরে এই লগটি ছিল। পেন্ডিং হলে null। পেন্ডিং লগ হলে null।
  • address: DATA, 20 Bytes - যে এডড্রেস থেকে এই লগটি উৎপন্ন হয়েছে।
  • data: DATA - ভেরিয়েবল-লেংথ নন-ইনডেক্সড লগ ডাটা। (solidity-তে: শূন্য বা ততোধিক 32 Bytes নন-ইনডেক্সড লগ আর্গুমেন্ট।)
  • topics: Array of DATA - ইনডেক্সড লগ আর্গুমেন্টের 0 থেকে 4টি 32 Bytes DATA এর অ্যারে। (solidity-তে: প্রথম টপিকটি হলো ইভেন্টের সিগনেচারের হ্যাস (যেমন, Deposit(address,bytes32,uint256)), যদি না আপনি ইভেন্টটিকে anonymous স্পেসিফায়ার দিয়ে ডিক্লেয়ার করে থাকেন।)

• উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
// ফলাফল
{
  "id":1,
  "jsonrpc":"2.0",
  "result": [{
    "logIndex": "0x1", // 1
    "blockNumber":"0x1b4", // 436
    "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
    "transactionHash":  "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
    "transactionIndex": "0x0", // 0
    "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
    "data":"0x0000000000000000000000000000000000000000000000000000000000000000",
    "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
    },{
      ...
    }]
}

eth_getFilterLogs

প্রদত্ত আইডি সহ ফিল্টারের সাথে মিলে যাওয়া সব লগের একটি অ্যারে রিটার্ন করে।

প্যারামিটার

1. QUANTITY - ফিল্টার আইডি।

params: [
  "0x16", // 22
]

রিটার্নস eth_getFilterChanges দেখুন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

ফলাফল eth_getFilterChanges দেখুন

eth_getLogs

প্রদত্ত ফিল্টার অবজেক্টের সাথে মিলে যাওয়া সব লগের একটি অ্যারে রিটার্ন করে।

প্যারামিটার

1. Object - ফিল্টার অপশনগুলো:

• fromBlock: QUANTITY|TAG - (ঐচ্ছিক, ডিফল্ট: "latest") ইন্টিজার ব্লক নম্বর, অথবা সর্বশেষ প্রস্তাবিত ব্লকের জন্য "latest", সর্বশেষ নিরাপদ ব্লকের জন্য "safe", সর্বশেষ চূড়ান্ত ব্লকের জন্য "finalized", অথবা এখনও ব্লকে না থাকা লেনদেনের জন্য "pending", "earliest"।
• toBlock: QUANTITY|TAG - (ঐচ্ছিক, ডিফল্ট: "latest") ইন্টিজার ব্লক নম্বর, অথবা সর্বশেষ প্রস্তাবিত ব্লকের জন্য "latest", সর্বশেষ নিরাপদ ব্লকের জন্য "safe", সর্বশেষ চূড়ান্ত ব্লকের জন্য "finalized", অথবা এখনও ব্লকে না থাকা লেনদেনের জন্য "pending", "earliest"।
• address: DATA|Array, 20 Bytes - (ঐচ্ছিক) কন্ট্রাক্ট এডড্রেস বা এডড্রেসগুলোর একটি তালিকা যেখান থেকে লগগুলো উৎপন্ন হওয়া উচিত।
• topics: Array of DATA, - (ঐচ্ছিক) 32 Bytes DATA টপিকের অ্যারে। টপিকগুলো অর্ডার-নির্ভর। প্রতিটি টপিক "or" অপশন সহ DATA এর একটি অ্যারেও হতে পারে।
• blockHash: DATA, 32 Bytes - (ঐচ্ছিক, ভবিষ্যৎ) EIP-234 যুক্ত হওয়ার সাথে সাথে, blockHash একটি নতুন ফিল্টার অপশন হবে যা রিটার্ন করা লগগুলোকে 32-বাইট হ্যাস blockHash সহ একক ব্লকে সীমাবদ্ধ করে। blockHash ব্যবহার করা fromBlock = toBlock = blockHash হ্যাস সহ ব্লক নম্বরের সমতুল্য। যদি ফিল্টার ক্রাইটেরিয়াতে blockHash উপস্থিত থাকে, তবে fromBlock বা toBlock কোনোটিই অনুমোদিত নয়।

params: [
  {
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    ],
  },
]

রিটার্নস eth_getFilterChanges দেখুন

উদাহরণ

// রিকোয়েস্ট
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

ফলাফল eth_getFilterChanges দেখুন

ব্যবহারের উদাহরণ

JSON_RPC ব্যবহার করে একটি কন্ট্রাক্ট ডিপ্লয় করা

এই বিভাগে শুধুমাত্র RPC ইন্টারফেস ব্যবহার করে কীভাবে একটি কন্ট্রাক্ট ডিপ্লয় করতে হয় তার একটি ডেমোনস্ট্রেশন বা প্রদর্শন অন্তর্ভুক্ত রয়েছে। কন্ট্রাক্ট ডিপ্লয় করার বিকল্প উপায় রয়েছে যেখানে এই জটিলতাগুলো বিমূর্ত (abstracted) করা হয়—উদাহরণস্বরূপ, RPC ইন্টারফেসের উপর তৈরি লাইব্রেরি যেমন web3.js (opens in a new tab) এবং web3.py (opens in a new tab) ব্যবহার করে। এই অ্যাবস্ট্রাকশনগুলো সাধারণত বুঝতে সহজ এবং এতে ভুলের সম্ভাবনা কম থাকে, তবে এর পেছনের কাজগুলো কীভাবে হচ্ছে তা বোঝা এখনও বেশ সহায়ক।

নিচে Multiply7 নামের একটি সাধারণ স্মার্ট কন্ট্রাক্ট দেওয়া হলো যা JSON-RPC ইন্টারফেস ব্যবহার করে একটি ইথিরিয়াম নোড-এ ডিপ্লয় করা হবে। এই টিউটোরিয়ালটি ধরে নেয় যে পাঠক ইতিমধ্যে একটি Geth নোড চালাচ্ছেন। নোড এবং ক্লায়েন্ট সম্পর্কে আরও তথ্য এখানে পাওয়া যাবে। নন-Geth ক্লায়েন্টগুলোর জন্য কীভাবে HTTP JSON-RPC চালু করতে হয় তা দেখতে অনুগ্রহ করে নির্দিষ্ট ক্লায়েন্ট ডকুমেন্টেশন দেখুন। বেশিরভাগ ক্লায়েন্ট ডিফল্টভাবে localhost:8545-এ সার্ভ করে।

contract Multiply7 {
    event Print(uint);
    function multiply(uint input) returns (uint) {
        Print(input * 7);
        return input * 7;
    }
}

প্রথমেই নিশ্চিত করতে হবে যে HTTP RPC ইন্টারফেসটি চালু আছে। এর মানে হলো স্টার্টআপের সময় আমরা Geth-কে --http ফ্ল্যাগ প্রদান করি। এই উদাহরণে আমরা একটি প্রাইভেট ডেভেলপমেন্ট চেইনে Geth নোড ব্যবহার করছি। এই পদ্ধতি ব্যবহার করলে আসল নেটওয়ার্ক-এ আমাদের ইথার (ether)-এর প্রয়োজন হবে না।

geth --http --dev console 2>>geth.log

এটি http://localhost:8545-এ HTTP RPC ইন্টারফেস চালু করবে।

আমরা curl (opens in a new tab) ব্যবহার করে কয়েনবেস এডড্রেস (একাউন্ট-এর অ্যারে থেকে প্রথম এডড্রেসটি পেয়ে) এবং ব্যালেন্স পুনরুদ্ধার করে ইন্টারফেসটি চলছে কিনা তা যাচাই করতে পারি। অনুগ্রহ করে মনে রাখবেন যে এই উদাহরণগুলোর ডেটা আপনার লোকাল নোড-এ ভিন্ন হবে। আপনি যদি এই কমান্ডগুলো চেষ্টা করতে চান, তবে দ্বিতীয় curl রিকোয়েস্টের রিকোয়েস্ট প্যারামিটারগুলো প্রথমটি থেকে প্রাপ্ত ফলাফল দিয়ে প্রতিস্থাপন করুন।

curl --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[], "id":1}' -H "Content-Type: application/json" localhost:8545
{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}

curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545
{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}

যেহেতু সংখ্যাগুলো হেক্স এনকোড করা, তাই ব্যালেন্সটি wei-তে একটি হেক্স স্ট্রিং হিসেবে ফেরত দেওয়া হয়। আমরা যদি ব্যালেন্সটি ইথার-এ একটি সংখ্যা হিসেবে পেতে চাই তবে আমরা Geth কনসোল থেকে web3 ব্যবহার করতে পারি।

web3.fromWei("0x1639e49bba16280000", "ether")
// "410"

যেহেতু এখন আমাদের প্রাইভেট ডেভেলপমেন্ট চেইনে কিছু ইথার আছে, আমরা কন্ট্রাক্টটি ডিপ্লয় করতে পারি। প্রথম ধাপ হলো Multiply7 কন্ট্রাক্টটিকে বাইট কোডে কম্পাইল করা যা EVM-এ পাঠানো যেতে পারে। সলিডিটি (Solidity) কম্পাইলার solc ইনস্টল করতে, Solidity documentation (opens in a new tab) অনুসরণ করুন। (আপনি হয়তো আমাদের উদাহরণের জন্য ব্যবহৃত কম্পাইলারের সংস্করণের (opens in a new tab) সাথে মেলাতে একটি পুরোনো solc রিলিজ ব্যবহার করতে চাইতে পারেন।)

পরবর্তী ধাপ হলো Multiply7 কন্ট্রাক্টটিকে বাইট কোডে কম্পাইল করা যা EVM-এ পাঠানো যেতে পারে।

echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin

======= <stdin>:Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029

এখন যেহেতু আমাদের কাছে কম্পাইল করা কোড আছে, আমাদের নির্ধারণ করতে হবে এটি ডিপ্লয় করতে কত গ্যাস খরচ হবে। RPC ইন্টারফেসে একটি eth_estimateGas মেথড রয়েছে যা আমাদের একটি আনুমানিক হিসাব দেবে।

curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}

এবং সবশেষে কন্ট্রাক্টটি ডিপ্লয় করুন।

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545
{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}

লেনদেন-টি নোড দ্বারা গৃহীত হয় এবং একটি লেনদেন হ্যাস ফেরত দেওয়া হয়। এই হ্যাস-টি লেনদেন ট্র্যাক করতে ব্যবহার করা যেতে পারে। পরবর্তী ধাপ হলো আমাদের কন্ট্রাক্টটি কোথায় ডিপ্লয় করা হয়েছে সেই এডড্রেস নির্ধারণ করা। প্রতিটি সম্পাদিত লেনদেন একটি রসিদ (receipt) তৈরি করবে। এই রসিদে লেনদেন সম্পর্কে বিভিন্ন তথ্য থাকে যেমন লেনদেন-টি কোন ব্লক-এ অন্তর্ভুক্ত ছিল এবং EVM দ্বারা কত গ্যাস ব্যবহার করা হয়েছিল। যদি কোনো লেনদেন একটি কন্ট্রাক্ট তৈরি করে তবে এতে কন্ট্রাক্ট এডড্রেস-ও থাকবে। আমরা eth_getTransactionReceipt RPC মেথড দিয়ে রসিদটি পুনরুদ্ধার করতে পারি।

curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}

আমাদের কন্ট্রাক্টটি 0x4d03d617d700cf81935d7f797f4e2ae719648262-এ তৈরি করা হয়েছিল। রসিদের পরিবর্তে একটি নাল (null) ফলাফলের অর্থ হলো লেনদেন-টি এখনও কোনো ব্লক-এ অন্তর্ভুক্ত হয়নি। কিছুক্ষণ অপেক্ষা করুন এবং আপনার কনসেন্সাস ক্লায়েন্ট চলছে কিনা তা পরীক্ষা করে আবার চেষ্টা করুন।

স্মার্ট কন্ট্রাক্ট-এর সাথে ইন্টারঅ্যাক্ট করা

এই উদাহরণে আমরা কন্ট্রাক্টের multiply মেথডে eth_sendTransaction ব্যবহার করে একটি লেনদেন পাঠাব।

eth_sendTransaction-এর জন্য বেশ কয়েকটি আর্গুমেন্ট প্রয়োজন, বিশেষ করে from, to এবং data। From হলো আমাদের একাউন্ট-এর পাবলিক এডড্রেস, এবং to হলো কন্ট্রাক্ট এডড্রেস। data আর্গুমেন্টে একটি পেলোড থাকে যা নির্ধারণ করে কোন মেথডটি কল করতে হবে এবং কোন আর্গুমেন্টগুলোর সাথে। এখানেই ABI (অ্যাপ্লিকেশন বাইনারি ইন্টারফেস) (opens in a new tab) কাজে আসে। ABI হলো একটি JSON ফাইল যা নির্ধারণ করে কীভাবে EVM-এর জন্য ডেটা সংজ্ঞায়িত এবং এনকোড করতে হয়।

পেলোডের বাইটগুলো নির্ধারণ করে কন্ট্রাক্টের কোন মেথডটি কল করা হয়েছে। এটি ফাংশনের নাম এবং এর আর্গুমেন্টের ধরনগুলোর উপর Keccak হ্যাস থেকে প্রথম 4 বাইট, যা হেক্স এনকোড করা। multiply ফাংশনটি একটি uint গ্রহণ করে যা uint256-এর একটি উপনাম (alias)। এটি আমাদের যা দেয় তা হলো:

web3.sha3("multiply(uint256)").substring(0, 10)
// "0xc6888fa1"

পরবর্তী ধাপ হলো আর্গুমেন্টগুলো এনকোড করা। এখানে শুধুমাত্র একটি uint256 আছে, ধরা যাক, মানটি হলো 6। ABI-তে একটি বিভাগ রয়েছে যা নির্দিষ্ট করে কীভাবে uint256 ধরনগুলো এনকোড করতে হয়।

int<M>: enc(X) হলো X-এর বিগ-এন্ডিয়ান টুস কমপ্লিমেন্ট (two’s complement) এনকোডিং, যা নেগেটিভ X-এর জন্য উচ্চ-ক্রম (বাম) দিকে 0xff দিয়ে এবং পজিটিভ X-এর জন্য শূন্য > বাইট দিয়ে প্যাড করা হয় যাতে এর দৈর্ঘ্য 32 বাইটের গুণিতক হয়।

এটি 0000000000000000000000000000000000000000000000000000000000000006-এ এনকোড হয়।

ফাংশন সিলেক্টর এবং এনকোড করা আর্গুমেন্ট একত্রিত করলে আমাদের ডেটা হবে 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006।

এটি এখন নোড-এ পাঠানো যেতে পারে:

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545
{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}

যেহেতু একটি লেনদেন পাঠানো হয়েছিল, তাই একটি লেনদেন হ্যাস ফেরত দেওয়া হয়েছে। রসিদটি পুনরুদ্ধার করলে পাওয়া যায়:

{
   blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
   blockNumber: 268,
   contractAddress: null,
   cumulativeGasUsed: 22631,
   gasUsed: 22631,
   logs: [{
      address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",
      blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
      blockNumber: 268,
      data: "0x000000000000000000000000000000000000000000000000000000000000002a",
      logIndex: 0,
      topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],
      transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
      transactionIndex: 0
  }],
  transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
  transactionIndex: 0
}

রসিদটিতে একটি লগ রয়েছে। এই লগটি লেনদেন সম্পাদনের সময় EVM দ্বারা তৈরি করা হয়েছিল এবং রসিদে অন্তর্ভুক্ত করা হয়েছিল। multiply ফাংশনটি দেখায় যে ইনপুটের 7 গুণের সাথে Print ইভেন্টটি রেইজ করা হয়েছিল। যেহেতু Print ইভেন্টের আর্গুমেন্টটি একটি uint256 ছিল, তাই আমরা এটিকে ABI নিয়ম অনুযায়ী ডিকোড করতে পারি যা আমাদের প্রত্যাশিত ডেসিমাল 42 দেবে। ডেটা ছাড়াও এটি লক্ষণীয় যে টপিকগুলো ব্যবহার করে নির্ধারণ করা যেতে পারে কোন ইভেন্টটি লগ তৈরি করেছে:

web3.sha3("Print(uint256)")
// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"

এটি ছিল সবচেয়ে সাধারণ কিছু কাজের একটি সংক্ষিপ্ত পরিচিতি, যা JSON-RPC-এর সরাসরি ব্যবহার প্রদর্শন করে।

সম্পর্কিত বিষয়সমূহ

• JSON-RPC স্পেসিফিকেশন (opens in a new tab)
• নোড এবং ক্লায়েন্ট
• জাভাস্ক্রিপ্ট API
• ব্যাকএন্ড API
• এক্সিকিউশন ক্লায়েন্ট