aboutsummaryrefslogblamecommitdiffstats
path: root/docs/structure-of-a-contract.rst
blob: 224eb368cc1b8b4533bb98566f4acb86372bc592 (plain) (tree)
1
2
3
4
5
6
7
8
9

                                                                                     

                       




                                                                          

                                                                                                                             

                                                        
                              







                                                                            

                         
                          

                                        

   
                                                               
                                                      
           
 
                        







                                                             

                         
                          
                                          

                

   
                                                         
                                                                       
                        
 
                                 



                  

                                                                                       

  
 
                          
 
                     
                            
 
                                         
                                        
            
       
 


                                                     

   
                     







                                                                  

                         
                          
                                                                      
 
                              


                                                                         

   
                                                                                 

                                   
                            



             
                                                                      
                                 


  

                         
                   





                              

   
                         



          
                                                                         
                               

  
 

                         
                     
                                                      
   
.. index:: contract, state variable, function, event, struct, enum, function;modifier

.. _contract_structure:

***********************
Structure of a Contract
***********************

Contracts in Solidity are similar to classes in object-oriented languages.
Each contract can contain declarations of :ref:`structure-state-variables`, :ref:`structure-functions`,
:ref:`structure-function-modifiers`, :ref:`structure-events`, :ref:`structure-structs-types` and :ref:`structure-enum-types`.
Furthermore, contracts can inherit from other contracts.

.. _structure-state-variables:

State Variables
===============

State variables are values which are permanently stored in contract storage.

::

  pragma solidity ^0.4.0;

  contract SimpleStorage {
      uint storedData; // State variable
      // ...
  }

See the :ref:`types` section for valid state variable types and
:ref:`visibility-and-getters` for possible choices for
visibility.

.. _structure-functions:

Functions
=========

Functions are the executable units of code within a contract.

::

  pragma solidity ^0.4.0;

  contract SimpleAuction {
      function bid() payable { // Function
          // ...
      }
  }

:ref:`function-calls` can happen internally or externally
and have different levels of visibility (:ref:`visibility-and-getters`)
towards other contracts.

.. _structure-function-modifiers:

Function Modifiers
==================

Function modifiers can be used to amend the semantics of functions in a declarative way
(see :ref:`modifiers` in contracts section).

::

  pragma solidity ^0.4.11;

  contract Purchase {
      address public seller;

      modifier onlySeller() { // Modifier
          require(msg.sender == seller);
          _;
      }

      function abort() onlySeller { // Modifier usage
          // ...
      }
  }

.. _structure-events:

Events
======

Events are convenience interfaces with the EVM logging facilities.

::

  pragma solidity ^0.4.0;

  contract SimpleAuction {
      event HighestBidIncreased(address bidder, uint amount); // Event

      function bid() payable {
          // ...
          HighestBidIncreased(msg.sender, msg.value); // Triggering event
      }
  }

See :ref:`events` in contracts section for information on how events are declared
and can be used from within a dapp.

.. _structure-structs-types:

Structs Types
=============

Structs are custom defined types that can group several variables (see
:ref:`structs` in types section).

::

  pragma solidity ^0.4.0;

  contract Ballot {
      struct Voter { // Struct
          uint weight;
          bool voted;
          address delegate;
          uint vote;
      }
  }

.. _structure-enum-types:

Enum Types
==========

Enums can be used to create custom types with a finite set of values (see
:ref:`enums` in types section).

::

  pragma solidity ^0.4.0;

  contract Purchase {
      enum State { Created, Locked, Inactive } // Enum
  }