1. Using Oracle Blockchain Platform
  2. Run Solidity Smart Contracts with EVM on Oracle Blockchain Platform

D Run Solidity Smart Contracts with EVM on Oracle Blockchain Platform

This topic provides a walkthrough showing how you can run Solidity smart contracts with EVM (Ethereum Virtual Machine) deployed as a chaincode on Oracle Blockchain Platform.

The Ethereum Virtual Machine runs smart contracts in the Ethereum networks. It was created through the Hyperledger Burrow project and has been integrated into Hyperledger Fabric. This project enables you to use a Hyperledger Fabric permissioned blockchain platform to interact with Ethereum smart contracts written in an EVM-compatible language such as Solidity. See: Hyperledger Fabric EVM chaincode.

A basic overview of the process of running a Solidity smart contract on a provisioned Oracle Blockchain Platform:
  1. Upload the EVM chaincode zip into Oracle Blockchain Platform.
  2. Deploy it using the bytecode generated by the Remix IDE.
  3. Get the smart contract address in response to the deployment, and use that address to send transactions.
Steps in this topic have been tested with fabric-chaincode-evm:release-0.4 and may not work with other releases.

Set Up the EVM Chaincode Zip File

Before deploying the smart contract, the EVM chaincode zip needs to be prepared. To create the chaincode zip folder:

  1. Download the EVM chaincode zip from Hyperledger Fabric EVM chaincode.
  2. Unzip the downloaded fabric-chaincode-evm-release-0.4.zip.
  3. In the extracted files, go to fabric-chaincode-evm-release-0.4/evmcc/vendor/github.com/hyperledger.
  4. Create the directory fabric-chaincode-evm/evmcc in the /hyperledger directory.
  5. Copy the following folders from fabric-chaincode-evm-release-0.4/evmcc to fabric-chaincode-evm-release-0.4/evmcc/vendor/github.com/hyperledger/fabric-chaincode-evm/evmcc:
    • /address
    • /event
    • /eventmanager
    • /mocks
    • /statemanager
  6. Zip the top-level fabric-chaincode-evm-release-0.4/evmcc folder and rename it. The following steps use evmcc.zip as the example name.

Deploy EVM Chaincode on Oracle Blockchain Platform

After you have created the EVM chaincode zip, you need to deploy it on Oracle Blockchain Platform.

  1. Log into the Oracle Blockchain Platform console.
  2. On the Chaincodes tab, click Deploy a New Chaincode.
  3. Select Quick Deployment, and entire the following information:
    • Chaincode Name: enter any name of your choice. This example uses soliditycc.
    • Version: v0
    • Initial Parameters for Chaincode Instantiation: leave this field empty
    • Channel: select the channels on which you want to install and instantiate the chaincode
    • Chaincode source: upload the evmcc.zip package you created in the previous steps.
    After you submit your information, the EVM chaincode will be visible in the Chaincodes tab.

Create and Compile Your Solidity Smart Contract

  1. Open the browser-based Remix IDE: https://remix.ethereum.org/.
  2. If you already have a Solidity smart contract written, import it into Remix.
  3. If you don't have a Solidity smart contract written, create a Solidity file (.sol) in Remix and do one of the following:
    • If you're familiar with Solidity you can create your own smart contract file.
    • You can use the Simple Storage sample code provided in the Solidity documentation: Solidity: Introduction to Smart Contracts
    • You can use the sample code being used for this example which takes string name as an input and prints the same as output string using set(name) and get():
      pragma solidity ^0.4.0;
contract Myname {
    string public yourName;

    function set(string name) public {
        yourName = name;
    }
    function get() public view returns (string) {
        return yourName;
    }
}
    Note that you may see an error message about the default compiler version not matching the version you've specified in your smart contract.
  4. Compile your smart contract. Open the Solidity Compiler panel in Remix, ensure that your smart contract tab is open to select it as the file being compiled, set the compiler version to the most recent 4.X version, and click Compile.
    Screen capture of the test Solidity smart contract in the Remix Compiler view.

  5. Once the file has compiled, click the Bytecode icon - this copies the bytecode as a JSON document to your clipboard.
  6. Paste the copied bytecode into a text editor and save it.

Deploy the Smart Contract

In the copied bytecode, the section you need is the "object" field. This is the EVM bytecode of a sample smart contract.
"object": "608060405234801561001057600080fd5b50610410806100206000396000f30060
8060405260043610610057576000357c0100000000000000000000000000000000000000000000000000000000900463
ffffffff1680634ed3885e1461005c5780636d4ce63c146100c5578063d97d663014610155575b600080fd5b34801561
006857600080fd5b506100c3600480360381019080803590602001908201803590602001908080601f01602080910402
602001604051908101604052809392919081815260200183838082843782019150505050505091929192905050506101
e5565b005b3480156100d157600080fd5b506100da6101ff565b60405180806020018281038252838181518152602001
91508051906020019080838360005b8381101561011a5780820151818401526020810190506100ff565b505050509050
90810190601f1680156101475780820380516001836020036101000a031916815260200191505b509250505060405180
910390f35b34801561016157600080fd5b5061016a6102a1565b60405180806020018281038252838181518152602001
91508051906020019080838360005b838110156101aa57808201518184015260208101905061018f565b505050509050
90810190601f1680156101d75780820380516001836020036101000a031916815260200191505b509250505060405180
910390f35b80600090805190602001906101fb92919061033f565b5050565b6060600080546001816001161561010002
03166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615
6101000203166002900480156102975780601f1061026c57610100808354040283529160200191610297565b82019190
6000526020600020905b81548152906001019060200180831161027a57829003601f168201915b505050505090509056
5b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190
818152602001828054600181600116156101000203166002900480156103375780601f1061030c576101008083540402
83529160200191610337565b820191906000526020600020905b81548152906001019060200180831161031a57829003
601f168201915b505050505081565b828054600181600116156101000203166002900490600052602060002090601f01
6020900481019282601f1061038057805160ff19168380011785556103ae565b828001600101855582156103ae579182
015b828111156103ad578251825591602001919060010190610392565b5b5090506103bb91906103bf565b5090565b61
03e191905b808211156103dd5760008160009055506001016103c5565b5090565b905600a165627a7a72305820a990d4
0b57c66329a32a18e847b3c18d6c911487ffadfed2098e71e8cafa0c980029",
In general, the EVM expects two arguments:
  • The to address.
  • The input that's necessary in Ethereum transactions.

To deploy smart contracts, the to field is the zero address, and the input is the compiled EVM bytecode of the contract. Thus, there are two arguments provided to the invoke. The first one, which was traditionally supposed to be a function name inside the chaincode, is now 0000000000000000000000000000000000000000, and the second argument is the Solidity smart contract bytecode.

  1. To deploy the Solidity smart contract on Oracle Blockchain Platform, you need to invoke the deployed EVM chaincode with these two arguments using REST proxy endpoints. 
    
--data-raw '{"chaincode":"<chaincodename>","args":["<zeroaddress>","<EVMbytecode>"]}'
    For example, using cURL to deploy the Solidity smart contract to Oracle Blockchain Platform with the name soliditycc:
    curl -L -X POST 'https://<hostname>:7443/restproxy/api/v2/channels/<channelname>/transactions' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-H 'Content-Type: application/json' \
--data-raw '{"chaincode":"soliditycc","args":["0000000000000000000000000000000000000000","608060405234801561....152d2820d3b5d784b3711119691d0029"],"timeout":0,"sync":true}'
  2. The response payload of the transaction is the contract address for your deployed contract. Copy this address and save it - it's used when you execute smart contract functions.
    Screen capture of the API call and response showing the smart contract address in the payload response field.
    In this example, the smart contract address is 66b92979bb66d645371b3247177e4b2513cb9834.

Interacting With the Smart Contract

To interact with the deployed smart contract, you need the contract address returned as the payload while deploying the contract in the previous section.

To execute functions, you will use invoke and query transactions but with different parameters. The sample contract contains two functions: get and set.

In these transactions, the to field is the contract address and the input field is the function execution hash concatenated with any of the required arguments.

You need to acquire the hash of the function execution to run a transaction. A simple way to do this is to execute the functions in the Remix IDE and to then copy the hash from the transaction logs:

  1. In the Remix IDE, open the Deploy and Run Transactions panel. Ensure that your contract is selected in the Contract field, and click Deploy.
    Screen capture of the Solidity contract about to be deployed.

    Once the deployment completes, the contract should be listed in the Deployed Contracts list.
  2. Expand the contract in the Deployed Contracts list. The smart contract functions are listed.
  3. Run a transaction. For the provided example, enter oracle and click set.
  4. The Terminal window shows the transaction logs. If the transaction logs are minimized, expand them by clicking the log. Copy the value of the input field (which is the function execution hash) by clicking the icon next to it. Save this value to the same location as your contract address, removing the leading 0x.
    Screen capture of the Deployment page showing the completed transaction and field values, and pointing to the input field containing the function execution hash value.

  5. Once you have the function execution hash and the contract address, you can run the set transaction on Oracle Blockchain Platform using them as the raw data arguments. 
    
--data-raw '{"chaincode":"<chaincodename>","args":["<contractaddress>","<setfunctionexecutionhash>"]}'
    For example using cURL:
    curl -L -X POST 'https://<hostname>:7443/restproxy/api/v2/channels/<channelname>/transactions' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-H 'Content-Type: application/json' \
--data-raw '{"chaincode":"soliditycc","args":["66b92979bb66d645371b3247177e4b2513cb9834","4ed3885e000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000066f7261636c650000000000000000000000000000000000000000000000000000"]}'
  6. Open the Oracle Blockchain Platform console; the transaction should be listed in the ledger.

To run another transaction such as a query using the smart contract's get function, you can generate the function execution hash in Remix and combine it with the contract address:

  1. In Remix on the Deploy and Run Transactions panel, ensure that your contract is still listed under Deployed Contracts. If not, redeploy it.
  2. Click get. Retrieve and save the input from the transaction as you did with the set transaction, removing the leading 0x.
    Screen capture of the get transaction in Remix, clarifying that the input field contains the required function execution hash.

  3. You can use this transaction hash and the contract address to run a query transaction against the chaincode deployed on Oracle Blockchain Platform. 
    
--data-raw '{"chaincode":"<chaincodename>","args":["<contractaddress>","<getfunctionexecutionhash>"]}'
    For example in cURL:
    curl -L -X POST 'https://<hostname>:7443/restproxy/api/v2/channels/<channelname>/chaincode-queries' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-H 'Content-Type: application/json' \
--data-raw '{"chaincode":"soliditycc","args":["66b92979bb66d645371b3247177e4b2513cb9834","6d4ce63c"]}'
    The returned payload will contain the asset being queried - in the example case the string oracle.