Merge branch 'master' into spellingNorm

Author: Benson0224

docs/clients/wallet-cli-command.md

@@ -192,7 +192,7 @@ Balance = 2665198240
 ```
 
 ### UpdateAccountPermission
-该命令用于为其他账户赋予当前账户的部分权限，让其他账户可以在该发起账户下完成多种操作以便实现更复杂的功能及更好的管理账户，经常用于多重签名交易等场景。
+该命令用于管理账户权限，为其他账户赋予当前账户的部分权限，让其他账户可以在该发起账户下完成多种操作以便实现更复杂的功能及更好的管理账户。
 ```shell
 wallet>UpdateAccountPermission [ownerAddress] [permissions]
 ```
@@ -854,12 +854,12 @@ after sign transaction hex string is 0a85010a029ca12208432ed1fe1357ff7f40a2b3a7f
 txid is ece603ec8ad11578450dc8adf29dd9d9833e733c313fe16a947c8c768f1e4483
 Send 10 Sun to TXBpeye7UQ4dDZEnmGDv4vX37mBYDo1tUE successful !!
 ```
-在转账过程中，需要输入`permission_id`，其默认值为0，此时表示该笔交易只需发起人签名即可。 在上面的例子中，我们输入了“2”，表示使用多重签名完成此笔交易，此时需要拥有`actives` 权限的两个账户都签名才能完成交易，请参照[UpdateAccountPermission](#UpdateAccountPermission) 部分的例子，首先由`TB9qhqbev6DpX8mxdf3zDdtSQ6GC6Vb6Ej` 完成签名，此时系统会询问是否继续签名，输入“y”之后，再由`TXBpeye7UQ4dDZEnmGDv4vX37mBYDo1tUE` 完成签名。
+在转账过程中，需要输入`permission_id`，其默认值为0，此时表示该笔交易只需发起人签名即可。 在上面的例子中，我们输入了“2”，表示需要具有ID为2的权限的账户来签名完成此笔交易，此时需要拥有`actives` 权限的两个账户都签名才能完成交易，请参照[UpdateAccountPermission](#UpdateAccountPermission) 部分的例子，首先由`TB9qhqbev6DpX8mxdf3zDdtSQ6GC6Vb6Ej` 完成签名，此时系统会询问是否继续签名，输入“y”之后，再由`TXBpeye7UQ4dDZEnmGDv4vX37mBYDo1tUE` 完成签名。
 
 两个账户的权重各为1，完成多签的权重阀值为2，此时签名条件达成，交易成功。这个例子为使用同一客户端时如何完成多重签名交易。当使用多个客户端时，请参考下面这个命令。
 
 ### AddTransactionSign
-当有多个客户端时，可以使用该命令进行多重签名交易，此时需要交易本体的hex string。
+当有多个客户端时，可以使用该命令为交易添加签名，此时需要交易本体的hex string。
 
 示例：
 ```shell

docs/introduction/overview.md

@@ -63,13 +63,13 @@ votewitness SR1 3 SR2 7 # 同时给SR1投了3票，给SR2投了7票
 只有超级代表对应账户具有提议权，其他账户无法创建提议。允许修改的网络动态参数以及编号如下( [min,max] )：
 
 - 0: MAINTENANCE_TIME_INTERVAL, [3 * 27* 1000 ,24 * 3600 * 1000] //修改超级代表调整时间间隔，目前为6 * 3600 * 1000ms
-- 1: ACCOUNT_UPGRADE_COST, [0,100 000 000 000 000 000]  //修改账户升级为超级代表的费用，目前为9999_000_000 Sun
-- 2: CREATE_ACCOUNT_FEE, [0,100 000 000 000  000 000] // 修改创建账户费用，目前为100_000Sun
+- 1: ACCOUNT_UPGRADE_COST, [0,100 000 000 000 000 000]  //修改账户升级为超级代表的费用，目前为9,999,000,000 Sun
+- 2: CREATE_ACCOUNT_FEE, [0,100 000 000 000  000 000] // 修改创建账户费用，目前为100,000Sun
 - 3: TRANSACTION_FEE, [0,100 000 000 000 000 000] // 修改TRX抵扣带宽的费用，目前为10Sun/byte
-- 4: ASSET_ISSUE_FEE, [0,100 000 000 000 000 000] // 修改资产发行费用，目前为1024_000_000 Sun
-- 5: WITNESS_PAY_PER_BLOCK, [0,100 000 000 000 000 000] // 修改超级代表出块奖励，目前为32_000_000 Sun
-- 6: WITNESS_STANDBY_ALLOWANCE, [0,100 000 000 000 000 000] // 修改分给前127名超级代表候选人的奖励，115_200_000_000 Sun
-- 7: CREATE_NEW_ACCOUNT_FEE_IN_SYSTEM_CONTRACT, []// 修改系统创建账户的费用，目前为1_000_000 Sun
+- 4: ASSET_ISSUE_FEE, [0,100 000 000 000 000 000] // 修改资产发行费用，目前为1,024,000,000 Sun
+- 5: WITNESS_PAY_PER_BLOCK, [0,100 000 000 000 000 000] // 修改超级代表出块奖励，目前为32,000,000 Sun
+- 6: WITNESS_STANDBY_ALLOWANCE, [0,100 000 000 000 000 000] // 修改分给前127名超级代表候选人的奖励，115,200,000,000 Sun
+- 7: CREATE_NEW_ACCOUNT_FEE_IN_SYSTEM_CONTRACT, []// 修改系统创建账户的费用，目前为1,000,000 Sun
 - 8: CREATE_NEW_ACCOUNT_BANDWIDTH_RATE, // 提议7、8，组合使用，用于修改创建账户时对资源或TRX的消耗
 - 9: ALLOW_CREATION_OF_CONTRACTS, // 用于控制虚拟机功能的开启
 - 10: REMOVE_THE_POWER_OF_THE_GR  // 用于清除GR的创世票数
@@ -90,7 +90,7 @@ id0_N: 参数编号
 value0_N: 新参数值
 ```
 
-注：TRON网络中，1 TRX = 1000_000 Sun。
+注：Tron网络中，1 TRX = 1,000,000 Sun。
 
 #### 2.4.3 对提议进行投票
 
@@ -607,7 +607,7 @@ function assignAddress() public view {
 freezeBalancev2 frozen_balance [ResourceCode:0 BANDWIDTH,1 ENERGY]
 ```
 
-通过质押TRX获取的Energy， 额度 = 为获取Energy质押的TRX / 整个网络为获取Energy质押的TRX 总额 * 50_000_000_000。
+通过质押TRX获取的Energy， 额度 = 为获取Energy质押的TRX / 整个网络为获取Energy质押的TRX 总额 * 50,000,000,000。
 也就是所有用户按质押TRX平分固定额度的Energy。
 
 示例：
@@ -617,19 +617,19 @@ freezeBalancev2 frozen_balance [ResourceCode:0 BANDWIDTH,1 ENERGY]
 
 二人质押获得的可用Energy分别是
 
-A: 25_000_000_000 且energy_limit 为25_000_000_000
+A: 25,000,000,000 且energy_limit 为25,000,000,000
 
-B: 25_000_000_000 且energy_limit 为25_000_000_000
+B: 25,000,000,000 且energy_limit 为25,000,000,000
 
 当第三人C质押1TRX时。
 
 三人质押获得的可用Energy调整为
 
-A: 20_000_000_000 且energy_limit调整为20_000_000_000
+A: 20,000,000,000 且energy_limit调整为20,000,000,000
 
-B: 20_000_000_000 且energy_limit调整为20_000_000_000
+B: 20,000,000,000 且energy_limit调整为20,000,000,000
 
-B: 10_000_000_000 且energy_limit 为10_000_000_000
+C: 10,000,000,000 且energy_limit 为10,000,000,000
 
 ```
 
@@ -640,11 +640,11 @@ B: 10_000_000_000 且energy_limit 为10_000_000_000
 示例：
 
 ```text
-在某一时刻A的Energy已使用量为72_000_000 Energy
+在某一时刻A的Energy已使用量为72,000,000 Energy
 
 在没有其他消耗或质押的操作下：
 
-一小时后A的Energy已使用量为 72_000_000 - (72_000_000 * (60*60/60*60*24)) Energy = 69_000_000 Energy
+一小时后A的Energy已使用量为 72,000,000 - (72,000,000 * (60*60/60*60*24)) Energy = 69,000,000 Energy
 
 24小时后A的Energy已使用量为 0 Energy。
 ```
@@ -683,15 +683,15 @@ B: 10_000_000_000 且energy_limit 为10_000_000_000
 
 则，feeLimit的预估方法为：
 
-1). A = 20000 energy * (1 trx / 400 energy) = 50 trx = 50_000_000 sun,
+1). A = 20000 energy * (1 trx / 400 energy) = 50 trx = 50,000,000 sun,
 
-2). B = 20000 energy * (1 trx / 10000 energy) = 2 trx = 2_000_000 sun，
+2). B = 20000 energy * (1 trx / 10000 energy) = 2 trx = 2,000,000 sun，
 
-3).  取A和B的最大值，为50_000_000 sun，
+3).  取A和B的最大值，为50,000,000 sun，
 
 4).  开发者承诺承担90%，用户需要承担10%，
 
-那么，建议用户填写的feeLimit为 50_000_000 sun * 10% = 5_000_000 sun。
+那么，建议用户填写的feeLimit为 50,000,000 sun * 10% = 5,000,000 sun。
 
 小节附录：
 
@@ -1059,7 +1059,7 @@ TRON网络引入了Bandwidth point 和 Energy 两种资源概念。其中Bandwid
 
 Bandwidth Points的获取分两种：
 
-+ 通过质押TRX获取的Bandwidth Points， 额度 = 为获取Bandwidth Points质押的TRX / 整个网络为获取Bandwidth Points质押的TRX 总额 * 43_200_000_000。
++ 通过质押TRX获取的Bandwidth Points， 额度 = 为获取Bandwidth Points质押的TRX / 整个网络为获取Bandwidth Points质押的TRX 总额 * 43,200,000,000。
 也就是所有用户按质押TRX平分固定额度的Bandwidth Points。
 
 + 每个账号每天有固定免费额度的带宽，该额度由波场网络的第#61号参数定义，用户可在tronscan上查看最新的值（https://tronscan.org/#/sr/committee）。
@@ -1244,7 +1244,7 @@ ExchangeWithdraw 1 abc 1000000
 
 交易中token的当前价格信息的计算过程：
 
-假设 first_token 当前的价格为 100 Sun，first_token_balance 为1000_000,second_token_balance 为2000_000，
+假设 first_token 当前的价格为 100 Sun，first_token_balance 为1,000,000,second_token_balance 为2,000,000，
 second_token 当前的价格为 first_token * first_token_balance/second_token_balance = 50 Sun
 first_token的价格可有"first_token&&TRX"交易对计算获得
 
@@ -1254,18 +1254,18 @@ first_token的价格可有"first_token&&TRX"交易对计算获得
 
 sellTokenQuant是要卖出的first_token的金额
 buyTokenQuant是要买入的second_token的金额
-supply = 1_000_000_000_000_000_000L
+supply = 1,000,000,000,000,000,000L
 supplyQuant = -supply *(1.0 - Math.pow(1.0 + (double) sellTokenQuant/（firstTokenBalance + sellTokenQuant）, 0.0005))
 buyTokenQuant = （long）balance* (Math.pow(1.0 + (double) supplyQuant / supply, 2000.0) - 1.0)
 
 注意：由于网络其他账户发生交易，价格可能发生变化。
 
 相关api详情，请查询[TRON HTTP API](../api/http.md)。
 
-## 10. 多重签名
+## 10. 账户权限管理
 
 详细信息请参考:
-[波场多重签名](../mechanism-algorithm/multi-signatures.md)
+[账户权限管理](../mechanism-algorithm/multi-signatures.md)
 
 ## 11. 匿名交易
 

docs/mechanism-algorithm/dex.md

@@ -109,7 +109,7 @@ ExchangeWithdraw 1 abc 1000000
 
 交易中token的当前价格信息的计算过程：
 
-假设 first_token 当前的价格为 100 Sun，first_token_balance 为1000_000, second_token_balance 为2000_000，
+假设 first_token 当前的价格为 100 Sun，first_token_balance 为1,000,000, second_token_balance 为2,000,000，
 
 second_token 当前的价格为 first_token * first_token_balance/second_token_balance = 50 Sun
 
@@ -121,7 +121,7 @@ sellTokenQuant是要卖出的first_token的金额
 
 buyTokenQuant是要买入的second_token的金额
 
-supply = 1_000_000_000_000_000_000L
+supply = 1,000,000,000,000,000,000L
 
 supplyQuant = -supply * (1.0 - Math.pow(1.0 + (double) sellTokenQuant/（firstTokenBalance + sellTokenQuant）, 0.0005))
 

docs/mechanism-algorithm/multi-signatures.md

@@ -1,10 +1,8 @@
-# 多重签名
+# 账户权限管理
 
 ## 背景
 
-多重签名功能允许权限分级，每个权限可以对应多个私钥。这使得实现账户的多人联合控制成为可能。
-
-[TRON multi-signatures TIP](https://github.com/tronprotocol/tips/blob/master/tip-16.md)
+[账户权限管理](https://github.com/tronprotocol/tips/blob/master/tip-16.md)功能允许权限分级，每个权限可以对应多个私钥。这使得实现账户的多人联合控制成为可能。
 
 ## 概念说明
 
@@ -51,10 +49,10 @@ message AccountPermissionUpdateContract {
 }
 ```
 
-`owner_address`：待修改权限的账户的地址
-`owner`：修改后的 owner 权限
-`witness`：修改后的 witness 权限
-`actives`：修改后的 actives 权限
+* `owner_address`：待修改权限的账户的地址
+* `owner`：修改后的 owner 权限
+* `witness`：修改后的 witness 权限
+* `actives`：修改后的 actives 权限
 
 注意：该接口是覆盖原账户权限，因此，如果只想修改owner权限，witness（如果是超级代表账户）及actives的也需要设置。
 
@@ -77,16 +75,16 @@ message Permission {
 }
 ```
 
-`PermissionType`: 权限类型，目前仅支持三种权限
-`id`: 值由系统自动设置，Owner id=0, Witness id=1, Active id 从2开始递增分配。在执行合约时，
+* `PermissionType`: 权限类型，目前仅支持三种权限
+* `id`: 值由系统自动设置，Owner id=0, Witness id=1, Active id 从2开始递增分配。在执行合约时，
 通过该id来指定使用哪个权限，如使用owner权限，即将id设置为0。
-`permission_name`: 权限名称，由用户设定，长度限制为32字节
-`threshold`: 阈值，只有当参与签名的权重之和超过域值才允许做相应的操作。要求小于Long类型的最大值
-`parent_id`：目前只能为0
-`operations`：共32字节（256位），每位代表一个合约的权限，为1时表示拥有该合约的权限。
+* `permission_name`: 权限名称，由用户设定，长度限制为32字节
+* `threshold`: 阈值，只有当参与签名的权重之和超过域值才允许做相应的操作。要求小于Long类型的最大值
+* `parent_id`：目前只能为0
+* `operations`：共32字节（256位），每位代表一个合约的权限，为1时表示拥有该合约的权限。
 如`operations=0x0100...00(十六进制),即100...0(二进制)`时,查看proto中Transaction.ContractType定义，合约AccountCreateContract的id为0，
 即表示该permission只拥有执行AccountCreateContract的权限，可以使用"active权限中operations的计算示例"计算获得。
-`keys`：共同拥有该权限的地址及权重，最多允许5个key。
+* `keys`：共同拥有该权限的地址及权重，最多允许5个key。
 
 #### Key
 
@@ -97,8 +95,8 @@ message Key {
 }
 ```
 
-`address`：拥有该权限的地址
-`weight`：该地址对该权限拥有权重
+* `address`：拥有该权限的地址
+* `weight`：该地址对该权限拥有权重
 
 #### Transaction
 
@@ -117,10 +115,11 @@ message Transaction {
 OwnerPermission是账户的最高权限，用于控制用户的所有权、调整权限结构，Owner权限也可以执行所有合约。
 
 Owner权限具有以下特性：
-1、拥有OwnerPermission的地址可以修改OwnerPermission。
-2、当OwnerPermission为空时，默认采用该账户的地址具有owner权限。
-3、账户新建时，自动将该账户的地址填充到OwnerPermission中，并默认域值为1，keys中仅包含该账户地址且权重为1。
-4、当执行合约时未指定permissionId时， 默认采用OwnerPermission。
+
+1. 拥有OwnerPermission的地址可以修改OwnerPermission。
+2. 当OwnerPermission为空时，默认采用该账户的地址具有owner权限。
+3. 账户新建时，自动将该账户的地址填充到OwnerPermission中，并默认域值为1，keys中仅包含该账户地址且权重为1。
+4. 当执行合约时未指定permissionId时， 默认采用OwnerPermission。
 
 ### Witness权限
 
@@ -129,8 +128,9 @@ Owner权限具有以下特性：
 使用场景示例：一个超级代表在云服务器上部署出块程序，为了账户安全，此时可以将出块权限赋予另一个地址。由于该地址仅具有出块权限，无TRX转出权限，即使该服务器上私钥被泄密，也不会出现TRX丢失。
 
 出块节点的配置：
-1、未修改witness权限时，无需特殊配置。
-2、修改witness权限后的出块节点，需要在重新配置，配置项如下：
+
+1. 未修改witness权限时，无需特殊配置。
+2. 修改witness权限后的出块节点，需要在重新配置，配置项如下：
 
 ```conf
 #config.conf
@@ -158,16 +158,17 @@ localwitness = [
 Active权限，用于提供一个权限的组合，比如提供一个只能执行创建账户、转账功能的权限。
 
 Active权限有以下特性：
-1、拥有OwnerPermission的地址可以修改Active权限
-2、拥有执行AccountPermissionUpdateContract权限的地址也能够修改Active权限
-3、最多支持8个组合。
-4、permission的id从2开始自动递增。
-5、账户新建时，自动创建一个Active权限，并将该账户的地址填充到其中，默认域值为1，keys中仅包含该账户地址且权重为1。
+
+1. 拥有OwnerPermission的地址可以修改Active权限
+2. 拥有执行AccountPermissionUpdateContract权限的地址也能够修改Active权限
+3. 最多支持8个组合。
+4. permission的id从2开始自动递增。
+5. 账户新建时，自动创建一个Active权限，并将该账户的地址填充到其中，默认域值为1，keys中仅包含该账户地址且权重为1。
 
 ### 费用
 
 1. 使用更新账户权限时，即 AccountPermissionUpdate 合约，收取100TRX。
-2. 使用多重签名的交易时，即交易中包括两个及两个以上签名的交易，除交易费用外，另收取1TRX。
+2. 交易中包括两个及两个以上签名时，除交易费用外，另收取1TRX。
 3. 可通过提议，修改以上费用。
 
 ## API
@@ -176,10 +177,10 @@ Active权限有以下特性：
 
 `AccountPermissionUpdateContract`，修改权限步骤如下：
 
-1、使用接口`getaccount`查询账户，并获取原权限
-2、修改permission
-3、创建合约，签名
-4、发送交易
+1. 使用接口`getaccount`查询账户，并获取原权限
+2. 修改permission
+3. 创建合约，签名
+4. 发送交易
 
 ### http-demo
 
@@ -265,17 +266,17 @@ public static void main(String[] args) {
 
 ### 执行合约
 
-1、创建交易，与非多重签名交易的构建过程相同
-2、指定Permission_id，默认为0，表示owner-permission, [demo](https://github.com/tronprotocol/wallet-cli/commit/ff9122f2236f1ce19cbb9ba9f0494c8923a3d10c#diff-a63fa7484f62fe1d8fb27276c991a4e3R211)
-3、用户A签名，将签名后交易通过其他方式发送给B。
-4、用户B签名，将签名后交易通过其他方式发送给C。
+1. 创建交易，与非多重签名交易的构建过程相同
+2. 指定Permission_id，默认为0，表示owner-permission, [demo](https://github.com/tronprotocol/wallet-cli/commit/ff9122f2236f1ce19cbb9ba9f0494c8923a3d10c#diff-a63fa7484f62fe1d8fb27276c991a4e3R211)
+3. 用户A签名，将签名后交易通过其他方式发送给B。
+4. 用户B签名，将签名后交易通过其他方式发送给C。
+
 …
-n、最后一个完成签名的用户，将交易广播到节点。
-n+1、验证多重签名的权重之和大于域值则接受交易，否则拒绝交易
 
-代码示例：
+n. 最后一个完成签名的用户，将交易广播到节点。
+
+n+1. 节点验证所有签名的权重之和，如果大于等于域值则接受交易，否则拒绝交易
 
-[多重签名示例](https://github.com/tronprotocol/wallet-cli/blob/multi_sign_V2/src/main/java/org/tron/demo/MultiSignDemo.java)
 
 ### 其他相关接口