Merge pull request tronprotocol#150 from vivian-kang/master

Update history.md
a519623897 · Jul 6, 2023 · 4ad5e8b · 4ad5e8b
2 parents ea81612 + b08c9c2
commit 4ad5e8b
Show file tree

Hide file tree

Showing 3 changed files with 44 additions and 11 deletions.
diff --git a/docs/api/http.md b/docs/api/http.md
@@ -322,6 +322,7 @@ curl -X POST  http://127.0.0.1:8090/wallet/getapprovedlist -d '{
 - [wallet/getdelegatedresourceaccountindex](#walletgetdelegatedresourceaccountindex)
 - [wallet/freezebalancev2](#walletfreezebalancev2)
 - [wallet/unfreezebalancev2](#walletunfreezebalancev2)
+- [wallet/cancelallunfreezev2](#walletcancelallunfreezev2)
 - [wallet/delegateresource](#walletdelegateresource)
 - [wallet/undelegateresource](#walletundelegateresource)
 - [wallet/withdrawexpireunfreeze](#walletwithdrawexpireunfreeze)
@@ -452,6 +453,25 @@ curl -X POST http://127.0.0.1:8090/wallet/unfreezebalancev2 -d
 
 返回值：未签名的交易对象
 
+#### wallet/cancelallunfreezev2
+
+作用： 取消所有未完成的解质押，将过期的解质押金额提取到账户余额中，将未过期的解质押金额重新质押
+
+```
+curl -X POST http://127.0.0.1:8090/wallet/cancelallunfreezev2 -d
+'{
+    "owner_address": "41e472f387585c2b58bc2c9bb4492bc1f17342cd1"
+}'
+```
+
+参数：
+
+- `owner_address`: 账户地址, HEX 格式或 Base58check 格式
+- `permission_id`: 可选参数，多重签名时使用
+
+返回值：未签名的交易对象
+
+
 #### wallet/delegateresource
 
 作用： 将带宽或者能量资源代理给其它账户
@@ -474,6 +494,7 @@ curl -X POST http://127.0.0.1:8090/wallet/delegateresource -d
 - `balance`: 代理balance数量的TRX所对应的资源给目标地址, 单位为sun
 - `resource`: 代理的资源类型, BANDWIDTH 或者 ENERGY
 - `lock`: true表示为该资源代理操作设置三天的锁定期，即资源代理给目标地址后的三天内不可以取消对其的资源代理，如果锁定期内，再次代理资源给同一目标地址，则锁定期将重新设置为3天。false表示本次资源代理没有锁定期，可随时取消对目标地址的资源代理
+- `lock_period`: 锁定周期，以区块时间（3s）为单位，表示锁定多少个区块的时间，当lock为true时，该字段有效。如果代理锁定期为1天，则lock_period为：28800
 - `permission_id`: 可选参数，多重签名时使用
 
 返回值：未签名的交易对象
@@ -899,6 +920,7 @@ curl -X POST  http://127.0.0.1:8090/wallet/triggersmartcontract -d '{"contract_a
 - `contract_address`，默认为hexString格式
 - `function_selector`，函数签名，不能有空格
 - `parameter`：调用参数[1,2]的虚拟机格式，使用remix提供的js工具，将合约调用者调用的参数数组[1,2]转化为虚拟机所需要的参数格式
+- `data`：与智能合约进行交互的数据，包括所调用的合约函数和参数。可以选择通过该字段，也可以选择通过function_selector和parameter进行合约交互，当data与function_selector同时存在时，使用function_selector进行合约交互
 - `fee_limit`：最大消耗的SUN（1TRX = 1,000,000SUN）
 - `call_value`：本次调用往合约转账的SUN（1TRX = 1,000,000SUN）
 - `owner_address`：发起triggercontract的账户地址，默认为hexString格式
@@ -912,16 +934,19 @@ curl -X POST  http://127.0.0.1:8090/wallet/triggersmartcontract -d '{"contract_a
 #### wallet/triggerconstantcontract
 作用：调用常量合约，产生的交易不上链
 ```
-curl -X POST  http://127.0.0.1:8090/wallet/triggerconstantcontract -d '{"contract_address":"4189139CB1387AF85E3D24E212A008AC974967E561","function_selector":"set(uint256,uint256)","parameter":"00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002","fee_limit":10,"call_value":100,"owner_address":"41D1E7A6BC354106CB410E65FF8B181C600FF14292"}'
+curl -X POST  http://127.0.0.1:8090/wallet/triggerconstantcontract -d '{"contract_address":"4189139CB1387AF85E3D24E212A008AC974967E561","function_selector":"set(uint256,uint256)","parameter":"00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002","call_value":100,"owner_address":"41D1E7A6BC354106CB410E65FF8B181C600FF14292"}'
 ```
 参数说明：
 
 - `contract_address`，默认为hexString格式
 - `function_selector`，函数签名，不能有空格
 - `parameter`：调用参数[1,2]的虚拟机格式，使用remix提供的js工具，将合约调用者调用的参数数组[1,2]转化为虚拟机所需要的参数格式
-- `fee_limit`：最大消耗的SUN（1TRX = 1,000,000SUN）
+- `data`：合约字节码或者与智能合约进行交互的数据，包括所调用的合约函数和参数。可以选择通过该字段，也可以选择通过function_selector和parameter进行合约交互，当data与function_selector同时存在时，优先使用function_selector
 - `owner_address`：发起triggercontract的账户地址，默认为hexString格式
-- `Permission_id`可选参数，多重签名时使用，设置交易多重签名时使用的permissionId
+- `call_value`：本次调用往合约转账的SUN（1TRX = 1,000,000SUN）
+- `call_token_value`:本次调用往合约中转账10币的数量，如果不设置token_id，这项设置为0或者不设置
+- `token_id`:本次调用往合约中转账10币的id，如果没有，不需要设置
+
 
 返回值：TransactionExtention, TransactionExtention中包含未签名的交易Transaction
 
@@ -987,9 +1012,12 @@ curl -X POST  http://127.0.0.1:8090/wallet/estimateenergy -d '{
 - `contract_address`，默认为hexString格式
 - `function_selector`，函数签名，不能有空格
 - `parameter`：调用参数[1,2]的虚拟机格式，使用remix提供的js工具，将合约调用者调用的参数数组[1,2]转化为虚拟机所需要的参数格式
+- `data`：合约字节码或者与智能合约进行交互的数据，包括所调用的合约函数和参数。可以选择通过该字段，也可以选择通过function_selector和parameter进行合约交互，当data与function_selector同时存在时，优先使用function_selector
 - `fee_limit`：最大消耗的SUN（1TRX = 1,000,000SUN）
 - `owner_address`：发起triggercontract的账户地址，默认为hexString格式
-- `Permission_id`可选参数，多重签名时使用，设置交易多重签名时使用的permissionId
+- `call_value`：本次调用往合约转账的SUN（1TRX = 1,000,000SUN）
+- `call_token_value`:本次调用往合约中转账10币的数量，如果不设置token_id，这项设置为0或者不设置
+- `token_id`:本次调用往合约中转账10币的id，如果没有，不需要设置
 
 返回值：能量预估值
 

diff --git a/docs/api/rpc.md b/docs/api/rpc.md
@@ -501,20 +501,25 @@ rpc UnDelegateResource (UnDelegateResourceContract) returns (TransactionExtentio
 Nodes: FullNode
 
 
-**77.&nbsp;Query transaction information in the pending pool**
+**78.&nbsp;Query transaction information in the pending pool**
 ```
 rpc GetTransactionFromPending (BytesMessage) returns (Transaction) {};
 ```
 Nodes: FullNode
 
-**78.&nbsp;Query the pending pool transaction id list**
+**79.&nbsp;Query the pending pool transaction id list**
 ```
 rpc GetTransactionListFromPending (EmptyMessage) returns (TransactionIdList) {};
 ```
 Nodes: FullNode
 
-**79.&nbsp;Query the size of the pending pool**
+**80.&nbsp;Query the size of the pending pool**
 ```
 rpc GetPendingSize (EmptyMessage) returns (NumberMessage) {};
 Nodes: FullNode
 ```
+**81.&nbsp; Cancel UnFreeze**
+```protobuf
+rpc CancelAllUnfreezeV2 (CancelAllUnfreezeV2Contract) returns (TransactionExtention) {}
+```
+Nodes: FullNode
diff --git a/docs/releases/history.md b/docs/releases/history.md
@@ -262,7 +262,7 @@ rate.limiter.global.ip.qps = 5
 
 
 #### 2. 优化智能合约调用相关HTTP接口
-Periander版本优化了智能合约调用相关HTTP接口 triggersmartcontract 、 triggerconstantcontract 和 estimateenergy，新增了`call_data`参数。该优化不但实现了直接通过交易中的`data`数据进行合约调用，而且还使得triggerconstantcontract 、estimateenergy接口可以预估智能合约部署交易的能量消耗，大幅提高了智能合约开发的便利性。
+Periander版本优化了智能合约调用相关HTTP接口 triggersmartcontract 、 triggerconstantcontract 和 estimateenergy，新增了`data`参数。该优化不但实现了直接通过交易中的`data`数据进行合约调用，而且还使得triggerconstantcontract 、estimateenergy接口可以预估智能合约部署交易的能量消耗，大幅提高了智能合约开发的便利性。
 
 * 使用`function_selector`和`parameter`进行合约调用
     
@@ -282,7 +282,7 @@ Periander版本优化了智能合约调用相关HTTP接口 triggersmartcontract
     '
     ```
 
-* 使用`call_data`进行合约调用
+* 使用`data`进行合约调用
     ```
     curl --request POST \
      --url https://api.shasta.trongrid.io/wallet/triggersmartcontract \
@@ -292,7 +292,7 @@ Periander版本优化了智能合约调用相关HTTP接口 triggersmartcontract
     {
       "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
       "contract_address": "TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs",
-      "call_data": "70a08231000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
+      "data": "70a08231000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
       "visible": true
     }'
     ```
@@ -306,7 +306,7 @@ Periander版本优化了智能合约调用相关HTTP接口 triggersmartcontract
      --data '
     {
       "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
-      "call_data": "608060405234801561001057600080fd5b50d3801561001d57600080fd5b50d2801561002a57600080fd5b506101c18061003a6000396000f3fe608060405234801561001057600080fd5b50d3801561001d57600080fd5b50d2801561002a57600080fd5b50600436106100455760003560e01c8063f8b2cb4f1461004a575b600080fd5b610064600480360381019061005f919061012a565b61007a565b6040516100719190610170565b60405180910390f35b60008173ffffffffffffffffffffffffffffffffffffffff16319050919050565b600080fd5b600074ffffffffffffffffffffffffffffffffffffffffff82169050919050565b6100ca816100a0565b81146100d557600080fd5b50565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610103826100d8565b9050919050565b600081359050610119816100c1565b610122816100f8565b905092915050565b6000602082840312156101405761013f61009b565b5b600061014e8482850161010a565b91505092915050565b6000819050919050565b61016a81610157565b82525050565b60006020820190506101856000830184610161565b9291505056fea26474726f6e58221220839f9be3efc349a3efd6bb491d0bee7bc34d86313c73f6e6eeddc4719ec69c0064736f6c63430008120033",
+      "data": "608060405234801561001057600080fd5b50d3801561001d57600080fd5b50d2801561002a57600080fd5b506101c18061003a6000396000f3fe608060405234801561001057600080fd5b50d3801561001d57600080fd5b50d2801561002a57600080fd5b50600436106100455760003560e01c8063f8b2cb4f1461004a575b600080fd5b610064600480360381019061005f919061012a565b61007a565b6040516100719190610170565b60405180910390f35b60008173ffffffffffffffffffffffffffffffffffffffff16319050919050565b600080fd5b600074ffffffffffffffffffffffffffffffffffffffffff82169050919050565b6100ca816100a0565b81146100d557600080fd5b50565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610103826100d8565b9050919050565b600081359050610119816100c1565b610122816100f8565b905092915050565b6000602082840312156101405761013f61009b565b5b600061014e8482850161010a565b91505092915050565b6000819050919050565b61016a81610157565b82525050565b60006020820190506101856000830184610161565b9291505056fea26474726f6e58221220839f9be3efc349a3efd6bb491d0bee7bc34d86313c73f6e6eeddc4719ec69c0064736f6c63430008120033",
       "visible": true
     }'
     ```