list

فهرست کردن تمام بازبینی‌های سند هویت.

update

پیشنهاد یک بازبینی جدید برای سند هویت. بازبینی‌ها علاوه بر سند هویت به‌روزشده پیشنهادی، درست مانند کامیت‌های کد منبع دارای یک عنوان و توضیحات هستند.

اگر عنوان و توضیحات در خط فرمان مشخص نشوند، از شما خواسته می‌شود که از طریق ویرایشگر متنی خود آن‌ها را وارد کنید.

توجه داشته باشید که اگر شما تنها نمایندهٔ مخزن باشید، تغییرات پیشنهادی به‌طور خودکار پذیرفته شده و در سند هویت گنجانده می‌شوند.

--title <string>

--description <string>

--delegate <did>

--rescind <did>

--threshold <num>

--visibility <private> | <public>

--allow <did>

--disallow <did>

--payload <id> <key> <val>

--no-confirm

--edit

edit

ویرایش یک بازبینی موجود از سند هویت. بازبینی باید همچنان در وضعیت «فعال» (active) باشد. همان گزینه‌های موجود برای update در اینجا نیز در دسترس هستند. توجه داشته باشید که این دستور یک بازبینی پیشنهادی هویت را ویرایش می‌کند؛ برای ویرایش خود سند هویت، از update استفاده کنید.

show

نمایش یک بازبینی مشخص از سند هویت.

accept

پذیرفتن یک بازبینی پیشنهادی برای سند هویت. بازبینی باید در وضعیت «فعال» (active) بوده و فراخواننده باید یک نماینده باشد.

reject

رد کردن یک بازبینی پیشنهادی برای سند هویت. بازبینی باید در وضعیت «فعال» (active) بوده و فراخواننده باید یک نماینده باشد.

redact

حذف یا بازپس‌گیری (redact) یک بازبینی موجود از سند هویت. بازبینی نباید در وضعیت «پذیرفته‌شده» (accepted) باشد و فراخواننده باید نویسندهٔ بازبینی باشد.

افزودن یک نماینده (Adding a delegate)

برای افزودن یک نماینده جدید به مخزن و به‌روزرسانی حد نصاب، از دستور update استفاده کنید:

$ rad id update --title "Add Bob" --description "Add Bob as a delegate" \
    --delegate did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk \
    --threshold 2

این دستور بازبینی جدیدی ایجاد می‌کند که پیشنهاد افزودن نمایندهٔ مشخص‌شده با DID ارائه‌شده را ثبت کرده و حد نصاب را روی 2 قرار می‌دهد، به این معنی که دو نماینده باید تغییرات بعدی هویت را امضا و تایید کنند.

تغییر میزان پدیداری مخزن (Changing repository visibility)

برای تغییر وضعیت یک مخزن از عمومی به خصوصی:

$ rad id update --visibility private

توجه داشته باشید که برای اعمال این تغییر، نیاز به پذیرش توسط حد نصاب نمایندگان وجود دارد.

تغییر یک محموله مخزن (Changing a repository payload)

تغییر نام و توضیحات یک مخزن معمولاً از طریق محمولهٔ xyz.radicle.project انجام می‌شود:

$ rad id update --title "Update title and description" \
    --description "Improve clarity" \
    --payload xyz.radicle.project name '"radicle-beans"' \
    --payload xyz.radicle.project description '"Tasty Radicle beans"'

توجه داشته باشید که مقادیر ارائه‌شده به --payload، مانند "radicle-beans"، باید مقادیر معتبر JSON باشند. این به این معنی است که رشته‌ها باید همان‌طور که در مثال بالا نشان داده شده است، درون علامت نقل‌قول دوتایی (double quotes) قرار گیرند.

حذف یک نماینده (Removing a delegate)

برای حذف یک نماینده و به‌روزرسانی حد نصاب، از گزینهٔ --rescind استفاده کنید:

$ rad id update --title "Remove Bob" \
    --description "Bob is no longer a delegate" \
    --rescind did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk \
    --threshold 1

همانند افزودن یک نماینده، این تغییر نیز نیازمند تایید نمایندگان باقی‌مانده است. هنگام حذف نمایندگان، مطمئن شوید که حد نصاب جدید مناسبی تعیین می‌کنید!

افزودن قوانین ارجاع‌های رسمی (Adding Canonical References Rules)

برای به‌روزرسانی قوانین ارجاع‌های رسمی پروژه، هنگام به‌روزرسانی از گزینهٔ --payload xyz.radicle.crefs با کلید rules و شیء حاوی قوانین به عنوان مقدار استفاده کنید. نمونه‌ای از آن در ادامه آورده شده است:

$ rad id update --title "Update canonical reference rules" \
    --payload xyz.radicle.crefs rules '{
          "refs/heads/master": { "threshold": 1, "allow": "delegates" },
          "refs/tags/*": { "threshold": 2, "allow": "delegates" },
          "refs/tags/qa/*": { "threshold": 1, "allow": "delegates" }
      }'

علاوه بر این، می‌توانید از گزینهٔ --edit در دستور update استفاده کرده و محموله را مستقیماً ویرایش کنید. نمونه‌ای از آنچه مشاهده خواهید کرد به این صورت است:

{
  "payload": {
    "xyz.radicle.crefs": {
      "rules": {
        "refs/heads/master": {
          "allow": "delegates",
          "threshold": 1
        },
        "refs/tags/*": {
          "allow": "delegates",
          "threshold": 1
        },
        "refs/tags/qa/*": {
          "allow": "delegates",
          "threshold": 1
        }
      }
    },
    "xyz.radicle.project": {
      "defaultBranch": "master",
      "description": "Radicle Heartwood Protocol & Stack",
      "name": "heartwood"
    }
  },
  "delegates": [
    "did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi"
  ],
  "threshold": 1
}