Transfer
+``` + +এটি কম্পোনেন্টের HTML (আরও সঠিকভাবে, [JSX](https://react.dev/learn/writing-markup-with-jsx)) ফরম্যাট। + +#### `server/noir/src/main.nr` {#server-noir-src-main-nr} + +[এই ফাইলটি](https://github.com/qbzzt/250911-zk-bank/blob/01-manual-zk/server/noir/src/main.nr) হল আসল জিরো-নলেজ কোড। + +``` +use std::hash::pedersen_hash; +``` + +[পেডারসেন হ্যাস](https://rya-sge.github.io/access-denied/2024/05/07/pedersen-hash-function/) [Noir স্ট্যান্ডার্ড লাইব্রেরি](https://noir-lang.org/docs/noir/standard_library/cryptographic_primitives/hashes#pedersen_hash)-র সাথে প্রদান করা হয়। জিরো-নলেজ প্রুফ সাধারণত এই হ্যাস ফাংশনটি ব্যবহার করে। স্ট্যান্ডার্ড হ্যাস ফাংশনগুলির তুলনায় এটি [অ্যারিথমেটিক সার্কিট](https://rareskills.io/post/arithmetic-circuit)-এর ভিতরে গণনা করা অনেক সহজ। + +``` +use keccak256::keccak256; +use dep::ecrecover; +``` + +এই দুটি ফাংশন হল এক্সটার্নাল লাইব্রেরি, যা [`Nargo.toml`](https://github.com/qbzzt/250911-zk-bank/blob/01-manual-zk/server/noir/Nargo.toml)-এ সংজ্ঞায়িত। এগুলি ঠিক তাদের নামের মতোই, একটি ফাংশন যা [keccak256 হ্যাস](https://emn178.github.io/online-tools/keccak_256.html) গণনা করে এবং একটি ফাংশন যা ইথেরিয়াম সিগনেচার যাচাই করে এবং স্বাক্ষরকারীর ইথেরিয়াম অ্যাড্রেস পুনরুদ্ধার করে। + +``` +global ACCOUNT_NUMBER : u32 = 5; +``` + +Noir [Rust](https://www.rust-lang.org/) দ্বারা অনুপ্রাণিত। ভেরিয়েবলগুলো, ডিফল্টরূপে, ধ্রুবক। আমরা এইভাবে গ্লোবাল কনফিগারেশন ধ্রুবক সংজ্ঞায়িত করি। বিশেষত, `ACCOUNT_NUMBER` হল আমাদের সংরক্ষিত অ্যাকাউন্টের সংখ্যা। + +`uGreeter
+Greeter
+ { + !readResults.isError && !readResults.isLoading && ++``` + +একটি `ShowGreeting` কম্পোনেন্ট তৈরি করুন (নিচে ব্যাখ্যা করা হয়েছে), কিন্তু শুধুমাত্র যদি ব্লকচেইন থেকে অভিবাদনটি সফলভাবে পড়া হয়। + +```tsx + +``` + +এটি ইনপুট টেক্সট ফিল্ড যেখানে ব্যবহারকারী একটি নতুন অভিবাদন সেট করতে পারে। প্রতিবার ব্যবহারকারী একটি কী চাপলে, আমরা `greetingChange` কল করি যা `setNewGreeting` কল করে। `setNewGreeting` `useState` হুক থেকে আসার কারণে, এটি `Greeter` কম্পোনেন্টকে আবার রেন্ডার করায়। এর মানে হল: + +- আমাদের নতুন অভিবাদনের মান রাখতে `value` নির্দিষ্ট করতে হবে, কারণ অন্যথায় এটি ডিফল্ট, খালি স্ট্রিং-এ ফিরে যাবে। +- `usePrepareContractWrite` প্রতিবার `newGreeting` পরিবর্তনের সময় কল করা হয়, যার মানে এটি সর্বদা প্রস্তুত লেনদেনে সর্বশেষ `newGreeting` থাকবে। + +```tsx + +``` + +যদি `workingTx.write` না থাকে তবে আমরা এখনও অভিবাদন আপডেট পাঠানোর জন্য প্রয়োজনীয় তথ্যের জন্য অপেক্ষা করছি, তাই বোতামটি নিষ্ক্রিয় থাকে। যদি একটি `workingTx.write` মান থাকে তবে সেটি হল লেনদেন পাঠানোর জন্য কল করার ফাংশন। + +```tsx +
+
+```
+
+আমরা UI-কে সমস্ত তথ্য দিয়ে বিশৃঙ্খল করতে চাই না, তাই সেগুলি দেখতে বা বন্ধ করা সম্ভব করার জন্য, আমরা একটি [`details`](https://www.w3schools.com/tags/tag_details.asp) ট্যাগ ব্যবহার করি।
+
+```tsx
+
+
+}
+```
+
+বিভিন্ন HTML ট্যাগ শেষ করুন।
+
+##### চূড়ান্ত `export` {#the-final-export}
+
+```tsx
+export { Greeter }
+```
+
+`Greeter` কম্পোনেন্টটি হল সেইটি যা আমাদের অ্যাপ্লিকেশনের জন্য এক্সপোর্ট করতে হবে।
+
+#### `src/wagmi.ts` {#wagmi-ts}
+
+অবশেষে, WAGMI সম্পর্কিত বিভিন্ন সংজ্ঞা `src/wagmi.ts`-এ রয়েছে। আমি এখানে সবকিছু ব্যাখ্যা করতে যাচ্ছি না, কারণ এর বেশিরভাগই বয়লারপ্লেট যা আপনার পরিবর্তন করার প্রয়োজন হওয়ার সম্ভাবনা কম।
+
+এখানকার কোডটি [গিটহাবে](https://github.com/qbzzt/20230801-modern-ui/blob/main/src/wagmi.ts) থাকা কোডের মতো ঠিক একই নয় কারণ পরে নিবন্ধে আমরা আরেকটি চেইন ([Redstone Holesky](https://redstone.xyz/docs/network-info)) যোগ করি।
+
+```ts
+import { getDefaultWallets } from '@rainbow-me/rainbowkit'
+import { configureChains, createConfig } from 'wagmi'
+import { holesky, sepolia } from 'wagmi/chains'
+```
+
+অ্যাপ্লিকেশনটি সমর্থন করে এমন ব্লকচেইনগুলি ইম্পোর্ট করুন। আপনি সমর্থিত চেইনের তালিকা [viem গিটহাবে](https://github.com/wagmi-dev/viem/tree/main/src/chains/definitions) দেখতে পারেন।
+
+```ts
+import { publicProvider } from 'wagmi/providers/public'
+
+const walletConnectProjectId = 'c96e690bb92b6311e8e9b2a6a22df575'
+```
+
+[WalletConnect](https://walletconnect.com/) ব্যবহার করতে সক্ষম হতে আপনার অ্যাপ্লিকেশনের জন্য একটি প্রজেক্ট আইডি প্রয়োজন। আপনি এটি [cloud.walletconnect.com](https://cloud.walletconnect.com/sign-in) থেকে পেতে পারেন।
+
+```ts
+const { chains, publicClient, webSocketPublicClient } = configureChains(
+ [ holesky, sepolia ],
+ [
+ publicProvider(),
+ ],
+)
+
+const { connectors } = getDefaultWallets({
+ appName: 'My wagmi + RainbowKit App',
+ chains,
+ projectId: walletConnectProjectId,
+})
+
+export const config = createConfig({
+ autoConnect: true,
+ connectors,
+ publicClient,
+ webSocketPublicClient,
+})
+
+export { chains }
+```
+
+### আরেকটি ব্লকচেইন যোগ করা {#add-blockchain}
+
+আজকাল অনেক [L2 স্কেলিং সমাধান](/layer-2/) রয়েছে, এবং আপনি হয়তো এমন কিছু সমর্থন করতে চাইতে পারেন যা viem এখনও সমর্থন করে না। এটি করার জন্য, আপনি `src/wagmi.ts` পরিবর্তন করুন। এই নির্দেশাবলী ব্যাখ্যা করে কিভাবে [Redstone Holesky](https://redstone.xyz/docs/network-info) যোগ করতে হয়।
+
+1. viem থেকে `defineChain` টাইপ ইম্পোর্ট করুন।
+
+ ```ts
+ import { defineChain } from 'viem'
+ ```
+
+2. নেটওয়ার্ক সংজ্ঞা যোগ করুন।
+
+ ```ts
+ const redstoneHolesky = defineChain({
+ id: 17_001,
+ name: 'Redstone Holesky',
+ network: 'redstone-holesky',
+ nativeCurrency: {
+ decimals: 18,
+ name: 'Ether',
+ symbol: 'ETH',
+ },
+ rpcUrls: {
+ default: {
+ http: ['https://rpc.holesky.redstone.xyz'],
+ webSocket: ['wss://rpc.holesky.redstone.xyz/ws'],
+ },
+ public: {
+ http: ['https://rpc.holesky.redstone.xyz'],
+ webSocket: ['wss://rpc.holesky.redstone.xyz/ws'],
+ },
+ },
+ blockExplorers: {
+ default: { name: 'Explorer', url: 'https://explorer.holesky.redstone.xyz' },
+ },
+ })
+ ```
+
+3. `configureChains` কলে নতুন চেইন যোগ করুন।
+
+ ```ts
+ const { chains, publicClient, webSocketPublicClient } = configureChains(
+ [ holesky, sepolia, redstoneHolesky ],
+ [ publicProvider(), ],
+ )
+ ```
+
+4. নিশ্চিত করুন যে অ্যাপ্লিকেশনটি নতুন নেটওয়ার্কে আপনার কন্ট্র্যাক্টের জন্য ঠিকানাটি জানে। এই ক্ষেত্রে, আমরা `src/components/Greeter.tsx` পরিবর্তন করি:
+
+ ```ts
+ const contractAddrs : AddressPerBlockchainType = {
+ // Holesky
+ 17000: '0x432d810484AdD7454ddb3b5311f0Ac2E95CeceA8',
+
+ // Redstone Holesky
+ 17001: '0x4919517f82a1B89a32392E1BF72ec827ba9986D3',
+
+ // Sepolia
+ 11155111: '0x7143d5c190F048C8d19fe325b748b081903E3BF0'
+ }
+ ```
+
+## উপসংহার {#conclusion}
+
+অবশ্যই, আপনি `Greeter`-এর জন্য একটি ইউজার ইন্টারফেস সরবরাহ করার বিষয়ে সত্যিই চিন্তা করেন না। আপনি আপনার নিজের কন্ট্র্যাক্টের জন্য একটি ইউজার ইন্টারফেস তৈরি করতে চান। আপনার নিজের অ্যাপ্লিকেশন তৈরি করতে, এই ধাপগুলি চালান:
+
+1. একটি wagmi অ্যাপ্লিকেশন তৈরি করতে নির্দিষ্ট করুন।
+
+ ```sh copy
+ pnpm create wagmi
+ ```
+
+2. অ্যাপ্লিকেশনটির নাম দিন।
+
+3. **React** ফ্রেমওয়ার্ক নির্বাচন করুন।
+
+4. **Vite** ভেরিয়েন্ট নির্বাচন করুন।
+
+5. আপনি [Rainbow kit যোগ করতে পারেন](https://www.rainbowkit.com/docs/installation#manual-setup)।
+
+এখন যান এবং আপনার কন্ট্র্যাক্টগুলি বৃহত্তর বিশ্বের জন্য ব্যবহারযোগ্য করে তুলুন।
+
+[আমার আরও কাজের জন্য এখানে দেখুন](https://cryptodocguy.pro/)।
+
diff --git a/public/content/translations/bn/developers/tutorials/deploying-your-first-smart-contract/index.md b/public/content/translations/bn/developers/tutorials/deploying-your-first-smart-contract/index.md
new file mode 100644
index 00000000000..626899db906
--- /dev/null
+++ b/public/content/translations/bn/developers/tutorials/deploying-your-first-smart-contract/index.md
@@ -0,0 +1,101 @@
+---
+title: "আপনার প্রথম স্মার্ট কন্ট্র্যাক্ট ডিপ্লয় করা"
+description: "একটি ইথেরিয়াম টেস্ট নেটওয়ার্কে আপনার প্রথম স্মার্ট কন্ট্র্যাক্ট ডিপ্লয় করার একটি ভূমিকা"
+author: "jdourlens"
+tags:
+ [
+ "স্মার্ট কন্ট্র্যাক্ট",
+ "remix",
+ "সলিডিটি",
+ "ডেপ্লয়িং"
+ ]
+skill: beginner
+lang: bn
+published: 2020-04-03
+source: EthereumDev
+sourceUrl: https://ethereumdev.io/deploying-your-first-smart-contract/
+address: "0x19dE91Af973F404EDF5B4c093983a7c6E3EC8ccE"
+---
+
+আমি অনুমান করছি যে আপনিও আমাদের মতোই ইথেরিয়াম ব্লকচেইনে আপনার প্রথম [স্মার্ট কন্ট্র্যাক্ট](/developers/docs/smart-contracts/) [ডিপ্লয়](/developers/docs/smart-contracts/deploying/) করতে এবং তার সাথে ইন্টারঅ্যাক্ট করতে উত্তেজিত।
+
+চিন্তা করবেন না, যেহেতু এটি আমাদের প্রথম স্মার্ট কন্ট্র্যাক্ট, আমরা এটিকে একটি [লোকাল টেস্ট নেটওয়ার্কে](/developers/docs/networks/) ডিপ্লয় করব যাতে এটি ডিপ্লয় করতে এবং আপনার ইচ্ছামত এটি নিয়ে খেলা করতে আপনার কোনো খরচ না হয়।
+
+## আমাদের কন্ট্র্যাক্ট লেখা {#writing-our-contract}
+
+প্রথম ধাপ হল [Remix ভিজিট করা](https://remix.ethereum.org/) এবং একটি নতুন ফাইল তৈরি করা। Remix ইন্টারফেসের উপরের বাম অংশে একটি নতুন ফাইল যোগ করুন এবং আপনার পছন্দের ফাইলের নাম লিখুন।
+
+
+
+নতুন ফাইলে, আমরা নিম্নলিখিত কোডটি পেস্ট করব।
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.5.17;
+
+contract Counter {
+
+ // গণনার সংখ্যা রাখার জন্য আনসাইন্ড int টাইপের পাবলিক ভেরিয়েবল
+ uint256 public count = 0;
+
+ // ফাংশন যা আমাদের কাউন্টারকে বৃদ্ধি করে
+ function increment() public {
+ count += 1;
+ }
+
+ // কাউন্টের মান পাওয়ার জন্য অপ্রয়োজনীয় গেটার
+ function getCount() public view returns (uint256) {
+ return count;
+ }
+
+}
+```
+
+আপনি যদি প্রোগ্রামিংয়ে অভ্যস্ত হন তবে আপনি সহজেই অনুমান করতে পারবেন এই প্রোগ্রামটি কী করে। এখানে লাইন বাই লাইন একটি ব্যাখ্যা দেওয়া হল:
+
+- লাইন 4: আমরা `Counter` নামে একটি কন্ট্র্যাক্ট সংজ্ঞায়িত করি।
+- লাইন 7: আমাদের কন্ট্র্যাক্ট 0 থেকে শুরু করে `count` নামের একটি আনসাইন্ড ইন্টিজার সংরক্ষণ করে।
+- লাইন 10: প্রথম ফাংশনটি কন্ট্র্যাক্টের স্টেট পরিবর্তন করবে এবং আমাদের `count` ভেরিয়েবলকে `increment()` করবে।
+- লাইন 15: দ্বিতীয় ফাংশনটি শুধুমাত্র একটি গেটার যা স্মার্ট কন্ট্র্যাক্টের বাইরে থেকে `count` ভেরিয়েবলের মান পড়তে সক্ষম। মনে রাখবেন, যেহেতু আমরা আমাদের `count` ভেরিয়েবলকে পাবলিক হিসেবে সংজ্ঞায়িত করেছি, এটি প্রয়োজনীয় নয় কিন্তু একটি উদাহরণ হিসেবে দেখানো হয়েছে।
+
+আমাদের প্রথম সহজ স্মার্ট কন্ট্র্যাক্টের জন্য এইটুকুই। আপনি হয়তো জানেন, এটি জাভা বা C++ এর মতো OOP (অবজেক্ট-ওরিয়েন্টেড প্রোগ্রামিং) ভাষাগুলির একটি ক্লাসের মতো দেখায়। এখন আমাদের কন্ট্র্যাক্ট নিয়ে খেলার সময়।
+
+## আমাদের কন্ট্র্যাক্ট ডিপ্লয় করা {#deploying-our-contract}
+
+যেহেতু আমরা আমাদের প্রথম স্মার্ট কন্ট্র্যাক্ট লিখেছি, এখন আমরা এটিকে ব্লকচেইনে ডিপ্লয় করব যাতে আমরা এটি নিয়ে খেলতে পারি।
+
+[ব্লকচেইনে স্মার্ট কন্ট্র্যাক্ট ডিপ্লয় করা](/developers/docs/smart-contracts/deploying/) আসলে কোনো প্রাপক নির্দিষ্ট না করে কম্পাইল করা স্মার্ট কন্ট্র্যাক্টের কোড ধারণকারী একটি লেনদেন পাঠানো মাত্র।
+
+আমরা প্রথমে বাম দিকের কম্পাইল আইকনে ক্লিক করে [কন্ট্র্যাক্টটি কম্পাইল করব](/developers/docs/smart-contracts/compiling/):
+
+
+
+তারপর কম্পাইল বোতামে ক্লিক করুন:
+
+
+
+আপনি "Auto compile" বিকল্পটি নির্বাচন করতে পারেন যাতে আপনি যখন টেক্সট এডিটরে কন্টেন্ট সংরক্ষণ করবেন তখন কন্ট্র্যাক্টটি সর্বদা কম্পাইল করা হবে।
+
+তারপর "deploy and run transactions" স্ক্রিনে নেভিগেট করুন:
+
+
+
+একবার আপনি "deploy and run transactions" স্ক্রিনে এলে, আপনার কন্ট্র্যাক্টের নাম দেখা যাচ্ছে কিনা তা দুবার পরীক্ষা করুন এবং Deploy-এ ক্লিক করুন। যেমনটি আপনি পৃষ্ঠার শীর্ষে দেখতে পাচ্ছেন, বর্তমান এনভায়রনমেন্ট হল "JavaScript VM" যার মানে হল আমরা আমাদের স্মার্ট কন্ট্র্যাক্টটিকে একটি লোকাল টেস্ট ব্লকচেইনে ডিপ্লয় করব এবং তার সাথে ইন্টারঅ্যাক্ট করব যাতে দ্রুত এবং কোনো ফি ছাড়াই পরীক্ষা করা যায়।
+
+
+
+একবার আপনি "Deploy" বোতামে ক্লিক করলে, আপনি দেখতে পাবেন আপনার কন্ট্র্যাক্টটি নীচে উপস্থিত হয়েছে। বাম দিকের তীরটিতে ক্লিক করে এটিকে প্রসারিত করুন যাতে আমরা আমাদের কন্ট্র্যাক্টের কন্টেন্ট দেখতে পারি। এটি হল আমাদের ভেরিয়েবল `counter`, আমাদের `increment()` ফাংশন এবং গেটার `getCounter()`।
+
+আপনি যদি `count` বা `getCount` বোতামে ক্লিক করেন, তবে এটি আসলে কন্ট্র্যাক্টের `count` ভেরিয়েবলের কন্টেন্ট পুনরুদ্ধার করবে এবং এটি প্রদর্শন করবে। যেহেতু আমরা এখনো `increment` ফাংশনটি কল করিনি, এটি 0 প্রদর্শন করবে।
+
+
+
+চলুন এখন বোতামে ক্লিক করে `increment` ফাংশনটিকে কল করি। আপনি দেখতে পাবেন যে লেনদেনগুলির লগ উইন্ডোর নীচে উপস্থিত হচ্ছে। আপনি দেখতে পাবেন যে `increment` বোতামের পরিবর্তে ডেটা পুনরুদ্ধারের জন্য বোতাম টিপলে লগগুলি আলাদা হয়। এর কারণ হল ব্লকচেইনে ডেটা পড়ার জন্য কোনো লেনদেন (লেখা) বা ফি প্রয়োজন হয় না। কারণ শুধুমাত্র ব্লকচেইনের স্টেট পরিবর্তন করার জন্য একটি লেনদেন করতে হয়:
+
+
+
+ইনক্রিমেন্ট বোতামটি চাপার পরে যা আমাদের `increment()` ফাংশনকে কল করার জন্য একটি লেনদেন তৈরি করবে, আমরা যদি কাউন্ট বা getCount বোতামগুলিতে আবার ক্লিক করি তাহলে আমরা আমাদের স্মার্ট কন্ট্র্যাক্টের নতুন আপডেট করা স্টেটটি পড়ব যেখানে কাউন্ট ভেরিয়েবলটি 0-এর চেয়ে বড় হবে।
+
+
+
+পরবর্তী টিউটোরিয়ালে, আমরা কভার করব [কিভাবে আপনি আপনার স্মার্ট কন্ট্র্যাক্টে ইভেন্ট যোগ করতে পারেন](/developers/tutorials/logging-events-smart-contracts/)। লগিং ইভেন্টগুলি হল আপনার স্মার্ট কন্ট্র্যাক্ট ডিবাগ করার এবং একটি ফাংশন কল করার সময় কী ঘটছে তা বোঝার একটি সুবিধাজনক উপায়।
diff --git a/public/content/translations/bn/developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md b/public/content/translations/bn/developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md
new file mode 100644
index 00000000000..8f5e9e82f56
--- /dev/null
+++ b/public/content/translations/bn/developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md
@@ -0,0 +1,372 @@
+---
+title: "একটি স্থানীয়, মাল্টি-ক্লায়েন্ট টেস্টনেটে কীভাবে একটি dApp ডেভেলপ এবং পরীক্ষা করা যায়"
+description: "এই গাইডটি আপনাকে প্রথমে একটি মাল্টি-ক্লায়েন্ট স্থানীয় Ethereum টেস্টনেটকে কীভাবে ইনস্ট্যানশিয়েট এবং কনফিগার করতে হয় তা দেখাবে এবং তারপরে dApp স্থাপন এবং পরীক্ষা করার জন্য টেস্টনেট ব্যবহার করবে।"
+author: "Tedi Mitiku"
+tags:
+ [
+ "ক্লায়েন্ট",
+ "নোড",
+ "স্মার্ট কন্ট্র্যাক্ট",
+ "কম্পোজেবিলিটি",
+ "কনসেন্সাস লেয়ার",
+ "এক্সিকিউশন লেয়ার",
+ "পরীক্ষা"
+ ]
+skill: intermediate
+lang: bn
+published: 2023-04-11
+---
+
+## ভূমিকা {#introduction}
+
+এই গাইডটি আপনাকে একটি কনফিগারযোগ্য স্থানীয় Ethereum টেস্টনেট ইনস্ট্যানশিয়েট করার, এতে একটি স্মার্ট কন্ট্র্যাক্ট স্থাপন করার এবং আপনার dApp-এর বিরুদ্ধে পরীক্ষা চালানোর জন্য টেস্টনেট ব্যবহার করার প্রক্রিয়াটি দেখায়। এই গাইডটি dApp ডেভেলপারদের জন্য ডিজাইন করা হয়েছে যারা একটি লাইভ টেস্টনেট বা মেইননেটে স্থাপন করার আগে বিভিন্ন নেটওয়ার্ক কনফিগারেশনের বিরুদ্ধে স্থানীয়ভাবে তাদের dApps ডেভেলপ এবং পরীক্ষা করতে চান।
+
+এই গাইডে, আপনি যা যা করবেন:
+
+- [Kurtosis](https://www.kurtosis.com/) ব্যবহার করে [`eth-network-package`](https://github.com/kurtosis-tech/eth-network-package)-এর সাথে একটি স্থানীয় Ethereum টেস্টনেট ইনস্ট্যানশিয়েট করুন,
+- একটি dApp কম্পাইল, স্থাপন এবং পরীক্ষা করার জন্য আপনার Hardhat dApp ডেভেলপমেন্ট পরিবেশকে স্থানীয় টেস্টনেটের সাথে সংযুক্ত করুন, এবং
+- বিভিন্ন নেটওয়ার্ক কনফিগারেশনের বিরুদ্ধে ডেভেলপমেন্ট এবং পরীক্ষার কর্মপ্রবাহ সক্রিয় করতে, স্থানীয় টেস্টনেট কনফিগার করুন, যার মধ্যে নোডের সংখ্যা এবং নির্দিষ্ট EL/CL ক্লায়েন্ট পেয়ারিং-এর মতো প্যারামিটার অন্তর্ভুক্ত রয়েছে।
+
+### Kurtosis কী? {#what-is-kurtosis}
+
+[Kurtosis](https://www.kurtosis.com/) একটি কম্পোজেবল বিল্ড সিস্টেম যা মাল্টি-কন্টেইনার পরীক্ষার পরিবেশ কনফিগার করার জন্য ডিজাইন করা হয়েছে। এটি বিশেষভাবে ডেভেলপারদের পুনরুৎপাদনযোগ্য পরিবেশ তৈরি করতে সক্ষম করে যার জন্য ডাইনামিক সেটআপ লজিক প্রয়োজন, যেমন ব্লকচেইন টেস্টনেট।
+
+এই গাইডে, Kurtosis eth-network-package [`geth`](https://geth.ethereum.org/) এক্সিকিউশন লেয়ার (EL) ক্লায়েন্ট, সেইসাথে [`teku`](https://consensys.io/teku), [`lighthouse`](https://lighthouse.sigmaprime.io/), এবং [`lodestar`](https://lodestar.chainsafe.io/) কনসেন্সাস লেয়ার (CL) ক্লায়েন্টগুলির জন্য সমর্থন সহ একটি স্থানীয় Ethereum টেস্টনেট চালু করে। এই প্যাকেজটি Hardhat Network, Ganache, এবং Anvil-এর মতো ফ্রেমওয়ার্কের নেটওয়ার্কগুলির জন্য একটি কনফিগারযোগ্য এবং কম্পোজেবল বিকল্প হিসেবে কাজ করে। Kurtosis ডেভেলপারদের ব্যবহৃত টেস্টনেটের উপর অধিক নিয়ন্ত্রণ এবং নমনীয়তা প্রদান করে, যা [Ethereum Foundation-এর the Merge পরীক্ষা করার জন্য Kurtosis ব্যবহার করার](https://www.kurtosis.com/blog/testing-the-ethereum-merge) একটি প্রধান কারণ এবং নেটওয়ার্ক আপগ্রেড পরীক্ষার জন্য এটি ব্যবহার করা অব্যাহত রয়েছে।
+
+## Kurtosis সেট আপ করা {#setting-up-kurtosis}
+
+এগিয়ে যাওয়ার আগে, নিশ্চিত করুন আপনার কাছে আছে:
+
+- আপনার স্থানীয় মেশিনে [Docker ইঞ্জিন ইনস্টল এবং শুরু করেছেন](https://docs.kurtosis.com/install/#i-install--start-docker)
+- [Kurtosis CLI ইনস্টল করেছেন](https://docs.kurtosis.com/install#ii-install-the-cli) (অথবা যদি আপনার কাছে CLI আগে থেকেই ইনস্টল করা থাকে তবে এটিকে সর্বশেষ রিলিজে আপগ্রেড করেছেন)
+- [Node.js](https://nodejs.org/en), [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable), এবং [npx](https://www.npmjs.com/package/npx) ইনস্টল করেছেন (আপনার dApp পরিবেশের জন্য)
+
+## একটি স্থানীয় Ethereum টেস্টনেট ইনস্ট্যানশিয়েট করা {#instantiate-testnet}
+
+একটি স্থানীয় Ethereum টেস্টনেট চালু করতে, রান করুন:
+
+```python
+kurtosis --enclave local-eth-testnet run github.com/kurtosis-tech/eth-network-package
+```
+
+দ্রষ্টব্য: এই কমান্ডটি `--enclave` ফ্ল্যাগ ব্যবহার করে আপনার নেটওয়ার্কের নাম দেয়: "local-eth-testnet"।
+
+Kurtosis নির্দেশাবলী ব্যাখ্যা, যাচাই এবং তারপর কার্যকর করার জন্য কাজ করার সময় যে পদক্ষেপগুলি নিচ্ছে তা প্রিন্ট করবে। শেষে, আপনার নিম্নলিখিতটির মতো একটি আউটপুট দেখা উচিত:
+
+```python
+INFO[2023-04-04T18:09:44-04:00] ======================================================
+INFO[2023-04-04T18:09:44-04:00] || Created enclave: local-eth-testnet ||
+INFO[2023-04-04T18:09:44-04:00] ======================================================
+Name: local-eth-testnet
+UUID: 39372d756ae8
+Status: RUNNING
+Creation Time: Tue, 04 Apr 2023 18:09:03 EDT
+
+========================================= Files Artifacts =========================================
+UUID Name
+d4085a064230 cl-genesis-data
+1c62cb792e4c el-genesis-data
+bd60489b73a7 genesis-generation-config-cl
+b2e593fe5228 genesis-generation-config-el
+d552a54acf78 geth-prefunded-keys
+5f7e661eb838 prysm-password
+054e7338bb59 validator-keystore-0
+
+========================================== User Services ==========================================
+UUID Name Ports Status
+e20f129ee0c5 cl-client-0-beacon http: 4000/tcp -> {attrs.name}
+
+ {JSON.stringify(attrs.object, null, 2)}
+```
+
+বেশিরভাগ ফিল্ড [`JSON.stringify`](https://www.w3schools.com/js/js_json_stringify.asp) ব্যবহার করে প্রদর্শিত হয়।
+
+```tsx
+
+ { funs.length > 0 &&
+ <>
+ ফাংশন:
+ -
+```
+
+ব্যতিক্রম হল ফাংশন, যা [JSON স্ট্যান্ডার্ডের](https://www.json.org/json-en.html) অংশ নয়, তাই সেগুলিকে আলাদাভাবে প্রদর্শন করতে হবে।
+
+```tsx
+ {funs.map((f, i) =>
+```
+
+JSX-এর মধ্যে, `{` কার্লি ব্র্যাকেট `}` এর ভিতরের কোড জাভাস্ক্রিপ্ট হিসাবে ব্যাখ্যা করা হয়। তারপর, `(` রেগুলার ব্র্যাকেট `)` এর ভিতরের কোডটি আবার JSX হিসাবে ব্যাখ্যা করা হয়।
+
+```tsx
+ (
- {f} ) + )} +``` + +রিয়্যাক্টের [DOM ট্রি](https://www.w3schools.com/js/js_htmldom.asp)-তে ট্যাগগুলির জন্য স্বতন্ত্র শনাক্তকারী প্রয়োজন। এর মানে হল একই ট্যাগের শিশুদের (এই ক্ষেত্রে, [আনঅর্ডারড তালিকা](https://www.w3schools.com/tags/tag_ul.asp)) জন্য ভিন্ন `key` অ্যাট্রিবিউট প্রয়োজন। + +```tsx +
Hello ${loginResponse.extract.nameID}
+ + + `) + res.send(); +``` + +একটি HTML প্রতিক্রিয়া পাঠান, শুধু ব্যবহারকারীকে দেখানোর জন্য যে আমরা লগইন পেয়েছি। + +```typescript + } catch (err) { + console.error('Error processing SAML response:', err); + res.status(400).send('SAML authentication failed'); + } + } +) +``` + +ব্যর্থতার ক্ষেত্রে ব্যবহারকারীকে জানান। + +```typescript +spRouter.get('/login', +``` + +ব্রাউজার যখন এই পৃষ্ঠাটি পাওয়ার চেষ্টা করে তখন একটি লগইন অনুরোধ তৈরি করুন। এটি উপরের সিকোয়েন্স ডায়াগ্রামের ১ নং ধাপের জন্য হ্যান্ডলার। + +```typescript + async (req, res) => { + const loginRequest = await sp.createLoginRequest(idp, "post") +``` + +একটি লগইন অনুরোধ পোস্ট করার জন্য তথ্য পান। + +```typescript + res.send(` + + + +``` + +এই পৃষ্ঠাটি ফর্মটি (নীচে দেখুন) স্বয়ংক্রিয়ভাবে জমা দেয়। এইভাবে ব্যবহারকারীকে পুনঃনির্দেশিত হওয়ার জন্য কিছু করতে হবে না। এটি উপরের সিকোয়েন্স ডায়াগ্রামের ২ নং ধাপ। + +```typescript + + + + `) + } +) + +app.use(express.urlencoded({extended: true})) +``` + +[এই মিডলওয়্যারটি](https://expressjs.com/en/5x/api.html#express.urlencoded) [HTTP অনুরোধের](https://www.tutorialspoint.com/http/http_requests.htm) বডি পড়ে। ডিফল্টভাবে express এটিকে উপেক্ষা করে, কারণ বেশিরভাগ অনুরোধের জন্য এটির প্রয়োজন হয় না। আমাদের এটির প্রয়োজন কারণ POST বডি ব্যবহার করে। + +```typescript +app.use(`/${config.spDir}`, spRouter) +``` + +পরিষেবা প্রদানকারী ডিরেক্টরিতে (`/sp`) রাউটারটি মাউন্ট করুন। + +```typescript +app.get("/", (req, res) => { + res.send(` + + + + + + `) +}) +``` + +যদি কোনো ব্রাউজার রুট ডিরেক্টরি পাওয়ার চেষ্টা করে, তবে তাকে লগইন পৃষ্ঠার একটি লিঙ্ক দিন। + +```typescript +app.listen(config.spPort, () => { + console.log(`service provider is running on http://${config.spHostname}:${config.spPort}`) +}) +``` + +এই express অ্যাপ্লিকেশনটির সাথে `spPort`-এ শুনুন। + +#### src/idp.mts + +এটি হল পরিচয় প্রদানকারী। এটি পরিষেবা প্রদানকারীর মতোই, নীচের ব্যাখ্যাগুলি সেই অংশগুলির জন্য যা ভিন্ন। + +```typescript +const xmlParser = new (await import("fast-xml-parser")).XMLParser( + { + ignoreAttributes: false, // Preserve attributes + attributeNamePrefix: "@_", // Prefix for attributes + } +) +``` + +পরিষেবা প্রদানকারীর কাছ থেকে আমরা যে XML অনুরোধটি পাই তা আমাদের পড়তে এবং বুঝতে হবে। + +```typescript +const getLoginPage = requestId => ` +``` + +এই ফাংশনটি স্বয়ংক্রিয়-জমা দেওয়া ফর্ম সহ পৃষ্ঠাটি তৈরি করে যা উপরের সিকোয়েন্স ডায়াগ্রামের ৪ নং ধাপে ফেরত দেওয়া হয়। + +```typescript + + +লগইন পৃষ্ঠা
+ + + + +const idpRouter = express.Router() + +idpRouter.post("/loginSubmitted", async (req, res) => { + const loginResponse = await idp.createLoginResponse( +``` + +এটি উপরের সিকোয়েন্স ডায়াগ্রামের ৫ নং ধাপের জন্য হ্যান্ডলার। [`idp.createLoginResponse`](https://github.com/tngan/samlify/blob/master/src/entity-idp.ts#L73-L125) লগইন প্রতিক্রিয়া তৈরি করে। + +```typescript + sp, + { + authnContextClassRef: 'urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport', + audience: sp.entityID, +``` + +অডিয়েন্স হল পরিষেবা প্রদানকারী। + +```typescript + extract: { + request: { + id: req.body.requestId + } + }, +``` + +অনুরোধ থেকে নিষ্কাশিত তথ্য। অনুরোধে আমাদের যে একটি প্যারামিটার নিয়ে চিন্তা করতে হয় তা হল requestId, যা পরিষেবা প্রদানকারীকে অনুরোধ এবং তাদের প্রতিক্রিয়াগুলির সাথে মেলাতে দেয়। + +```typescript + signingKey: { privateKey: idpPrivateKey, publicKey: config.idpCert } // Ensure signing +``` + +প্রতিক্রিয়া স্বাক্ষর করার জন্য ডেটা পেতে আমাদের `signingKey` প্রয়োজন। পরিষেবা প্রদানকারী স্বাক্ষরবিহীন অনুরোধ বিশ্বাস করে না। + +```typescript + }, + "post", + { + email: req.body.email +``` + +এটি হল সেই ফিল্ড যেখানে ব্যবহারকারীর তথ্য থাকে যা আমরা পরিষেবা প্রদানকারীকে ফেরত পাঠাই। + +```typescript + } + ); + + res.send(` + + + + + + + + `) +}) +``` + +আবার, একটি স্বয়ংক্রিয়ভাবে জমা দেওয়া ফর্ম ব্যবহার করুন। এটি উপরের সিকোয়েন্স ডায়াগ্রামের ৬ নং ধাপ। + +```typescript + +// IdP endpoint for login requests +idpRouter.post(`/login`, +``` + +এটি সেই এন্ডপয়েন্ট যা পরিষেবা প্রদানকারীর কাছ থেকে একটি লগইন অনুরোধ গ্রহণ করে। এটি উপরের সিকোয়েন্স ডায়াগ্রামের ৩ নং ধাপের হ্যান্ডলার। + +```typescript + async (req, res) => { + try { + // Workaround because I couldn't get parseLoginRequest to work. + // const loginRequest = await idp.parseLoginRequest(sp, 'post', req) + const samlRequest = xmlParser.parse(Buffer.from(req.body.SAMLRequest, 'base64').toString('utf-8')) + res.send(getLoginPage(samlRequest["samlp:AuthnRequest"]["@_ID"])) +``` + +প্রমাণীকরণ অনুরোধের আইডি পড়ার জন্য আমাদের [`idp.parseLoginRequest`](https://github.com/tngan/samlify/blob/master/src/entity-idp.ts#L127-L144) ব্যবহার করতে পারা উচিত। তবে, আমি এটি কাজ করাতে পারিনি এবং এর উপর অনেক সময় ব্যয় করা সার্থক ছিল না তাই আমি শুধু একটি [সাধারণ-উদ্দেশ্যের XML পার্সার](https://www.npmjs.com/package/fast-xml-parser) ব্যবহার করেছি। আমাদের যে তথ্য প্রয়োজন তা হল `অনুগ্রহ করে স্বাক্ষর করুন
+ ++ + + +` +} +``` + +বাকিটা শুধু স্ট্যান্ডার্ড HTML। + +```typescript +idpRouter.get("/signature/:nonce/:account/:signature", async (req, res) => { +``` + +এটি সিকোয়েন্স ডায়াগ্রামের ৫ নং ধাপের জন্য হ্যান্ডলার। + +```typescript + const requestId = nonces[req.params.nonce] + if (requestId === undefined) { + res.send("Bad nonce") + return ; + } + + nonces[req.params.nonce] = undefined +``` + +অনুরোধ আইডি পান, এবং `nonces` থেকে নন্সটি মুছে ফেলুন যাতে এটি পুনরায় ব্যবহার করা না যায়। + +```typescript + try { +``` + +যেহেতু স্বাক্ষরটি অনেক উপায়ে অবৈধ হতে পারে, তাই আমরা এটিকে একটি `try ...`-তে মোড়ানো। `catch` ব্লকে কোনো থ্রো করা ত্রুটি ধরতে। + +```typescript + const validSignature = await verifyMessage({ + address: req.params.account, + message: `${loginPrompt}${req.params.nonce}`, + signature: req.params.signature + }) +``` + +সিকোয়েন্স ডায়াগ্রামে ৫.৫ নং ধাপ বাস্তবায়ন করতে [`verifyMessage`](https://viem.sh/docs/actions/public/verifyMessage#verifymessage) ব্যবহার করুন। + +```typescript + if (!validSignature) + throw("Bad signature") + } catch (err) { + res.send("Error:" + err) + return ; + } +``` + +হ্যান্ডলারের বাকি অংশটি পূর্বে `/loginSubmitted` হ্যান্ডলারে আমরা যা করেছি তার সমতুল্য, শুধুমাত্র একটি ছোট পরিবর্তন ছাড়া। + +```typescript + const loginResponse = await idp.createLoginResponse( + . + . + . + { + email: req.params.account + "@bad.email.address" + } + ); +``` + +আমাদের কাছে আসল ইমেল অ্যাড্রেস নেই (আমরা এটি পরবর্তী বিভাগে পাব), তাই আপাতত আমরা ইথেরিয়াম অ্যাড্রেসটি ফেরত দিই এবং এটিকে স্পষ্টভাবে একটি ইমেল অ্যাড্রেস নয় বলে চিহ্নিত করি। + +```typescript +// IdP endpoint for login requests +idpRouter.post(`/login`, + async (req, res) => { + try { + // Workaround because I couldn't get parseLoginRequest to work. + // const loginRequest = await idp.parseLoginRequest(sp, 'post', req) + const samlRequest = xmlParser.parse(Buffer.from(req.body.SAMLRequest, 'base64').toString('utf-8')) + res.send(getSignaturePage(samlRequest["samlp:AuthnRequest"]["@_ID"])) + } catch (err) { + console.error('Error processing SAML response:', err); + res.status(400).send('SAML authentication failed'); + } + } +) +``` + +`getLoginPage`-এর পরিবর্তে, এখন ৩ নং ধাপের হ্যান্ডলারে `getSignaturePage` ব্যবহার করুন। + +## ইমেল অ্যাড্রেস পাওয়া + +পরবর্তী পদক্ষেপ হল ইমেল অ্যাড্রেস পাওয়া, যা পরিষেবা প্রদানকারীর দ্বারা অনুরোধ করা শনাক্তকারী। এটি করার জন্য, আমরা [ইথেরিয়াম অ্যাটেস্টেশন সার্ভিস (EAS)](https://attest.org/) ব্যবহার করি। + +অ্যাটেস্টেশন পাওয়ার সবচেয়ে সহজ উপায় হল [GraphQL API](https://docs.attest.org/docs/developer-tools/api) ব্যবহার করা। আমরা এই কোয়েরিটি ব্যবহার করি: + +``` +query GetAttestationsByRecipient { + attestations( + where: { + recipient: { equals: "${getAddress(ethAddr)}" } + schemaId: { equals: "0xfa2eff59a916e3cc3246f9aec5e0ca00874ae9d09e4678e5016006f07622f977" } + } + take: 1 + ) { + data + id + attester + } +} +``` + +এই [`schemaId`](https://optimism.easscan.org/schema/view/0xfa2eff59a916e3cc3246f9aec5e0ca00874ae9d09e4678e5016006f07622f977)-এ শুধু একটি ই-মেইল অ্যাড্রেস অন্তর্ভুক্ত থাকে। এই কোয়েরিটি এই স্কিমার অ্যাটেস্টেশনের জন্য জিজ্ঞাসা করে। অ্যাটেস্টেশনের বিষয়টিকে `recipient` বা প্রাপক বলা হয়। এটি সবসময় একটি ইথেরিয়াম অ্যাড্রেস। + +সতর্কতা: আমরা এখানে যেভাবে অ্যাটেস্টেশন পাচ্ছি তাতে দুটি নিরাপত্তা সমস্যা রয়েছে। + +- আমরা API এন্ডপয়েন্ট, `https://optimism.easscan.org/graphql`-এ যাচ্ছি, যা একটি কেন্দ্রীভূত উপাদান। আমরা `id` অ্যাট্রিবিউট পেতে পারি এবং তারপর একটি অ্যাটেস্টেশন আসল কিনা তা যাচাই করার জন্য একটি অনচেইন লুকআপ করতে পারি, কিন্তু API এন্ডপয়েন্টটি আমাদের তাদের সম্পর্কে না বলে এখনও অ্যাটেস্টেশন সেন্সর করতে পারে। + + এই সমস্যাটি সমাধান করা অসম্ভব নয়, আমরা আমাদের নিজস্ব GraphQL এন্ডপয়েন্ট চালাতে পারি এবং চেইন লগ থেকে অ্যাটেস্টেশন পেতে পারি, কিন্তু তা আমাদের উদ্দেশ্যের জন্য অতিরিক্ত। + +- আমরা অ্যাটেস্টরের পরিচয় দেখি না। যেকেউ আমাদের মিথ্যা তথ্য খাওয়াতে পারে। একটি বাস্তব-বিশ্বের বাস্তবায়নে আমাদের বিশ্বস্ত অ্যাটেস্টরদের একটি সেট থাকত এবং শুধুমাত্র তাদের অ্যাটেস্টেশনগুলি দেখতাম। + +এটি কার্যকর দেখতে, বিদ্যমান IdP এবং SP বন্ধ করুন এবং এই কমান্ডগুলি চালান: + +```sh +git checkout email-address +pnpm install +pnpm start +``` + +তারপর আপনার ই-মেইল অ্যাড্রেস দিন। আপনার কাছে এটি করার দুটি উপায় আছে: + +- একটি প্রাইভেট কী ব্যবহার করে একটি ওয়ালেট আমদানি করুন, এবং টেস্টিং প্রাইভেট কী `0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80` ব্যবহার করুন। + +- আপনার নিজের ই-মেইল অ্যাড্রেসের জন্য একটি অ্যাটেস্টেশন যোগ করুন: + + 1. অ্যাটেস্টেশন এক্সপ্লোরারে [স্কিমাতে](https://optimism.easscan.org/schema/view/0xfa2eff59a916e3cc3246f9aec5e0ca00874ae9d09e4678e5016006f07622f977) ব্রাউজ করুন। + + 2. **স্কিমা দিয়ে অ্যাটেস্ট করুন**-এ ক্লিক করুন। + + 3. প্রাপক হিসাবে আপনার ইথেরিয়াম অ্যাড্রেস, ইমেল অ্যাড্রেস হিসাবে আপনার ই-মেইল অ্যাড্রেস লিখুন এবং **অনচেইন** নির্বাচন করুন। তারপর **অ্যাটেস্টেশন তৈরি করুন**-এ ক্লিক করুন। + + 4. আপনার ওয়ালেটে লেনদেনটি অনুমোদন করুন। গ্যাসের জন্য অর্থ প্রদান করতে আপনার [অপটিমিজম ব্লকচেইনে](https://app.optimism.io/bridge/deposit) কিছু ETH লাগবে। + +যাই হোক, এটি করার পর [http://localhost:3000](http://localhost:3000) তে ব্রাউজ করুন এবং নির্দেশাবলী অনুসরণ করুন। আপনি যদি টেস্টিং প্রাইভেট কী আমদানি করে থাকেন, তাহলে আপনি যে ই-মেইলটি পাবেন তা হল `test_addr_0@example.com`। আপনি যদি নিজের অ্যাড্রেস ব্যবহার করে থাকেন, তাহলে এটি তাই হবে যা আপনি প্রত্যয়িত করেছেন। + +### বিস্তারিত ব্যাখ্যা + + + +নতুন ধাপগুলি হল GraphQL কমিউনিকেশন, ধাপ ৫.৬ এবং ৫.৭। + +আবার, এখানে `idp.mts`-এর পরিবর্তিত অংশগুলি দেওয়া হল। + +```typescript +import { GraphQLClient } from 'graphql-request' +import { SchemaEncoder } from '@ethereum-attestation-service/eas-sdk' +``` + +আমাদের প্রয়োজনীয় লাইব্রেরিগুলি আমদানি করুন। + +```typescript +const graphqlEndpointUrl = "https://optimism.easscan.org/graphql" +``` + +[প্রতিটি ব্লকচেইনের জন্য একটি পৃথক এন্ডপয়েন্ট](https://docs.attest.org/docs/developer-tools/api) রয়েছে। + +```typescript +const graphqlClient = new GraphQLClient(graphqlEndpointUrl, { fetch }) +``` + +একটি নতুন `GraphQLClient` ক্লায়েন্ট তৈরি করুন যা আমরা এন্ডপয়েন্ট কোয়েরি করার জন্য ব্যবহার করতে পারি। + +```typescript +const graphqlSchema = 'string emailAddress' +const graphqlEncoder = new SchemaEncoder(graphqlSchema) +``` + +GraphQL আমাদের শুধু বাইট সহ একটি অস্বচ্ছ ডেটা অবজেক্ট দেয়। এটি বুঝতে আমাদের স্কিমা প্রয়োজন। + +```typescript +const ethereumAddressToEmail = async ethAddr => { +``` + +একটি ইথেরিয়াম অ্যাড্রেস থেকে একটি ই-মেইল অ্যাড্রেসে যাওয়ার জন্য একটি ফাংশন। + +```typescript + const query = ` + query GetAttestationsByRecipient { +``` + +এটি একটি GraphQL কোয়েরি। + +```typescript + attestations( +``` + +আমরা অ্যাটেস্টেশন খুঁজছি। + +```typescript + where: { + recipient: { equals: "${getAddress(ethAddr)}" } + schemaId: { equals: "0xfa2eff59a916e3cc3246f9aec5e0ca00874ae9d09e4678e5016006f07622f977" } + } +``` + +আমরা যে অ্যাটেস্টেশনগুলি চাই তা হল আমাদের স্কিমার মধ্যে থাকা অ্যাটেস্টেশন, যেখানে প্রাপক হল `getAddress(ethAddr)`। [`getAddress`](https://viem.sh/docs/utilities/getAddress#getaddress) ফাংশনটি নিশ্চিত করে যে আমাদের অ্যাড্রেসে সঠিক [চেকসাম](https://github.com/ethereum/ercs/blob/master/ERCS/erc-55.md) আছে। GraphQL কেস-সিগনিফিকেন্ট হওয়ায় এটি প্রয়োজনীয়। `0xBAD060A7`, `0xBad060A7`, এবং `0xbad060a7` ভিন্ন মান। + +```typescript + take: 1 +``` + +আমরা যতগুলিই অ্যাটেস্টেশন পাই না কেন, আমরা শুধুমাত্র প্রথমটি চাই। + +```typescript + ) { + data + id + attester + } + }` +``` + +আমরা যে ফিল্ডগুলি পেতে চাই। + +- `attester`: যে অ্যাড্রেসটি অ্যাটেস্টেশন জমা দিয়েছে। সাধারণত এটি অ্যাটেস্টেশনটি বিশ্বাস করা হবে কি না তা সিদ্ধান্ত নিতে ব্যবহৃত হয়। +- `id`: অ্যাটেস্টেশন আইডি। GraphQL কোয়েরি থেকে প্রাপ্ত তথ্য সঠিক কিনা তা যাচাই করতে আপনি এই মানটি ব্যবহার করে [অনচেইনে অ্যাটেস্টেশনটি পড়তে](https://optimism.blockscout.com/address/0x4200000000000000000000000000000000000021?tab=read_proxy&source_address=0x4E0275Ea5a89e7a3c1B58411379D1a0eDdc5b088#0xa3112a64) পারেন। +- `data`: স্কিমা ডেটা (এই ক্ষেত্রে, ই-মেইল অ্যাড্রেস)। + +```typescript + const queryResult = await graphqlClient.request(query) + + if (queryResult.attestations.length == 0) + return "no_address@available.is" +``` + +যদি কোনো অ্যাটেস্টেশন না থাকে, তাহলে এমন একটি মান ফেরত দিন যা স্পষ্টতই ভুল, কিন্তু যা পরিষেবা প্রদানকারীর কাছে বৈধ বলে মনে হবে। + +```typescript + const attestationDataFields = graphqlEncoder.decodeData(queryResult.attestations[0].data) + return attestationDataFields[0].value.value +} +``` + +যদি কোনো মান থাকে, তাহলে ডেটা ডিকোড করতে `decodeData` ব্যবহার করুন। আমাদের এর প্রদত্ত মেটাডেটার প্রয়োজন নেই, শুধু মানটিই প্রয়োজন। + +```typescript + const loginResponse = await idp.createLoginResponse( + sp, + { + . + . + . + }, + "post", + { + email: await ethereumAddressToEmail(req.params.account) + } + ); +``` + +ই-মেইল অ্যাড্রেস পেতে নতুন ফাংশনটি ব্যবহার করুন। + +## বিকেন্দ্রীকরণ সম্পর্কে কী? + +এই কনফিগারেশনে ব্যবহারকারীরা এমন কেউ হওয়ার ভান করতে পারে না যা তারা নয়, যতক্ষণ না আমরা ইথেরিয়াম থেকে ই-মেইল অ্যাড্রেস ম্যাপিংয়ের জন্য বিশ্বস্ত অ্যাটেস্টরদের উপর নির্ভর করি। তবে, আমাদের পরিচয় প্রদানকারী এখনও একটি কেন্দ্রীভূত উপাদান। পরিচয় প্রদানকারীর প্রাইভেট কী যার কাছে আছে, সে পরিষেবা প্রদানকারীর কাছে মিথ্যা তথ্য পাঠাতে পারে। + +[মাল্টি-পার্টি কম্পিউটেশন (MPC)](https://en.wikipedia.org/wiki/Secure_multi-party_computation) ব্যবহার করে একটি সমাধান থাকতে পারে। আমি আশা করি ভবিষ্যতে একটি টিউটোরিয়ালে এটি নিয়ে লিখব। + +## উপসংহার + +ইথেরিয়াম স্বাক্ষরের মতো একটি লগ অন স্ট্যান্ডার্ড গ্রহণ করা একটি মুরগি ও ডিমের সমস্যার সম্মুখীন হয়। পরিষেবা প্রদানকারীরা সম্ভাব্য বিস্তৃত বাজারে আবেদন করতে চায়। ব্যবহারকারীরা তাদের লগ অন স্ট্যান্ডার্ড সমর্থন করার বিষয়ে চিন্তা না করে পরিষেবাগুলি অ্যাক্সেস করতে সক্ষম হতে চায়। +ইথেরিয়াম IdP-এর মতো অ্যাডাপ্টার তৈরি করা আমাদের এই বাধা অতিক্রম করতে সাহায্য করতে পারে। + +[আমার আরও কাজের জন্য এখানে দেখুন](https://cryptodocguy.pro/)। diff --git a/public/content/translations/bn/developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md b/public/content/translations/bn/developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md new file mode 100644 index 00000000000..51fb7e28b30 --- /dev/null +++ b/public/content/translations/bn/developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md @@ -0,0 +1,156 @@ +--- +title: "Ethereum ডেভেলপমেন্ট শুরু করা" +description: "এটি Ethereum ডেভেলপমেন্ট শুরু করার জন্য নতুনদের একটি গাইড। আমরা আপনাকে একটি API এন্ডপয়েন্ট স্পিন আপ করা থেকে শুরু করে, একটি কমান্ড লাইন রিকোয়েস্ট করা, এবং আপনার প্রথম web3 স্ক্রিপ্ট লেখা পর্যন্ত নিয়ে যাব! ব্লকচেইন ডেভেলপমেন্টের কোনো অভিজ্ঞতা আবশ্যক নয়!" +author: "Elan Halpern" +tags: + [ + "javascript", + "ethers.js", + "নোড", + "querying", + "alchemy" + ] +skill: beginner +lang: bn +published: 2020-10-30 +source: Medium +sourceUrl: https://medium.com/alchemy-api/getting-started-with-ethereum-development-using-alchemy-c3d6a45c567f +--- + + + +এটি Ethereum ডেভেলপমেন্ট শুরু করার জন্য নতুনদের একটি গাইড। এই টিউটোরিয়ালের জন্য আমরা [Alchemy](https://alchemyapi.io/) ব্যবহার করব, যা শীর্ষস্থানীয় ব্লকচেইন ডেভেলপার প্ল্যাটফর্ম এবং যা Maker, 0x, MyEtherWallet, Dharma এবং Kyber সহ শীর্ষস্থানীয় ব্লকচেইন অ্যাপগুলোর 70% থেকে লক্ষ লক্ষ ব্যবহারকারীকে শক্তি যোগাচ্ছে। Alchemy আমাদেরকে Ethereum চেইনের একটি API এন্ডপয়েন্টে অ্যাক্সেস দেবে যাতে আমরা ট্রানজ্যাকশন পড়তে এবং লিখতে পারি। + +আমরা আপনাকে Alchemy-তে সাইন আপ করা থেকে শুরু করে আপনার প্রথম web3 স্ক্রিপ্ট লেখা পর্যন্ত নিয়ে যাব! ব্লকচেইন ডেভেলপমেন্টের কোনো অভিজ্ঞতা আবশ্যক নয়! + +## ১. একটি বিনামূল্যে Alchemy অ্যাকাউন্টের জন্য সাইন আপ করুন {#sign-up-for-a-free-alchemy-account} + +Alchemy-তে একটি অ্যাকাউন্ট তৈরি করা সহজ, [এখানে বিনামূল্যে সাইন আপ করুন](https://auth.alchemy.com/)। + +## 2. একটি Alchemy অ্যাপ তৈরি করুন {#create-an-alchemy-app} + +Ethereum চেইনের সাথে যোগাযোগ করতে এবং Alchemy-র প্রোডাক্টগুলো ব্যবহার করতে, আপনার রিকোয়েস্টগুলো প্রমাণীকরণ করার জন্য একটি API কী প্রয়োজন। + +আপনি [ড্যাশবোর্ড থেকে API কী তৈরি করতে পারেন](https://dashboard.alchemy.com/)। একটি নতুন কী তৈরি করতে, নিচে দেখানো হিসাবে “Create App”-এ নেভিগেট করুন: + +[_ShapeShift_](https://shapeshift.com/)-কে বিশেষ ধন্যবাদ _আমাদেরকে তাদের ড্যাশবোর্ড দেখানোর সুযোগ দেওয়ার জন্য!_ + + + +আপনার নতুন কী পেতে “Create App”-এর অধীনে বিবরণ পূরণ করুন। আপনি এখানে আপনার পূর্বে তৈরি করা অ্যাপ এবং আপনার দলের তৈরি করা অ্যাপগুলোও দেখতে পারেন। যেকোনো অ্যাপের জন্য “View Key”-তে ক্লিক করে বিদ্যমান কীগুলো পান। + + + +আপনি “Apps”-এর উপর হোভার করে এবং একটি নির্বাচন করে বিদ্যমান API কীগুলোও পেতে পারেন। আপনি এখানে “View Key” করতে পারেন, পাশাপাশি নির্দিষ্ট ডোমেন হোয়াইটলিস্ট করতে, বিভিন্ন ডেভেলপার টুলস দেখতে এবং অ্যানালিটিক্স দেখতে “Edit App” করতে পারেন। + + + +## 3. কমান্ড লাইন থেকে একটি রিকোয়েস্ট করুন {#make-a-request-from-the-command-line} + +JSON-RPC এবং curl ব্যবহার করে Alchemy-র মাধ্যমে Ethereum ব্লকচেইনের সাথে ইন্টারঅ্যাক্ট করুন। + +ম্যানুয়াল রিকোয়েস্টগুলোর জন্য, আমরা `POST` রিকোয়েস্টের মাধ্যমে `JSON-RPC`-এর সাথে ইন্টারঅ্যাক্ট করার সুপারিশ করি। কেবলমাত্র `Content-Type: application/json` হেডার এবং আপনার কোয়েরিটি নিম্নলিখিত ফিল্ডগুলো সহ `POST` বডি হিসাবে পাস করুন: + +- `jsonrpc`: JSON-RPC সংস্করণ—বর্তমানে, শুধুমাত্র `2.0` সমর্থিত। +- `method`: ETH API মেথড। [API রেফারেন্স দেখুন।](https://docs.alchemyapi.io/documentation/alchemy-api-reference/json-rpc) +- `params`: মেথডে পাস করার জন্য প্যারামিটারগুলোর একটি তালিকা। +- `id`: আপনার রিকোয়েস্টের আইডি। রেসপন্সের মাধ্যমে এটি ফেরত দেওয়া হবে যাতে আপনি ট্র্যাক রাখতে পারেন কোন রিকোয়েস্টের জন্য কোন রেসপন্সটি এসেছে। + +এখানে একটি উদাহরণ রয়েছে যা আপনি বর্তমান গ্যাসের মূল্য পুনরুদ্ধার করতে কমান্ড লাইন থেকে চালাতে পারেন: + +```bash +curl https://eth-mainnet.alchemyapi.io/v2/demo \ +-X POST \ +-H "Content-Type: application/json" \ +-d '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}' +``` + +_**দ্রষ্টব্য:** [https://eth-mainnet.alchemyapi.io/v2/demo](https://eth-mainnet.alchemyapi.io/jsonrpc/demo)-কে আপনার নিজের API কী `https://eth-mainnet.alchemyapi.io/v2/**your-api-key` দিয়ে প্রতিস্থাপন করুন।_ + +**ফলাফল:** + +```json +{ "id": 73,"jsonrpc": "2.0","result": "0x09184e72a000" // 10000000000000 } +``` + +## ৪. আপনার Web3 ক্লায়েন্ট সেট আপ করুন {#set-up-your-web3-client} + +**যদি আপনার একটি বিদ্যমান ক্লায়েন্ট থাকে,** আপনার বর্তমান নোড প্রোভাইডার URL-কে আপনার API কীসহ একটি Alchemy URL-এ পরিবর্তন করুন: `“https://eth-mainnet.alchemyapi.io/v2/your-api-key"` + +**_দ্রষ্টব্য:_** নিচের স্ক্রিপ্টগুলো একটি **নোড কনটেক্সটে** চালাতে হবে অথবা **একটি ফাইলে সেভ করতে হবে**, কমান্ড লাইন থেকে চালানো যাবে না। যদি আপনার আগে থেকেই Node বা npm ইনস্টল করা না থাকে, তাহলে ম্যাকের জন্য এই দ্রুত [সেট-আপ গাইডটি](https://app.gitbook.com/@alchemyapi/s/alchemy/guides/alchemy-for-macs) দেখুন। + +অনেক [Web3 লাইব্রেরি](https://docs.alchemyapi.io/guides/getting-started#other-web3-libraries) আছে যা আপনি Alchemy-র সাথে ইন্টিগ্রেট করতে পারেন, তবে আমরা [Alchemy Web3](https://docs.alchemy.com/reference/api-overview) ব্যবহার করার সুপারিশ করি, যা web3.js-এর একটি ড্রপ-ইন প্রতিস্থাপন এবং যা Alchemy-র সাথে নির্বিঘ্নে কাজ করার জন্য তৈরি এবং কনফিগার করা হয়েছে। এটি স্বয়ংক্রিয় পুনঃপ্রচেষ্টা এবং শক্তিশালী WebSocket সাপোর্টের মতো একাধিক সুবিধা প্রদান করে। + +AlchemyWeb3.js ইনস্টল করতে, **আপনার প্রজেক্ট ডিরেক্টরিতে নেভিগেট করুন** এবং চালান: + +**Yarn দিয়ে:** + +``` +yarn add @alch/alchemy-web3 +``` + +**NPM দিয়ে:** + +``` +npm install @alch/alchemy-web3 +``` + +Alchemy-র নোড ইনফ্রাস্ট্রাকচারের সাথে ইন্টারঅ্যাক্ট করতে, NodeJS-এ চালান অথবা এটি একটি JavaScript ফাইলে যোগ করুন: + +```js +const { createAlchemyWeb3 } = require("@alch/alchemy-web3") +const web3 = createAlchemyWeb3( + "https://eth-mainnet.alchemyapi.io/v2/your-api-key" +) +``` + +## ৫। আপনার প্রথম Web3 স্ক্রিপ্ট লিখুন! {#write-your-first-web3-script} + +এখন কিছু web3 প্রোগ্রামিংয়ে হাত পাকানোর জন্য আমরা একটি সাধারণ স্ক্রিপ্ট লিখব যা Ethereum মেইননেট থেকে সর্বশেষ ব্লক নম্বরটি প্রিন্ট করবে। + +**১. যদি আপনি এখনও না করে থাকেন, তাহলে আপনার টার্মিনালে একটি নতুন প্রজেক্ট ডিরেক্টরি তৈরি করুন এবং তার মধ্যে প্রবেশ করুন:** + +``` +mkdir web3-example +cd web3-example +``` + +**২. যদি আপনি আগে থেকে না করে থাকেন, তাহলে আপনার প্রজেক্টে Alchemy web3 (বা যেকোনো web3) ডিপেনডেন্সি ইনস্টল করুন:** + +``` +npm install @alch/alchemy-web3 +``` + +**৩. `index.js` নামে একটি ফাইল তৈরি করুন এবং নিম্নলিখিত কন্টেন্টগুলো যোগ করুন:** + +> আপনার শেষ পর্যন্ত `demo`-কে আপনার Alchemy HTTP API কী দিয়ে প্রতিস্থাপন করা উচিত। + +```js +async function main() { + const { createAlchemyWeb3 } = require("@alch/alchemy-web3") + const web3 = createAlchemyWeb3("https://eth-mainnet.alchemyapi.io/v2/demo") + const blockNumber = await web3.eth.getBlockNumber() + console.log("সর্বশেষ ব্লক নম্বরটি হল " + blockNumber) +} +main() +``` + +অ্যাসিঙ্ক বিষয়গুলোর সাথে অপরিচিত? এই [মিডিয়াম পোস্টটি](https://medium.com/better-programming/understanding-async-await-in-javascript-1d81bb079b2c) দেখুন। + +**4.** নোড ব্যবহার করে এটি আপনার টার্মিনালে চালান\*\* + +``` +node index.js +``` + +**5.** আপনি এখন আপনার কনসোলে সর্বশেষ ব্লক নম্বরের আউটপুট দেখতে পাবেন!\*\* + +``` +সর্বশেষ ব্লক নম্বর হল 11043912 +``` + +**বাহ! অভিনন্দন! আপনি এইমাত্র Alchemy ব্যবহার করে আপনার প্রথম web3 স্ক্রিপ্ট লিখেছেন 🎉** + +এরপরে কী করবেন তা নিয়ে নিশ্চিত নন? আমাদের [হ্যালো ওয়ার্ল্ড স্মার্ট কন্ট্র্যাক্ট গাইডে](https://www.alchemy.com/docs/hello-world-smart-contract) আপনার প্রথম স্মার্ট কন্ট্র্যাক্ট ডিপ্লয় করার চেষ্টা করুন এবং কিছু সলিডিটি প্রোগ্রামিংয়ের সাথে হাত পাকান, অথবা [ড্যাশবোর্ড ডেমো অ্যাপ](https://docs.alchemyapi.io/tutorials/demo-app) দিয়ে আপনার ড্যাশবোর্ডের জ্ঞান পরীক্ষা করুন! + +_[বিনামূল্যে Alchemy-তে সাইন আপ করুন](https://auth.alchemy.com/), আমাদের [নথিপত্র](https://www.alchemy.com/docs/) দেখুন এবং সর্বশেষ খবরের জন্য, আমাদের [টুইটারে](https://twitter.com/AlchemyPlatform) অনুসরণ করুন_। diff --git a/public/content/translations/bn/developers/tutorials/guide-to-smart-contract-security-tools/index.md b/public/content/translations/bn/developers/tutorials/guide-to-smart-contract-security-tools/index.md new file mode 100644 index 00000000000..9cb0d88f3c6 --- /dev/null +++ b/public/content/translations/bn/developers/tutorials/guide-to-smart-contract-security-tools/index.md @@ -0,0 +1,102 @@ +--- +title: "স্মার্ট কন্ট্র্যাক্ট নিরাপত্তা টুলের জন্য একটি গাইড" +description: "তিনটি ভিন্ন পরীক্ষা এবং প্রোগ্রাম বিশ্লেষণ কৌশলের একটি সংক্ষিপ্ত বিবরণ" +author: "Trailofbits" +lang: bn +tags: [ "সলিডিটি", "স্মার্ট কন্ট্র্যাক্ট", "নিরাপত্তা" ] +skill: intermediate +published: 2020-09-07 +source: Building secure contracts +sourceUrl: https://github.com/crytic/building-secure-contracts/tree/master/program-analysis +--- + +আমরা তিনটি স্বতন্ত্র পরীক্ষা এবং প্রোগ্রাম বিশ্লেষণ কৌশল ব্যবহার করতে যাচ্ছি: + +- **[Slither](/developers/tutorials/how-to-use-slither-to-find-smart-contract-bugs/) সহ স্ট্যাটিক বিশ্লেষণ।** প্রোগ্রামের সমস্ত পাথ একই সময়ে অনুমান করা হয় এবং বিশ্লেষণ করা হয়, বিভিন্ন প্রোগ্রাম উপস্থাপনার মাধ্যমে (যেমন, কন্ট্রোল-ফ্লো-গ্রাফ) +- **[Echidna](/developers/tutorials/how-to-use-echidna-to-test-smart-contracts/) দিয়ে ফাজিং।** একটি সিউডো-র্যান্ডম লেনদেন জেনারেশনের মাধ্যমে কোডটি এক্সিকিউট করা হয়। ফাজার একটি প্রদত্ত প্রপার্টি লঙ্ঘন করার জন্য লেনদেনের একটি ক্রম খুঁজে বের করার চেষ্টা করবে। +- **[Manticore](/developers/tutorials/how-to-use-manticore-to-find-smart-contract-bugs/) দিয়ে সিম্বলিক এক্সিকিউশন।** একটি ফর্মাল ভেরিফিকেশন কৌশল, যা প্রতিটি এক্সিকিউশন পাথকে একটি গাণিতিক সূত্রে অনুবাদ করে, যার উপর সীমাবদ্ধতা পরীক্ষা করা যেতে পারে। + +প্রতিটি কৌশলের সুবিধা এবং অসুবিধা রয়েছে, এবং [নির্দিষ্ট ক্ষেত্রে](#determining-security-properties) কার্যকর হবে: + +| কৌশল | টুল | ব্যবহার | গতি | মিস করা বাগ | ভুল অ্যালার্ম | +| ------------------- | --------- | -------------------------------- | ------- | ------------ | ------------- | +| স্ট্যাটিক বিশ্লেষণ | Slither | CLI এবং স্ক্রিপ্ট | সেকেন্ড | মাঝারি | নিম্ন | +| ফাজিং | Echidna | Solidity প্রপার্টি | মিনিট | নিম্ন | কোনোটিই নয় | +| সিম্বলিক এক্সিকিউশন | Manticore | Solidity প্রপার্টি এবং স্ক্রিপ্ট | ঘন্টা | কোনোটিই নয়\* | কোনোটিই নয় | + +\* যদি সমস্ত পথ টাইমআউট ছাড়াই অন্বেষণ করা হয় + +**Slither** কয়েক সেকেন্ডের মধ্যে কন্ট্র্যাক্ট বিশ্লেষণ করে, তবে, স্ট্যাটিক বিশ্লেষণের ফলে ভুল অ্যালার্ম হতে পারে এবং জটিল পরীক্ষার জন্য (যেমন, গাণিতিক পরীক্ষা) এটি কম উপযুক্ত হবে। বিল্ট-ইন ডিটেক্টরে পুশ-বাটন অ্যাক্সেসের জন্য API-এর মাধ্যমে বা ব্যবহারকারী-সংজ্ঞায়িত পরীক্ষার জন্য API-এর মাধ্যমে Slither চালান। + +**Echidna** কে কয়েক মিনিটের জন্য চালাতে হবে এবং এটি কেবল ট্রু পজিটিভ ফলাফল তৈরি করবে। Echidna ব্যবহারকারী-প্রদত্ত নিরাপত্তা প্রপার্টি পরীক্ষা করে, যা Solidity-তে লেখা। এটি র্যান্ডম অন্বেষণের উপর ভিত্তি করে হওয়ায় কিছু বাগ মিস করতে পারে। + +**Manticore** "সবচেয়ে ভারী" বিশ্লেষণ সম্পাদন করে। Echidna-র মতো, Manticore ব্যবহারকারী-প্রদত্ত প্রপার্টি যাচাই করে। এটি চালাতে আরও বেশি সময় লাগবে, তবে এটি একটি প্রপার্টির বৈধতা প্রমাণ করতে পারে এবং ভুল অ্যালার্ম রিপোর্ট করবে না। + +## প্রস্তাবিত ওয়ার্কফ্লো {#suggested-workflow} + +এখন কোনো সাধারণ বাগ উপস্থিত নেই বা পরে যোগ করা হবে না তা নিশ্চিত করতে Slither-এর বিল্ট-ইন ডিটেক্টর দিয়ে শুরু করুন। ইনহেরিটেন্স, ভ্যারিয়েবল নির্ভরতা এবং কাঠামোগত সমস্যা সম্পর্কিত প্রপার্টি পরীক্ষা করতে Slither ব্যবহার করুন। কোডবেস বড় হওয়ার সাথে সাথে স্টেট মেশিনের আরও জটিল প্রপার্টি পরীক্ষা করতে Echidna ব্যবহার করুন। Solidity থেকে পাওয়া যায় না এমন সুরক্ষার জন্য কাস্টম চেক তৈরি করতে Slither-কে আবার ব্যবহার করুন, যেমন একটি ফাংশনকে ওভাররাইড করার বিরুদ্ধে সুরক্ষা। সবশেষে, জটিল নিরাপত্তা প্রপার্টি, যেমন, গাণিতিক ক্রিয়াকলাপের লক্ষ্যযুক্ত যাচাইকরণের জন্য Manticore ব্যবহার করুন। + +- সাধারণ সমস্যাগুলি ধরতে Slither-এর CLI ব্যবহার করুন +- আপনার কন্ট্র্যাক্টের উচ্চ-স্তরের নিরাপত্তা প্রপার্টি পরীক্ষা করতে Echidna ব্যবহার করুন +- কাস্টম স্ট্যাটিক চেক লিখতে Slither ব্যবহার করুন +- আপনি যখন জটিল নিরাপত্তা প্রপার্টির গভীরতর নিশ্চয়তা চান তখন Manticore ব্যবহার করুন + +**ইউনিট পরীক্ষার উপর একটি নোট**। উচ্চ-মানের সফ্টওয়্যার তৈরি করতে ইউনিট পরীক্ষা প্রয়োজন। তবে, এই কৌশলগুলি নিরাপত্তা ত্রুটি খুঁজে বের করার জন্য সবচেয়ে উপযুক্ত নয়। এগুলি সাধারণত কোডের পজিটিভ আচরণ পরীক্ষা করার জন্য ব্যবহৃত হয় (অর্থাৎ, কোডটি স্বাভাবিক প্রসঙ্গে প্রত্যাশিতভাবে কাজ করে), যেখানে নিরাপত্তা ত্রুটিগুলি এজ কেসে থাকে যা ডেভেলপাররা বিবেচনা করেননি। কয়েক ডজন স্মার্ট কন্ট্র্যাক্ট নিরাপত্তা পর্যালোচনার উপর আমাদের গবেষণায়, আমরা আমাদের ক্লায়েন্টের কোডে যে পরিমাণ বা তীব্রতার নিরাপত্তা ত্রুটি পেয়েছি, তার উপর [ইউনিট পরীক্ষা কভারেজের কোনো প্রভাব ছিল না](https://blog.trailofbits.com/2019/08/08/246-findings-from-our-smart-contract-audits-an-executive-summary/)। + +## নিরাপত্তা প্রপার্টি নির্ধারণ {#determining-security-properties} + +আপনার কোড কার্যকরভাবে পরীক্ষা এবং যাচাই করার জন্য, আপনাকে মনোযোগের প্রয়োজন এমন ক্ষেত্রগুলি চিহ্নিত করতে হবে। যেহেতু নিরাপত্তার জন্য আপনার রিসোর্স সীমিত, তাই আপনার প্রচেষ্টাকে অপ্টিমাইজ করার জন্য আপনার কোডবেসের দুর্বল বা উচ্চ-মূল্যের অংশগুলির পরিধি নির্ধারণ করা গুরুত্বপূর্ণ। থ্রেট মডেলিং সাহায্য করতে পারে। পর্যালোচনা করার কথা বিবেচনা করুন: + +- [র্যাপিড রিস্ক অ্যাসেসমেন্ট](https://infosec.mozilla.org/guidelines/risk/rapid_risk_assessment.html) (সময় কম থাকলে আমাদের পছন্দের পদ্ধতি) +- [ডেটা-সেন্ট্রিক সিস্টেম থ্রেট মডেলিংয়ের জন্য নির্দেশিকা](https://csrc.nist.gov/pubs/sp/800/154/ipd) (ওরফে NIST 800-154) +- [Shostack থ্রেট মডেলিং](https://www.amazon.com/Threat-Modeling-Designing-Adam-Shostack/dp/1118809998) +- [STRIDE](https://wikipedia.org/wiki/STRIDE_\(security\)) / [DREAD](https://wikipedia.org/wiki/DREAD_\(risk_assessment_model\)) +- [PASTA](https://wikipedia.org/wiki/Threat_model#P.A.S.T.A.) +- [অ্যাসার্শনের ব্যবহার](https://blog.regehr.org/archives/1091) + +### উপাদান {#components} + +আপনি কী পরীক্ষা করতে চান তা জানলে সঠিক টুল বেছে নিতেও সাহায্য করবে। + +স্মার্ট কন্ট্র্যাক্টের জন্য প্রায়শই প্রাসঙ্গিক বিস্তৃত ক্ষেত্রগুলির মধ্যে রয়েছে: + +- **স্টেট মেশিন।** বেশিরভাগ কন্ট্র্যাক্টকে একটি স্টেট মেশিন হিসাবে উপস্থাপন করা যেতে পারে। বিবেচনা করুন যে (1) কোনো অবৈধ স্টেটে পৌঁছানো যাবে না, (2) যদি একটি স্টেট বৈধ হয় তবে সেখানে পৌঁছানো যাবে, এবং (3) কোনো স্টেট কন্ট্র্যাক্টকে ফাঁদে ফেলবে না। + + - স্টেট-মেশিন স্পেসিফিকেশন পরীক্ষা করার জন্য Echidna এবং Manticore হল পছন্দের টুল। + +- **অ্যাক্সেস কন্ট্রোল।** যদি আপনার সিস্টেমে বিশেষ সুবিধাপ্রাপ্ত ব্যবহারকারী থাকে (যেমন, একজন মালিক, কন্ট্রোলার, ...) আপনাকে নিশ্চিত করতে হবে যে (1) প্রত্যেক ব্যবহারকারী শুধুমাত্র অনুমোদিত কাজ সম্পাদন করতে পারে এবং (2) কোনো ব্যবহারকারী আরও সুবিধাপ্রাপ্ত ব্যবহারকারীর কাজ ব্লক করতে পারে না। + + - Slither, Echidna এবং Manticore সঠিক অ্যাক্সেস কন্ট্রোল পরীক্ষা করতে পারে। উদাহরণস্বরূপ, Slither পরীক্ষা করতে পারে যে শুধুমাত্র হোয়াইটলিস্ট করা ফাংশনগুলিতে onlyOwner মডিফায়ার নেই। Echidna এবং Manticore আরও জটিল অ্যাক্সেস কন্ট্রোলের জন্য উপযোগী, যেমন একটি কন্ট্র্যাক্ট একটি নির্দিষ্ট স্টেটে পৌঁছালে তবেই অনুমতি দেওয়া হয়। + +- **গাণিতিক অপারেশন।** গাণিতিক অপারেশনের সুস্থতা পরীক্ষা করা গুরুত্বপূর্ণ। ওভারফ্লো/আন্ডারফ্লো প্রতিরোধ করতে সর্বত্র `SafeMath` ব্যবহার করা একটি ভাল পদক্ষেপ, তবে, আপনাকে এখনও অন্যান্য গাণিতিক ত্রুটিগুলি বিবেচনা করতে হবে, যার মধ্যে রাউন্ডিং সমস্যা এবং কন্ট্র্যাক্টকে ফাঁদে ফেলার মতো ত্রুটি রয়েছে। + + - Manticore এখানে সেরা পছন্দ। যদি গাণিতিক হিসাব SMT সলভারের সুযোগের বাইরে থাকে তবে Echidna ব্যবহার করা যেতে পারে। + +- **ইনহেরিটেন্সের সঠিকতা।** Solidity কন্ট্র্যাক্টগুলি মাল্টিপল ইনহেরিটেন্সের উপর ব্যাপকভাবে নির্ভর করে। `super` কল মিস করা শ্যাডোইং ফাংশন এবং ভুল ব্যাখ্যা করা c3 লিনিয়ারাইজেশন অর্ডারের মতো ভুলগুলি সহজেই চালু করা যেতে পারে। + + - Slither এই সমস্যাগুলি সনাক্তকরণ নিশ্চিত করার টুল। + +- **বাহ্যিক ইন্টারঅ্যাকশন।** কন্ট্র্যাক্টগুলি একে অপরের সাথে ইন্টারঅ্যাক্ট করে, এবং কিছু বাহ্যিক কন্ট্র্যাক্টকে বিশ্বাস করা উচিত নয়। উদাহরণস্বরূপ, যদি আপনার কন্ট্র্যাক্ট বাহ্যিক ওরাকলের উপর নির্ভর করে, তাহলে উপলব্ধ ওরাকলের অর্ধেক আপোস করা হলে এটি কি সুরক্ষিত থাকবে? + + - আপনার কন্ট্র্যাক্টের সাথে বাহ্যিক ইন্টারঅ্যাকশন পরীক্ষা করার জন্য Manticore এবং Echidna সেরা পছন্দ। Manticore-এর বাহ্যিক কন্ট্র্যাক্ট স্টাব করার জন্য একটি বিল্ট-ইন মেকানিজম রয়েছে। + +- **স্ট্যান্ডার্ড কনফরমেন্স।** Ethereum স্ট্যান্ডার্ডগুলির (যেমন, ERC20) ডিজাইনে ত্রুটির ইতিহাস রয়েছে। আপনি যে স্ট্যান্ডার্ডের উপর ভিত্তি করে তৈরি করছেন তার সীমাবদ্ধতা সম্পর্কে সচেতন থাকুন। + - Slither, Echidna, এবং Manticore আপনাকে একটি প্রদত্ত স্ট্যান্ডার্ড থেকে বিচ্যুতি সনাক্ত করতে সাহায্য করবে। + +### টুল নির্বাচনের চিটশিট {#tool-selection-cheatsheet} + +| উপাদান | টুলস | উদাহরণ | +| ----------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| স্টেট মেশিন | Echidna, Manticore | | +| অ্যাক্সেস কন্ট্রোল | Slither, Echidna, Manticore | [Slither এক্সারসাইজ 2](https://github.com/crytic/slither/blob/7f54c8b948c34fb35e1d61adaa1bd568ca733253/docs/src/tutorials/exercise2.md), [Echidna এক্সারসাইজ 2](https://github.com/crytic/building-secure-contracts/blob/master/program-analysis/echidna/exercises/Exercise-2.md) | +| গাণিতিক অপারেশন | Manticore, Echidna | [Echidna এক্সারসাইজ 1](https://github.com/crytic/building-secure-contracts/blob/master/program-analysis/echidna/exercises/Exercise-1.md), [Manticore এক্সারসাইজ 1 - 3](https://github.com/crytic/building-secure-contracts/tree/master/program-analysis/manticore/exercises) | +| ইনহেরিটেন্সের সঠিকতা | Slither | [Slither এক্সারসাইজ 1](https://github.com/crytic/slither/blob/7f54c8b948c34fb35e1d61adaa1bd568ca733253/docs/src/tutorials/exercise1.md) | +| বাহ্যিক ইন্টারঅ্যাকশন | Manticore, Echidna | | +| স্ট্যান্ডার্ড কনফরমেন্স | Slither, Echidna, Manticore | [`slither-erc`](https://github.com/crytic/slither/wiki/ERC-Conformance) | + +আপনার লক্ষ্যের উপর নির্ভর করে অন্যান্য ক্ষেত্রগুলি পরীক্ষা করার প্রয়োজন হবে, তবে এই স্থূল-দানাযুক্ত ক্ষেত্রগুলি যেকোনো স্মার্ট কন্ট্র্যাক্ট সিস্টেমের জন্য একটি ভাল শুরু। + +আমাদের পাবলিক অডিটগুলিতে যাচাইকৃত বা পরীক্ষিত প্রপার্টির উদাহরণ রয়েছে। বাস্তব-বিশ্বের নিরাপত্তা প্রপার্টি পর্যালোচনা করতে নিম্নলিখিত রিপোর্টগুলির `স্বয়ংক্রিয় পরীক্ষা এবং যাচাইকরণ` বিভাগগুলি পড়ার কথা বিবেচনা করুন: + +- [0x](https://github.com/trailofbits/publications/blob/master/reviews/0x-protocol.pdf) +- [Balancer](https://github.com/trailofbits/publications/blob/master/reviews/BalancerCore.pdf) diff --git a/public/content/translations/bn/developers/tutorials/hello-world-smart-contract-fullstack/index.md b/public/content/translations/bn/developers/tutorials/hello-world-smart-contract-fullstack/index.md new file mode 100644 index 00000000000..8b1939fa53f --- /dev/null +++ b/public/content/translations/bn/developers/tutorials/hello-world-smart-contract-fullstack/index.md @@ -0,0 +1,1542 @@ +--- +title: "নতুনদের জন্য Hello World স্মার্ট কন্ট্র্যাক্ট - ফুলস্ট্যাক" +description: "Ethereum-এ একটি সহজ স্মার্ট কন্ট্র্যাক্ট লেখা এবং স্থাপন করার উপর একটি পরিচিতি টিউটোরিয়াল।" +author: "nstrike2" +tags: + [ + "সলিডিটি", + "hardhat", + "alchemy", + "স্মার্ট কন্ট্র্যাক্ট", + "ডেপ্লয়িং", + "ব্লক এক্সপ্লোরার", + "ফ্রন্টএন্ড", + "লেনদেনসমূহ" + ] +skill: beginner +lang: bn +published: 2021-10-25 +--- + +আপনি যদি ব্লকচেইন ডেভেলপমেন্টে নতুন হন এবং কোথা থেকে শুরু করবেন বা কীভাবে স্মার্ট কন্ট্র্যাক্ট স্থাপন এবং তার সঙ্গে যোগাযোগ করবেন তা না জানেন, তবে এই গাইডটি আপনার জন্য। আমরা [MetaMask](https://metamask.io), [Solidity](https://docs.soliditylang.org/en/v0.8.0/), [Hardhat](https://hardhat.org), এবং [Alchemy](https://alchemy.com/eth) ব্যবহার করে Goerli টেস্ট নেটওয়ার্কে একটি সহজ, স্মার্ট কন্ট্র্যাক্ট তৈরি এবং স্থাপন করার পদ্ধতি ধাপে ধাপে দেখাব। + +এই টিউটোরিয়ালটি সম্পূর্ণ করতে আপনার একটি Alchemy অ্যাকাউন্ট লাগবে। [একটি বিনামূল্যে অ্যাকাউন্টের জন্য সাইন আপ করুন](https://www.alchemy.com/)। + +যেকোনো পর্যায়ে আপনার কোনো প্রশ্ন থাকলে, নির্দ্বিধায় [Alchemy Discord](https://discord.gg/gWuC7zB)-এ যোগাযোগ করুন! + +## পর্ব ১ - Hardhat ব্যবহার করে আপনার স্মার্ট কন্ট্র্যাক্ট তৈরি ও স্থাপন করুন {#part-1} + +### ইথেরিয়াম নেটওয়ার্কের সাথে সংযোগ করুন {#connect-to-the-ethereum-network} + +Ethereum চেইনে রিকুয়েস্ট করার অনেক উপায় আছে। সহজ করার জন্য, আমরা Alchemy-তে একটি বিনামূল্যের অ্যাকাউন্ট ব্যবহার করব, যা একটি ব্লকচেইন ডেভেলপার প্ল্যাটফর্ম এবং API, যা আমাদের নিজেদের নোড না চালিয়ে ইথেরিয়াম চেইনের সাথে যোগাযোগ করতে দেয়। Alchemy-তে নিরীক্ষণ এবং বিশ্লেষণের জন্য ডেভেলপার টুলও রয়েছে; আমাদের স্মার্ট কন্ট্র্যাক্ট স্থাপনার নেপথ্যে কী ঘটছে তা বোঝার জন্য আমরা এই টিউটোরিয়ালে এগুলির সুবিধা নেব। + +### আপনার অ্যাপ এবং API কী তৈরি করুন {#create-your-app-and-api-key} + +একবার আপনি একটি Alchemy অ্যাকাউন্ট তৈরি করলে, আপনি একটি অ্যাপ তৈরি করে একটি API কী তৈরি করতে পারেন। এটি আপনাকে Goerli টেস্টনেটে অনুরোধ করার অনুমতি দেবে। আপনি যদি টেস্টনেটগুলির সাথে পরিচিত না হন তবে আপনি [একটি নেটওয়ার্ক বেছে নেওয়ার জন্য Alchemy-র গাইডটি পড়তে পারেন](https://www.alchemy.com/docs/choosing-a-web3-network)। + +Alchemy ড্যাশবোর্ডে, নেভিগেশন বারে **অ্যাপস** ড্রপডাউনটি খুঁজুন এবং **অ্যাপ তৈরি করুন**-এ ক্লিক করুন। + + + +আপনার অ্যাপটিকে '_Hello World_' নাম দিন এবং একটি সংক্ষিপ্ত বিবরণ লিখুন। আপনার এনভায়রনমেন্ট হিসেবে **Staging** এবং আপনার নেটওয়ার্ক হিসেবে **Goerli** নির্বাচন করুন। + + + +_দ্রষ্টব্য: অবশ্যই **Goerli** নির্বাচন করুন, নতুবা এই টিউটোরিয়ালটি কাজ করবে না।_ + +**অ্যাপ তৈরি করুন**-এ ক্লিক করুন। আপনার অ্যাপটি নীচের টেবিলে প্রদর্শিত হবে। + +### একটি ইথেরিয়াম অ্যাকাউন্ট তৈরি করুন {#create-an-ethereum-account} + +লেনদেন পাঠানো এবং গ্রহণ করার জন্য আপনার একটি ইথেরিয়াম অ্যাকাউন্ট প্রয়োজন। আমরা MetaMask ব্যবহার করব, যা ব্রাউজারের একটি ভার্চুয়াল ওয়ালেট এবং এটি ব্যবহারকারীদের তাদের ইথেরিয়াম অ্যাকাউন্টের ঠিকানা পরিচালনা করতে দেয়। + +আপনি [এখানে](https://metamask.io/download) বিনামূল্যে একটি MetaMask অ্যাকাউন্ট ডাউনলোড এবং তৈরি করতে পারেন। যখন আপনি একটি অ্যাকাউন্ট তৈরি করছেন, বা যদি আপনার আগে থেকেই একটি অ্যাকাউন্ট থাকে, তবে উপরের ডানদিকে থাকা "Goerli Test Network"-এ স্যুইচ করতে ভুলবেন না (যাতে আমরা আসল টাকা নিয়ে কাজ না করি)। + +### ধাপ ৪: একটি ফসেট থেকে ইথার যোগ করুন {#step-4-add-ether-from-a-faucet} + +টেস্ট নেটওয়ার্কে আপনার স্মার্ট কন্ট্র্যাক্ট স্থাপন করতে, আপনার কিছু নকল ETH লাগবে। Goerli নেটওয়ার্কে ETH পেতে, একটি Goerli ফসেটে যান এবং আপনার Goerli অ্যাকাউন্টের ঠিকানা লিখুন। উল্লেখ্য যে Goerli ফসেটগুলি সম্প্রতি কিছুটা অবিশ্বাস্য হতে পারে - চেষ্টা করার জন্য বিকল্পগুলির একটি তালিকার জন্য [টেস্ট নেটওয়ার্ক পৃষ্ঠাটি](/developers/docs/networks/#goerli) দেখুন: + +_দ্রষ্টব্য: নেটওয়ার্ক কনজেশনের কারণে, এতে কিছুটা সময় লাগতে পারে।_ +`` + +### ধাপ ৫: আপনার ব্যালেন্স পরীক্ষা করুন {#step-5-check-your-balance} + +আপনার ওয়ালেটে ETH আছে কিনা তা পুনরায় পরীক্ষা করতে, আসুন আমরা [Alchemy-র কম্পোজার টুল](https://composer.alchemyapi.io/?composer_state=%7B%22network%22%3A0%2C%22methodName%22%3A%22eth_getBalance%22%2C%22paramValues%22%3A%5B%22%22%2C%22latest%22%5D%7D) ব্যবহার করে একটি [eth_getBalance](https://docs.alchemyapi.io/alchemy/documentation/alchemy-api-reference/json-rpc#eth_getbalance) অনুরোধ করি। এটি আমাদের ওয়ালেটে থাকা ETH-এর পরিমাণ ফেরত দেবে। আরও জানতে [কম্পোজার টুলটি কীভাবে ব্যবহার করবেন সে সম্পর্কে Alchemy-র সংক্ষিপ্ত টিউটোরিয়ালটি](https://youtu.be/r6sjRxBZJuU) দেখুন। + +আপনার MetaMask অ্যাকাউন্টের ঠিকানা ইনপুট করুন এবং **অনুরোধ পাঠান**-এ ক্লিক করুন। আপনি নীচের কোড স্নিপেটের মতো একটি প্রতিক্রিয়া দেখতে পাবেন। + +```json +{ "jsonrpc": "2.0", "id": 0, "result": "0x2B5E3AF16B1880000" } +``` + +> _দ্রষ্টব্য: এই ফলাফলটি wei-তে, ETH-এ নয়।_ Wei ইথারের ক্ষুদ্রতম একক হিসাবে ব্যবহৃত হয়।_ + +যাক বাবা! আমাদের নকল টাকা সব আছে। + +### ধাপ ৬: আমাদের প্রজেক্ট শুরু করুন {#step-6-initialize-our-project} + +প্রথমে, আমাদের প্রজেক্টের জন্য একটি ফোল্ডার তৈরি করতে হবে। আপনার কমান্ড লাইনে নেভিগেট করুন এবং নিম্নলিখিতটি ইনপুট করুন। + +``` +mkdir hello-world +cd hello-world +``` + +এখন যেহেতু আমরা আমাদের প্রজেক্ট ফোল্ডারের ভিতরে আছি, আমরা প্রজেক্টটি শুরু করতে `npm init` ব্যবহার করব। + +> যদি আপনার এখনও npm ইনস্টল করা না থাকে, তাহলে [Node.js এবং npm ইনস্টল করার জন্য এই নির্দেশাবলী](https://docs.alchemyapi.io/alchemy/guides/alchemy-for-macs#1-install-nodejs-and-npm) অনুসরণ করুন। + +এই টিউটোরিয়ালের উদ্দেশ্যে, আপনি ইনিশিয়ালাইজেশন প্রশ্নগুলির কীভাবে উত্তর দেন তা বিবেচ্য নয়। এখানে আমরা রেফারেন্সের জন্য কীভাবে এটি করেছি তা দেওয়া হলো: + +``` +প্যাকেজের নাম: (hello-world) +সংস্করণ: (1.0.0) +বর্ণনা: hello world স্মার্ট কন্ট্র্যাক্ট +এন্ট্রি পয়েন্ট: (index.js) +টেস্ট কমান্ড: +git রিপোজিটরি: +কীওয়ার্ড: +লেখক: +লাইসেন্স: (ISC) + +/Users/.../.../.../hello-world/package.json এ লিখতে চলেছে: + +{ + "name": "hello-world", + "version": "1.0.0", + "description": "hello world স্মার্ট কন্ট্র্যাক্ট", + "main": "index.js", + "scripts": { + "test": "echo \"Error: no test specified\" && exit 1" + }, + "author": "", + "license": "ISC" +} +``` + +package.json অনুমোদন করুন এবং আমরা এগিয়ে যাওয়ার জন্য প্রস্তুত! + +### ধাপ ৭: Hardhat ডাউনলোড করুন {#step-7-download-hardhat} + +Hardhat হল আপনার Ethereum সফ্টওয়্যার কম্পাইল, স্থাপন, পরীক্ষা এবং ডিবাগ করার জন্য একটি ডেভেলপমেন্ট পরিবেশ। এটি ডেভেলপারদের লাইভ চেইনে স্থাপন করার আগে স্থানীয়ভাবে স্মার্ট কন্ট্র্যাক্ট এবং ডিএ্যাপস তৈরি করতে সাহায্য করে। + +আমাদের `hello-world` প্রজেক্টের ভিতরে চালান: + +``` +npm install --save-dev hardhat +``` + +[ইনস্টলেশন নির্দেশাবলী](https://hardhat.org/getting-started/#overview) সম্পর্কে আরও বিস্তারিত জানতে এই পৃষ্ঠাটি দেখুন। + +### ধাপ ৮: Hardhat প্রজেক্ট তৈরি করুন {#step-8-create-hardhat-project} + +আমাদের `hello-world` প্রজেক্ট ফোল্ডারের ভিতরে, চালান: + +``` +npx hardhat +``` + +তারপরে আপনার একটি স্বাগত বার্তা এবং আপনি কী করতে চান তা নির্বাচন করার একটি বিকল্প দেখতে পাওয়া উচিত। “একটি খালি hardhat.config.js তৈরি করুন” নির্বাচন করুন: + +``` +888 888 888 888 888 +888 888 888 888 888 +888 888 888 888 888 +8888888888 8888b. 888d888 .d88888 88888b. 8888b. 888888 +888 888 "88b 888P" d88" 888 888 "88b "88b 888 +888 888 .d888888 888 888 888 888 888 .d888888 888 +888 888 888 888 888 Y88b 888 888 888 888 888 Y88b. +888 888 "Y888888 888 "Y88888 888 888 "Y888888 "Y888 + +👷 Hardhat v2.0.11-এ আপনাকে স্বাগত 👷 + +আপনি কী করতে চান? … +একটি নমুনা প্রজেক্ট তৈরি করুন +❯ একটি খালি hardhat.config.js তৈরি করুন +প্রস্থান করুন +``` + +এটি প্রজেক্টে একটি `hardhat.config.js` ফাইল তৈরি করবে। আমরা আমাদের প্রজেক্টের সেটআপ নির্দিষ্ট করার জন্য টিউটোরিয়ালের পরে এটি ব্যবহার করব। + +### ধাপ ৯: প্রজেক্ট ফোল্ডার যোগ করুন {#step-9-add-project-folders} + +প্রজেক্টটি সংগঠিত রাখতে, আসুন দুটি নতুন ফোল্ডার তৈরি করি। কমান্ড লাইনে, আপনার `hello-world` প্রজেক্টের রুট ডিরেক্টরিতে নেভিগেট করুন এবং টাইপ করুন: + +``` +mkdir contracts +mkdir scripts +``` + +- `contracts/` হল যেখানে আমরা আমাদের হ্যালো ওয়ার্ল্ড স্মার্ট কন্ট্র্যাক্ট কোড ফাইল রাখব +- `scripts/` হল যেখানে আমরা আমাদের কন্ট্র্যাক্ট স্থাপন এবং ইন্টারঅ্যাক্ট করার জন্য স্ক্রিপ্ট রাখব + +### ধাপ ১০: আমাদের কন্ট্র্যাক্ট লিখুন {#step-10-write-our-contract} + +আপনি নিজেকে জিজ্ঞাসা করতে পারেন, আমরা কখন কোড লিখতে যাচ্ছি? এখন সেই সময়! + +আপনার প্রিয় এডিটরে hello-world প্রজেক্টটি খুলুন। স্মার্ট কন্ট্র্যাক্টগুলি সাধারণত সলিডিটিতে লেখা হয়, যা আমরা আমাদের স্মার্ট কন্ট্র্যাক্ট লেখার জন্য ব্যবহার করব। + +1. `contracts` ফোল্ডারে নেভিগেট করুন এবং `HelloWorld.sol` নামে একটি নতুন ফাইল তৈরি করুন +2. নীচে একটি নমুনা Hello World স্মার্ট কন্ট্র্যাক্ট রয়েছে যা আমরা এই টিউটোরিয়ালের জন্য ব্যবহার করব। নীচের বিষয়বস্তুগুলি `HelloWorld.sol` ফাইলে কপি করুন। + +_দ্রষ্টব্য: এই কন্ট্র্যাক্টটি কী করে তা বোঝার জন্য মন্তব্যগুলি পড়তে ভুলবেন না।_ + +``` +// সিমেন্টিক ভার্সনিং ব্যবহার করে সলিডিটির সংস্করণ নির্দিষ্ট করে। +// আরও জানুন: https://solidity.readthedocs.io/en/v0.5.10/layout-of-source-files.html#pragma +pragma solidity >=0.7.3; + +// `HelloWorld` নামের একটি কন্ট্র্যাক্ট সংজ্ঞায়িত করে। +// একটি কন্ট্র্যাক্ট হল ফাংশন এবং ডেটার একটি সংগ্রহ (তার স্টেট)। একবার স্থাপন করা হলে, একটি কন্ট্র্যাক্ট ইথেরিয়াম ব্লকচেইনে একটি নির্দিষ্ট ঠিকানায় থাকে। আরও জানুন: https://solidity.readthedocs.io/en/v0.5.10/structure-of-a-contract.html +contract HelloWorld { + + //আপডেট ফাংশন কল করা হলে নির্গত হয় + //স্মার্ট কন্ট্র্যাক্ট ইভেন্টগুলি হল আপনার কন্ট্র্যাক্টের জন্য আপনার অ্যাপ ফ্রন্ট-এন্ডে ব্লকচেইনে কিছু ঘটেছে তা জানানোর একটি উপায়, যা নির্দিষ্ট ইভেন্টের জন্য 'শুনতে' পারে এবং সেগুলি ঘটলে ব্যবস্থা নিতে পারে। + event UpdatedMessages(string oldStr, string newStr); + + // `string` টাইপের একটি স্টেট ভেরিয়েবল `message` ঘোষণা করে। + // স্টেট ভেরিয়েবলগুলি হল এমন ভেরিয়েবল যার মানগুলি স্থায়ীভাবে কন্ট্র্যাক্ট স্টোরেজে সংরক্ষণ করা হয়। `public` কীওয়ার্ডটি কন্ট্র্যাক্টের বাইরে থেকে ভেরিয়েবলগুলিকে অ্যাক্সেসযোগ্য করে তোলে এবং একটি ফাংশন তৈরি করে যা অন্য কন্ট্র্যাক্ট বা ক্লায়েন্টরা মান অ্যাক্সেস করার জন্য কল করতে পারে। + string public message; + + // অনেক ক্লাস-ভিত্তিক অবজেক্ট-ওরিয়েন্টেড ভাষার মতো, একটি কনস্ট্রাক্টর হল একটি বিশেষ ফাংশন যা শুধুমাত্র কন্ট্র্যাক্ট তৈরির সময় কার্যকর করা হয়। + // কনস্ট্রাক্টরগুলি কন্ট্র্যাক্টের ডেটা ইনিশিয়ালাইজ করতে ব্যবহৃত হয়। আরও জানুন:https://solidity.readthedocs.io/en/v0.5.10/contracts.html#constructors + constructor(string memory initMessage) { + + // একটি স্ট্রিং আর্গুমেন্ট `initMessage` গ্রহণ করে এবং কন্ট্র্যাক্টের `message` স্টোরেজ ভেরিয়েবলে মান সেট করে)। + message = initMessage; + } + + // একটি পাবলিক ফাংশন যা একটি স্ট্রিং আর্গুমেন্ট গ্রহণ করে এবং `message` স্টোরেজ ভেরিয়েবল আপডেট করে। + function update(string memory newMessage) public { + string memory oldMsg = message; + message = newMessage; + emit UpdatedMessages(oldMsg, newMessage); + } +} +``` + +এটি একটি বেসিক স্মার্ট কন্ট্র্যাক্ট যা তৈরি হওয়ার পরে একটি বার্তা সংরক্ষণ করে। এটি `update` ফাংশন কল করে আপডেট করা যেতে পারে। + +### ধাপ ১১: আপনার প্রজেক্টের সাথে MetaMask এবং Alchemy সংযোগ করুন {#step-11-connect-metamask-alchemy-to-your-project} + +আমরা একটি MetaMask ওয়ালেট, Alchemy অ্যাকাউন্ট তৈরি করেছি এবং আমাদের স্মার্ট কন্ট্র্যাক্ট লিখেছি, এখন এই তিনটি সংযোগ করার সময়। + +আপনার ওয়ালেট থেকে পাঠানো প্রতিটি লেনদেনের জন্য আপনার অনন্য ব্যক্তিগত কী ব্যবহার করে একটি স্বাক্ষরের প্রয়োজন। আমাদের প্রোগ্রামকে এই অনুমতি দেওয়ার জন্য, আমরা আমাদের ব্যক্তিগত কী একটি এনভায়রনমেন্ট ফাইলে নিরাপদে সংরক্ষণ করতে পারি। আমরা এখানে Alchemy-র জন্য একটি API কীও সংরক্ষণ করব। + +> লেনদেন পাঠানোর বিষয়ে আরও জানতে, ওয়েব3 ব্যবহার করে লেনদেন পাঠানোর উপর [এই টিউটোরিয়ালটি](https://www.alchemy.com/docs/hello-world-smart-contract#step-11-connect-metamask--alchemy-to-your-project) দেখুন। + +প্রথমে, আপনার প্রজেক্ট ডিরেক্টরিতে ডটএনভ প্যাকেজটি ইনস্টল করুন: + +``` +npm install dotenv --save +``` + +তারপর, প্রজেক্টের রুট ডিরেক্টরিতে একটি `.env` ফাইল তৈরি করুন। এতে আপনার MetaMask ব্যক্তিগত কী এবং HTTP Alchemy API URL যোগ করুন। + +আপনার এনভায়রনমেন্ট ফাইলের নাম অবশ্যই `.env` হতে হবে, নতুবা এটি এনভায়রনমেন্ট ফাইল হিসেবে স্বীকৃত হবে না। + +এটির নাম `process.env` বা `.env-custom` বা অন্য কিছু দেবেন না। + +- আপনার ব্যক্তিগত কী এক্সপোর্ট করতে [এই নির্দেশাবলী](https://metamask.zendesk.com/hc/en-us/articles/360015289632-How-to-Export-an-Account-Private-Key) অনুসরণ করুন +- HTTP Alchemy API URL পেতে নিচে দেখুন + + + +আপনার `.env` ফাইলটি এইরকম দেখতে হবে: + +``` +API_URL = "https://eth-goerli.alchemyapi.io/v2/your-api-key" +PRIVATE_KEY = "your-metamask-private-key" +``` + +এগুলিকে আমাদের কোডের সাথে সংযোগ করতে, আমরা ধাপ 13-এ আমাদের `hardhat.config.js` ফাইলে এই ভেরিয়েবলগুলিকে রেফারেন্স করব। + +### ধাপ 12: Ethers.js ইনস্টল করুন {#step-12-install-ethersjs} + +Ethers.js হল একটি লাইব্রেরি যা আরও ব্যবহারকারী-বান্ধব পদ্ধতির সাথে [স্ট্যান্ডার্ড JSON-RPC পদ্ধতি](https://docs.alchemyapi.io/alchemy/documentation/alchemy-api-reference/json-rpc) মোড়ক দিয়ে ইথেরিয়ামের সাথে ইন্টারঅ্যাক্ট করা এবং অনুরোধ করা সহজ করে তোলে। + +Hardhat আমাদের অতিরিক্ত টুলিং এবং বর্ধিত কার্যকারিতার জন্য [প্লাগইন](https://hardhat.org/plugins/) একীভূত করার অনুমতি দেয়। আমরা কন্ট্র্যাক্ট স্থাপনার জন্য [Ethers প্লাগইন](https://hardhat.org/docs/plugins/official-plugins#hardhat-ethers) এর সুবিধা নেব। + +আপনার প্রজেক্ট ডিরেক্টরিতে টাইপ করুন: + +```bash +npm install --save-dev @nomiclabs/hardhat-ethers "ethers@^5.0.0" +``` + +### ধাপ ১৩: hardhat.config.js আপডেট করুন {#step-13-update-hardhat-configjs} + +আমরা এখন পর্যন্ত বেশ কিছু নির্ভরতা এবং প্লাগইন যোগ করেছি, এখন আমাদের `hardhat.config.js` আপডেট করতে হবে যাতে আমাদের প্রজেক্ট তাদের সকলের সম্পর্কে জানতে পারে। + +আপনার `hardhat.config.js` আপডেট করে এইরকম করুন: + +```javascript +/** + * @type import('hardhat/config').HardhatUserConfig + */ + +require("dotenv").config() +require("@nomiclabs/hardhat-ethers") + +const { API_URL, PRIVATE_KEY } = process.env + +module.exports = { + solidity: "0.7.3", + defaultNetwork: "goerli", + networks: { + hardhat: {}, + goerli: { + url: API_URL, + accounts: [`0x${PRIVATE_KEY}`], + }, + }, +} +``` + +### ধাপ ১৪: আমাদের কন্ট্র্যাক্ট কম্পাইল করুন {#step-14-compile-our-contract} + +সবকিছু ঠিকঠাক কাজ করছে কিনা তা নিশ্চিত করতে, আসুন আমাদের কন্ট্র্যাক্ট কম্পাইল করি। `compile` টাস্কটি অন্তর্নির্মিত হার্ডহ্যাট টাস্কগুলির মধ্যে একটি। + +কমান্ড লাইন থেকে রান করুন: + +```bash +npx hardhat compile +``` + +আপনি `SPDX লাইসেন্স আইডেন্টিফায়ার সোর্স ফাইলে সরবরাহ করা হয়নি` সম্পর্কে একটি সতর্কতা পেতে পারেন, কিন্তু সে সম্পর্কে চিন্তা করার দরকার নেই — আশা করি বাকি সব ঠিকঠাক দেখাবে! যদি না হয়, আপনি সবসময় [Alchemy ডিসকর্ড](https://discord.gg/u72VCg3)-এ বার্তা দিতে পারেন। + +### ধাপ ১৫: আমাদের ডেপ্লয় স্ক্রিপ্ট লিখুন {#step-15-write-our-deploy-script} + +এখন যেহেতু আমাদের কন্ট্র্যাক্ট লেখা হয়ে গেছে এবং আমাদের কনফিগারেশন ফাইল প্রস্তুত, এখন আমাদের কন্ট্র্যাক্ট ডেপ্লয় স্ক্রিপ্ট লেখার সময়। + +`scripts/` ফোল্ডারে যান এবং `deploy.js` নামে একটি নতুন ফাইল তৈরি করুন, এতে নিম্নলিখিত বিষয়বস্তু যোগ করুন: + +```javascript +async function main() { + const HelloWorld = await ethers.getContractFactory("HelloWorld") + + // ডেপ্লয়মেন্ট শুরু করুন, যা একটি কন্ট্র্যাক্ট অবজেক্টের সমাধান করে এমন একটি প্রতিশ্রুতি প্রদান করে + const hello_world = await HelloWorld.deploy("Hello World!") + console.log("Contract deployed to address:", hello_world.address) +} + +main() + .then(() => process.exit(0)) + .catch((error) => { + console.error(error) + process.exit(1) + }) +``` + +Hardhat তাদের [কন্ট্র্যাক্টস টিউটোরিয়াল](https://hardhat.org/tutorial/testing-contracts.html#writing-tests)-এ এই কোডের প্রতিটি লাইন কী করে তা চমৎকারভাবে ব্যাখ্যা করেছে, আমরা এখানে তাদের ব্যাখ্যাগুলি গ্রহণ করেছি। + +```javascript +const HelloWorld = await ethers.getContractFactory("HelloWorld") +``` + +ethers.js-এ একটি `ContractFactory` হল নতুন স্মার্ট কন্ট্র্যাক্ট ডেপ্লয় করার জন্য ব্যবহৃত একটি বিমূর্তকরণ, তাই এখানে `HelloWorld` হল আমাদের hello world কন্ট্র্যাক্টের উদাহরণগুলির জন্য একটি [ফ্যাক্টরি](https://en.wikipedia.org/wiki/Factory_\(object-oriented_programming\))। `hardhat-ethers` প্লাগইন `ContractFactory` এবং `Contract` ব্যবহার করার সময়, ইনস্ট্যান্সগুলি ডিফল্টরূপে প্রথম স্বাক্ষরকারী (মালিক) এর সাথে সংযুক্ত থাকে। + +```javascript +const hello_world = await HelloWorld.deploy() +``` + +একটি `ContractFactory`-এ `deploy()` কল করলে ডেপ্লয়মেন্ট শুরু হবে, এবং একটি `Promise` প্রদান করবে যা একটি `Contract` অবজেক্টে সমাধান করে। এটি সেই অবজেক্ট যার আমাদের প্রতিটি স্মার্ট কন্ট্র্যাক্ট ফাংশনের জন্য একটি পদ্ধতি রয়েছে। + +### ধাপ 16: আমাদের কন্ট্র্যাক্ট স্থাপন করুন {#step-16-deploy-our-contract} + +আমরা অবশেষে আমাদের স্মার্ট কন্ট্র্যাক্ট স্থাপন করার জন্য প্রস্তুত! কমান্ড লাইনে যান এবং চালান: + +```bash +npx hardhat run scripts/deploy.js --network goerli +``` + +তারপরে আপনার এইরকম কিছু দেখা উচিত: + +```bash +কন্ট্র্যাক্টটি এই ঠিকানায় স্থাপন করা হয়েছে: 0x6cd7d44516a20882cEa2DE9f205bF401c0d23570 +``` + +**অনুগ্রহ করে এই ঠিকানাটি সংরক্ষণ করুন**। আমরা এটি টিউটোরিয়ালের পরে ব্যবহার করব। + +আমরা যদি [Goerli etherscan](https://goerli.etherscan.io)-এ যাই এবং আমাদের কন্ট্র্যাক্টের ঠিকানা অনুসন্ধান করি, তাহলে আমরা দেখতে পাব যে এটি সফলভাবে স্থাপন করা হয়েছে। লেনদেনটি এইরকম কিছু দেখাবে: + + + +`From` ঠিকানাটি আপনার MetaMask অ্যাকাউন্টের ঠিকানার সাথে মিলবে এবং `To` ঠিকানায় বলা হবে **কন্ট্র্যাক্ট তৈরি**। যদি আমরা লেনদেনের মধ্যে ক্লিক করি, তাহলে আমরা `To` ফিল্ডে আমাদের কন্ট্র্যাক্টের ঠিকানা দেখতে পাব। + + + +অভিনন্দন! আপনি সবেমাত্র একটি ইথেরিয়াম টেস্টনেটে একটি স্মার্ট কন্ট্র্যাক্ট স্থাপন করেছেন। + +নেপথ্যে কী ঘটছে তা বোঝার জন্য, আসুন আমাদের [Alchemy ড্যাশবোর্ড](https://dashboard.alchemy.com/explorer)-এর এক্সপ্লোরার ট্যাবে নেভিগেট করি। আপনার যদি একাধিক Alchemy অ্যাপ থাকে তবে অ্যাপ অনুসারে ফিল্টার করে **Hello World** নির্বাচন করতে ভুলবেন না। + + + +এখানে আপনি কিছু JSON-RPC পদ্ধতি দেখতে পাবেন যা Hardhat/Ethers আমাদের জন্য নেপথ্যে তৈরি করেছে যখন আমরা `.deploy()` ফাংশন কল করেছিলাম। এখানকার দুটি গুরুত্বপূর্ণ পদ্ধতি হল [`eth_sendRawTransaction`](https://docs.alchemyapi.io/alchemy/documentation/alchemy-api-reference/json-rpc#eth_sendrawtransaction), যা Goerli চেইনে আমাদের কন্ট্র্যাক্ট লেখার অনুরোধ, এবং [`eth_getTransactionByHash`](https://docs.alchemyapi.io/alchemy/documentation/alchemy-api-reference/json-rpc#eth_gettransactionbyhash), যা হ্যাস দেওয়া হলে আমাদের transaction সম্পর্কে তথ্য পড়ার জন্য একটি অনুরোধ। লেনদেন পাঠানোর বিষয়ে আরও জানতে, [Web3 ব্যবহার করে লেনদেন পাঠানোর উপর আমাদের টিউটোরিয়ালটি দেখুন](/developers/tutorials/sending-transactions-using-web3-and-alchemy/)। + +## পর্ব ২: আপনার স্মার্ট কন্ট্র্যাক্টের সাথে ইন্টারঅ্যাক্ট করুন {#part-2-interact-with-your-smart-contract} + +যেহেতু আমরা সফলভাবে Goerli নেটওয়ার্কে একটি স্মার্ট কন্ট্র্যাক্ট স্থাপন করেছি, আসুন এবার শিখি কীভাবে এর সাথে ইন্টারঅ্যাক্ট করতে হয়। + +### একটি interact.js ফাইল তৈরি করুন {#create-a-interactjs-file} + +এটি সেই ফাইল যেখানে আমরা আমাদের ইন্টারঅ্যাকশন স্ক্রিপ্ট লিখব। আমরা Ethers.js লাইব্রেরি ব্যবহার করব যা আপনি পূর্বে পর্ব ১-এ ইনস্টল করেছিলেন। + +`scripts/` ফোল্ডারের ভিতরে, `interact.js` নামে একটি নতুন ফাইল তৈরি করুন এবং নিম্নলিখিত কোডটি যোগ করুন: + +```javascript +// interact.js + +const API_KEY = process.env.API_KEY +const PRIVATE_KEY = process.env.PRIVATE_KEY +const CONTRACT_ADDRESS = process.env.CONTRACT_ADDRESS +``` + +### আপনার .env ফাইল আপডেট করুন {#update-your-env-file} + +আমরা নতুন এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করব, তাই আমাদের `.env` ফাইলে সেগুলিকে সংজ্ঞায়িত করতে হবে যা [আমরা আগে তৈরি করেছি](#step-11-connect-metamask-&-alchemy-to-your-project)। + +আমাদের Alchemy `API_KEY` এবং `CONTRACT_ADDRESS`-এর জন্য একটি সংজ্ঞা যোগ করতে হবে যেখানে আপনার স্মার্ট কন্ট্র্যাক্টটি স্থাপন করা হয়েছিল। + +আপনার `.env` ফাইলটি এইরকম কিছু দেখতে হবে: + +```bash +# .env + +API_URL = "https://eth-goerli.alchemyapi.io/v2/
+ 
+
+
+
+)
+```
+
+আপনি যদি এই কোডটি সাবধানে স্ক্যান করেন, আপনি লক্ষ্য করবেন যে আমরা আমাদের UI-তে আমাদের বিভিন্ন স্টেট ভেরিয়েবল কোথায় ব্যবহার করি:
+
+- ৬-১২ লাইনে, যদি ব্যবহারকারীর ওয়ালেট সংযুক্ত থাকে (অর্থাৎ `walletAddress.length > 0`), আমরা "walletButton" আইডি সহ বোতামে ব্যবহারকারীর `walletAddress`-এর একটি সংক্ষিপ্ত সংস্করণ প্রদর্শন করি; অন্যথায় এটি কেবল "ওয়ালেট সংযোগ করুন" বলে।
+- ১৭ লাইনে, আমরা স্মার্ট কন্ট্র্যাক্টে সংরক্ষিত বর্তমান বার্তা প্রদর্শন করি, যা `message` স্ট্রিং-এ ধরা হয়।
+- ২৩-২৬ লাইনে, আমরা টেক্সট ফিল্ডে ইনপুট পরিবর্তন হলে আমাদের `newMessage` স্টেট ভেরিয়েবল আপডেট করার জন্য একটি [নিয়ন্ত্রিত কম্পোনেন্ট](https://legacy.reactjs.org/docs/forms.html#controlled-components) ব্যবহার করি।
+
+আমাদের স্টেট ভেরিয়েবল ছাড়াও, আপনি আরও দেখতে পাবেন যে `publishButton` এবং `walletButton` আইডি সহ বোতামগুলি ক্লিক করা হলে যথাক্রমে `connectWalletPressed` এবং `onUpdatePressed` ফাংশনগুলি কল করা হয়।
+
+অবশেষে, আসুন দেখা যাক এই `HelloWorld.js` কম্পোনেন্টটি কোথায় যুক্ত করা হয়েছে।
+
+আপনি যদি `App.js` ফাইলে যান, যা React-এর প্রধান কম্পোনেন্ট এবং অন্যান্য সমস্ত কম্পোনেন্টের জন্য একটি ধারক হিসেবে কাজ করে, আপনি দেখতে পাবেন যে আমাদের `HelloWorld.js` কম্পোনেন্টটি ৭ নং লাইনে ইনজেক্ট করা হয়েছে।
+
+সবশেষে, আসুন আপনার জন্য সরবরাহ করা আরও একটি ফাইল, `interact.js` ফাইলটি দেখে নেওয়া যাক।
+
+#### `interact.js` ফাইল {#the-interact-js-file}
+
+যেহেতু আমরা [M-V-C](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) প্যারাডাইম অনুসরণ করতে চাই, আমরা একটি পৃথক ফাইল চাইব যা আমাদের ডিএ্যাপস-এর যুক্তি, ডেটা এবং নিয়মগুলি পরিচালনা করার জন্য আমাদের সমস্ত ফাংশন ধারণ করে এবং তারপরে সেই ফাংশনগুলিকে আমাদের ফ্রন্টএন্ডে (আমাদের `HelloWorld.js` কম্পোনেন্ট) এক্সপোর্ট করতে সক্ষম হব।
+
+👆🏽এইটিই আমাদের `interact.js` ফাইলের সঠিক উদ্দেশ্য!
+
+আপনার `src` ডিরেক্টরিতে `util` ফোল্ডারে নেভিগেট করুন, এবং আপনি লক্ষ্য করবেন যে আমরা `interact.js` নামে একটি ফাইল অন্তর্ভুক্ত করেছি যা আমাদের সমস্ত স্মার্ট কন্ট্র্যাক্ট ইন্টারঅ্যাকশন এবং ওয়ালেট ফাংশন ও ভেরিয়েবল ধারণ করবে।
+
+```javascript
+// interact.js
+
+//export const helloWorldContract;
+
+export const loadCurrentMessage = async () => {}
+
+export const connectWallet = async () => {}
+
+const getCurrentWalletConnected = async () => {}
+
+export const updateMessage = async (message) => {}
+```
+
+আপনি ফাইলের শীর্ষে লক্ষ্য করবেন যে আমরা `helloWorldContract` অবজেক্টটি কমেন্ট আউট করেছি। এই টিউটোরিয়ালের পরে, আমরা এই অবজেক্টটি আনকমেন্ট করব এবং এই ভেরিয়েবলে আমাদের স্মার্ট কন্ট্র্যাক্টটি ইনস্ট্যানশিয়েট করব, যা আমরা তারপরে আমাদের `HelloWorld.js` কম্পোনেন্টে এক্সপোর্ট করব।
+
+আমাদের `helloWorldContract` অবজেক্টের পরে চারটি অবাস্তবায়িত ফাংশন নিম্নলিখিত কাজগুলি করে:
+
+- `loadCurrentMessage` - এই ফাংশনটি স্মার্ট কন্ট্র্যাক্টে সংরক্ষিত বর্তমান বার্তা লোড করার যুক্তি পরিচালনা করে। এটি [Alchemy Web3 API](https://github.com/alchemyplatform/alchemy-web3) ব্যবহার করে Hello World স্মার্ট কন্ট্র্যাক্টে একটি _পড়ার_ কল করবে।
+- `connectWallet` - এই ফাংশনটি ব্যবহারকারীর MetaMask কে আমাদের ডিএ্যাপস-এর সাথে সংযোগ করবে।
+- `getCurrentWalletConnected` - এই ফাংশনটি পৃষ্ঠা লোড হওয়ার সময় আমাদের ডিএ্যাপস-এর সাথে একটি ইথেরিয়াম অ্যাকাউন্ট ইতিমধ্যে সংযুক্ত আছে কিনা তা পরীক্ষা করবে এবং সেই অনুযায়ী আমাদের UI আপডেট করবে।
+- `updateMessage` - এই ফাংশনটি স্মার্ট কন্ট্র্যাক্টে সংরক্ষিত বার্তা আপডেট করবে। এটি Hello World স্মার্ট কন্ট্র্যাক্টে একটি _লেখার_ কল করবে, তাই বার্তা আপডেট করার জন্য ব্যবহারকারীর MetaMask ওয়ালেটকে একটি ইথেরিয়াম লেনদেন স্বাক্ষর করতে হবে।
+
+এখন যেহেতু আমরা বুঝতে পারছি আমরা কী নিয়ে কাজ করছি, আসুন দেখি কীভাবে আমাদের স্মার্ট কন্ট্র্যাক্ট থেকে পড়তে হয়!
+
+### ধাপ ৩: আপনার স্মার্ট কন্ট্র্যাক্ট থেকে পড়ুন {#step-3-read-from-your-smart-contract}
+
+আপনার স্মার্ট কন্ট্র্যাক্ট থেকে পড়তে, আপনাকে সফলভাবে সেট আপ করতে হবে:
+
+- ইথেরিয়াম চেইনের সাথে একটি API সংযোগ
+- আপনার স্মার্ট কন্ট্র্যাক্টের একটি লোড করা উদাহরণ
+- আপনার স্মার্ট কন্ট্র্যাক্ট ফাংশনে কল করার জন্য একটি ফাংশন
+- স্মার্ট কন্ট্র্যাক্ট থেকে আপনি যে ডেটা পড়ছেন তা পরিবর্তন হলে আপডেটগুলির জন্য নজর রাখার জন্য একটি লিসেনার
+
+এটি অনেক ধাপের মতো শোনাতে পারে, কিন্তু চিন্তা করবেন না! আমরা আপনাকে ধাপে ধাপে প্রতিটি কিভাবে করতে হয় তা দেখাব! :\)
+
+#### ইথেরিয়াম চেইনের সাথে একটি API সংযোগ স্থাপন করুন {#establish-an-api-connection-to-the-ethereum-chain}
+
+তাহলে মনে আছে এই টিউটোরিয়ালের পর্ব ২-এ, আমরা আমাদের স্মার্ট কন্ট্র্যাক্ট থেকে পড়ার জন্য আমাদের [Alchemy Web3 কী ব্যবহার করেছিলাম](https://docs.alchemy.com/alchemy/tutorials/hello-world-smart-contract/interacting-with-a-smart-contract#step-1-install-web3-library)? চেইন থেকে পড়ার জন্য আপনার ডিএ্যাপস-এ একটি Alchemy Web3 কীও প্রয়োজন হবে।
+
+আপনার যদি এটি ইতিমধ্যে না থাকে, তাহলে প্রথমে [Alchemy Web3](https://github.com/alchemyplatform/alchemy-web3) ইনস্টল করুন আপনার `starter-files`-এর রুট ডিরেক্টরিতে নেভিগেট করে এবং আপনার টার্মিনালে নিম্নলিখিতটি চালান:
+
+```text
+npm install @alch/alchemy-web3
+```
+
+[Alchemy Web3](https://github.com/alchemyplatform/alchemy-web3) হল [Web3.js](https://docs.web3js.org/)-এর একটি র্যাপার, যা উন্নত API পদ্ধতি এবং অন্যান্য গুরুত্বপূর্ণ সুবিধা প্রদান করে যাতে আপনার জীবন একজন ওয়েব3 ডেভেলপার হিসাবে সহজ হয়। এটি এমনভাবে ডিজাইন করা হয়েছে যাতে ন্যূনতম কনফিগারেশনের প্রয়োজন হয় যাতে আপনি এখনই আপনার অ্যাপে এটি ব্যবহার করা শুরু করতে পারেন!
+
+তারপর, আপনার প্রজেক্ট ডিরেক্টরিতে [dotenv](https://www.npmjs.com/package/dotenv) প্যাকেজটি ইনস্টল করুন, যাতে আমরা আমাদের API কী আনার পরে এটি সংরক্ষণের জন্য একটি নিরাপদ জায়গা পাই।
+
+```text
+npm install dotenv --save
+```
+
+আমাদের ডিএ্যাপস-এর জন্য, **আমরা আমাদের HTTP API কী-এর পরিবর্তে আমাদের Websockets API কী ব্যবহার করব**, কারণ এটি আমাদের একটি লিসেনার সেট আপ করতে দেবে যা স্মার্ট কন্ট্র্যাক্টে সংরক্ষিত বার্তা পরিবর্তন হলে সনাক্ত করে।
+
+আপনার API কী পাওয়ার পর, আপনার রুট ডিরেক্টরিতে একটি `.env` ফাইল তৈরি করুন এবং এতে আপনার Alchemy Websockets url যোগ করুন। এরপরে, আপনার `.env` ফাইলটি এরকম দেখতে হবে:
+
+```javascript
+REACT_APP_ALCHEMY_KEY = wss://eth-goerli.ws.alchemyapi.io/v2/বর্তমান বার্তা:
+{message}
+ +নতুন বার্তা:
+ +
+ setNewMessage(e.target.value)}
+ value={newMessage}
+ />
+
+
+{status}
+ + ++ {" "} + 🦊 + আপনাকে অবশ্যই আপনার ব্রাউজারে MetaMask ইনস্টল করতে হবে, যা একটি ভার্চুয়াল ইথেরিয়াম ওয়ালেট। + +
+ + ), + } + } +} +``` + +তাহলে এই বিশাল কোড ব্লকটি ঠিক কী করে? + +ওয়েল, প্রথমে, এটি পরীক্ষা করে যে আপনার ব্রাউজারে `window.ethereum` সক্ষম আছে কিনা। + +`window.ethereum` হল একটি গ্লোবাল API যা MetaMask এবং অন্যান্য ওয়ালেট প্রদানকারীরা ইনজেক্ট করে, যা ওয়েবসাইটগুলিকে ব্যবহারকারীদের ইথেরিয়াম অ্যাকাউন্টগুলির জন্য অনুরোধ করার অনুমতি দেয়। অনুমোদিত হলে, এটি ব্যবহারকারী যে ব্লকচেইনগুলির সাথে সংযুক্ত রয়েছে সেখান থেকে ডেটা পড়তে পারে এবং ব্যবহারকারীকে বার্তা এবং লেনদেন স্বাক্ষর করার পরামর্শ দিতে পারে। আরও তথ্যের জন্য [MetaMask ডক্স](https://docs.metamask.io/guide/ethereum-provider.html#table-of-contents) দেখুন! + +যদি `window.ethereum` উপস্থিত _না থাকে_, তার মানে MetaMask ইনস্টল করা নেই। এর ফলে একটি JSON অবজেক্ট রিটার্ন করা হয়, যেখানে রিটার্ন করা `address` একটি খালি স্ট্রিং এবং `status` JSX অবজেক্টটি ব্যবহারকারীকে MetaMask ইনস্টল করার বার্তা দেয়। + +এখন যদি `window.ethereum` উপস্থিত _থাকে_, তখনই বিষয়গুলো আকর্ষণীয় হয়ে ওঠে। + +একটি try/catch লুপ ব্যবহার করে, আমরা [`window.ethereum.request({ method: \"eth_requestAccounts\" });`](https://docs.metamask.io/guide/rpc-api.html#eth-requestaccounts) কল করে MetaMask-এর সাথে সংযোগ করার চেষ্টা করব। এই ফাংশনটি কল করলে ব্রাউজারে MetaMask খুলবে, যেখানে ব্যবহারকারীকে তাদের ওয়ালেট আপনার dApp-এর সাথে সংযোগ করার জন্য অনুরোধ করা হবে। + +- ব্যবহারকারী যদি সংযোগ করতে চান, তবে `method: "eth_requestAccounts"` একটি অ্যারে প্রদান করবে যাতে ব্যবহারকারীর সমস্ত অ্যাকাউন্ট ঠিকানা থাকবে যা ডিএ্যাপস-এর সাথে সংযুক্ত হয়েছে। সবমিলিয়ে, আমাদের `connectWallet` ফাংশনটি একটি JSON অবজেক্ট রিটার্ন করবে যা এই অ্যারের _প্রথম_ `address` (লাইন ৯ দেখুন) এবং একটি `status` বার্তা ধারণ করবে যা ব্যবহারকারীকে স্মার্ট কন্ট্র্যাক্টে একটি বার্তা লিখতে অনুরোধ করে। +- যদি ব্যবহারকারী সংযোগ প্রত্যাখ্যান করে, তাহলে JSON অবজেক্টটি রিটার্ন করা `address`-এর জন্য একটি খালি স্ট্রিং এবং একটি `status` বার্তা ধারণ করবে যা ব্যবহারকারীর সংযোগ প্রত্যাখ্যান করার বিষয়টি প্রতিফলিত করে। + +এখন যেহেতু আমরা এই `connectWallet` ফাংশনটি লিখেছি, পরবর্তী ধাপ হল এটিকে আমাদের `HelloWorld.js` কম্পোনেন্টে কল করা। + +#### `connectWallet` ফাংশনটি আপনার `HelloWorld.js` UI কম্পোনেন্টে যোগ করুন {#add-the-connectWallet-function-to-your-HelloWorld-js-ui-component} + +`HelloWorld.js`-এর `connectWalletPressed` ফাংশনে নেভিগেট করুন এবং এটিকে নিম্নলিখিতভাবে আপডেট করুন: + +```javascript +// HelloWorld.js + +const connectWalletPressed = async () => { + const walletResponse = await connectWallet() + setStatus(walletResponse.status) + setWallet(walletResponse.address) +} +``` + +লক্ষ্য করুন কীভাবে আমাদের বেশিরভাগ কার্যকারিতা `interact.js` ফাইল থেকে আমাদের `HelloWorld.js` কম্পোনেন্ট থেকে বিমূর্ত করা হয়েছে? এটি যাতে আমরা M-V-C প্যারাডাইম মেনে চলি! + +`connectWalletPressed`-এ, আমরা কেবল আমাদের ইম্পোর্ট করা `connectWallet` ফাংশনে একটি await কল করি, এবং এর প্রতিক্রিয়ার সাহায্যে, আমরা তাদের স্টেট হুকগুলির মাধ্যমে আমাদের `status` এবং `walletAddress` ভেরিয়েবলগুলি আপডেট করি। + +এখন, আসুন উভয় ফাইল (`HelloWorld.js` এবং `interact.js`) সংরক্ষণ করি এবং আমাদের UI পরীক্ষা করি। + +আপনার ব্রাউজারে [http://localhost:3000/](http://localhost:3000/) পৃষ্ঠাটি খুলুন এবং পৃষ্ঠার উপরের ডানদিকে "ওয়ালেট সংযোগ করুন" বোতামটি টিপুন। + +আপনার যদি MetaMask ইনস্টল করা থাকে, তাহলে আপনাকে আপনার ওয়ালেটটি আপনার dApp-এর সাথে সংযোগ করার জন্য অনুরোধ করা হবে। সংযোগ করার জন্য আমন্ত্রণ গ্রহণ করুন। + +আপনি দেখতে পাবেন যে ওয়ালেট বোতামটি এখন প্রতিফলিত করছে যে আপনার ঠিকানা সংযুক্ত! ইয়াসসসস 🔥 + +এরপর, পৃষ্ঠাটি রিফ্রেশ করার চেষ্টা করুন... এটা অদ্ভুত। আমাদের ওয়ালেট বোতামটি আমাদের MetaMask সংযোগ করার জন্য অনুরোধ করছে, যদিও এটি ইতিমধ্যে সংযুক্ত রয়েছে... + +তবে, ভয় পাবেন না! আমরা সহজেই এটি সমাধান করতে পারি (বুঝতে পারছেন?) `getCurrentWalletConnected` বাস্তবায়ন করে, যা পরীক্ষা করবে যে কোনও ঠিকানা ইতিমধ্যে আমাদের ডিএ্যাপস-এর সাথে সংযুক্ত আছে কিনা এবং সেই অনুযায়ী আমাদের UI আপডেট করবে! + +#### `getCurrentWalletConnected` ফাংশন {#the-getcurrentwalletconnected-function} + +`interact.js` ফাইলে আপনার `getCurrentWalletConnected` ফাংশনটি নিম্নলিখিতভাবে আপডেট করুন: + +```javascript +// interact.js + +export const getCurrentWalletConnected = async () => { + if (window.ethereum) { + try { + const addressArray = await window.ethereum.request({ + method: "eth_accounts", + }) + if (addressArray.length > 0) { + return { + address: addressArray[0], + status: "👆🏽 উপরের টেক্সট-ফিল্ডে একটি বার্তা লিখুন।", + } + } else { + return { + address: "", + status: "🦊 উপরের ডানদিকের বোতাম ব্যবহার করে MetaMask-এর সাথে সংযোগ করুন।", + } + } + } catch (err) { + return { + address: "", + status: "😥 " + err.message, + } + } + } else { + return { + address: "", + status: ( + ++ {" "} + 🦊 + আপনাকে অবশ্যই আপনার ব্রাউজারে MetaMask ইনস্টল করতে হবে, যা একটি ভার্চুয়াল ইথেরিয়াম ওয়ালেট। + +
+ + ), + } + } +} +``` + +এই কোডটি _খুবই_ অনুরূপ `connectWallet` ফাংশনটির মতো যা আমরা আগের ধাপে লিখেছি। + +প্রধান পার্থক্য হল `eth_requestAccounts` মেথড কল করার পরিবর্তে, যা ব্যবহারকারীর ওয়ালেট সংযোগ করার জন্য MetaMask খোলে, এখানে আমরা `eth_accounts` মেথড কল করি, যা সহজভাবে আমাদের dApp-এর সাথে বর্তমানে সংযুক্ত MetaMask অ্যাড্রেসগুলো ধারণকারী একটি অ্যারে রিটার্ন করে। + +এই ফাংশনটি কার্যকর দেখতে, আসুন এটিকে আমাদের `HelloWorld.js` কম্পোনেন্টের `useEffect` ফাংশনে কল করি: + +```javascript +// HelloWorld.js + +useEffect(async () => { + const message = await loadCurrentMessage() + setMessage(message) + addSmartContractListener() + + const { address, status } = await getCurrentWalletConnected() + setWallet(address) + setStatus(status) +}, []) +``` + +লক্ষ্য করুন, আমরা `getCurrentWalletConnected`-এ আমাদের কলের প্রতিক্রিয়া ব্যবহার করে আমাদের `walletAddress` এবং `status` স্টেট ভেরিয়েবলগুলিকে আপডেট করি। + +এখন যে আপনি এই কোডটি যোগ করেছেন, আসুন আমাদের ব্রাউজার উইন্ডোটি রিফ্রেশ করার চেষ্টা করি। + +দারুণ! বোতামটি বলা উচিত যে আপনি সংযুক্ত, এবং আপনার সংযুক্ত ওয়ালেটের অ্যাড্রেসের একটি প্রিভিউ দেখানো উচিত - এমনকি আপনি রিফ্রেশ করার পরেও! + +#### `addWalletListener` বাস্তবায়ন করুন {#implement-addwalletlistener} + +আমাদের dApp ওয়ালেট সেটআপের চূড়ান্ত ধাপ হল ওয়ালেট লিসেনার ইমপ্লিমেন্ট করা যাতে আমাদের UI আপডেট হয় যখন আমাদের ওয়ালেটের স্টেট পরিবর্তন হয়, যেমন যখন ব্যবহারকারী সংযোগ বিচ্ছিন্ন করে বা অ্যাকাউন্ট পরিবর্তন করে। + +আপনার `HelloWorld.js` ফাইলে, আপনার `addWalletListener` ফাংশনটি নিম্নলিখিতভাবে পরিবর্তন করুন: + +```javascript +// HelloWorld.js + +function addWalletListener() { + if (window.ethereum) { + window.ethereum.on("accountsChanged", (accounts) => { + if (accounts.length > 0) { + setWallet(accounts[0]) + setStatus("👆🏽 উপরের টেক্সট-ফিল্ডে একটি বার্তা লিখুন।") + } else { + setWallet("") + setStatus("🦊 উপরের ডানদিকের বোতাম ব্যবহার করে MetaMask-এর সাথে সংযোগ করুন।") + } + }) + } else { + setStatus( ++ {" "} + 🦊 + আপনাকে অবশ্যই আপনার ব্রাউজারে MetaMask ইনস্টল করতে হবে, যা একটি ভার্চুয়াল ইথেরিয়াম ওয়ালেট। + +
+ ) + } +} +``` + +আমি বাজি ধরতে পারি যে এই মুহূর্তে এখানে কী ঘটছে তা বোঝার জন্য আপনার আর আমাদের সাহায্যের প্রয়োজন নেই, তবে সম্পূর্ণতার জন্য, আসুন দ্রুত এটি ভেঙে দেখা যাক: + +- প্রথমে, আমাদের ফাংশন পরীক্ষা করে যে `window.ethereum` সক্রিয় আছে কিনা (অর্থাৎ MetaMask ইনস্টল করা আছে)। + - যদি না থাকে, আমরা কেবল আমাদের `status` স্টেট ভেরিয়েবলটিকে একটি JSX স্ট্রিং-এ সেট করি যা ব্যবহারকারীকে MetaMask ইনস্টল করার জন্য অনুরোধ করে। + - যদি এটি সক্রিয় থাকে, আমরা লাইন ৩-এ `window.ethereum.on(\"accountsChanged\")` লিসেনার সেট আপ করি যা MetaMask ওয়ালেটের স্টেট পরিবর্তন শোনে, যার মধ্যে রয়েছে যখন ব্যবহারকারী dApp-এ একটি অতিরিক্ত অ্যাকাউন্ট সংযোগ করে, অ্যাকাউন্ট পরিবর্তন করে বা একটি অ্যাকাউন্ট সংযোগ বিচ্ছিন্ন করে। যদি অন্তত একটি অ্যাকাউন্ট সংযুক্ত থাকে, তাহলে `walletAddress` স্টেট ভেরিয়েবলটি লিসেনারের দ্বারা রিটার্ন করা `accounts` অ্যারের প্রথম অ্যাকাউন্ট হিসেবে আপডেট হয়। অন্যথায়, `walletAddress` একটি খালি স্ট্রিং হিসাবে সেট করা হয়। + +সবশেষে, আমাদের এটিকে আমাদের `useEffect` ফাংশনে কল করতে হবে: + +```javascript +// HelloWorld.js + +useEffect(async () => { + const message = await loadCurrentMessage() + setMessage(message) + addSmartContractListener() + + const { address, status } = await getCurrentWalletConnected() + setWallet(address) + setStatus(status) + + addWalletListener() +}, []) +``` + +এবং এটাই সব! আমরা সফলভাবে আমাদের সমস্ত ওয়ালেট কার্যকারিতা প্রোগ্রামিং সম্পন্ন করেছি! এখন আমাদের শেষ কাজ: আমাদের স্মার্ট কন্ট্র্যাক্টে সংরক্ষিত বার্তা আপডেট করা! + +### ধাপ ৬: `updateMessage` ফাংশনটি বাস্তবায়ন করুন {#step-6-implement-the-updateMessage-function} + +ঠিক আছে বন্ধুরা, আমরা শেষ পর্যায়ে পৌঁছেছি! আপনার `interact.js` ফাইলের `updateMessage`-এ, আমরা নিম্নলিখিতগুলি করতে যাচ্ছি: + +1. নিশ্চিত করুন যে আমরা আমাদের স্মার্ট কন্টাক্টে যে বার্তাটি প্রকাশ করতে চাই তা বৈধ +2. MetaMask ব্যবহার করে আমাদের লেনদেন স্বাক্ষর করুন +3. আমাদের `HelloWorld.js` ফ্রন্টএন্ড কম্পোনেন্ট থেকে এই ফাংশনটি কল করুন + +এতে খুব বেশি সময় লাগবে না; চলুন এই ডিএ্যাপসটি শেষ করি! + +#### ইনপুট ত্রুটি হ্যান্ডলিং {#input-error-handling} + +স্বাভাবিকভাবেই, ফাংশনের শুরুতে কিছু ধরণের ইনপুট ত্রুটি হ্যান্ডলিং থাকা যুক্তিযুক্ত। + +আমরা চাইব যে যদি কোনো MetaMask এক্সটেনশন ইনস্টল করা না থাকে, কোনো ওয়ালেট সংযুক্ত না থাকে (অর্থাৎ, পাস করা `address` একটি খালি স্ট্রিং হয়), বা `message` একটি খালি স্ট্রিং হয়, তাহলে আমাদের ফাংশনটি তাড়াতাড়ি ফিরে আসবে। `updateMessage`-এ নিম্নলিখিত ত্রুটি হ্যান্ডলিং যোগ করুন: + +```javascript +// interact.js + +export const updateMessage = async (address, message) => { + if (!window.ethereum || address === null) { + return { + status: + "💡 ব্লকচেইনে বার্তা আপডেট করতে আপনার MetaMask ওয়ালেট সংযোগ করুন।", + } + } + + if (message.trim() === "") { + return { + status: "❌ আপনার বার্তা একটি খালি স্ট্রিং হতে পারে না।", + } + } +} +``` + +এখন যে এটিতে সঠিক ইনপুট ত্রুটি হ্যান্ডলিং রয়েছে, এখন MetaMask এর মাধ্যমে লেনদেন স্বাক্ষর করার সময়! + +#### আমাদের লেনদেন স্বাক্ষর করা {#signing-our-transaction} + +আপনি যদি ঐতিহ্যবাহী ওয়েব3 ইথেরিয়াম লেনদেনের সাথে ইতিমধ্যে স্বাচ্ছন্দ্য বোধ করেন, তবে আমরা পরবর্তীতে যে কোডটি লিখব তা খুব পরিচিত হবে। আপনার ইনপুট ত্রুটি হ্যান্ডলিং কোডের নীচে, `updateMessage`-এ নিম্নলিখিতগুলি যোগ করুন: + +```javascript +// interact.js + +//লেনদেন প্যারামিটার সেট আপ করুন +const transactionParameters = { + to: contractAddress, // কন্ট্র্যাক্ট প্রকাশনার সময় ছাড়া প্রয়োজনীয়। + from: address, // ব্যবহারকারীর সক্রিয় ঠিকানার সাথে মিলতে হবে। + data: helloWorldContract.methods.update(message).encodeABI(), +} + +//লেনদেন স্বাক্ষর করুন +try { + const txHash = await window.ethereum.request({ + method: "eth_sendTransaction", + params: [transactionParameters], + }) + return { + status: ( + + ✅{" "} + + Etherscan-এ আপনার লেনদেনের স্থিতি দেখুন! + ++ ℹ️ নেটওয়ার্ক দ্বারা লেনদেন যাচাই হয়ে গেলে, বার্তাটি + স্বয়ংক্রিয়ভাবে আপডেট হয়ে যাবে। + + ), + } +} catch (error) { + return { + status: "😥 " + error.message, + } +} +``` + +আসুন দেখা যাক কী ঘটছে। প্রথমে, আমরা আমাদের লেনদেনের প্যারামিটার সেট আপ করি, যেখানে: + +- `to` প্রাপকের ঠিকানা (আমাদের স্মার্ট কন্ট্র্যাক্ট) নির্দিষ্ট করে +- `from` লেনদেনের স্বাক্ষরকারীকে নির্দিষ্ট করে, যা আমাদের ফাংশনে পাস করা `address` ভেরিয়েবল +- `data` আমাদের Hello World স্মার্ট কন্ট্র্যাক্টের `update` পদ্ধতিতে কল ধারণ করে, যা ইনপুট হিসাবে আমাদের `message` স্ট্রিং ভেরিয়েবল গ্রহণ করে + +তারপর, আমরা একটি অ্যাওয়েট কল করি, `window.ethereum.request`, যেখানে আমরা MetaMask-কে লেনদেন স্বাক্ষর করতে বলি। লক্ষ্য করুন, ১১ এবং ১২ লাইনে, আমরা আমাদের eth পদ্ধতি, `eth_sendTransaction` নির্দিষ্ট করছি এবং আমাদের `transactionParameters` পাস করছি। + +এই সময়ে, MetaMask ব্রাউজারে খুলবে, এবং ব্যবহারকারীকে ট্রানজ্যাকশন সাইন বা প্রত্যাখ্যান করতে অনুরোধ করবে। + +- যদি লেনদেন সফল হয়, ফাংশনটি একটি JSON অবজেক্ট প্রদান করবে যেখানে `status` JSX স্ট্রিং ব্যবহারকারীকে তাদের লেনদেন সম্পর্কে আরও তথ্যের জন্য Etherscan দেখতে অনুরোধ করে। +- যদি লেনদেন ব্যর্থ হয়, ফাংশনটি একটি JSON অবজেক্ট প্রদান করবে যেখানে `status` স্ট্রিং ত্রুটির বার্তা রিলে করে। + +সব মিলিয়ে, আমাদের `updateMessage` ফাংশনটি এইরকম দেখতে হবে: + +```javascript +// interact.js + +export const updateMessage = async (address, message) => { + //ইনপুট ত্রুটি হ্যান্ডলিং + if (!window.ethereum || address === null) { + return { + status: + "💡 ব্লকচেইনে বার্তা আপডেট করতে আপনার MetaMask ওয়ালেট সংযোগ করুন।", + } + } + + if (message.trim() === "") { + return { + status: "❌ আপনার বার্তা একটি খালি স্ট্রিং হতে পারে না।", + } + } + + //লেনদেন প্যারামিটার সেট আপ করুন + const transactionParameters = { + to: contractAddress, // কন্ট্র্যাক্ট প্রকাশনার সময় ছাড়া প্রয়োজনীয়। + from: address, // ব্যবহারকারীর সক্রিয় ঠিকানার সাথে মিলতে হবে। + data: helloWorldContract.methods.update(message).encodeABI(), + } + + //লেনদেন স্বাক্ষর করুন + try { + const txHash = await window.ethereum.request({ + method: "eth_sendTransaction", + params: [transactionParameters], + }) + return { + status: ( + + ✅{" "} + + Etherscan-এ আপনার লেনদেনের স্থিতি দেখুন! + +
+ ℹ️ নেটওয়ার্ক দ্বারা লেনদেন যাচাই হয়ে গেলে, বার্তাটি + স্বয়ংক্রিয়ভাবে আপডেট হয়ে যাবে। + + ), + } + } catch (error) { + return { + status: "😥 " + error.message, + } + } +} +``` + +সবশেষে, আমাদের `updateMessage` ফাংশনটিকে আমাদের `HelloWorld.js` কম্পোনেন্টের সাথে সংযোগ করতে হবে। + +#### `updateMessage`-কে `HelloWorld.js` ফ্রন্টএন্ডের সাথে সংযোগ করুন {#connect-updatemessage-to-the-helloworld-js-frontend} + +আমাদের `onUpdatePressed` ফাংশনটি ইম্পোর্ট করা `updateMessage` ফাংশনে একটি অ্যাওয়েট কল করবে এবং `status` স্টেট ভেরিয়েবলটি পরিবর্তন করবে যাতে আমাদের লেনদেন সফল হয়েছে নাকি ব্যর্থ হয়েছে তা প্রতিফলিত হয়: + +```javascript +// HelloWorld.js + +const onUpdatePressed = async () => { + const { status } = await updateMessage(walletAddress, newMessage) + setStatus(status) +} +``` + +এটি খুবই পরিচ্ছন্ন এবং সহজ। আর জানেন কী... আপনার ডিএ্যাপস সম্পূর্ণ!!! + +এগিয়ে যান এবং **আপডেট** বোতামটি পরীক্ষা করুন! + +### আপনার নিজের কাস্টম ডিএ্যাপস তৈরি করুন {#make-your-own-custom-dapp} + +ওয়াও, আপনি টিউটোরিয়ালের শেষ পর্যন্ত পৌঁছেছেন! সংক্ষেপে, আপনি শিখেছেন কীভাবে: + +- আপনার ডিএ্যাপস প্রজেক্টের সাথে একটি MetaMask ওয়ালেট সংযোগ করা +- [Alchemy Web3](https://docs.alchemy.com/alchemy/documentation/alchemy-web3) API ব্যবহার করে আপনার স্মার্ট কন্ট্র্যাক্ট থেকে ডেটা পড়া +- MetaMask ব্যবহার করে ইথেরিয়াম লেনদেন স্বাক্ষর করা + +এখন আপনি এই টিউটোরিয়ালের দক্ষতা প্রয়োগ করে আপনার নিজের কাস্টম ডিএ্যাপস প্রজেক্ট তৈরি করার জন্য সম্পূর্ণরূপে সজ্জিত! বরাবরের মতো, আপনার যদি কোনো প্রশ্ন থাকে, তাহলে [Alchemy Discord](https://discord.gg/gWuC7zB)-এ আমাদের কাছে সাহায্যের জন্য পৌঁছাতে দ্বিধা করবেন না। 🧙♂️ + +এই টিউটোরিয়ালটি সম্পূর্ণ করার পর, টুইটারে [@alchemyplatform](https://twitter.com/AlchemyPlatform)-এ আমাদের ট্যাগ করে আপনার অভিজ্ঞতা কেমন ছিল বা আপনার কোনো মতামত থাকলে আমাদের জানান! diff --git a/public/content/translations/bn/developers/tutorials/hello-world-smart-contract/index.md b/public/content/translations/bn/developers/tutorials/hello-world-smart-contract/index.md new file mode 100644 index 00000000000..bf5ea083d3a --- /dev/null +++ b/public/content/translations/bn/developers/tutorials/hello-world-smart-contract/index.md @@ -0,0 +1,366 @@ +--- +title: "শিক্ষানবিশদের জন্য হ্যালো ওয়ার্ল্ড স্মার্ট কন্ট্র্যাক্ট" +description: "Ethereum-এ একটি সহজ স্মার্ট কন্ট্র্যাক্ট লেখা এবং স্থাপন করার উপর একটি পরিচিতি টিউটোরিয়াল।" +author: "elanh" +tags: + [ + "সলিডিটি", + "hardhat", + "alchemy", + "স্মার্ট কন্ট্র্যাক্ট", + "ডেপ্লয়িং" + ] +skill: beginner +lang: bn +published: 2021-03-31 +--- + +আপনি যদি ব্লকচেইন ডেভেলপমেন্টে নতুন হন এবং কোথা থেকে শুরু করবেন তা না জানেন, অথবা আপনি যদি শুধুমাত্র স্মার্ট কন্ট্র্যাক্টগুলি কীভাবে স্থাপন এবং তার সাথে ইন্টারঅ্যাক্ট করতে হয় তা বুঝতে চান, তাহলে এই নির্দেশিকাটি আপনার জন্য। আমরা একটি ভার্চুয়াল ওয়ালেট [MetaMask](https://metamask.io/), [Solidity](https://docs.soliditylang.org/en/v0.8.0/), [Hardhat](https://hardhat.org/), এবং [Alchemy](https://www.alchemy.com/eth) ব্যবহার করে Sepolia টেস্ট নেটওয়ার্কে একটি সহজ স্মার্ট কন্ট্র্যাক্ট তৈরি এবং স্থাপন করার মাধ্যমে দেখাব (যদি আপনি এখনও এর কোনটির অর্থ না বোঝেন তবে চিন্তা করবেন না, আমরা এটি ব্যাখ্যা করব)। + +এই টিউটোরিয়ালের [পার্ট 2](https://docs.alchemy.com/docs/interacting-with-a-smart-contract)-তে আমরা দেখব কিভাবে আমাদের স্মার্ট কন্ট্র্যাক্টটি এখানে স্থাপন করার পরে তার সাথে ইন্টারঅ্যাক্ট করা যায়, এবং [পার্ট 3](https://www.alchemy.com/docs/submitting-your-smart-contract-to-etherscan)-তে আমরা দেখব কিভাবে এটি Etherscan-এ প্রকাশ করা যায়। + +যেকোনো সময়ে আপনার কোনো প্রশ্ন থাকলে [Alchemy Discord](https://discord.gg/gWuC7zB)-এ যোগাযোগ করতে পারেন! + +## ধাপ 1: Ethereum নেটওয়ার্কের সাথে সংযোগ করুন {#step-1} + +Ethereum চেইনে রিকুয়েস্ট করার অনেক উপায় আছে। সহজ করার জন্য, আমরা Alchemy-তে একটি বিনামূল্যের অ্যাকাউন্ট ব্যবহার করব, এটি একটি ব্লকচেইন ডেভেলপার প্ল্যাটফর্ম এবং API যা আমাদের নিজস্ব নোড চালানোর প্রয়োজন ছাড়াই Ethereum চেইনের সাথে যোগাযোগ করতে দেয়। প্ল্যাটফর্মটিতে পর্যবেক্ষণ এবং বিশ্লেষণের জন্য ডেভেলপার টুলসও রয়েছে যা আমরা এই টিউটোরিয়ালে আমাদের স্মার্ট কন্ট্র্যাক্ট স্থাপনার আড়ালে কী ঘটছে তা বোঝার জন্য ব্যবহার করব। আপনার যদি আগে থেকেই একটি Alchemy অ্যাকাউন্ট না থাকে, [আপনি এখানে বিনামূল্যে সাইন আপ করতে পারেন](https://dashboard.alchemy.com/signup)। + +## ধাপ 2: আপনার অ্যাপ (এবং API কী) তৈরি করুন {#step-2} + +একবার আপনি একটি Alchemy অ্যাকাউন্ট তৈরি করে ফেললে, আপনি একটি অ্যাপ তৈরি করে একটি API কী জেনারেট করতে পারেন। এটি আমাদের Sepolia টেস্ট নেটওয়ার্কে অনুরোধ করার অনুমতি দেবে। আপনি যদি টেস্টনেটের সাথে পরিচিত না হন, তাহলে [এই পেজটি](/developers/docs/networks/) দেখুন। + +1. ন্যাভ বারে "Select an app" নির্বাচন করে এবং "Create new app" ক্লিক করে আপনার Alchemy ড্যাশবোর্ডের "Create new app" পেজে যান + + + +2. আপনার অ্যাপের নাম দিন “Hello World”, একটি সংক্ষিপ্ত বিবরণ দিন, এবং একটি ব্যবহারের ক্ষেত্র বেছে নিন, যেমন, "Infra & Tooling."। এরপরে, "Ethereum" অনুসন্ধান করুন এবং নেটওয়ার্কটি নির্বাচন করুন। + + + +3. এগিয়ে যেতে "Next" এ ক্লিক করুন, তারপর "Create app" এ এবং এটিই! আপনার অ্যাপটি একটি API কী কপির জন্য উপলব্ধ সহ ন্যাভ বার ড্রপডাউন মেনুতে উপস্থিত হওয়া উচিত। + +## ধাপ 3: একটি Ethereum অ্যাকাউন্ট (অ্যাড্রেস) তৈরি করুন {#step-3} + +লেনদেন পাঠানো এবং গ্রহণ করার জন্য আমাদের একটি Ethereum অ্যাকাউন্ট প্রয়োজন। এই টিউটোরিয়ালের জন্য, আমরা MetaMask ব্যবহার করব, যা ব্রাউজারের একটি ভার্চুয়াল ওয়ালেট এবং আপনার Ethereum অ্যাকাউন্ট অ্যাড্রেস পরিচালনা করতে ব্যবহৃত হয়। [লেনদেন](/developers/docs/transactions/) সম্পর্কে আরও। + +আপনি [এখানে](https://metamask.io/download) বিনামূল্যে MetaMask ডাউনলোড করতে এবং একটি Ethereum অ্যাকাউন্ট তৈরি করতে পারেন। আপনি যখন একটি অ্যাকাউন্ট তৈরি করছেন, অথবা যদি আপনার আগে থেকেই একটি অ্যাকাউন্ট থাকে, তাহলে নেটওয়ার্ক ড্রপডাউন মেনু ব্যবহার করে "Sepolia" টেস্ট নেটওয়ার্কে স্যুইচ করতে ভুলবেন না (যাতে আমরা আসল টাকা নিয়ে কাজ না করি)। + +আপনি যদি Sepolia তালিকাভুক্ত না দেখেন, তাহলে মেনুতে যান, তারপর Advanced-এ যান এবং "Show test networks" চালু করতে নিচে স্ক্রোল করুন। নেটওয়ার্ক নির্বাচন মেনুতে, টেস্টনেটগুলির একটি তালিকা খুঁজে পেতে "Custom" ট্যাবটি বেছে নিন এবং "Sepolia" নির্বাচন করুন। + + + +## ধাপ 4: একটি ফসেট থেকে ইথার যোগ করুন {#step-4} + +টেস্ট নেটওয়ার্কে আমাদের স্মার্ট কন্ট্র্যাক্ট স্থাপন করার জন্য, আমাদের কিছু নকল Eth লাগবে। Sepolia ETH পেতে আপনি বিভিন্ন ফসেটের একটি তালিকা দেখতে [Sepolia নেটওয়ার্কের বিবরণ](/developers/docs/networks/#sepolia)-এ যেতে পারেন। যদি একটি কাজ না করে, তবে অন্যটি চেষ্টা করুন কারণ সেগুলি মাঝে মাঝে খালি হয়ে যেতে পারে। নেটওয়ার্ক ট্রাফিকের কারণে আপনার নকল ETH পেতে কিছু সময় লাগতে পারে। কিছুক্ষণ পরেই আপনার Metamask অ্যাকাউন্টে ETH দেখতে পাবেন! + +## ধাপ 5: আপনার ব্যালেন্স পরীক্ষা করুন {#step-5} + +আমাদের ব্যালেন্স আছে কিনা তা দুবার পরীক্ষা করার জন্য, আসুন [Alchemy’s composer tool](https://sandbox.alchemy.com/?network=ETH_SEPOLIA&method=eth_getBalance&body.id=1&body.jsonrpc=2.0&body.method=eth_getBalance&body.params%5B0%5D=&body.params%5B1%5D=latest) ব্যবহার করে একটি [eth_getBalance](/developers/docs/apis/json-rpc/#eth_getbalance) অনুরোধ করি। এটি আমাদের ওয়ালেটে থাকা ETH-এর পরিমাণ ফেরত দেবে। আপনার MetaMask অ্যাকাউন্ট অ্যাড্রেস ইনপুট করার পরে এবং “অনুরোধ পাঠান”-এ ক্লিক করার পরে, আপনার এইরকম একটি প্রতিক্রিয়া দেখা উচিত: + +```json +{ "jsonrpc": "2.0", "id": 0, "result": "0x2B5E3AF16B1880000" } +``` + +> **দ্রষ্টব্য:** এই ফলাফলটি ETH-এ নয়, wei-তে। Wei ইথারের ক্ষুদ্রতম একক হিসাবে ব্যবহৃত হয়। wei থেকে ETH-তে রূপান্তর হল: 1 eth = 1018 wei। সুতরাং যদি আমরা 0x2B5E3AF16B1880000 কে দশমিকে রূপান্তর করি তাহলে আমরা 5\*10¹⁸ পাই যা 5 ETH এর সমান। +> +> যাক বাবা! আমাদের নকল টাকা সব আছে
.env কমিট করবেন না! অনুগ্রহ করে নিশ্চিত করুন যে আপনার .env ফাইলটি কারো সাথে শেয়ার বা প্রকাশ করবেন না, কারণ এটি করার মাধ্যমে আপনি আপনার গোপনীয়তাগুলির সাথে আপস করছেন। আপনি যদি সংস্করণ নিয়ন্ত্রণ ব্যবহার করেন, তাহলে আপনার .env একটি gitignore ফাইলে যোগ করুন।
+