![]() |
![]()
| ![]() |
![]()
NAMErad-id - Manage changes to a Radicle repository's identity. SYNOPSISrad id [<option>...]
DESCRIPTIONThe rad id command is used to manage and propose changes to the identity of a Radicle repository. Each repository has an associated identity document that contains metadata such as the repository name, description, and delegates. The identity document is versioned and changes to it must be signed by a quorum of delegates. The identity document is stored as a Canonical JSON document. COMMANDSWith no arguments, rad id defaults to the list command, showing the list of revisions to the identity of the current repository. listLists all revisions to the identity document. updateProposes a new revision to the identity document. Revisions have a title and a description in addition to the proposed updated identity document, just like source code commits. If a title and description are not provided on the command line, you will be prompted to enter one via your text editor. Note that if you are the repository’s only delegate, proposed changes will be automatically accepted and included into the identity document. --title <string> Set the title for the new revision.
--description <string> Set the description for the new revision.
--delegate <did> Update the identity by adding a new delegate, identified
by their DID.
--rescind <did> Update the identity by removing a delegate identified by
their DID.
--threshold <num> Update the identity by setting the number of delegates
required to accept a revision.
--visibility <private> | <public> Update the identity by setting the repository visibility
to private or public.
--allow <did> Update the identity by giving a specific peer access to a
private repository.
--disallow <did> Update the identity by removing a specific peer’s
access to a private repository. Note that the peer could have the contents of
the repository up until the point that access was revoked.
--payload <id> <key> <val> Update the identity by setting metadata in one of the
identity payloads. This can be used to update a repository’s project
name or description, for example. To delete a field from a payload, simply set
it to null.
--no-confirm Don’t ask for confirmation before creating the
revision.
--edit Opens your $EDITOR to edit the JSON contents
directly.
editEdit an existing revision to the identity document. The revision must still be in the "active" state. The same options as for update are available. Note that this edits a proposed revision to the identity; to edit the identity document itself, use update. showShow a specific revision of the identity document. acceptAccept a proposed revision to the identity document. The revision must be in the "active" state and the caller must be a delegate. rejectReject a proposed revision to the identity document. The revision must be in the "active" state and the caller must be a delegate. redactRedact an existing revision to the identity document. The revision must not be in the "accepted" state and the caller must be the author of the revision. OPTIONS--repo <rid> Specify the repository to operate on. Defaults to the
current repository.
--quiet, -q Suppress output.
--help Print help information.
EXAMPLESAdding a delegateTo add a new delegate to a repository and update the threshold, use the update command: $ rad id update --title "Add Bob" --description "Add Bob as a delegate" \ This will create a new revision proposing to add the delegate identified by the given DID and set the threshold to 2, meaning two delegates must sign off on future identity changes. Changing repository visibilityTo change a repository from public to private: $ rad id update --visibility private Note that this will require acceptance from a quorum of delegates to take effect. Changing a repository payloadTo change a repository’s name and description, this is usually done through the xyz.radicle.project payload: $ rad id update --title "Update title and description" \ Note that the values passed to --payload, eg. "radicle-beans" must be valid JSON values. This means that strings should be double quoted, as in the example above. Removing a delegateTo remove a delegate and update the threshold, use the --rescind option: $ rad id update --title "Remove Bob" \ As with adding a delegate, this change will require approval from the remaining delegates. Make sure you set an appropriate new threshold when removing delegates! AUTHORThe Radicle Team
|