You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit fc1ecd7
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: @l10n/ru/docs/protocol/operations/agent-access.md
+7-2Lines changed: 7 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -62,16 +62,21 @@
62
62
63
63
## Правила
64
64
65
-
-**Не делегируются никогда:**`set_agent_permission`, `proposal_create`, `proposal_update`, `proposal_delete`, `account_update`, `recover_account`, `change_recovery_account`, `set_account_price`, `set_subaccount_price`, `target_account_sale`. Виртуальные операции и устаревшие алиасы (писать `validator_update`, а не `witness_update`) отвергаются.
65
+
-**Не делегируются никогда:**`set_agent_permission`, `proposal_update`, `account_update`, `recover_account`, `change_recovery_account`, `set_account_price`, `set_subaccount_price`, `target_account_sale`. Виртуальные операции и устаревшие алиасы (писать `validator_update`, а не `witness_update`) отвергаются.
66
66
-**Один ключ — один агент:** ключ, уже привязанный к другому имени того же принципала, отвергается.
67
67
-**Не больше 16 агентов** на принципала. Выдача сначала удаляет его истёкших агентов.
68
-
-**Когда подпись агента засчитывается:** транзакции не нужны master- и regular-подписи, собственные ключи принципала её не подписывают, агент жив (срок не истёк, список операций не пуст), его список покрывает **каждую** операцию транзакции, которой нужна подпись, и его ключ есть среди подписей. Через вложенные `account_auths` доступа нет.
68
+
-**Дополнительные возможности, не исправления:** явная выдача разрешает прямые требования **active и regular**. Область проверяется по операции и принципалу: агент Alice с `transfer` не обязан иметь `custom` Bob, подписанный отдельно; собственная невыданная операция Alice запрещена. Сначала проверяются обычные полномочия, включая master; лишние подписи по-прежнему отвергаются. Смешивать regular с active/master нельзя.
69
+
-**Без повышения полномочий:** агент не заменяет master, произвольные `other` или вложенные `account_auths`. Его доказательство не становится одобрением аккаунта для другого требования транзакции.
70
+
-**Предложения:** явно выданный `proposal_create` лишь сохраняет предложение, даже с невыданными внутренними операциями: **одобрения пусты**, ничего не исполняется. `proposal_delete` разрешает вето только с проверками requester существующего evaluator. `proposal_update` запрещён: подпись агента не создаёт постоянное одобрение предложения ни аккаунтом, ни ключом.
71
+
-**Отзыв при применении:** только агентские доказательства перепроверяются непосредственно перед соответствующей операцией. Предшествующий отзыв, ограничение списка, замена ключа или стирание агентов отменяет такое доказательство. Обычные полномочия проверяются на входе; привычная смена ключей с последующим использованием в той же транзакции сохраняется.
69
72
-**Удаление:** все агенты принципала стираются при смене master, смене active, восстановлении аккаунта, прямой продаже и закрытии аукциона. Смена только regular их не трогает. «Смена» — это **наличие** поля в `account_update`: если в операции есть `master` или `active`, агенты стираются даже при том же ключе. Клиент, который правит только regular или memo, обязан не передавать `master`/`active` (в viz-php-lib `build_account_update` передайте `null` для роли, чтобы её не слать).
70
73
71
74
## Чтение агентов
72
75
73
76
`database_api.get_agent_permissions(account)` — см. [database_api](../../plugins/database-api.md#get-agent-permissions-account).
74
77
78
+
`get_potential_signatures` возвращает ключи-кандидаты, включая обычный fallback к active/master и явно выданные ключи агентов; это не разрешение операции. `get_required_signatures` возвращает доступные подписи-вклады, даже если независимому аккаунту или явной authority ещё не хватает подписей. Уже подписанные ключи исключаются; ключ агента учитывается только при покрытии всех прямых требований своего аккаунта. Частичные обычные multisig-подписи сохраняются. Подбор подписей не означает принятие транзакции: `verify_authority` и применение по-прежнему требуют все полномочия и проверяют границы гранта.
79
+
75
80
## В кошельках
76
81
77
82
**Выдача (принципал).** WebVIZWallet → *Агенты*: имя агента, публичный ключ (кнопка *Сгенерировать* создаёт новую пару — приватный ключ сохраните, он показывается один раз), галочки разрешённых операций, срок (*бессрочно* или дата), addons строкой через запятую. На странице — список текущих агентов с кнопкой *Отозвать*. Выдача подписывается **active**-ключом принципала. Vizonator даёт ту же операцию сайтам через `window.vizonator`, всегда через окно подтверждения с ключом, операциями, сроком и addons.
Copy file name to clipboardExpand all lines: docs/protocol/operations/agent-access.md
+7-2Lines changed: 7 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -62,16 +62,21 @@ Re-issuing by the same name replaces the key, operations, addons and expiration
62
62
63
63
## Rules
64
64
65
-
-**Never delegable:**`set_agent_permission`, `proposal_create`, `proposal_update`, `proposal_delete`, `account_update`, `recover_account`, `change_recovery_account`, `set_account_price`, `set_subaccount_price`, `target_account_sale`. Virtual operations and deprecated aliases (use `validator_update`, not `witness_update`) are rejected.
65
+
-**Never delegable:**`set_agent_permission`, `proposal_update`, `account_update`, `recover_account`, `change_recovery_account`, `set_account_price`, `set_subaccount_price`, `target_account_sale`. Virtual operations and deprecated aliases (use `validator_update`, not `witness_update`) are rejected.
66
66
-**One key, one agent:** a key already bound to another agent name of the same principal is rejected.
67
67
-**At most 16 agents** per principal. A grant first removes the principal's expired agents.
68
-
-**When an agent signature counts:** the transaction needs no master or regular authority, the principal's own keys do not already sign it, the agent is live (not expired, operation list non-empty), its list covers **every** operation of the transaction that needs a signature, and its key is among the signatures. No reach through nested `account_auths`.
68
+
-**Optional capabilities, not correctness fixes:** explicit grants may satisfy direct top-level **active or regular** requirements. Coverage is per operation and principal: an Alice `transfer` grant need not cover Bob's separately signed `custom`, but Alice's own ungranted operation is still rejected. Ordinary authority is tried first, including master fallback; unused extra signatures remain invalid. Legacy prohibition on mixing regular with active/master operations remains.
69
+
-**No authority escalation:** agents never satisfy master, arbitrary `other` authorities or nested `account_auths`. A successful agent proof is not an account approval and cannot authorize another account in the same transaction.
70
+
-**Proposals:** explicit `proposal_create` permits storing a proposal, even with ungranted inner operations, but creates **no approvals** and executes nothing. Explicit `proposal_delete` permits a veto only when the unchanged evaluator accepts the requester. `proposal_update` remains denied: agent proofs never become persistent proposal approval, including account or key approvals.
71
+
-**Apply-time revocation:** agent-dependent requirements are rechecked immediately before their operation. A preceding revoke, grant restriction, key replacement or authority wipe cannot leave an entry-time agent proof usable. Ordinary entry-time authority proofs are not rechecked; ordinary rotate-and-use behavior is unchanged.
69
72
-**Wipes:** all agents of the principal are removed on master change, active change, account recovery, direct sale and auction close. A regular-only change keeps them. "Change" means the field is **present** in `account_update`: sending `master` or `active` wipes the agents even if the key is the same, so a client that only edits regular or memo must leave `master`/`active` out of the operation (in viz-php-lib `build_account_update` pass `null` for a role to leave it out).
70
73
71
74
## Reading agents
72
75
73
76
`database_api.get_agent_permissions(account)` — see [database_api](../../plugins/database-api.md#get-agent-permissions-account).
74
77
78
+
`get_potential_signatures` returns candidate keys, including ordinary active/master fallback and directly granted agent keys; it is not an authorization decision. `get_required_signatures` returns available contributions, even when an independent principal or explicit authority is still missing. It excludes keys already signed and only counts an agent when its grants cover every direct requirement of that principal; ordinary partial multisig contributions remain discoverable. Discovery is not acceptance: `verify_authority` and transaction application still require all authorities and enforce the actual grant scope.
79
+
75
80
## In wallets
76
81
77
82
**Granting (principal).** WebVIZWallet → *Agents*: agent name, public key (the *Generate* button creates a fresh pair — save the private key, it is shown once), tick the allowed operations, expiration (*perpetual* or a date), addons as a comma-separated list. The page lists current agents with a *Revoke* button. The grant is signed by the principal's **active** key. Vizonator exposes the same operation to sites through `window.vizonator`, always behind a confirmation window that shows the key, operations, expiration and addons.
0 commit comments