make your own nip5 address.

src/SUMMARY.md

@@ -26,6 +26,7 @@
 - [مقدمه](./nostr-for-devs/intro.rtl.md)
   - [چگونه یک رله نوستر اجرا کنیم؟](./nostr-for-devs/run-a-relay.rtl.md)
   - [چگونه یک ربات نوستر بسازیم؟](./nostr-for-devs/make-a-bot.rtl.md)
+  - [چگونه یک آدرس نیپ ۵ برای خود بسازیم؟](./nostr-for-devs/using-nip5.rtl.md)
 
  <!--  افزودن ارتباط با امضا کنندگان نوستر -->
 

src/nostr-for-devs/using-nip5.rtl.md

@@ -0,0 +1,124 @@
+# چگونه یک آدرس نیپ ۵ داشته باشیم؟
+
+همانطور که میدانید برعکس شبکه های اجتماعی شناخته شده متمرکز کلاینت های نوستر افراد و هویت هارا به استفاده از یک شناسه طولانی میشناسند. انتقال و اشتراک گذاری این شناسه بدون اشتباه یا در هر جایی بدون دسترسی به یک تلفن همراه یا کامپیوتر ممکن است دردسر باشد و تجربه خوبی نباشد.
+
+یکی از راه حل های توسعه دهندگان برای این مشکل نیپ ۵ است. آدرس های نیپ ۵ شباهت بالایی به آدرس ایمیل دارند. (برای جزییات دقیق عملکرد این نیپ نسخه ترجمه شده این نیپ را در همین کتاب میتوانید مطالعه کنید یا با مراجعه به مخزن اصلی نیپ ها نسخه اصلی را مطالعه کنید.) یک نمونه از ادرس نیپ ۵:
+
+```[email protected]```
+
+پیش از ایجاد یک آدرس نیپ پنج این حساب تنها با کلید عمومی npub14jng93gugnysgerpmcxtxj7vvvud243vm7gx9thfc0995n9q4v7qw3npu6 قابل یافتن بود. اما اکنون شما با جستجو ادرس نیپ ۵ بالا در کلاینت خود یا مراجعه به لینک پایین میتوانید این حساب را مشاهده کنید.
+
+https://njump.me/[email protected]
+
+
+کلمه پیش از @ نام دلبخواه شما و دامنه بعد از ان نام دامنه شخصی شما یا سرویسی است که شما از ان ادرس خود را دریافت کرده اید.
+
+نکته: شما میتوانید چند آدرس نیپ ۵ مرتبط با حساب خود داشته باشید.
+
+در ادامه ما روش های مختلفی برای دریافت یک ادرس نیپ پنج را بررسی خواهیم کرد.
+
+## سرویس های رایگان (نام دامنه سرویس)
+
+یکی از ساده ترین روش های تهیه یک آدرس نیپ ۵ استفاده از سرویس های رایگان اراعه دهنده نیپ ۵ میباشد. در این روش شما تنها قادر به مشخص کردن نام پیش از @ خواهید بود.
+
+فهرست سرویس های موجود:
+
+https://bitcoinnostr.com/
+https://nostrcheck.me/
+https://zaps.lol/
+https://www.nostr-check.com/
+https://nl.nostraddress.com/
+https://cosanostr.com/
+
+در تمامی این سرویس ها شما میتوانید کلید عمومی خود و یک نام دلخواه را وارد کنید و آدرس نیپ ۵ خود را دریافت کنید. 
+
+نکته: شرایط یا تعهد سرویس ها (به ویژه سرویس های رایگان) میتواند متفاوت باشد.
+
+ممکن است برخی از کلاینت ها همچون 0xchat بصورت داخلی به شما اجازه دریافت ادرس رایگان نیپ ۵ را بدهند.
+
+## سرویس های پولی (نام دامنه سرویس)
+
+استفاده از سرویس های پولی برای دریافت ادرس نیپ ۵ هم ممکن است:
+
+https://nostrplebs.com/
+https://nl.nostraddress.com/
+https://getalby.com/
+https://nostr.directory/
+https://nostr.com.au/
+https://stacker.news/
+https://nostrich.house/
+
+ نکته: شرایط ویژه ممکن است در سرویس های پولی هم وجود داشته باشد.
+
+ ## استفاده از دامنه شخصی و گیت هاب
+
+ در این روش شما با استفاده از دامنه شخصی خود آدرس نیپ ۵ خود را روی گیت هاب نگهداری میکنید. با این روش تمام شرایط تحت کنترل شما خواهد بود و نام دامنه دلخواه شده استفاده خواهد شد.
+
+ در ادامه به روند انجام این کار و چند نمونه عملی میپردازیم.
+
+ ۱. یک دامنه تهیه کنید.
+
+ ۲. رکورد های DNS دامنه خود را به شکل زیر تنظیم کنید:
+
+ ```
+ | Type | Host           | Answer          | TTL | Priority |
+|------|----------------|-----------------|-----|----------|
+| A    | YOURDOMAIN.COM | 185.199.108.153 | 300 |          |
+| A    | YOURDOMAIN.COM | 185.199.109.153 | 300 |          |
+| A    | YOURDOMAIN.COM | 185.199.110.153 | 300 |          |
+| A    | YOURDOMAIN.COM | 185.199.111.153 | 300 |          |
+```
+
+۳. یک مخزن جدید در گیتهاب ایجاد کنید.
+
+ ۴. در مخزن یک فایل جدید با مسیر `your-repo/.well-known/nostr.json‍` ایجاد کنید.
+
+ ۵. فایل nostr.json را با کلید عمومی و اطلاعات دلخواه خود پر کنید:
+
+ ```json
+ {
+  "names": {
+    "bob": "e88a691e98d9987c964521dff60025f60700378a4879180dcbbb4a5027850411"
+  }
+}
+```
+میتوانید bob را با نام دلخواه خود (پیش از @) جایگزین کنید. و کلید عمومی خود را (بصورت hex) در مقابل ان قرار دهید.
+
+برای تبدیل کلید عمومی از npub به hex  از این ابزار میتوانید استفاده کنید: https://nostrcheck.me/converter/
+
+بر اساس نیپ ۵ شما میتوانید بصورت key/value کلید ها و نام های بیشتری در فایل مورد نظر قراردهید و برای دوستان و یا حساب های دیگر خود نیز آدرس نیپ ۵ ایجاد کنید.
+
+۶. در root مخزن خود یک فایل با نام `_config.yml‍` ایجاد کنید و محتوای زیر را در آن قرار دهید:
+
+‍‍‍```yaml
+include: [".well-known"]
+```
+
+7. بر اساس نام مخزن و حساب کاربری گیت هاب خود به ادرس زیر بروید:
+
+github.com/[USER]/[YOUR-REPO]/settings/pages
+
+۸. پایین قسمت Build and deployment گزینه Deploy from branch را انتخاب کنید و پایین آن برنچ Main/Master را انتخاب کنید. (این موارد ممکن است در پنل جدید گیت هاب تغییر کنند. در نظر داشته باشید که از پنل قدیمی استفاده کنید یا مکان جدید موارد گفته شده را پیدا کنید.)
+
+۹. در پایین قسمت Custom domain نام دامنه خالی خود را (همچون YOURDOMAIN.COM) وارد کنید. (ممکن است از طرف گیتهاب خطا دریافت کنید. ان را نادیده بگیرید.)
+
+۱۰. پایین آن گزینه Enforce HTTPS را فعال کنید. گاهی ممکن است کمی زمان بر باشد.
+
+اکنون آدرس نیپ ۵ شما بصورت `[email protected]` در دسترس است و در کلاینت های مختلف قابل جستجو خواهد بود. برای نمایش این آدرس به کلاینت مد نظر خود بروید و پروفایل خود را بروزرسانی کنید . ادرس خود را در قسمت نیپ ۵ قرار دهید.
+
+نمونه های عملی:
+
+مخزن خام:
+
+https://github.com/kehiy/kehiy
+
+پروژه react ای:
+https://github.com/dezh-tech/website/blob/main/public/.well-known/nostr.json
+
+پروژه svelte:
+https://github.com/dezh-tech/jellyfish/blob/main/static/.well-known/nostr.json
+
+منبع اصلی آموزش: https://nvk.org/n00b-nip5
+
+
+