<!-- AUTO-GENERATED by scripts/generate-cli-docs.ts — do not edit. Regenerate: yarn docs:gen -->

# pop role

Authority roles and membership

## pop role list

List current authority roles

```text
pop role list [flags]
```

## pop role status

Inspect membership, rules and permission rows for a role

```text
pop role status [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID |
| `--user` | string | no | - | Filter memberships by wallet address |

## pop role pending

List delegated actions and their review windows

```text
pop role pending [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--all` | boolean | no | `false` | Include finalized, cancelled and voided actions |
| `--subject` | string | no | - | Filter by authority subject ID |
| `--user` | string | no | - | Filter by target wallet address |

## pop role create

Propose creation of an authority role

```text
pop role create [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--image` | string | no | `""` | Image URI |
| `--max-members` | number | no | `0` | Member cap (0 = unlimited) |
| `--metadata-hash` | string | no | `0x0000000000000000000000000000000000000000000000000000000000000000` | IPFS SHA-256 digest (bytes32) |
| `--name` | string | yes | - | Subject name |

## pop role claim

claim your role membership

```text
pop role claim [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role renounce

renounce your role membership

```text
pop role renounce [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role grant

Propose a role grant

```text
pop role grant [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--delegable` | boolean | no | `false` | Allow delegated managers to clear this governance grant |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role offer

Propose a role offer

```text
pop role offer [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--delegable` | boolean | no | `false` | Allow delegated managers to clear this governance grant |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role remove

Propose member removal

```text
pop role remove [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--ban` | boolean | no | `false` | Ban membership instead of attempting soft removal |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role unremove

Propose unremove

```text
pop role unremove [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role withdraw-offer

Propose withdraw-offer

```text
pop role withdraw-offer [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role clear-rule

Propose clear-rule

```text
pop role clear-rule [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role set-rule

Propose an explicit grant or ban rule

```text
pop role set-rule [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--delegable` | boolean | no | `false` | - |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--kind` | string | yes | - | Choices: `none`, `grant`, `ban` |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role set-default

Propose default role eligibility

```text
pop role set-default [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--allow` | boolean | yes | - | - |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--force` | boolean | no | `false` | Permit closing a role with accepted members |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role rename

Rename an authority subject using SUBJECT_RENAME permission or governance

```text
pop role rename [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--governance` | boolean | no | `false` | Propose this action for execution by organization governance |
| `--image` | string | no | `""` | Image URI |
| `--metadata-hash` | string | no | `0x0000000000000000000000000000000000000000000000000000000000000000` | IPFS SHA-256 digest (bytes32) |
| `--name` | string | yes | - | Subject name |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role set-max-members

Propose the role membership cap

```text
pop role set-max-members [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--max-members` | number | yes | - | - |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role set-manager

Propose manager delegation for a subject

```text
pop role set-manager [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--caps` | number | yes | - | Capability mask: 1 grant/offer, 2 remove |
| `--delay` | number | no | `0` | Review delay in seconds |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--manager` | string | yes | - | Manager subject ID (0 clears delegation) |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role delegate-grant

delegate-grant through configured manager authority

```text
pop role delegate-grant [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role delegate-offer

delegate-offer through configured manager authority

```text
pop role delegate-offer [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role delegate-unremove

delegate-unremove through configured manager authority

```text
pop role delegate-unremove [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role delegate-remove

Queue delegated member removal

```text
pop role delegate-remove [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--ban` | boolean | no | `false` | - |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role finalize

finalize a pending delegated action

```text
pop role finalize [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--pending` | string | yes | - | Authority pending action ID |

## pop role cancel

cancel a pending delegated action

```text
pop role cancel [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--governance` | boolean | no | `false` | Propose this action for execution by organization governance |
| `--pending` | string | yes | - | Authority pending action ID |

## pop role reconcile

Repair a lapsed membership

```text
pop role reconcile [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--user` | string | yes | - | Member wallet address |

## pop role set-perm

Propose an authority permission row

```text
pop role set-perm [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--context` | string | no | `0x0000000000000000000000000000000000000000000000000000000000000000` | bytes32 context (global is zero; task project context is projectId + 1) |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--inherit-global` | boolean | no | `false` | - |
| `--key` | string | yes | - | Semantic key name (DD_VOTE, PT_MEMBER, etc.) or bytes32 key |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |
| `--value` | string | yes | - | Permission value without flag bits |

## pop role clear-perm

Propose clearing an authority permission row

```text
pop role clear-perm [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--context` | string | no | `0x0000000000000000000000000000000000000000000000000000000000000000` | - |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--key` | string | yes | - | - |
| `--subject` | string | yes | - | Authority subject ID (adopted role IDs keep their historical value) |

## pop role set-paused

Propose pausing or unpausing non-governance authority writes

```text
pop role set-paused [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--duration` | number | no | `60` | Governance vote duration in minutes |
| `--paused` | boolean | yes | - | - |

_Global flags: --org, --chain, --rpc, --json, --address, --private-key, --dry-run, --yes, --verbose, --quiet, --preflight (see [index.md](index.md))_