5.4.4.5 Key Trust Mode Invoking Smart Contract API

For the key trust mode FISCO DApps, when the off-BSN system invokes the smart contract functions via PCN gateway, it is required to include the call parameters in the request. The gateway will return the transaction result from the smart contract.

1. Interface address:

https://PCNGatewayAddress/api/fiscobcos/v1/node/reqChainCode

Note: After a participant has successfully joined in a FISCO DApp service, the participant can view and download the DApp’s configuration parameters which are used for off-BSN systems to connect to this DApp’s smart contracts, including the PCN gateway address and Dapp access keys, as shown below:

5.4.4.5

2. Call Method: POST

3. Signature algorithm: required and refer to Section 5.4.4.1

4. Call parameters

No. Field name Field Type Required Remarks
1 Header header Map Y
2 Body body Map Y
3 Signature Value mac String Y
header
1 user unique ID userCode String Y
2 DApp unique ID appCode String Y
Body
1 User ID userId String Y Registered user ID via 7.3.1 API
2 Smart Contract Name contractName String Y
3 Function Name funcName String Y
4 Function Parameters funcParam string N convert array type to json string format

Example:

{"header":{"appCode":"cl0006202003181926573677572","userCode":"USER0006202003181951281835816"},"body":{"contractName":"HelloWorld","userId":"100003","funcName":"set","funcParam":[\"abc\"]},"mac":"MEUCIQDTFe2Gerdf7YJrG1a1Yt99M0ZQ3T1lGpsXdNmFV7WuTgIgSkZ19abUhAJbMrJMBoD8N7f26xhpQRuR4vNAfY7EEbs="}

5. Response parameters

No. Field name Field Type Required Remarks
1 Header header Map Y
2 Body body Map Y
3 Signature Value mac String Y
header
1 Response ID code int Y 0: authentication successful -1: authentication failed
2 Response Message msg String N if code=0 then can be null
Body
1 Invoke Type constant Bool N
2 Query information queryInfo String N If Constant is true, this field has value.
3 Transaction hash txId string N If Constant is false, this field has value and is valid.
4 Block HASH blockHash String N If Constant is false, this field has value and is valid.
5 Block Number blockNumber Int N If Constant is false, this field has value and is valid.
6 Gas Used gasUsed Int N If Constant is false, this field has value and is valid.
7 Transaction Status status String N If Constant is false, this field has value and is valid. 0x0 means transaction successful, status value refer to transaction receipt status in 7.3.9
8 From account from String N If Constant is false, this field has value and is valid.
9 To account To String N If Constant is false, this field has value and is valid.
10 Input Input String N If Constant is false, this field has value and is valid.
11 Ouput output String N If Constant is false, this field has value and is valid.
© 2019-2021 Red Date (Hong Kong) Technology Limited. all right reserved,powered by GitbookFile Modify: 2021-06-02 09:20:13

results matching ""

    No results matching ""

    results matching ""

      No results matching ""