02 June 2023

Smart Contract Hacking Chapter 1 - Solidity For Penetration Testers Part 1 (Hello World)

 

Note: We will start off our Smart Contract Hacking journey with some basic solidity programming in the first two weeks. After that we will ramp things up and get a little crazy deploying blockchains and liquidating funds from accounts. But since the purpose of this series is to share the information I have learned over the last two years.  I do not want to alienate those new to Smart Contracts and programming so we will take these first few weeks a bit slow. 

Also note the text was taken from a book I was / am writing, I retrofitted it for this blog, and placed videos where screenshots may otherwise exist. If something seems off.. Just DM me on twitter and I will update it anything I might have missed during editing, but I tried to edit it as best as possible to meet this format rather then a book. 

Cheers  @Fiction 

http://cclabs.io

Thanks to @GarrGhar for helping me edit/sanity check info for each of the chapters. 


About Solidity

The solidity programming language is the language used to write smart contracts on the Ethereum blockchain. As of my initial writing of this chapter the current compiler version was 0.6.6. However, the versions change rapidly. For example, when I started coding in solidity 2 years ago, solidity was in version 4 and now its version 7 with major library and coding stylistic requirement updates in version 5. 

So, note that when compiling your code for labs its best to use the version sited in that particular example. This is easily achieved in the online compilers, by selecting the compiler version from the dropdown menu. If you would like to give yourself a small challenge, use the latest compiler version and try to modify the code to work with it. Usually this just requires a few minor modifications and can be a good learning experience under the hood of how Solidity works and what has changed.

Solidity is very similar to writing JavaScript and is fully object oriented. In the intro chapters we will attempt to provide a quick overview of solidity understanding needed for a penetration tester. This will not be full guide to programming, as programming is considered to be a pre-requisite to application hacking. Instead this chapter will be a gentle introduction of needed concepts you will use throughout this book. Solidity is also a needed pre-requisite for understanding the rest of the information and its associated exploitation course. 

However, as long as you understand general programming concepts then you should have no trouble understanding solidity. It is a relatively easy language to get up and running with quickly in comparison to more mature languages like C++ and Java which may take a more significant amount of time to learn.

The most important thing to understand with solidity is that unlike traditional languages, solidity handles transactions of monetary value by default. Meaning you don't need to attach to a payment API to add transactions to your applications. Payment functionality is baked into the language as its primary purpose and for usage with the Ethereum blockchain.  All that's needed for financial transactions in solidity is a standard library transfer function, and you can easily send value to anyone's public address. 

For example, the following simple function will transfer a specified amount of Ether to the user calling the function provided they have a large enough balance to allow the transfer. But lets not dive into that just yet. 

 

1.  function withdraw (uint amount) {
2.     require (amount <= balances[msg.sender]);
3.     msg.sender.transfer(amount);
4.  }

 

Structure of a Smart Contract

Rather than discuss payments at this point, let's not jump to far ahead of ourselves. We need to understand the structure of a smart contract. Let's take a look at a Hello World example. We will analyze all of the key aspects that make solidity different then other languages you may currently understand.

You can easily follow along with this on http://remix.ethereum.org which is a free online IDE and compiler for coding in solidity. A full video walk through of Remix is included later on in this chapter.  Remix contains in-browser compilers and virtual environments that emulate block creation and allow you to send and receive transactions.  This is a powerful development tool and absolutely free to use. 

Below is the simple code example we will analyze before moving on to a live walk through. 

1.  pragma solidity 0.6.6; 
2.   
3.  contract HelloWorld {
4.           
5.     constructor () public payable {
6.           //This is a comment
7.           //You can put your configuration information here
8.     }
9.   
10.   function hello () public pure returns (string memory) {
11.                  return "Hello World";
12.         }
13.}

 

There is a lot going on in this small program so I will try to break it down as simple as possible. In the first line, we have the pragma statement which is required at the top of each program to let the compiler know which version of solidity this code was written for.  As I said earlier, these versions change rapidly due to the evolving technology and many changes are implemented into each new version. So, the compiler needs to know which version you intended this to run on.

On line 3 is the word "contract" followed by whatever name you wish to call your contract. The contract's functionality is then enclosed in curly braces. This is similar to creating a class in any other language. It's a block of associated code that can be inherited, or interfaced with and contains its own variables and methods.

On line 5 contained within the contract curly braces we have a constructor denoted by the word "constructor".  The constructor is run one time at contract creation and used to setup any variables or details of the smart contract. This is often used for creating an administrator of the contract or other items that are needed prior to contract usage. 

Functions and variables within Solidity also have various types and visibility set with their creation.  In this case also on line 5 you will see the words "public" and "payable" used to describe the constructor. 

Public you may be familiar with as it's a common visibility keyword used in other languages denoting that anyone can call this function. There are other visibility types in Solidity listed below, we will cover each of these in more detail as we use them to our advantage when hacking smart contracts:

 

Public

This allows anyone to call and use this function

 

Private

This allows only the current contract and its functions to call it directly.

 

Internal

This is similar to private except it also allows derived contracts to use its functionality

 

External

External can only be called externally by other contracts unless the "this" keyword is used with the function call.

 

The second keyword in the constructor definition "payable" you may not be familiar with unless you have worked on blockchain projects. The word payable within solidity is needed on any item that can receive Ether. So, by setting the constructor as payable we can send a base amount of Ether to the contract when its deployed. This will add an initial monetary liquidity for whatever functionality the contract is providing. For example, if this were a gambling game, we would need some initial Ethereum to payout our winners before our revenues catch up with our payouts and we start collecting large sums of failed gambling revenue. 

Within the constructor is an example of how comments are handled in solidity, the simple double forward slash is used like in most languages. Comments function in the same way as any other language in that they are not processed and they are ignored by the compiler but are useful for understanding the code you wrote later after you have taking time apart from reading your code.

Finally, we have our simple hello function starting on line 10. Again, there is a lot going on here. First is the name of the function with parentheses that can contain arguments like in any other language. However, this function does not take arguments.

You will notice two more keywords in the function definition "pure" and "returns". Returns is simply the way the function denotes that it will return a value to the user, which it then states directly after it what type of variable it returns. In this case, it returns a string in memory.  We will talk about memory and storage later on and the security implications of them.

Next is the word "Pure" there are a couple types of functions in Solidity which will list below with a brief description.


View

This type of function does not modify or change the state of the contract but may return values and use global variables.

Pure

A pure function is a function which is completely self-contained in that it only uses local variables and it does not change the state of the smart contract.


Finally, in line 11 we return our string to the user who called the function. In the context of a user, this could be a physical user using an application or smart contract functionality or it could actually be another smart contract calling the function.

 

Hands on Lab – Remix HelloWorld

Now that we talked over in detail all the new concepts to solidity programs using a small example, lets compile and run this code on remix.ethereum.org.

Action Steps:

ü Browse to remix.etherum.org
ü Type out the the code from above (Do not copy Paste it)
ü Compile and deploy the code
ü Review the transaction in the log window

 

Intro to the Remix Development Environment Video


In Remix create a new file and type out the example helloworld code.  I would suggest that you actually type out all of the examples in this book. They will not be exhaustive or long and will provide you great value and make you comfortable when it comes to writing your own exploits and using the compilers and tools. These are all essential tools to your understanding.

Within your remix environment, you will want to select the compiler version 0.6.6 to ensure that this code runs correctly. If you typed out the code correctly you should not receive any errors and you will be able to deploy and interact with it. In the following video we will walk you through that process and explain some nuances of solidity. 


Explaining and Compiling HelloWorld Video: 






 

Lets now quickly review a few key points about the transaction that you saw within the video when compiling your code. This transaction is shown below. 

__________________________________________________________________________________

call to HelloWorld.hello

CALL

from      0xBF8B5A94eD4dFB45089b455B1A0e296D6669c625

 to           HelloWorld.hello() 0xADe285e11e0B9eE35167d1E25C3605Eba1778C86

 transaction cost               21863 gas (Cost only applies when called by a contract)

                                         execution cost 591 gas (Cost only applies when called by a contract)

 hash     0x14557f9552d454ca865deb422ebb50a853735b57efaebcfc9c9abe57ba1836ed

 input    0x19f...f1d21

 decoded input {}

 decoded output               {

                "0": "string: Hello World"

}

 logs       []

_________________________________________________________________________________

 

The output above is a hello transaction which contains the relevant data retrieved when you executed the hello function in the video. The first important thing to notice is the word "CALL". In solidity there are call and send transactions. The difference between the two is whether they change the state of the blockchain or not. In this case we did not change the state, we only retrieved information so a CALL was issued.  If we were changing variables and sending values then a SEND transaction would have been issued instead.

Next you will see the "From" address which should correspond with the address you used to call the transaction.  The "To" field should be the address the smart contract was given when you deployed the smart contract. You can view this on your deployment screen next to the deployed contract name by hitting the copy button and pasting it somewhere to see the full value.

You will then see the costs and gas associated with the transaction. Costs change based on the size of the contracts and the assembly code created by the compiler. Each instruction has a cost. We will cover that later when we do a bit of debugging and decompiling. 

Finally take note of the Decoded Output which contains the return string of "Hello World".

 

Summary

If you are new to solidity or new to programming in general this might have been a lot of information.  In the next chapter we cover a few more key solidity concepts before moving on to exploiting vulnerabilities where a much more in depth understanding of how solidity works and its security implications will be explored. For more solidity resources and full-length free tutorials check out the following references

  

Homework:

https://cryptozombies.io/en/course/

More info
  1. Hacking Tools Hardware
  2. Hacker Tools Software
  3. Hack Tools For Ubuntu
  4. Hacking Tools Kit
  5. Nsa Hack Tools
  6. Beginner Hacker Tools
  7. World No 1 Hacker Software
  8. Hacker Tools Hardware
  9. Pentest Tools
  10. Hacker Tools Online
  11. Tools For Hacker
  12. Hacking Tools And Software
  13. Pentest Tools For Ubuntu
  14. Hack Tool Apk
  15. Pentest Tools Tcp Port Scanner
  16. Hacking Tools 2020
  17. What Are Hacking Tools
  18. How To Install Pentest Tools In Ubuntu
  19. Hacking Tools For Kali Linux
  20. Pentest Recon Tools
  21. Hacker Tools 2020
  22. Pentest Tools Review
  23. Hacker Tools Windows
  24. Pentest Tools Open Source
  25. What Is Hacking Tools
  26. Wifi Hacker Tools For Windows
  27. Hacker Tools Online
  28. Hack Rom Tools
  29. Hack And Tools
  30. Computer Hacker
  31. Pentest Tools
  32. Hack Website Online Tool
  33. Pentest Automation Tools
  34. Hacker Search Tools
  35. Pentest Recon Tools
  36. Hacker Security Tools
  37. Hacker Tools Windows
  38. Wifi Hacker Tools For Windows
  39. Hacker Tools Free
  40. Hack Tools Online
  41. Pentest Recon Tools
  42. Game Hacking
  43. Hacker Tools Hardware
  44. Hacker Tools Linux
  45. Hack Tools For Pc
  46. Github Hacking Tools
  47. Hacker Tools For Ios
  48. Android Hack Tools Github
  49. Hack Tools Download
  50. Best Hacking Tools 2020
  51. Pentest Tools Website Vulnerability
  52. Top Pentest Tools
  53. Hacking Tools And Software
  54. Ethical Hacker Tools
  55. Wifi Hacker Tools For Windows
  56. What Are Hacking Tools
  57. Hack Tools Mac
  58. Hacking Tools For Mac
  59. Beginner Hacker Tools
  60. Pentest Tools Find Subdomains
  61. Hacking Tools Pc
  62. New Hacker Tools
  63. Easy Hack Tools
  64. Hacker Security Tools
  65. New Hack Tools
  66. Growth Hacker Tools
  67. Hacker Tools Github
  68. Pentest Tools Tcp Port Scanner
  69. World No 1 Hacker Software
  70. Hacker Tools Mac
  71. Pentest Tools Online
  72. Nsa Hack Tools
  73. Hacking Tools 2020
  74. Hacker Tools Mac
  75. What Is Hacking Tools
  76. Underground Hacker Sites
  77. Ethical Hacker Tools
  78. Pentest Tools For Ubuntu
  79. Pentest Tools Framework
  80. Hacking App
  81. Hack Tools For Pc
  82. Hacking Tools For Beginners
  83. Beginner Hacker Tools
  84. Hacker Tools Apk Download
  85. Pentest Tools Port Scanner
  86. Computer Hacker
  87. Tools For Hacker
  88. Hacker Tools Mac
  89. Hack Tools Github
  90. Pentest Tools Linux
  91. Hack App
  92. World No 1 Hacker Software
  93. Hacking Tools Windows
  94. Hacking App
  95. Pentest Tools Url Fuzzer
  96. Hacking Tools
  97. Hacking App
  98. Top Pentest Tools
  99. Pentest Tools For Android
  100. Growth Hacker Tools
  101. Hacker Tools For Windows
  102. Pentest Tools Tcp Port Scanner
  103. Hacking Tools Pc
  104. What Is Hacking Tools
  105. Pentest Tools Bluekeep
  106. Game Hacking
  107. Growth Hacker Tools
  108. Hacking Tools 2019
  109. How To Install Pentest Tools In Ubuntu
  110. Growth Hacker Tools
  111. What Are Hacking Tools
  112. Easy Hack Tools
  113. Pentest Tools Bluekeep
  114. Hacking Tools Mac
  115. Hacking Tools And Software
  116. Hacker Tools Online
  117. Hacking Tools For Windows Free Download
  118. Hacking Tools Hardware
  119. How To Install Pentest Tools In Ubuntu
  120. Pentest Tools Windows
  121. Kik Hack Tools
  122. Hacker Tools For Ios
  123. Hack Tools
  124. Pentest Tools Github
  125. New Hacker Tools
  126. Pentest Tools Find Subdomains
  127. Hackrf Tools
  128. Hacker
  129. Pentest Tools Subdomain
  130. Growth Hacker Tools
  131. Hacker Tools Apk Download
  132. Pentest Box Tools Download
  133. Pentest Tools Kali Linux
  134. Game Hacking
  135. Underground Hacker Sites
  136. Hack Tools For Ubuntu
  137. Hacking Tools For Mac
  138. Hacker Security Tools
  139. Hacker Hardware Tools
  140. Pentest Tools Subdomain
  141. Pentest Tools Open Source
  142. Hack Tools For Games
  143. Hacker Tools Hardware

No comments:

Post a Comment