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) کا حساب لگاتا ہے اور ایک فنکشن جو Ethereum دستخطوں کی تصدیق کرتا ہے اور دستخط کنندہ کا Ethereum پتہ بازیافت کرتا ہے۔ + +``` +global ACCOUNT_NUMBER : u32 = 5; +``` + +Noir [Rust](https://www.rust-lang.org/) سے متاثر ہے۔ متغیرات، بطور ڈیفالٹ، مستقل ہوتے ہیں۔ اس طرح ہم عالمی کنفیگریشن مستقلات کی تعریف کرتے ہیں۔ خاص طور پر، `ACCOUNT_NUMBER` ان اکاؤنٹس کی تعداد ہے جنہیں ہم اسٹور کرتے ہیں۔ + +`uGreeter
+Greeter
+ { + !readResults.isError && !readResults.isLoading && ++``` + +ایک `ShowGreeting` کمپونینٹ بنائیں (جس کی وضاحت نیچے کی گئی ہے)، لیکن صرف اس صورت میں جب گریٹنگ بلاک چین سے کامیابی کے ساتھ پڑھی گئی ہو۔ + +```tsx + +``` + +یہ ان پٹ ٹیکسٹ فیلڈ ہے جہاں یوزر ایک نئی گریٹنگ سیٹ کر سکتا ہے۔ ہر بار جب یوزر کوئی کی (key) دباتا ہے، ہم `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` میں ہیں۔ میں یہاں ہر چیز کی وضاحت نہیں کروں گا، کیونکہ اس کا زیادہ تر حصہ بوائلرپلیٹ ہے جسے آپ کو تبدیل کرنے کی ضرورت کا امکان نہیں ہے۔
+
+یہاں کا کوڈ [github پر موجود](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 github میں](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/ur/developers/tutorials/deploying-your-first-smart-contract/index.md b/public/content/translations/ur/developers/tutorials/deploying-your-first-smart-contract/index.md
new file mode 100644
index 00000000000..7a58026b9ba
--- /dev/null
+++ b/public/content/translations/ur/developers/tutorials/deploying-your-first-smart-contract/index.md
@@ -0,0 +1,95 @@
+---
+title: "اپنا پہلا سمارٹ کنٹریکٹ ڈیپلائے کرنا"
+description: "ایتھیریم ٹیسٹ نیٹ ورک پر اپنا پہلا سمارٹ کنٹریکٹ ڈیپلائے کرنے کا تعارف"
+author: "jdourlens"
+tags: [ "اسمارٹ معاہدات", "remix", "solidity", "تعینات کرنا" ]
+skill: beginner
+lang: ur-in
+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: ہمارا کنٹریکٹ `count` نامی ایک غیر دستخط شدہ انٹیجر کو اسٹور کرتا ہے جو 0 سے شروع ہوتا ہے۔
+- لائن 10: پہلا فنکشن کنٹریکٹ کی حالت میں ترمیم کرے گا اور ہمارے متغیر `count` میں `increment()` کرے گا۔
+- لائن 15: دوسرا فنکشن صرف ایک گیٹر ہے تاکہ سمارٹ کنٹریکٹ کے باہر `count` متغیر کی قدر کو پڑھا جا سکے۔ نوٹ کریں کہ، چونکہ ہم نے اپنے `count` متغیر کو عوامی کے طور پر بیان کیا ہے، یہ ضروری نہیں ہے لیکن اسے ایک مثال کے طور پر دکھایا گیا ہے۔
+
+یہ سب ہمارے پہلے سادہ سمارٹ کنٹریکٹ کے لیے ہے۔ جیسا کہ آپ جانتے ہوں گے، یہ جاوا یا C++ جیسی OOP (آبجیکٹ اورینٹڈ پروگرامنگ) زبانوں کی کلاس کی طرح لگتا ہے۔ اب ہمارے کنٹریکٹ کے ساتھ کھیلنے کا وقت ہے۔
+
+## ہمارا کنٹریکٹ ڈیپلائے کرنا {#deploying-our-contract}
+
+چونکہ ہم نے اپنا پہلا سمارٹ کنٹریکٹ لکھا ہے، اب ہم اسے بلاک چین پر ڈیپلائے کریں گے تاکہ اس کے ساتھ کھیل سکیں۔
+
+[بلاک چین پر سمارٹ کنٹریکٹ کو ڈیپلائے کرنا](/developers/docs/smart-contracts/deploying/) دراصل صرف ایک ٹرانزیکشن بھیجنا ہے جس میں کمپائل شدہ سمارٹ کنٹریکٹ کا کوڈ ہوتا ہے بغیر کسی وصول کنندہ کی وضاحت کیے۔
+
+ہم سب سے پہلے بائیں جانب کمپائل آئیکن پر کلک کرکے [کنٹریکٹ کو کمپائل کریں گے](/developers/docs/smart-contracts/compiling/):
+
+
+
+پھر کمپائل بٹن پر کلک کریں:
+
+
+
+آپ "آٹو کمپائل" آپشن کو منتخب کرنے کا انتخاب کر سکتے ہیں تاکہ جب آپ ٹیکسٹ ایڈیٹر پر مواد محفوظ کریں تو کنٹریکٹ ہمیشہ کمپائل ہو جائے۔
+
+پھر "ڈیپلائے اور رن ٹرانزیکشنز" اسکرین پر جائیں:
+
+
+
+ایک بار جب آپ "ڈیپلائے اور رن ٹرانزیکشنز" اسکرین پر ہوں، تو دو بار چیک کریں کہ آپ کے کنٹریکٹ کا نام ظاہر ہوتا ہے اور ڈیپلائے پر کلک کریں۔ جیسا کہ آپ صفحہ کے اوپری حصے میں دیکھ سکتے ہیں، موجودہ ماحول "JavaScript VM" ہے جس کا مطلب ہے کہ ہم اپنے سمارٹ کنٹریکٹ کو مقامی ٹیسٹ بلاک چین پر ڈیپلائے اور اس کے ساتھ تعامل کریں گے تاکہ تیزی سے اور بغیر کسی فیس کے ٹیسٹ کر سکیں۔
+
+
+
+ایک بار جب آپ "ڈیپلائے" بٹن پر کلک کر لیں گے، تو آپ کو اپنا کنٹریکٹ نیچے ظاہر ہوتا نظر آئے گا۔ اسے پھیلانے کے لیے بائیں طرف کے تیر پر کلک کریں تاکہ ہم اپنے کنٹریکٹ کا مواد دیکھ سکیں۔ یہ ہمارا متغیر `counter`، ہمارا `increment()` فنکشن اور گیٹر `getCounter()` ہے۔
+
+اگر آپ `count` یا `getCount` بٹن پر کلک کرتے ہیں، تو یہ دراصل کنٹریکٹ کے `count` متغیر کا مواد حاصل کرے گا اور اسے ظاہر کرے گا۔ چونکہ ہم نے ابھی تک `increment` فنکشن کو کال نہیں کیا ہے، اس لیے اسے 0 دکھانا چاہیے۔
+
+
+
+آئیے اب بٹن پر کلک کرکے `increment` فنکشن کو کال کریں۔ آپ کو ونڈو کے نیچے کی جانے والی ٹرانزیکشنز کے لاگز نظر آئیں گے۔ آپ دیکھیں گے کہ جب آپ `increment` بٹن کے بجائے ڈیٹا حاصل کرنے کے لیے بٹن دبا رہے ہوتے ہیں تو لاگز مختلف ہوتے ہیں۔ اس کی وجہ یہ ہے کہ بلاک چین پر ڈیٹا پڑھنے کے لیے کسی ٹرانزیکشن (لکھنے) یا فیس کی ضرورت نہیں ہوتی ہے۔ کیونکہ صرف بلاک چین کی حالت میں ترمیم کرنے کے لیے ٹرانزیکشن کرنے کی ضرورت ہوتی ہے:
+
+
+
+انکریمنٹ بٹن دبانے کے بعد جو ہمارے `increment()` فنکشن کو کال کرنے کے لیے ایک ٹرانزیکشن پیدا کرے گا، اگر ہم کاؤنٹ یا گیٹ کاؤنٹ بٹنوں پر واپس کلک کرتے ہیں تو ہم اپنے سمارٹ کنٹریکٹ کی نئی اپ ڈیٹ شدہ حالت کو پڑھیں گے جس میں کاؤنٹ متغیر 0 سے بڑا ہوگا۔
+
+
+
+اگلے ٹیوٹوریل میں، ہم [آپ اپنے سمارٹ کنٹریکٹس میں ایونٹس کیسے شامل کر سکتے ہیں](/developers/tutorials/logging-events-smart-contracts/) کا احاطہ کریں گے۔ لاگنگ ایونٹس آپ کے سمارٹ کنٹریکٹ کو ڈیبگ کرنے اور یہ سمجھنے کا ایک آسان طریقہ ہے کہ فنکشن کو کال کرتے وقت کیا ہو رہا ہے۔
diff --git a/public/content/translations/ur/developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md b/public/content/translations/ur/developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md
new file mode 100644
index 00000000000..6666440ae4b
--- /dev/null
+++ b/public/content/translations/ur/developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md
@@ -0,0 +1,372 @@
+---
+title: "مقامی، ملٹی کلائنٹ ٹیسٹ نیٹ پر ایک dApp کو کیسے تیار اور ٹیسٹ کیا جائے"
+description: "یہ گائیڈ پہلے آپ کو اس بارے میں بتائے گا کہ کسی dApp کو ڈیپلائے اور ٹیسٹ کرنے کے لیے ٹیسٹ نیٹ کا استعمال کرنے سے پہلے ملٹی کلائنٹ مقامی Ethereum ٹیسٹ نیٹ کو کیسے انسٹینٹیٹ اور کنفیگر کیا جائے۔"
+author: "Tedi Mitiku"
+tags:
+ [
+ "کلائنٹس",
+ "نوڈز",
+ "اسمارٹ معاہدات",
+ "مرکبیت",
+ "کنسینسس لیئر",
+ "ایگزیکیوشن لیئر",
+ "testing"
+ ]
+skill: intermediate
+lang: ur-in
+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 ٹیسٹ نیٹ کو انسٹینٹیٹ کریں،
+- اپنے Hardhat dApp ڈیولپمنٹ ماحول کو مقامی ٹیسٹ نیٹ سے جوڑیں تاکہ 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 فاؤنڈیشن نے The Merge کو ٹیسٹ کرنے کے لیے Kurtosis کا استعمال کیا](https://www.kurtosis.com/blog/testing-the-ethereum-merge) اور نیٹ ورک اپ گریڈ کی جانچ کے لیے اس کا استعمال جاری رکھے ہوئے ہے۔
+
+## Kurtosis سیٹ اپ کرنا {#setting-up-kurtosis}
+
+آگے بڑھنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:
+
+- اپنی مقامی مشین پر [ڈاکر انجن انسٹال اور شروع کیا](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 کے اندر، `{` کرلی بریکٹ `}` کے اندر کوڈ کو JavaScript کے طور پر سمجھا جاتا ہے۔ پھر، `(` ریگولر بریکٹ `)` کے اندر کوڈ کو دوبارہ JSX کے طور پر سمجھا جاتا ہے۔
+
+```tsx
+ (
- {f} ) + )} +``` + +React کو [DOM ٹری](https://www.w3schools.com/js/js_htmldom.asp) میں ٹیگز کے لیے الگ شناختی نشانات کی ضرورت ہوتی ہے۔ اس کا مطلب ہے کہ ایک ہی ٹیگ کے بچوں (اس معاملے میں، [غیر ترتیب شدہ فہرست](https://www.w3schools.com/tags/tag_ul.asp)) کو مختلف `key` صفات کی ضرورت ہوتی ہے۔ + +```tsx +
ہیلو ${loginResponse.extract.nameID}
+ + + `) + res.send(); +``` + +ایک HTML جواب بھیجیں، صرف صارف کو یہ دکھانے کے لیے کہ ہمیں لاگ ان مل گیا ہے۔ + +```typescript + } catch (err) { + console.error('SAML جواب پر کارروائی کرنے میں خرابی:', err); + res.status(400).send('SAML توثیق ناکام'); + } + } +) +``` + +ناکامی کی صورت میں صارف کو مطلع کریں۔ + +```typescript +spRouter.get('/login', +``` + +جب براؤزر اس صفحے کو حاصل کرنے کی کوشش کرتا ہے تو ایک لاگ ان درخواست بنائیں۔ یہ اوپر کے ترتیب وار خاکے میں مرحلہ 1 کے لیے ہینڈلر ہے۔ + +```typescript + async (req, res) => { + const loginRequest = await sp.createLoginRequest(idp, "post") +``` + +لاگ ان کی درخواست پوسٹ کرنے کے لیے معلومات حاصل کریں۔ + +```typescript + res.send(` + + + +``` + +یہ صفحہ خود بخود فارم (نیچے دیکھیں) جمع کراتا ہے۔ اس طرح صارف کو ری ڈائریکٹ ہونے کے لیے کچھ کرنے کی ضرورت نہیں ہے۔ یہ اوپر کے ترتیب وار خاکے میں مرحلہ 2 ہے۔ + +```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(`سروس فراہم کنندہ http://${config.spHostname}:${config.spPort} پر چل رہا ہے`) +}) +``` + +اس express ایپلیکیشن کے ساتھ `spPort` کو سنیں۔ + +#### src/idp.mts + +یہ شناختی فراہم کنندہ ہے۔ یہ سروس فراہم کنندہ سے بہت ملتا جلتا ہے، نیچے دی گئی وضاحتیں ان حصوں کے لیے ہیں جو مختلف ہیں۔ + +```typescript +const xmlParser = new (await import("fast-xml-parser")).XMLParser( + { + ignoreAttributes: false, // صفات کو محفوظ رکھیں + attributeNamePrefix: "@_", // صفات کے لیے سابقہ + } +) +``` + +ہمیں سروس فراہم کنندہ سے موصول ہونے والی XML درخواست کو پڑھنے اور سمجھنے کی ضرورت ہے۔ + +```typescript +const getLoginPage = requestId => ` +``` + +یہ فنکشن خودکار طور پر جمع کردہ فارم کے ساتھ صفحہ بناتا ہے جو اوپر کے ترتیب وار خاکے کے مرحلہ 4 میں واپس آتا ہے۔ + +```typescript + + +لاگ ان صفحہ
+ + + + +const idpRouter = express.Router() + +idpRouter.post("/loginSubmitted", async (req, res) => { + const loginResponse = await idp.createLoginResponse( +``` + +یہ اوپر کے ترتیب وار خاکے کے مرحلہ 5 کے لیے ہینڈلر ہے۔ [`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 } // دستخط کو یقینی بنائیں +``` + +جواب پر دستخط کرنے کے لیے ڈیٹا رکھنے کے لیے ہمیں `signingKey` کی ضرورت ہے۔ سروس فراہم کنندہ غیر دستخط شدہ درخواستوں پر بھروسہ نہیں کرتا ہے۔ + +```typescript + }, + "post", + { + email: req.body.email +``` + +یہ صارف کی معلومات کے ساتھ وہ فیلڈ ہے جسے ہم سروس فراہم کنندہ کو واپس بھیجتے ہیں۔ + +```typescript + } + ); + + res.send(` + + + + + + + + `) +}) +``` + +دوبارہ، ایک خودکار طور پر جمع کردہ فارم استعمال کریں۔ یہ اوپر کے ترتیب وار خاکے کا مرحلہ 6 ہے۔ + +```typescript + +// لاگ ان درخواستوں کے لیے IdP اینڈ پوائنٹ +idpRouter.post(`/login`, +``` + +یہ وہ اینڈ پوائنٹ ہے جو سروس فراہم کنندہ سے لاگ ان کی درخواست وصول کرتا ہے۔ یہ اوپر کے ترتیب وار خاکے کے مرحلہ 3 کا ہینڈلر ہے۔ + +```typescript + async (req, res) => { + try { + // ورک اراؤنڈ کیونکہ میں parseLoginRequest کو کام کرنے پر مجبور نہیں کر سکا۔ + // 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) => { +``` + +یہ ترتیب وار خاکے میں مرحلہ 5 کے لیے ہینڈلر ہے۔ + +```typescript + const requestId = nonces[req.params.nonce] + if (requestId === undefined) { + res.send("خراب نانس") + 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 + }) +``` + +ترتیب وار خاکے میں مرحلہ 5.5 کو نافذ کرنے کے لیے [`verifyMessage`](https://viem.sh/docs/actions/public/verifyMessage#verifymessage) کا استعمال کریں۔ + +```typescript + if (!validSignature) + throw("خراب دستخط") + } catch (err) { + res.send("خرابی:" + err) + return ; + } +``` + +ہینڈلر کا بقیہ حصہ اس کے برابر ہے جو ہم نے پہلے `/loginSubmitted` ہینڈلر میں کیا ہے، سوائے ایک چھوٹی سی تبدیلی کے۔ + +```typescript + const loginResponse = await idp.createLoginResponse( + . + . + . + { + email: req.params.account + "@bad.email.address" + } + ); +``` + +ہمارے پاس اصل ای میل پتہ نہیں ہے (ہم اسے اگلے حصے میں حاصل کریں گے)، لہذا ابھی کے لیے ہم ایتھیریم پتہ واپس کرتے ہیں اور اسے واضح طور پر ای میل پتے کے طور پر نشان زد نہیں کرتے ہیں۔ + +```typescript +// لاگ ان درخواستوں کے لیے IdP اینڈ پوائنٹ +idpRouter.post(`/login`, + async (req, res) => { + try { + // ورک اراؤنڈ کیونکہ میں parseLoginRequest کو کام کرنے پر مجبور نہیں کر سکا۔ + // 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('SAML جواب پر کارروائی کرنے میں خرابی:', err); + res.status(400).send('SAML توثیق ناکام'); + } + } +) +``` + +مرحلہ 3 کے ہینڈلر میں `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 مواصلت، اقدامات 5.6 اور 5.7 ہیں۔ + +دوبارہ، یہاں `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`: تصدیق نامہ آئی ڈی۔ آپ اس قدر کا استعمال [آن چین پر تصدیق نامہ پڑھنے](https://optimism.blockscout.com/address/0x4200000000000000000000000000000000000021?tab=read_proxy&source_address=0x4E0275Ea5a89e7a3c1B58411379D1a0eDdc5b088#0xa3112a64) کے لیے کر سکتے ہیں تاکہ یہ تصدیق کی جا سکے کہ GraphQL استفسار سے ملنے والی معلومات درست ہے۔ +- `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/ur/developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md b/public/content/translations/ur/developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md new file mode 100644 index 00000000000..a15aafd580f --- /dev/null +++ b/public/content/translations/ur/developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md @@ -0,0 +1,156 @@ +--- +title: "ایتھیریم ڈیولپمنٹ کے ساتھ شروعات کرنا" +description: "یہ ایتھیریم ڈیولپمنٹ کے ساتھ شروعات کرنے کے لیے ایک ابتدائی گائیڈ ہے۔ ہم آپ کو ایک API اینڈ پوائنٹ شروع کرنے، کمانڈ لائن کی درخواست کرنے سے لے کر آپ کی پہلی ویب 3 اسکرپٹ لکھنے تک لے جائیں گے! بلاک چین ڈیولپمنٹ کے کسی تجربے کی ضرورت نہیں ہے!" +author: "Elan Halpern" +tags: + [ + "javascript", + "ethers.js", + "نوڈز", + "querying", + "alchemy" + ] +skill: beginner +lang: ur-in +published: 2020-10-30 +source: Medium +sourceUrl: https://medium.com/alchemy-api/getting-started-with-ethereum-development-using-alchemy-c3d6a45c567f +--- + + + +یہ ایتھیریم ڈیولپمنٹ کے ساتھ شروعات کرنے کے لیے ایک ابتدائی گائیڈ ہے۔ اس ٹیوٹوریل کے لیے ہم [Alchemy](https://alchemyapi.io/) کا استعمال کریں گے، جو کہ معروف بلاک چین ڈیولپر پلیٹ فارم ہے جو Maker، 0x، MyEtherWallet، Dharma، اور Kyber سمیت 70% سرفہرست بلاک چین ایپس کے لاکھوں صارفین کو تقویت فراہم کرتا ہے۔ Alchemy ہمیں ایتھیریم چین پر ایک API اینڈ پوائنٹ تک رسائی فراہم کرے گا تاکہ ہم ٹرانزیکشنز کو پڑھ اور لکھ سکیں۔ + +ہم آپ کو Alchemy کے ساتھ سائن اپ کرنے سے لے کر آپ کی پہلی ویب 3 اسکرپٹ لکھنے تک لے جائیں گے! بلاک چین ڈیولپمنٹ کے کسی تجربے کی ضرورت نہیں ہے! + +## 1۔ ایک مفت Alchemy اکاؤنٹ کے لیے سائن اپ کریں {#sign-up-for-a-free-alchemy-account} + +Alchemy کے ساتھ ایک اکاؤنٹ بنانا آسان ہے، [یہاں مفت میں سائن اپ کریں](https://auth.alchemy.com/)۔ + +## 2۔ ایک Alchemy ایپ بنائیں {#create-an-alchemy-app} + +ایتھیریم چین کے ساتھ کمیونیکیٹ کرنے اور 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 کے ذریعے ایتھیریم بلاک چین کے ساتھ انٹریکٹ کریں۔ + +مینوئل درخواستوں کے لیے، ہم `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`: آپ کی درخواست کا 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 } +``` + +## 4. اپنا ویب 3 کلائنٹ سیٹ اپ کریں {#set-up-your-web3-client} + +**اگر آپ کے پاس پہلے سے کلائنٹ ہے،** تو اپنے موجودہ نوڈ پرووائیڈر URL کو اپنی API کی کے ساتھ Alchemy URL میں تبدیل کریں: `“https://eth-mainnet.alchemyapi.io/v2/your-api-key"` + +**_نوٹ:_** نیچے دی گئی اسکرپٹس کو **نوڈ کانٹیکسٹ** میں چلانے یا **فائل میں محفوظ کرنے** کی ضرورت ہے، کمانڈ لائن سے نہیں۔ اگر آپ کے پاس پہلے سے نوڈ یا npm انسٹال نہیں ہے، تو میکس کے لیے یہ فوری [سیٹ اپ گائیڈ](https://app.gitbook.com/@alchemyapi/s/alchemy/guides/alchemy-for-macs) دیکھیں۔ + +بہت ساری [ویب 3 لائبریریاں](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 میں چلائیں یا اسے جاوا اسکرپٹ فائل میں شامل کریں: + +```js +const { createAlchemyWeb3 } = require("@alch/alchemy-web3") +const web3 = createAlchemyWeb3( + "https://eth-mainnet.alchemyapi.io/v2/your-api-key" +) +``` + +## 5. اپنی پہلی ویب 3 اسکرپٹ لکھیں! {#write-your-first-web3-script} + +اب تھوڑی ویب 3 پروگرامنگ میں عملی طور پر کام کرنے کے لیے، ہم ایک سادہ اسکرپٹ لکھیں گے جو ایتھیریم مین نیٹ سے تازہ ترین بلاک نمبر پرنٹ کرتی ہے۔ + +**1.** **اگر آپ نے پہلے سے ایسا نہیں کیا ہے، تو اپنے ٹرمینل میں ایک نئی پروجیکٹ ڈائرکٹری بنائیں اور اس میں cd کریں:** + +``` +mkdir web3-example +cd web3-example +``` + +**2.** **اگر آپ نے پہلے سے نہیں کیا ہے تو Alchemy web3 (یا کوئی بھی web3) ڈیپینڈینسی کو اپنے پروجیکٹ میں انسٹال کریں:** + +``` +npm install @alch/alchemy-web3 +``` + +**3.** **`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() +``` + +async چیزوں سے ناواقف ہیں؟ یہ [میڈیم پوسٹ](https://medium.com/better-programming/understanding-async-await-in-javascript-1d81bb079b2c) دیکھیں۔ + +\*\*4۔ **اسے اپنے ٹرمینل میں نوڈ کا استعمال کرتے ہوئے چلائیں** + +``` +node index.js +``` + +\*\*5۔ **اب آپ کو اپنے کنسول میں تازہ ترین بلاک نمبر کا آؤٹ پٹ نظر آنا چاہیے!** + +``` +تازہ ترین بلاک نمبر 11043912 ہے +``` + +**واہ!** مبارک ہو! **آپ نے ابھی ابھی Alchemy کا استعمال کرتے ہوئے اپنی پہلی ویب 3 اسکرپٹ لکھی ہے 🎉** + +یقین نہیں ہے کہ آگے کیا کرنا ہے؟ ہمارے [ہیلو ورلڈ اسمارٹ کنٹریکٹ گائیڈ](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/) دیکھیں، اور تازہ ترین خبروں کے لیے، ہمیں [Twitter](https://twitter.com/AlchemyPlatform) پر فالو کریں_۔ diff --git a/public/content/translations/ur/developers/tutorials/guide-to-smart-contract-security-tools/index.md b/public/content/translations/ur/developers/tutorials/guide-to-smart-contract-security-tools/index.md new file mode 100644 index 00000000000..26d546f1b72 --- /dev/null +++ b/public/content/translations/ur/developers/tutorials/guide-to-smart-contract-security-tools/index.md @@ -0,0 +1,102 @@ +--- +title: "اسمارٹ کنٹریکٹ سیکیورٹی ٹولز کے لئے ایک گائیڈ" +description: "تین مختلف ٹیسٹنگ اور پروگرام کے تجزیہ کی تکنیکوں کا ایک جائزہ" +author: "Trailofbits" +lang: ur-in +tags: [ "solidity", "اسمارٹ معاہدات", "سیکورٹی" ] +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 کے ذریعے Slither چلائیں یا صارف کی طرف سے متعین کردہ جانچ کے لیے API کے ذریعے۔ + +**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.) +- [Assertions کا استعمال](https://blog.regehr.org/archives/1091) + +### اجزاء {#components} + +یہ جاننا کہ آپ کیا جانچنا چاہتے ہیں، آپ کو صحیح ٹول منتخب کرنے میں بھی مدد ملے گی۔ + +وہ وسیع علاقے جو اسمارٹ کنٹریکٹس کے لیے اکثر متعلقہ ہوتے ہیں ان میں شامل ہیں: + +- **اسٹیٹ مشین۔** زیادہ تر کنٹریکٹس کو اسٹیٹ مشین کے طور پر پیش کیا جا سکتا ہے۔ یہ جانچنے پر غور کریں کہ (1) کوئی غلط اسٹیٹ تک نہیں پہنچا جا سکتا، (2) اگر کوئی اسٹیٹ درست ہے تو اس تک پہنچا جا سکتا ہے، اور (3) کوئی اسٹیٹ کنٹریکٹ کو ٹریپ نہیں کرتی ہے۔ + + - Echidna اور Manticore اسٹیٹ مشین کی تفصیلات کی جانچ کے لیے ترجیحی ٹولز ہیں۔ + +- **رسائی کنٹرولز۔** اگر آپ کے سسٹم میں مراعات یافتہ صارفین ہیں (مثال کے طور پر، ایک مالک، کنٹرولرز، ...) آپ کو یہ یقینی بنانا ہوگا کہ (1) ہر صارف صرف مجاز کارروائیاں انجام دے سکتا ہے اور (2) کوئی صارف زیادہ مراعات یافتہ صارف کی کارروائیوں کو بلاک نہیں کر سکتا۔ + + - Slither، Echidna اور Manticore درست رسائی کنٹرولز کی جانچ کر سکتے ہیں۔ مثال کے طور پر، Slither یہ جانچ سکتا ہے کہ صرف وائٹ لسٹ کیے گئے فنکشنز میں onlyOwner موڈیفائر کی کمی ہے۔ Echidna اور Manticore زیادہ پیچیدہ رسائی کنٹرول کے لیے مفید ہیں، جیسے کہ اجازت صرف اس صورت میں دی جاتی ہے جب کنٹریکٹ کسی دی گئی اسٹیٹ تک پہنچ جائے۔ + +- **حسابی آپریشنز۔** حسابی آپریشنز کی درستگی کی جانچ کرنا بہت اہم ہے۔ ہر جگہ `SafeMath` کا استعمال اوور فلو/انڈر فلو کو روکنے کے لیے ایک اچھا قدم ہے، تاہم، آپ کو اب بھی دیگر حسابی خامیوں پر غور کرنا چاہیے، بشمول راؤنڈنگ کے مسائل اور وہ خامیاں جو کنٹریکٹ کو ٹریپ کرتی ہیں۔ + + - Manticore یہاں بہترین انتخاب ہے۔ Echidna کا استعمال کیا جا سکتا ہے اگر حساب کتاب SMT سالور کے دائرہ کار سے باہر ہو۔ + +- **وراثت کی درستگی۔** Solidity کنٹریکٹس کثیر وراثت پر بہت زیادہ انحصار کرتے ہیں۔ غلطیاں جیسے کہ `super` کال سے محروم شیڈونگ فنکشن اور غلط تشریح شدہ c3 لینیئرائزیشن آرڈر آسانی سے متعارف ہو سکتے ہیں۔ + + - Slither ان مسائل کا پتہ لگانے کو یقینی بنانے کا ٹول ہے۔ + +- **بیرونی تعاملات۔** کنٹریکٹس ایک دوسرے کے ساتھ تعامل کرتے ہیں، اور کچھ بیرونی کنٹریکٹس پر بھروسہ نہیں کرنا چاہیے۔ مثال کے طور پر، اگر آپ کا کنٹریکٹ بیرونی اوریکلز پر انحصار کرتا ہے، تو کیا یہ محفوظ رہے گا اگر آدھے دستیاب اوریکلز سے سمجھوتہ ہو جائے؟ + + - Manticore اور Echidna آپ کے کنٹریکٹس کے ساتھ بیرونی تعاملات کی جانچ کے لیے بہترین انتخاب ہیں۔ Manticore میں بیرونی کنٹریکٹس کو اسٹب کرنے کے لیے ایک بلٹ ان میکانزم ہے۔ + +- **معیاری مطابقت۔** Ethereum معیارات (مثال کے طور پر، ERC20) کے ڈیزائن میں خامیوں کی ایک تاریخ ہے۔ اس معیار کی حدود سے آگاہ رہیں جس پر آپ تعمیر کر رہے ہیں۔ + - Slither، Echidna، اور Manticore آپ کو کسی دیے گئے معیار سے انحراف کا پتہ لگانے میں مدد کریں گے۔ + +### ٹول سلیکشن چیٹ شیٹ {#tool-selection-cheatsheet} + +| جز | ٹولز | مثالیں | +| --------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| اسٹیٹ مشین | Echidna, Manticore | | +| رسائی کنٹرول | Slither, Echidna, Manticore | [Slither exercise 2](https://github.com/crytic/slither/blob/7f54c8b948c34fb35e1d61adaa1bd568ca733253/docs/src/tutorials/exercise2.md)، [Echidna exercise 2](https://github.com/crytic/building-secure-contracts/blob/master/program-analysis/echidna/exercises/Exercise-2.md) | +| حسابی آپریشنز | Manticore, Echidna | [Echidna exercise 1](https://github.com/crytic/building-secure-contracts/blob/master/program-analysis/echidna/exercises/Exercise-1.md)، [Manticore exercises 1 - 3](https://github.com/crytic/building-secure-contracts/tree/master/program-analysis/manticore/exercises) | +| وراثت کی درستگی | Slither | [Slither exercise 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) | + +آپ کے اہداف کے لحاظ سے دیگر علاقوں کی جانچ کرنے کی ضرورت ہوگی، لیکن توجہ کے یہ موٹے دانے والے علاقے کسی بھی اسمارٹ کنٹریکٹ سسٹم کے لیے ایک اچھی شروعات ہیں۔ + +ہمارے عوامی آڈٹس میں تصدیق شدہ یا آزمائی گئی پراپرٹیز کی مثالیں شامل ہیں۔ حقیقی دنیا کی سیکیورٹی پراپرٹیز کا جائزہ لینے کے لیے درج ذیل رپورٹس کے `Automated Testing and Verification` سیکشنز کو پڑھنے پر غور کریں: + +- [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/ur/developers/tutorials/hello-world-smart-contract-fullstack/index.md b/public/content/translations/ur/developers/tutorials/hello-world-smart-contract-fullstack/index.md new file mode 100644 index 00000000000..e971035a361 --- /dev/null +++ b/public/content/translations/ur/developers/tutorials/hello-world-smart-contract-fullstack/index.md @@ -0,0 +1,1540 @@ +--- +title: "ہیلو ورلڈ اسمارٹ کنٹریکٹ برائے مبتدی - فل اسٹیک" +description: "Ethereum پر ایک سادہ اسمارٹ کنٹریکٹ لکھنے اور اسے ڈیپلائے کرنے کے بارے میں تعارفی ٹیوٹوریل۔" +author: "nstrike2" +tags: + [ + "solidity", + "hardhat", + "alchemy", + "اسمارٹ معاہدات", + "تعینات کرنا", + "بلاک ایکسپلورر", + "فرنٹ اینڈ", + "لین دین" + ] +skill: beginner +lang: ur-in +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) میں رابطہ کریں! + +## حصہ 1 - Hardhat کا استعمال کرتے ہوئے اپنا اسمارٹ کنٹریکٹ بنائیں اور ڈیپلائے کریں {#part-1} + +### Ethereum نیٹ ورک سے جڑیں {#connect-to-the-ethereum-network} + +Ethereum چین سے درخواستیں کرنے کے بہت سے طریقے ہیں۔ سادگی کے لیے، ہم Alchemy پر ایک مفت اکاؤنٹ استعمال کریں گے، جو ایک بلاک چین ڈیولپر پلیٹ فارم اور API ہے جو ہمیں خود ایک نوڈ چلائے بغیر Ethereum چین کے ساتھ بات چیت کرنے کی اجازت دیتا ہے۔ Alchemy میں نگرانی اور تجزیات کے لیے ڈیولپر ٹولز بھی ہیں؛ ہم اس ٹیوٹوریل میں ان سے فائدہ اٹھائیں گے تاکہ یہ سمجھ سکیں کہ ہمارے اسمارٹ کنٹریکٹ کی ڈیپلائیمنٹ میں پس پردہ کیا ہو رہا ہے۔ + +### اپنی ایپ اور API کلید بنائیں {#create-your-app-and-api-key} + +ایک بار جب آپ Alchemy اکاؤنٹ بنا لیتے ہیں، تو آپ ایک ایپ بنا کر ایک API کلید تیار کر سکتے ہیں۔ یہ آپ کو Goerli ٹیسٹ نیٹ پر درخواستیں بھیجنے کی اجازت دے گا۔ اگر آپ ٹیسٹ نیٹ سے واقف نہیں ہیں تو آپ [نیٹ ورک منتخب کرنے کے لیے Alchemy کی گائیڈ پڑھ سکتے ہیں](https://www.alchemy.com/docs/choosing-a-web3-network)۔ + +Alchemy ڈیش بورڈ پر، نیویگیشن بار میں **ایپس** ڈراپ ڈاؤن تلاش کریں اور **ایپ بنائیں** پر کلک کریں۔ + + + +اپنی ایپ کو '_ہیلو ورلڈ_' نام دیں اور ایک مختصر تفصیل لکھیں۔ اپنے ماحول کے طور پر **اسٹیجنگ** اور اپنے نیٹ ورک کے طور پر **Goerli** منتخب کریں۔ + + + +_نوٹ: یقینی بنائیں کہ **Goerli** منتخب کریں، ورنہ یہ ٹیوٹوریل کام نہیں کرے گا۔_ + +**ایپ بنائیں** پر کلک کریں۔ آپ کی ایپ نیچے دی گئی جدول میں ظاہر ہوگی۔ + +### ایک Ethereum اکاؤنٹ بنائیں {#create-an-ethereum-account} + +ٹرانزیکشنز بھیجنے اور وصول کرنے کے لیے آپ کو ایک Ethereum اکاؤنٹ کی ضرورت ہے۔ ہم MetaMask استعمال کریں گے، جو براؤزر میں ایک ورچوئل والیٹ ہے جو صارفین کو اپنے Ethereum اکاؤنٹ کے پتے کا انتظام کرنے کی اجازت دیتا ہے۔ + +آپ [یہاں](https://metamask.io/download) مفت میں MetaMask اکاؤنٹ ڈاؤن لوڈ اور بنا سکتے ہیں۔ جب آپ ایک اکاؤنٹ بنا رہے ہوں، یا اگر آپ کے پاس پہلے سے ہی ایک اکاؤنٹ ہے، تو یقینی بنائیں کہ اوپری دائیں کونے میں "Goerli ٹیسٹ نیٹ ورک" پر سوئچ کریں (تاکہ ہم اصلی پیسے سے نمٹ نہ رہے ہوں)۔ + +### مرحلہ 4: ایک فاسیٹ سے ایتھر شامل کریں {#step-4-add-ether-from-a-faucet} + +اپنے اسمارٹ کنٹریکٹ کو ٹیسٹ نیٹ ورک پر ڈیپلائے کرنے کے لیے، آپ کو کچھ جعلی ETH کی ضرورت ہوگی۔ Goerli نیٹ ورک پر ETH حاصل کرنے کے لیے، Goerli فوسیٹ پر جائیں اور اپنا Goerli اکاؤنٹ ایڈریس درج کریں۔ نوٹ کریں کہ Goerli فوسیٹس حال ہی میں تھوڑے غیر معتبر ہو سکتے ہیں - آزمانے کے لیے اختیارات کی فہرست کے لیے [ٹیسٹ نیٹ ورکس کا صفحہ](/developers/docs/networks/#goerli) دیکھیں۔ + +_نوٹ: نیٹ ورک کی بھیڑ کی وجہ سے، اس میں کچھ وقت لگ سکتا ہے۔_ +`` + +### مرحلہ 5: اپنا بیلنس چیک کریں {#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 کو ایتھر کی سب سے چھوٹی اکائی کے طور پر استعمال کیا جاتا ہے۔_ + +اف! ہمارا جعلی پیسہ سب وہیں ہے۔ + +### مرحلہ 6: ہمارے پروجیکٹ کو شروع کریں {#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) +تفصیل: ہیلو ورلڈ اسمارٹ کنٹریکٹ +انٹری پوائنٹ: (index.js) +ٹیسٹ کمانڈ: +گٹ ریپوزٹری: +کلیدی الفاظ: +مصنف: +لائسنس: (ISC) + +/Users/.../.../.../hello-world/package.json پر لکھنے کے بارے میں: + +{ + "name": "hello-world", + "version": "1.0.0", + "description": "ہیلو ورلڈ اسمارٹ کنٹریکٹ", + "main": "index.js", + "scripts": { + "test": "echo \"Error: no test specified\" && exit 1" + }, + "author": "", + "license": "ISC" +} +``` + +package.json کو منظور کریں اور ہم تیار ہیں! + +### مرحلہ 7: Hardhat ڈاؤن لوڈ کریں {#step-7-download-hardhat} + +Hardhat آپ کے Ethereum سافٹ ویئر کو کمپائل، ڈیپلوئے، ٹیسٹ اور ڈیبگ کرنے کے لیے ایک ڈیولپمنٹ ماحول ہے۔ یہ ڈیولپرز کو لائیو چین پر ڈیپلوئے کرنے سے پہلے مقامی طور پر اسمارٹ کنٹریکٹس اور dapps بنانے میں مدد کرتا ہے۔ + +ہمارے `hello-world` پروجیکٹ کے اندر چلائیں: + +``` +npm install --save-dev hardhat +``` + +[انسٹالیشن کی ہدایات](https://hardhat.org/getting-started/#overview) پر مزید تفصیلات کے لیے یہ صفحہ دیکھیں۔ + +### مرحلہ 8: Hardhat پروجیکٹ بنائیں {#step-8-create-hardhat-project} + +ہمارے `hello-world` پروجیکٹ فولڈر کے اندر، چلائیں: + +``` +npx hardhat +``` + +پھر آپ کو ایک خوش آمدیدی پیغام اور یہ منتخب کرنے کا آپشن نظر آئے گا کہ آپ کیا کرنا چاہتے ہیں۔ “create an empty 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` فائل بنائے گا۔ ہم اسے بعد میں ٹیوٹوریل میں اپنے پروجیکٹ کے سیٹ اپ کی وضاحت کے لیے استعمال کریں گے۔ + +### مرحلہ 9: پروجیکٹ فولڈر شامل کریں {#step-9-add-project-folders} + +پروجیکٹ کو منظم رکھنے کے لیے، آئیے دو نئے فولڈر بنائیں۔ کمانڈ لائن میں، اپنے `hello-world` پروجیکٹ کی روٹ ڈائرکٹری میں جائیں اور ٹائپ کریں: + +``` +mkdir contracts +mkdir scripts +``` + +- `contracts/` وہ جگہ ہے جہاں ہم اپنی ہیلو ورلڈ اسمارٹ کنٹریکٹ کوڈ فائل رکھیں گے۔ +- `scripts/` وہ جگہ ہے جہاں ہم اپنے کنٹریکٹ کو ڈیپلائے کرنے اور اس کے ساتھ انٹریکٹ کرنے کے لیے اسکرپٹس رکھیں گے۔ + +### مرحلہ 10: ہمارا کنٹریکٹ لکھیں {#step-10-write-our-contract} + +آپ خود سے پوچھ رہے ہوں گے کہ ہم کوڈ کب لکھنے جا رہے ہیں؟ یہی وقت ہے! + +اپنے پسندیدہ ایڈیٹر میں ہیلو-ورلڈ پروجیکٹ کھولیں۔ اسمارٹ کنٹریکٹس زیادہ تر Solidity میں لکھے جاتے ہیں، جسے ہم اپنا اسمارٹ کنٹریکٹ لکھنے کے لیے استعمال کریں گے۔ + +1. `contracts` فولڈر پر جائیں اور `HelloWorld.sol` نامی ایک نئی فائل بنائیں۔ +2. ذیل میں ایک نمونہ ہیلو ورلڈ اسمارٹ کنٹریکٹ ہے جسے ہم اس ٹیوٹوریل کے لیے استعمال کریں گے۔ نیچے دیے گئے مواد کو `HelloWorld.sol` فائل میں کاپی کریں۔ + +_نوٹ: یہ سمجھنے کے لیے کہ یہ کنٹریکٹ کیا کرتا ہے، تبصرے ضرور پڑھیں۔_ + +``` +// Solidity کے ورژن کی وضاحت کرتا ہے، سیمنٹک ورژننگ کا استعمال کرتے ہوئے۔ +// مزید جانیں: https://solidity.readthedocs.io/en/v0.5.10/layout-of-source-files.html#pragma +pragma solidity >=0.7.3; + +// `HelloWorld` نامی ایک کنٹریکٹ کی وضاحت کرتا ہے۔ +// ایک کنٹریکٹ فنکشنز اور ڈیٹا (اس کی حالت) کا ایک مجموعہ ہے۔ ایک بار ڈیپلائے ہونے کے بعد، ایک کنٹریکٹ Ethereum بلاک چین پر ایک مخصوص ایڈریس پر رہتا ہے۔ مزید جانیں: 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` فنکشن کو کال کرکے اپ ڈیٹ کیا جاسکتا ہے۔ + +### مرحلہ 11: MetaMask اور Alchemy کو اپنے پروجیکٹ سے جوڑیں {#step-11-connect-metamask-alchemy-to-your-project} + +ہم نے ایک MetaMask والیٹ، Alchemy اکاؤنٹ بنایا ہے، اور اپنا اسمارٹ کنٹریکٹ لکھا ہے، اب ان تینوں کو جوڑنے کا وقت آگیا ہے۔ + +آپ کے والیٹ سے بھیجی گئی ہر ٹرانزیکشن کے لیے آپ کی منفرد پرائیویٹ کلید کا استعمال کرتے ہوئے ایک دستخط کی ضرورت ہوتی ہے۔ ہمارے پروگرام کو یہ اجازت دینے کے لیے، ہم اپنی پرائیویٹ کلید کو ایک انوائرمنٹ فائل میں محفوظ طریقے سے محفوظ کر سکتے ہیں۔ ہم یہاں Alchemy کے لیے ایک API کلید بھی محفوظ کریں گے۔ + +> ٹرانزیکشنز بھیجنے کے بارے میں مزید جاننے کے لیے، web3 کا استعمال کرتے ہوئے ٹرانزیکشنز بھیجنے پر [یہ ٹیوٹوریل](https://www.alchemy.com/docs/hello-world-smart-contract#step-11-connect-metamask--alchemy-to-your-project) دیکھیں۔ + +سب سے پہلے، اپنی پروجیکٹ ڈائرکٹری میں dotenv پیکیج انسٹال کریں: + +``` +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" +``` + +انہیں حقیقت میں ہمارے کوڈ سے جوڑنے کے لیے، ہم ان متغیرات کا حوالہ اپنی `hardhat.config.js` فائل میں مرحلہ 13 پر دیں گے۔ + +### مرحلہ 12: Ethers.js انسٹال کریں {#step-12-install-ethersjs} + +Ethers.js ایک لائبریری ہے جو زیادہ صارف دوست طریقوں کے ساتھ [معیاری JSON-RPC طریقوں](https://docs.alchemyapi.io/alchemy/documentation/alchemy-api-reference/json-rpc) کو لپیٹ کر Ethereum کے ساتھ تعامل اور درخواستیں کرنا آسان بناتی ہے۔ + +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" +``` + +### مرحلہ 13: 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}`], + }, + }, +} +``` + +### مرحلہ 14: ہمارا کنٹریکٹ کمپائل کریں {#step-14-compile-our-contract} + +یہ یقینی بنانے کے لیے کہ اب تک سب کچھ کام کر رہا ہے، آئیے اپنے کنٹریکٹ کو کمپائل کریں۔ `compile` ٹاسک بلٹ ان ہارڈ ہیٹ ٹاسک میں سے ایک ہے۔ + +کمانڈ لائن سے چلائیں: + +```bash +npx hardhat compile +``` + +آپ کو `SPDX license identifier not provided in source file` کے بارے میں ایک انتباہ مل سکتا ہے، لیکن اس کے بارے میں فکر کرنے کی کوئی ضرورت نہیں ہے — امید ہے کہ باقی سب کچھ ٹھیک نظر آئے گا! اگر نہیں، تو آپ ہمیشہ [Alchemy discord](https://discord.gg/u72VCg3) میں پیغام بھیج سکتے ہیں۔ + +### مرحلہ 15: ہمارا ڈیپلائے اسکرپٹ لکھیں {#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("کنٹریکٹ اس ایڈریس پر ڈیپلائے کیا گیا:", 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` ہمارے ہیلو ورلڈ کنٹریکٹ کی مثالوں کے لیے ایک [فیکٹری](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` فیلڈ میں اپنا کنٹریکٹ ایڈریس نظر آئے گا۔ + + + +مبارک ہو! آپ نے ابھی ایک Ethereum ٹیسٹ نیٹ پر ایک اسمارٹ کنٹریکٹ ڈیپلائے کیا ہے۔ + +پس پردہ کیا ہو رہا ہے یہ سمجھنے کے لیے، آئیے اپنے [Alchemy ڈیش بورڈ](https://dashboard.alchemy.com/explorer) میں ایکسپلورر ٹیب پر جائیں۔ اگر آپ کے پاس متعدد Alchemy ایپس ہیں تو یقینی بنائیں کہ ایپ کے لحاظ سے فلٹر کریں اور **ہیلو ورلڈ** منتخب کریں۔ + + + +یہاں آپ کو کچھ 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)، جو ہیش دیے جانے پر ہماری ٹرانزیکشن کے بارے میں معلومات پڑھنے کی درخواست ہے۔ ٹرانزیکشنز بھیجنے کے بارے میں مزید جاننے کے لیے، [Web3 کا استعمال کرتے ہوئے ٹرانزیکشنز بھیجنے پر ہمارا ٹیوٹوریل](/developers/tutorials/sending-transactions-using-web3-and-alchemy/) دیکھیں۔ + +## حصہ 2: اپنے اسمارٹ کنٹریکٹ کے ساتھ تعامل کریں {#part-2-interact-with-your-smart-contract} + +اب جب کہ ہم نے Goerli نیٹ ورک پر ایک اسمارٹ کنٹریکٹ کامیابی سے ڈیپلائے کر لیا ہے، آئیے سیکھتے ہیں کہ اس کے ساتھ کیسے تعامل کیا جائے۔ + +### ایک interact.js فائل بنائیں {#create-a-interactjs-file} + +یہ وہ فائل ہے جہاں ہم اپنا تعامل کا اسکرپٹ لکھیں گے۔ ہم Ethers.js لائبریری استعمال کریں گے جو آپ نے پہلے حصہ 1 میں انسٹال کی تھی۔ + +`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 میں اپنے مختلف ریاستی متغیرات کہاں استعمال کرتے ہیں:
+
+- لائن 6-12 پر، اگر صارف کا والیٹ جڑا ہوا ہے (یعنی، `walletAddress.length > 0`)، تو ہم ID "walletButton" والے بٹن میں صارف کے `walletAddress` کا ایک چھوٹا ورژن دکھاتے ہیں؛ ورنہ یہ صرف "والیٹ جوڑیں" کہتا ہے۔
+- لائن 17 پر، ہم اسمارٹ کنٹریکٹ میں محفوظ موجودہ پیغام دکھاتے ہیں، جو `message` اسٹرنگ میں پکڑا گیا ہے۔
+- لائن 23-26 پر، ہم اپنے `newMessage` ریاستی متغیر کو اپ ڈیٹ کرنے کے لیے ایک [کنٹرولڈ جزو](https://legacy.reactjs.org/docs/forms.html#controlled-components) استعمال کرتے ہیں جب ٹیکسٹ فیلڈ میں ان پٹ تبدیل ہوتا ہے۔
+
+ہمارے ریاستی متغیرات کے علاوہ، آپ یہ بھی دیکھیں گے کہ `connectWalletPressed` اور `onUpdatePressed` افعال کو اس وقت کال کیا جاتا ہے جب IDs `publishButton` اور `walletButton` والے بٹنوں پر بالترتیب کلک کیا جاتا ہے۔
+
+آخر میں، آئیے اس بات پر توجہ دیں کہ یہ `HelloWorld.js` جزو کہاں شامل کیا گیا ہے۔
+
+اگر آپ `App.js` فائل پر جاتے ہیں، جو React میں مرکزی جزو ہے جو دیگر تمام اجزاء کے لیے کنٹینر کے طور پر کام کرتا ہے، تو آپ دیکھیں گے کہ ہمارا `HelloWorld.js` جزو لائن 7 پر داخل کیا گیا ہے۔
+
+آخری لیکن کم از کم، آئیے ایک اور فائل چیک کریں جو آپ کے لیے فراہم کی گئی ہے، `interact.js` فائل۔
+
+#### `interact.js` فائل {#the-interact-js-file}
+
+چونکہ ہم [M-V-C](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) پیراڈائم کی پیروی کرنا چاہتے ہیں، ہم ایک الگ فائل چاہیں گے جس میں ہمارے dapp کی منطق، ڈیٹا، اور قوانین کا انتظام کرنے کے لیے ہمارے تمام افعال شامل ہوں، اور پھر ان افعال کو ہمارے فرنٹ اینڈ (ہمارا `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) کا استعمال کرتے ہوئے ہیلو ورلڈ اسمارٹ کنٹریکٹ پر ایک _ریڈ_ کال کرے گا۔
+- `connectWallet` - یہ فنکشن صارف کے MetaMask کو ہمارے dapp سے جوڑے گا۔
+- `getCurrentWalletConnected` - یہ فنکشن چیک کرے گا کہ آیا کوئی Ethereum اکاؤنٹ پہلے سے ہی صفحہ لوڈ پر ہمارے dapp سے جڑا ہوا ہے اور ہمارے UI کو اسی کے مطابق اپ ڈیٹ کرے گا۔
+- `updateMessage` - یہ فنکشن اسمارٹ کنٹریکٹ میں محفوظ پیغام کو اپ ڈیٹ کرے گا۔ یہ ہیلو ورلڈ اسمارٹ کنٹریکٹ پر ایک _رائٹ_ کال کرے گا، لہذا صارف کے MetaMask والیٹ کو پیغام کو اپ ڈیٹ کرنے کے لیے ایک Ethereum ٹرانزیکشن پر دستخط کرنا ہوگا۔
+
+اب جب کہ ہم سمجھ گئے ہیں کہ ہم کس کے ساتھ کام کر رہے ہیں، آئیے یہ معلوم کریں کہ اپنے اسمارٹ کنٹریکٹ سے کیسے پڑھا جائے!
+
+### مرحلہ 3: اپنے اسمارٹ کنٹریکٹ سے پڑھیں {#step-3-read-from-your-smart-contract}
+
+اپنے اسمارٹ کنٹریکٹ سے پڑھنے کے لیے، آپ کو کامیابی سے سیٹ اپ کرنے کی ضرورت ہوگی:
+
+- Ethereum چین سے ایک API کنکشن
+- آپ کے اسمارٹ کنٹریکٹ کی ایک لوڈ شدہ مثال
+- آپ کے اسمارٹ کنٹریکٹ فنکشن کو کال کرنے کے لیے ایک فنکشن
+- ایک سننے والا جو اپ ڈیٹس کے لیے دیکھتا ہے جب آپ اسمارٹ کنٹریکٹ سے پڑھ رہے ڈیٹا میں تبدیلی آتی ہے
+
+یہ بہت سارے مراحل لگ سکتے ہیں، لیکن فکر نہ کریں! ہم آپ کو ہر ایک کو قدم بہ قدم کرنے کا طریقہ بتائیں گے! :\)
+
+#### Ethereum چین سے ایک API کنکشن قائم کریں {#establish-an-api-connection-to-the-ethereum-chain}
+
+تو یاد ہے کہ اس ٹیوٹوریل کے حصہ 2 میں، ہم نے اپنے اسمارٹ کنٹریکٹ سے پڑھنے کے لیے اپنی [Alchemy Web3 کلید کا استعمال کیا تھا](https://docs.alchemy.com/alchemy/tutorials/hello-world-smart-contract/interacting-with-a-smart-contract#step-1-install-web3-library)؟ آپ کو اپنے dapp میں چین سے پڑھنے کے لیے بھی ایک 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 طریقے اور دیگر اہم فوائد فراہم کرتا ہے تاکہ آپ کی زندگی کو ایک web3 ڈیولپر کے طور پر آسان بنایا جا سکے۔ یہ کم سے کم کنفیگریشن کی ضرورت کے لیے ڈیزائن کیا گیا ہے تاکہ آپ اسے اپنی ایپ میں فوراً استعمال کرنا شروع کر سکیں!
+
+پھر، اپنے پروجیکٹ ڈائرکٹری میں [dotenv](https://www.npmjs.com/package/dotenv) پیکیج انسٹال کریں، تاکہ ہمارے پاس اپنی API کلید کو حاصل کرنے کے بعد اسے محفوظ کرنے کے لیے ایک محفوظ جگہ ہو۔
+
+```text
+npm install dotenv --save
+```
+
+ہمارے dapp کے لیے، **ہم اپنی 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، ایک ورچوئل Ethereum والیٹ، انسٹال کرنا ہوگا۔ + +
+ + ), + } + } +} +``` + +تو کوڈ کا یہ بڑا بلاک بالکل کیا کرتا ہے؟ + +پہلے، یہ چیک کرتا ہے کہ آیا آپ کے براؤزر میں `window.ethereum` فعال ہے۔ + +`window.ethereum` MetaMask اور دیگر والیٹ فراہم کنندگان کے ذریعے انجیکٹ کردہ ایک عالمی API ہے جو ویب سائٹس کو صارفین کے Ethereum اکاؤنٹس کی درخواست کرنے کی اجازت دیتا ہے۔ اگر منظور ہو جائے، تو یہ ان بلاک چینز سے ڈیٹا پڑھ سکتا ہے جن سے صارف جڑا ہوا ہے، اور صارف کو پیغامات اور ٹرانزیکشنز پر دستخط کرنے کا مشورہ دے سکتا ہے۔ مزید معلومات کے لیے [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"` ایک سرنی واپس کرے گا جس میں صارف کے تمام اکاؤنٹ پتے شامل ہوں گے جو dapp سے جڑے ہوئے ہیں۔ مجموعی طور پر، ہمارا `connectWallet` فنکشن ایک JSON آبجیکٹ واپس کرے گا جس میں اس اری کا _پہلا_ `address` (لائن 9 دیکھیں) اور ایک `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` کو نافذ کرکے، جو یہ چیک کرے گا کہ آیا کوئی پتہ پہلے سے ہی ہمارے dapp سے جڑا ہوا ہے اور ہمارے 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، ایک ورچوئل Ethereum والیٹ، انسٹال کرنا ہوگا۔ + +
+ + ), + } + } +} +``` + +یہ کوڈ _بہت_ ملتا جلتا ہے `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) +}, []) +``` + +نوٹ کریں، ہم اپنے `walletAddress` اور `status` اسٹیٹ متغیرات کو اپ ڈیٹ کرنے کے لیے `getCurrentWalletConnected` پر اپنی کال کے جواب کا استعمال کرتے ہیں۔ + +اب جب کہ آپ نے یہ کوڈ شامل کر دیا ہے، آئیے اپنے براؤزر ونڈو کو ریفریش کرنے کی کوشش کریں۔ + +بہت اچھے! بٹن کو کہنا چاہیے کہ آپ جڑے ہوئے ہیں، اور آپ کے جڑے ہوئے والیٹ کے پتے کا ایک پیش نظارہ دکھانا چاہیے - یہاں تک کہ آپ کے ریفریش کرنے کے بعد بھی! + +#### `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، ایک ورچوئل Ethereum والیٹ، انسٹال کرنا ہوگا۔ + +
+ ) + } +} +``` + +مجھے شرط ہے کہ آپ کو اس مقام پر کیا ہو رہا ہے یہ سمجھنے کے لیے ہماری مدد کی بھی ضرورت نہیں ہے، لیکن مکمل ہونے کی خاطر، آئیے اسے جلدی سے توڑتے ہیں: + +- سب سے پہلے، ہمارا فنکشن چیک کرتا ہے کہ آیا `window.ethereum` فعال ہے (یعنی، MetaMask انسٹال ہے)۔ + - اگر ایسا نہیں ہے، تو ہم صرف اپنے `status` اسٹیٹ متغیر کو ایک JSX اسٹرنگ پر سیٹ کرتے ہیں جو صارف کو MetaMask انسٹال کرنے کا کہتا ہے۔ + - اگر یہ فعال ہے، تو ہم لائن 3 پر لسنر `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() +}, []) +``` + +اور بس! ہم نے کامیابی سے اپنی تمام والیٹ کی فعالیت کی پروگرامنگ مکمل کر لی ہے! اب اپنے آخری کام کی طرف: اپنے اسمارٹ کنٹریکٹ میں محفوظ پیغام کو اپ ڈیٹ کرنا! + +### مرحلہ 6: `updateMessage` فنکشن نافذ کریں {#step-6-implement-the-updateMessage-function} + +ٹھیک ہے فیم، ہم آخری مرحلے پر پہنچ گئے ہیں! اپنی `interact.js` فائل کے `updateMessage` میں، ہم درج ذیل کام کرنے جا رہے ہیں: + +1. یقینی بنائیں کہ وہ پیغام جسے ہم اپنے اسمارٹ رابطہ میں شائع کرنا چاہتے ہیں، درست ہے +2. MetaMask کا استعمال کرتے ہوئے اپنے ٹرانزیکشن پر دستخط کریں +3. اس فنکشن کو ہمارے `HelloWorld.js` فرنٹ اینڈ جزو سے کال کریں + +اس میں زیادہ وقت نہیں لگے گا؛ آئیے اس dapp کو مکمل کریں! + +#### ان پٹ کی خرابی کو ہینڈل کرنا {#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} + +اگر آپ پہلے سے ہی روایتی web3 Ethereum ٹرانزیکشنز کے ساتھ آرام دہ ہیں، تو جو کوڈ ہم اگلا لکھیں گے وہ بہت مانوس ہوگا۔ اپنے ان پٹ ایرر ہینڈلنگ کوڈ کے نیچے، `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` ہمارے ہیلو ورلڈ اسمارٹ کنٹریکٹ کے `update` میتھڈ کی کال پر مشتمل ہے، جو ہمارے `message` اسٹرنگ متغیر کو ان پٹ کے طور پر حاصل کرتا ہے + +پھر، ہم ایک `window.ethereum.request` کال کا انتظار کرتے ہیں، جہاں ہم MetaMask سے ٹرانزیکشن پر دستخط کرنے کے لیے کہتے ہیں۔ نوٹ کریں، لائن 11 اور 12 پر، ہم اپنے 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` فنکشن پر ایک await کال کرنی چاہیے اور `status` ریاستی متغیر میں ترمیم کرنی چاہیے تاکہ یہ ظاہر ہو کہ آیا ہمارا ٹرانزیکشن کامیاب ہوا یا ناکام: + +```javascript +// HelloWorld.js + +const onUpdatePressed = async () => { + const { status } = await updateMessage(walletAddress, newMessage) + setStatus(status) +} +``` + +یہ بہت صاف اور سادہ ہے۔ اور اندازہ لگائیں کیا... آپ کا DAPP مکمل ہے!!! + +آگے بڑھیں اور **اپ ڈیٹ** بٹن کو آزمائیں! + +### اپنا کسٹم dapp بنائیں {#make-your-own-custom-dapp} + +واہ، آپ ٹیوٹوریل کے آخر تک پہنچ گئے! خلاصہ کرنے کے لیے، آپ نے سیکھا کہ کیسے: + +- MetaMask والیٹ کو اپنے dapp پروجیکٹ سے جوڑیں +- [Alchemy Web3](https://docs.alchemy.com/alchemy/documentation/alchemy-web3) API کا استعمال کرتے ہوئے اپنے اسمارٹ کنٹریکٹ سے ڈیٹا پڑھیں +- MetaMask کا استعمال کرتے ہوئے Ethereum ٹرانزیکشنز پر دستخط کریں + +اب آپ اس ٹیوٹوریل کی مہارتوں کو اپنے کسٹم dapp پروجیکٹ کی تعمیر کے لیے استعمال کرنے کے لیے پوری طرح سے لیس ہیں! ہمیشہ کی طرح، اگر آپ کے کوئی سوالات ہیں، تو [Alchemy Discord](https://discord.gg/gWuC7zB) میں مدد کے لیے ہم سے رابطہ کرنے میں ہچکچاہٹ نہ کریں۔ 🧙♂️ + +ایک بار جب آپ یہ ٹیوٹوریل مکمل کر لیں، تو ہمیں بتائیں کہ آپ کا تجربہ کیسا رہا یا اگر آپ کے پاس کوئی رائے ہے تو ہمیں ٹویٹر پر [@alchemyplatform](https://twitter.com/AlchemyPlatform) پر ٹیگ کرکے بتائیں! diff --git a/public/content/translations/ur/developers/tutorials/hello-world-smart-contract/index.md b/public/content/translations/ur/developers/tutorials/hello-world-smart-contract/index.md new file mode 100644 index 00000000000..9fbaff1d609 --- /dev/null +++ b/public/content/translations/ur/developers/tutorials/hello-world-smart-contract/index.md @@ -0,0 +1,366 @@ +--- +title: "ابتدائی افراد کے لیے ہیلو ورلڈ اسمارٹ کنٹریکٹ" +description: "Ethereum پر ایک سادہ اسمارٹ کنٹریکٹ لکھنے اور اسے ڈیپلائے کرنے کے بارے میں تعارفی ٹیوٹوریل۔" +author: "elanh" +tags: + [ + "solidity", + "hardhat", + "alchemy", + "اسمارٹ معاہدات", + "تعینات کرنا" + ] +skill: beginner +lang: ur-in +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 نظر نہیں آتا، تو مینو میں جائیں، پھر ایڈوانسڈ میں جائیں اور "Show test networks" کو آن کرنے کے لیے نیچے اسکرول کریں۔ نیٹ ورک سلیکشن مینو میں، ٹیسٹ نیٹس کی فہرست تلاش کرنے کے لیے "Custom" ٹیب کا انتخاب کریں اور "Sepolia" کو منتخب کریں۔ + + + +## مرحلہ 4: ایک فوسیٹ سے ایتھر شامل کریں {#step-4} + +اپنے اسمارٹ کنٹریکٹ کو ٹیسٹ نیٹ ورک پر ڈیپلائے کرنے کے لیے، ہمیں کچھ جعلی Eth کی ضرورت ہوگی۔ Sepolia ETH حاصل کرنے کے لیے آپ مختلف فوسیٹس کی فہرست دیکھنے کے لیے [Sepolia نیٹ ورک کی تفصیلات](/developers/docs/networks/#sepolia) پر جا سکتے ہیں۔ اگر کوئی کام نہ کرے تو دوسرا آزمائیں کیونکہ وہ کبھی کبھی خالی ہو سکتے ہیں۔ نیٹ ورک ٹریفک کی وجہ سے آپ کو اپنا جعلی ETH حاصل کرنے میں کچھ وقت لگ سکتا ہے۔ آپ کو جلد ہی اپنے Metamask اکاؤنٹ میں ETH نظر آنا چاہیے! + +## مرحلہ 5: اپنا بیلنس چیک کریں {#step-5} + +یہ یقینی بنانے کے لیے کہ ہمارا بیلنس وہاں ہے، آئیے [Alchemy کے کمپوزر ٹول](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 اکاؤنٹ کا ایڈریس درج کرنے اور "Send Request" پر کلک کرنے کے بعد، آپ کو اس طرح کا جواب نظر آنا چاہیے: + +```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 فائل میں شامل کریں۔
+