Skip to content

Update multi-signatures.md#589

Open
GordonLtron wants to merge 1 commit into
tronprotocol:masterfrom
GordonLtron:Account-Permission-Management
Open

Update multi-signatures.md#589
GordonLtron wants to merge 1 commit into
tronprotocol:masterfrom
GordonLtron:Account-Permission-Management

Conversation

@GordonLtron
Copy link
Copy Markdown
Contributor

Description
This PR enhances the documentation for Account Permission Management. The updates focus on clarifying the hierarchical structure of TRON accounts, the mechanics of threshold-based security, and the bitmask calculation for operational permissions.

Key Changes
1. Security Model Refinement
Threshold Mechanics: Provided a clearer explanation of how Weight vs. Threshold validation works during transaction broadcasting.

2. Technical Specification Updates
Bitmask Calculation: Refined the Java example for calculating operations values, ensuring developers understand the little-endian hexadecimal requirement.
Atomic Transaction Logic: Added a "Warning" block regarding AccountPermissionUpdateContract, noting that partial updates will overwrite omitted permissions.

# Account Permission Management

The TRON network supports fine-grained control of account permissions. By configuring permissions (owner, witness, active), joint control of accounts, secure delegation, and functional permission separation can be achieved. The following document details the account permission model, contract structure, configuration methods, and common interface calls.
The TRON network supports Hierarchical Role-Based Access Control (RBAC) of account permissions. By configuring permissions (owner, witness, active), joint control of accounts, secure delegation, and functional permission separation can be achieved. The following document details the account permission model, contract structure, configuration methods, and common interface calls.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is recommended to stick with the original description; RBAC might not be entirely accurate for TRON.

- This contract is used to **update all account permission structures at once**.
- This contract is used to **update all account permission structures at once**, which is an "all-or-nothing" update. Even if modifying a single permission, the full permission set must be resubmitted to prevent accidental loss of access.
- Even if only one permission is modified, all other existing permissions must be fully specified in the contract.
- `AccountPermissionUpdateContract`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

An extra line?

### 2. Operations Value Calculation Example

`operations` is a 32-byte hexadecimal string (little-endian) representing executable contract permissions.
`operations` field is a 32-byte bitmask where each bit represents a specific `ContractType` , defining the functional scope of an Active permission.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest keeping the little-endian information.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants