Language Features:
- Control Flow Graph: Detect every access to uninitialized storage pointers.
Compiler Features:
- Inline Assembly: Improve error messages around invalid function argument count.
- Code Generator: Only check callvalue once if all functions are non-payable.
- Code Generator: Use codecopy for string constants more aggressively.
- Code Generator: Use binary search for dispatch function if more efficient. The size/speed tradeoff can be tuned using
--optimize-runs
. - Compiler Interface: Disallow unknown keys in standard JSON input.
- SMTChecker: Support mathematical and cryptographic functions in an uninterpreted way.
- Static Analyzer: Do not warn about unused variables or state mutability for functions with an empty body.
- Type Checker: Add an additional reason to be displayed when type conversion fails.
- Yul: Support object access via
datasize
,dataoffset
anddatacopy
in standalone assembly mode.
Bugfixes:
Build System:
- Replace the trusty PPA build by a static build on cosmic that is used for the trusty package instead.
- Remove support for Visual Studio 2015.
Language Features:
- Allow mapping type for parameters and return variables of public and external library functions.
- Allow public functions to override external functions.
Compiler Features:
- Code generator: Do not perform redundant double cleanup on unsigned integers when loading from calldata.
- Commandline interface: Experimental
--optimize
option for assembly mode (--strict-assembly
and--yul
). - SMTChecker: SMTLib2 queries and responses passed via standard JSON compiler interface.
- SMTChecker: Support
msg
,tx
andblock
member variables. - SMTChecker: Support
gasleft()
andblockhash()
functions. - SMTChecker: Support internal bound function calls.
- Yul: Support Yul objects in
--assemble
,--strict-assembly
and--yul
commandline options.
Bugfixes:
- Assembly output: Do not mix in/out jump annotations with arguments.
- Commandline interface: Fix crash when using
--ast
on empty runtime code. - Code Generator: Annotate jump from calldata decoder to function as "jump in".
- Code Generator: Fix internal error related to state variables of function type access via base contract name.
- Optimizer: Fix nondeterminism bug related to the boost version and constants representation. The bug only resulted in less optimal but still correct code because the generated routine is always verified to be correct.
- Type Checker: Properly detect different return types when overriding an external interface function with a public contract function.
- Type Checker: Disallow struct return types for getters of public state variables unless the new ABI encoder is active.
- Type Checker: Fix internal compiler error when a field of a struct used as a parameter in a function type has a non-existent type.
- Type Checker: Disallow functions
sha3
andsuicide
also without a function call. - Type Checker: Fix internal compiler error with
super
when base contract function is not implemented. - Type Checker: Fixed internal error when trying to create abstract contract in some cases.
- Type Checker: Fixed internal error related to double declaration of events.
- Type Checker: Disallow inline arrays of mapping type.
- Type Checker: Consider abstract function to be implemented by public state variable.
Build System:
- CMake: LLL is not built anymore by default. Must configure it with CMake as
-DLLL=ON
. - Docker: Includes both Scratch and Alpine images.
- Emscripten: Upgrade to Emscripten SDK 1.37.21 and boost 1.67.
Solc-Js:
- Fix handling of standard-json in the commandline executable.
- Remove support of nodejs 4.
How to update your code:
- Change every
.call()
to a.call("")
and every.call(signature, a, b, c)
to use.call(abi.encodeWithSignature(signature, a, b, c))
(the last one only works for value types). - Change every
keccak256(a, b, c)
tokeccak256(abi.encodePacked(a, b, c))
. - Add
public
to every function andexternal
to every fallback or interface function that does not specify its visibility already. - Make your fallback functions
external
. - Explicitly state the data location for all variables of struct, array or mapping types (including function parameters), e.g. change
uint[] x = m_x
touint[] storage x = m_x
. Note thatexternal
functions require parameters with a data location ofcalldata
. - Explicitly convert values of contract type to addresses before using an
address
member. Example: ifc
is a contract, changec.transfer(...)
toaddress(c).transfer(...)
. - Declare variables and especially function arguments as
address payable
, if you want to calltransfer
on them.
Breaking Changes:
- ABI Encoder: Properly pad data from calldata (
msg.data
and external function parameters). Useabi.encodePacked
for unpadded encoding. - C API (
libsolc
/ rawsoljson.js
): Removed theversion
,license
,compileSingle
,compileJSON
,compileJSONCallback
methods and replaced them with thesolidity_license
,solidity_version
andsolidity_compile
methods. - Code Generator: Signed right shift uses proper arithmetic shift, i.e. rounding towards negative infinity. Warning: this may silently change the semantics of existing code!
- Code Generator: Revert at runtime if calldata is too short or points out of bounds. This is done inside the
ABI decoder
and therefore also applies toabi.decode()
. - Code Generator: Use
STATICCALL
forpure
andview
functions. This was already the case in the experimental 0.5.0 mode. - Commandline interface: Remove obsolete
--formal
option. - Commandline interface: Rename the
--julia
option to--yul
. - Commandline interface: Require
-
if standard input is used as source. - Commandline interface: Use hash of library name for link placeholder instead of name itself.
- Compiler interface: Disallow remappings with empty prefix.
- Control Flow Analyzer: Consider mappings as well when checking for uninitialized return values.
- Control Flow Analyzer: Turn warning about returning uninitialized storage pointers into an error.
- General:
continue
in ado...while
loop jumps to the condition (it used to jump to the loop body). Warning: this may silently change the semantics of existing code. - General: Disallow declaring empty structs.
- General: Disallow raw
callcode
(was already deprecated in 0.4.12). It is still possible to use it via inline assembly. - General: Disallow
var
keyword. - General: Disallow
sha3
andsuicide
aliases. - General: Disallow the
throw
statement. This was already the case in the experimental 0.5.0 mode. - General: Disallow the
years
unit denomination (was already deprecated in 0.4.24) - General: Introduce
emit
as a keyword instead of parsing it as identifier. - General: New keywords:
calldata
andconstructor
- General: New reserved keywords:
alias
,apply
,auto
,copyof
,define
,immutable
,implements
,macro
,mutable
,override
,partial
,promise
,reference
,sealed
,sizeof
,supports
,typedef
andunchecked
. - General: Remove assembly instruction aliases
sha3
andsuicide
- General: C99-style scoping rules are enforced now. This was already the case in the experimental 0.5.0 mode.
- General: Disallow combining hex numbers with unit denominations (e.g.
0x1e wei
). This was already the case in the experimental 0.5.0 mode. - JSON AST: Remove
constant
andpayable
fields (the information is encoded in thestateMutability
field). - JSON AST: Replace the
isConstructor
field by a newkind
field, which can beconstructor
,fallback
orfunction
. - Interface: Remove "clone contract" feature. The
--clone-bin
and--combined-json clone-bin
commandline options are not available anymore. - Name Resolver: Do not exclude public state variables when looking for conflicting declarations.
- Optimizer: Remove the no-op
PUSH1 0 NOT AND
sequence. - Parser: Disallow trailing dots that are not followed by a number.
- Parser: Remove
constant
as function state mutability modifier. - Parser: Disallow uppercase X in hex number literals
- Type Checker: Disallow assignments between tuples with different numbers of components. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow values for constants that are not compile-time constants. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow arithmetic operations for boolean variables.
- Type Checker: Disallow tight packing of literals. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow calling base constructors without parentheses. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow conversions between
bytesX
anduintY
of different size. - Type Checker: Disallow conversions between unrelated contract types. Explicit conversion via
address
can still achieve it. - Type Checker: Disallow empty return statements for functions with one or more return values.
- Type Checker: Disallow empty tuple components. This was partly already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow multi-variable declarations with mismatching number of values. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow specifying base constructor arguments multiple times in the same inheritance hierarchy. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow calling constructor with wrong argument count. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Disallow uninitialized storage variables. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Detecting cyclic dependencies in variables and structs is limited in recursion to 256.
- Type Checker: Require explicit data location for all variables, including function parameters. This was partly already the case in the experimental 0.5.0 mode.
- Type Checker: Only accept a single
bytes
type for.call()
(and family),keccak256()
,sha256()
andripemd160()
. - Type Checker: Fallback function must be external. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Interface functions must be declared external. This was already the case in the experimental 0.5.0 mode.
- Type Checker: Address members are not included in contract types anymore. An explicit conversion is now required before invoking an
address
member from a contract. - Type Checker: Disallow "loose assembly" syntax entirely. This means that jump labels, jumps and non-functional instructions cannot be used anymore.
- Type System: Disallow explicit and implicit conversions from decimal literals to
bytesXX
types. - Type System: Disallow explicit and implicit conversions from hex literals to
bytesXX
types of different size. - Type System: Distinguish between payable and non-payable address types.
- View Pure Checker: Disallow
msg.value
in (or introducing it via a modifier to) a non-payable function. - Remove obsolete
std
directory from the Solidity repository. This means accessinghttps://github.com/ethereum/solidity/blob/develop/std/*.sol
(orhttps://github.com/ethereum/solidity/std/*.sol
in Remix) will not be possible. - References Resolver: Turn missing storage locations into an error. This was already the case in the experimental 0.5.0 mode.
- Syntax Checker: Disallow functions without implementation to use modifiers. This was already the case in the experimental 0.5.0 mode.
- Syntax Checker: Named return values in function types are an error.
- Syntax Checker: Strictly require visibility specifier for functions. This was already the case in the experimental 0.5.0 mode.
- Syntax Checker: Disallow unary
+
. This was already the case in the experimental 0.5.0 mode. - Syntax Checker: Disallow single statement variable declaration inside if/while/for bodies that are not blocks.
- View Pure Checker: Strictly enforce state mutability. This was already the case in the experimental 0.5.0 mode.
Language Features:
- General: Add
staticcall
toaddress
. - General: Allow appending
calldata
keyword to types, to explicitly specify data location for arguments of external functions. - General: Support
pop()
for storage arrays. - General: Scoping rules now follow the C99-style.
- General: Allow
enum
s in interfaces. - General: Allow
mapping
storage pointers as arguments and return values in all internal functions. - General: Allow
struct
s in interfaces. - General: Provide access to the ABI decoder through
abi.decode(bytes memory data, (...))
. - General: Disallow zero length for fixed-size arrays.
- Parser: Accept the
address payable
type during parsing.
Compiler Features:
- Build System: Support for Mojave version of macOS added.
- Code Generator:
CREATE2
instruction has been updated to match EIP1014 (aka "Skinny CREATE2"). It also is accepted as part of Constantinople. - Code Generator:
EXTCODEHASH
instruction has been added based on EIP1052. - Type Checker: Nicer error message when trying to reference overloaded identifiers in inline assembly.
- Type Checker: Show named argument in case of error.
- Type System: IntegerType is split into IntegerType and AddressType internally.
- Tests: Determine transaction status during IPC calls.
- Code Generator: Allocate and free local variables according to their scope.
- Removed
pragma experimental "v0.5.0";
. - Syntax Checker: Improved error message for lookup in function types.
- Name Resolver: Updated name suggestion look up function to take into account length of the identifier: 1: no search, 2-3: at most one change, 4-: at most two changes
- SMTChecker: Support calls to internal functions that return none or a single value.
Bugfixes:
- Build System: Support versions of CVC4 linked against CLN instead of GMP. In case of compilation issues due to the experimental SMT solver support, the solvers can be disabled when configuring the project with CMake using
-DUSE_CVC4=OFF
or-DUSE_Z3=OFF
. - Tests: Fix chain parameters to make ipc tests work with newer versions of cpp-ethereum.
- Code Generator: Fix allocation of byte arrays (zeroed out too much memory).
- Code Generator: Properly handle negative number literals in ABIEncoderV2.
- Code Generator: Do not crash on using a length of zero for multidimensional fixed-size arrays.
- Commandline Interface: Correctly handle paths with backslashes on windows.
- Control Flow Analyzer: Ignore unimplemented functions when detecting uninitialized storage pointer returns.
- Fix NatSpec json output for
@notice
and@dev
tags on contract definitions. - Optimizer: Correctly estimate gas costs of constants for special cases.
- Optimizer: Fix simplification rule initialization bug that appeared on some emscripten platforms.
- References Resolver: Do not crash on using
_slot
and_offset
suffixes on their own. - References Resolver: Enforce
storage
as data location for mappings. - References Resolver: Properly handle invalid references used together with
_slot
and_offset
. - References Resolver: Report error instead of assertion fail when FunctionType has an undeclared type as parameter.
- References Resolver: Fix high CPU usage when using large variable names issue. Only suggest similar name if identifiers shorter than 80 characters.
- Type Checker: Default data location for type conversions (e.g. from literals) is memory and not storage.
- Type Checker: Disallow assignments to mappings within tuple assignments as well.
- Type Checker: Disallow packed encoding of arrays of structs.
- Type Checker: Allow assignments to local variables of mapping types.
- Type Checker: Consider fixed size arrays when checking for recursive structs.
- Type Checker: Fix crashes in erroneous tuple assignments in which the type of the right hand side cannot be determined.
- Type Checker: Fix freeze for negative fixed-point literals very close to
0
, such as-1e-100
. - Type Checker: Dynamic types as key for public mappings return error instead of assertion fail.
- Type Checker: Fix internal error when array index value is too large.
- Type Checker: Fix internal error when fixed-size array is too large to be encoded.
- Type Checker: Fix internal error for array type conversions.
- Type Checker: Fix internal error when array index is not an unsigned.
- Type System: Allow arbitrary exponents for literals with a mantissa of zero.
- Parser: Fix incorrect source location for nameless parameters.
- Command Line Interface: Fix internal error when compiling stdin with no content and --ast option.
Important Bugfixes:
- Code Generator: Properly perform cleanup for exponentiation and non-256 bit types.
- Type Checker: Report error when using indexed structs in events with experimental ABIEncoderV2. This used to log wrong values.
- Type Checker: Report error when using structs in events without experimental ABIEncoderV2. This used to crash or log the wrong values.
- Parser: Consider all unicode line terminators (LF, VF, FF, CR, NEL, LS, PS) for single-line comments and string literals. They are invalid in strings and will end comments.
- Parser: Disallow unterminated multi-line comments at the end of input.
- Parser: Treat
/** /
as unterminated multi-line comment.
Language Features:
- Code Generator: Use native shift instructions on target Constantinople.
- General: Allow multiple variables to be declared as part of a tuple assignment, e.g.
(uint a, uint b) = ...
. - General: Remove deprecated
constant
as function state modifier from documentation and tests (but still leave it as a valid feature). - Type Checker: Deprecate the
years
unit denomination and raise a warning for it (or an error as experimental 0.5.0 feature). - Type Checker: Make literals (without explicit type casting) an error for tight packing as experimental 0.5.0 feature.
- Type Checker: Warn about wildcard tuple assignments (this will turn into an error with version 0.5.0).
- Type Checker: Warn when
keccak256
,sha256
andripemd160
are not used with a single bytes argument (suggest to useabi.encodePacked(...)
). This will turn into an error with version 0.5.0.
Compiler Features:
- Build System: Update internal dependency of jsoncpp to 1.8.4, which introduces more strictness and reduces memory usage.
- Control Flow Graph: Add Control Flow Graph as analysis structure.
- Control Flow Graph: Warn about returning uninitialized storage pointers.
- Gas Estimator: Only explore paths with higher gas costs. This reduces accuracy but greatly improves the speed of gas estimation.
- Optimizer: Remove unnecessary masking of the result of known short instructions (
ADDRESS
,CALLER
,ORIGIN
andCOINBASE
). - Parser: Display nicer error messages by showing the actual tokens and not internal names.
- Parser: Use the entire location of the token instead of only its starting position as source location for parser errors.
- SMT Checker: Support state variables of integer and bool type.
Bugfixes:
- Code Generator: Fix
revert
with reason coming from a state or local string variable. - Type Checker: Show proper error when trying to
emit
a non-event. - Type Checker: Warn about empty tuple components (this will turn into an error with version 0.5.0).
- Type Checker: The ABI encoding functions are pure and thus can be used for constants.
Features:
- Build system: Support Ubuntu Bionic.
- SMTChecker: Integration with CVC4 SMT solver
- Syntax Checker: Warn about functions named "constructor".
Bugfixes:
- Type Checker: Improve error message for failed function overload resolution.
- Type Checker: Do not complain about new-style constructor and fallback function to have the same name.
- Type Checker: Detect multiple constructor declarations in the new syntax and old syntax.
- Type Checker: Explicit conversion of
bytesXX
tocontract
is properly disallowed.
Features:
- Code Generator: Initialize arrays without using
msize()
. - Code Generator: More specialized and thus optimized implementation for
x.push(...)
- Commandline interface: Error when missing or inaccessible file detected. Suppress it with the
--ignore-missing
flag. - Constant Evaluator: Fix evaluation of single element tuples.
- General: Add encoding routines
abi.encodePacked
,abi.encode
,abi.encodeWithSelector
andabi.encodeWithSignature
. - General: Add global function
gasleft()
and deprecatemsg.gas
. - General: Add global function
blockhash(uint)
and deprecateblock.hash(uint)
. - General: Allow providing reason string for
revert()
andrequire()
. - General: Introduce new constructor syntax using the
constructor
keyword as experimental 0.5.0 feature. - General: Limit the number of errors output in a single run to 256.
- General: Support accessing dynamic return data in post-byzantium EVMs.
- General: Allow underscores in numeric and hex literals to separate thousands and quads.
- Inheritance: Error when using empty parentheses for base class constructors that require arguments as experimental 0.5.0 feature.
- Inheritance: Error when using no parentheses in modifier-style constructor calls as experimental 0.5.0 feature.
- Interfaces: Allow overriding external functions in interfaces with public in an implementing contract.
- Optimizer: Optimize
SHL
andSHR
only involving constants (Constantinople only). - Optimizer: Remove useless
SWAP1
instruction preceding a commutative instruction (such asADD
,MUL
, etc). - Optimizer: Replace comparison operators (
LT
,GT
, etc) with opposites if preceded bySWAP1
, e.g.SWAP1 LT
is replaced withGT
. - Optimizer: Optimize across
mload
ifmsize()
is not used. - Static Analyzer: Error on duplicated super constructor calls as experimental 0.5.0 feature.
- Syntax Checker: Issue warning for empty structs (or error as experimental 0.5.0 feature).
- Syntax Checker: Warn about modifiers on functions without implementation (this will turn into an error with version 0.5.0).
- Syntax Tests: Add source locations to syntax test expectations.
- Type Checker: Improve documentation and warnings for accessing contract members inherited from
address
.
Bugfixes:
- Code Generator: Allow
block.blockhash
without being called. - Code Generator: Do not include internal functions in the runtime bytecode which are only referenced in the constructor.
- Code Generator: Properly skip unneeded storage array cleanup when not reducing length.
- Code Generator: Bugfix in modifier lookup in libraries.
- Code Generator: Implement packed encoding of external function types.
- Code Generator: Treat empty base constructor argument list as not provided.
- Code Generator: Properly force-clean bytesXX types for shortening conversions.
- Commandline interface: Fix error messages for imported files that do not exist.
- Commandline interface: Support
--evm-version constantinople
properly. - DocString Parser: Fix error message for empty descriptions.
- Gas Estimator: Correctly ignore costs of fallback function for other functions.
- JSON AST: Remove storage qualifier for type name strings.
- Parser: Fix internal compiler error when parsing
var
declaration without identifier. - Parser: Fix parsing of getters for function type variables.
- Standard JSON: Support
constantinople
asevmVersion
properly. - Static Analyzer: Fix non-deterministic order of unused variable warnings.
- Static Analyzer: Invalid arithmetic with constant expressions causes errors.
- Type Checker: Fix detection of recursive structs.
- Type Checker: Fix asymmetry bug when comparing with literal numbers.
- Type System: Improve error message when attempting to shift by a fractional amount.
- Type System: Make external library functions accessible.
- Type System: Prevent encoding of weird types.
- Type System: Restrict rational numbers to 4096 bits.
Features:
- Code Generator: Assert that
k != 0
formulmod(a, b, k)
andaddmod(a, b, k)
as experimental 0.5.0 feature. - Code Generator: Do not retain any gas in calls (except if EVM version is set to homestead).
- Code Generator: Use
STATICCALL
opcode for callingview
andpure
functions as experimental 0.5.0 feature. - General: C99/C++-style scoping rules (instead of JavaScript function scoping) take effect as experimental v0.5.0 feature.
- General: Improved messaging when error spans multiple lines of a sourcefile
- General: Support and recommend using
emit EventName();
to call events explicitly. - Inline Assembly: Enforce strict mode as experimental 0.5.0 feature.
- Interface: Provide ability to select target EVM version (homestead or byzantium, with byzantium being the default).
- Standard JSON: Reject badly formatted invalid JSON inputs.
- Type Checker: Disallow uninitialized storage pointers as experimental 0.5.0 feature.
- Syntax Analyser: Do not warn about experimental features if they do not concern code generation.
- Syntax Analyser: Do not warn about
pragma experimental "v0.5.0"
and do not set the experimental flag in the bytecode for this. - Syntax Checker: Mark
throw
as an error as experimental 0.5.0 feature. - Syntax Checker: Issue error if no visibility is specified on contract functions as experimental 0.5.0 feature.
- Syntax Checker: Issue warning when using overloads of
address
on contract instances. - Type Checker: disallow combining hex numbers and unit denominations as experimental 0.5.0 feature.
Bugfixes:
- Assembly: Raise error on oversized number literals in assembly.
- JSON-AST: Add "documentation" property to function, event and modifier definition.
- Resolver: Properly determine shadowing for imports with aliases.
- Standalone Assembly: Do not ignore input after closing brace of top level block.
- Standard JSON: Catch errors properly when invalid "sources" are passed.
- Standard JSON: Ensure that library addresses supplied are of correct length and hex prefixed.
- Type Checker: Properly detect which array and struct types are unsupported by the old ABI encoder.
- Type Checker: Properly warn when using
_offset
and_slot
for constants in inline assembly. - Commandline interface: throw error if option is unknown
Features:
- Code Generator: Prevent non-view functions in libraries from being called directly (as opposed to via delegatecall).
- Commandline interface: Support strict mode of assembly (disallowing jumps,
instructional opcodes, etc) with the
--strict-assembly
switch. - Inline Assembly: Issue warning for using jump labels (already existed for jump instructions).
- Inline Assembly: Support some restricted tokens (return, byte, address) as identifiers in Iulia mode.
- Optimiser: Replace
x % 2**i
byx & (2**i-1)
. - Resolver: Continue resolving references after the first error.
- Resolver: Suggest alternative identifiers if a given identifier is not found.
- SMT Checker: Take if-else branch conditions into account in the SMT encoding of the program variables.
- Syntax Checker: Deprecate the
var
keyword (and mark it an error as experimental 0.5.0 feature). - Type Checker: Allow
this.f.selector
to be a pure expression. - Type Checker: Issue warning for using
public
visibility for interface functions. - Type Checker: Limit the number of warnings raised for creating abstract contracts.
Bugfixes:
- Error Output: Truncate huge number literals in the middle to avoid output blow-up.
- Parser: Disallow event declarations with no parameter list.
- Standard JSON: Populate the
sourceLocation
field in the error list. - Standard JSON: Properly support contract and library file names containing a colon (such as URLs).
- Type Checker: Suggest the experimental ABI encoder if using
struct
s as function parameters (instead of an internal compiler error). - Type Checker: Improve error message for wrong struct initialization.
Features:
- Code Generator: New ABI decoder which supports structs and arbitrarily nested
arrays and checks input size (activate using
pragma experimental ABIEncoderV2;
). - General: Allow constant variables to be used as array length.
- Inline Assembly:
if
statement. - Standard JSON: Support the
outputSelection
field for selective compilation of target artifacts. - Syntax Checker: Turn the usage of
callcode
into an error as experimental 0.5.0 feature. - Type Checker: Improve address checksum warning.
- Type Checker: More detailed errors for invalid array lengths (such as division by zero).
Bugfixes:
Features:
- Code Generator: Always use all available gas for calls as experimental 0.5.0 feature (previously, some amount was retained in order to work in pre-Tangerine-Whistle EVM versions)
- Parser: Better error message for unexpected trailing comma in parameter lists.
- Standard JSON: Support the
outputSelection
field for selective compilation of supplied sources. - Syntax Checker: Unary
+
is now a syntax error as experimental 0.5.0 feature. - Type Checker: Disallow non-pure constant state variables as experimental 0.5.0 feature.
- Type Checker: Do not add members of
address
to contracts as experimental 0.5.0 feature. - Type Checker: Force interface functions to be external as experimental 0.5.0 feature.
- Type Checker: Require
storage
ormemory
keyword for local variables as experimental 0.5.0 feature. - Compiler Interface: Better formatted error message for long source snippets
Bugfixes:
- Code Generator: Allocate one byte per memory byte array element instead of 32.
- Code Generator: Do not accept data with less than four bytes (truncated function signature) for regular function calls - fallback function is invoked instead.
- Optimizer: Remove unused stack computation results.
- Parser: Fix source location of VariableDeclarationStatement.
- Type Checker: Allow
gas
in view functions. - Type Checker: Do not mark event parameters as shadowing state variables.
- Type Checker: Prevent duplicate event declarations.
- Type Checker: Properly check array length and don't rely on an assertion in code generation.
- Type Checker: Properly support overwriting members inherited from
address
in a contract (such asbalance
,transfer
, etc.) - Type Checker: Validate each number literal in tuple expressions even if they are not assigned from.
Features:
- Assembly Parser: Support multiple assignment (
x, y := f()
). - Code Generator: Keep a single copy of encoding functions when using the experimental "ABIEncoderV2".
- Code Generator: Partial support for passing
structs
as arguments and return parameters (requirespragma experimental ABIEncoderV2;
for now). - General: Support
pragma experimental "v0.5.0";
to activate upcoming breaking changes. - General: Added
.selector
member on external function types to retrieve their signature. - Optimizer: Add new optimization step to remove unused
JUMPDEST
s. - Static Analyzer: Warn when using deprecated builtins
sha3
andsuicide
(replaced bykeccak256
andselfdestruct
, introduced in 0.4.2 and 0.2.0, respectively). - Syntax Checker: Warn if no visibility is specified on contract functions.
- Type Checker: Display helpful warning for unused function arguments/return parameters.
- Type Checker: Do not show the same error multiple times for events.
- Type Checker: Greatly reduce the number of duplicate errors shown for duplicate constructors and functions.
- Type Checker: Warn on using literals as tight packing parameters in
keccak256
,sha3
,sha256
andripemd160
. - Type Checker: Enforce
view
andpure
. - Type Checker: Enforce
view
/constant
with error as experimental 0.5.0 feature. - Type Checker: Enforce fallback functions to be
external
as experimental 0.5.0 feature.
Bugfixes:
- ABI JSON: Include all overloaded events.
- Parser: Crash fix related to parseTypeName.
- Type Checker: Allow constant byte arrays.
Features:
- ABI JSON: Include new field
stateMutability
with valuespure
,view
,nonpayable
andpayable
. - Analyzer: Experimental partial support for Z3 SMT checker ("SMTChecker").
- Build System: Shared libraries (
libdevcore
,libevmasm
,libsolidity
andliblll
) are no longer produced during the build process. - Code generator: Experimental new implementation of ABI encoder that can encode arbitrarily nested arrays ("ABIEncoderV2")
- Metadata: Store experimental flag in metadata CBOR.
- Parser: Display previous visibility specifier in error if multiple are found.
- Parser: Introduce
pure
andview
keyword for functions,constant
remains an alias forview
and pureness is not enforced yet, so use with care. - Static Analyzer: Warn about large storage structures.
- Syntax Checker: Support
pragma experimental <feature>;
to turn on experimental features. - Type Checker: More detailed error message for invalid overrides.
- Type Checker: Warn about shifting a literal.
Bugfixes:
- Assembly Parser: Be more strict about number literals.
- Assembly Parser: Limit maximum recursion depth.
- Parser: Enforce commas between array and tuple elements.
- Parser: Limit maximum recursion depth.
- Type Checker: Crash fix related to
using
. - Type Checker: Disallow constructors in libraries.
- Type Checker: Reject the creation of interface contracts using the
new
statement.
Features:
- Type Checker: Show unimplemented function if trying to instantiate an abstract class.
Bugfixes:
- Code Generator:
.delegatecall()
should always return execution outcome. - Code Generator: Provide "new account gas" for low-level
callcode
anddelegatecall
. - Type Checker: Constructors must be implemented if declared.
- Type Checker: Disallow the
.gas()
modifier onecrecover
,sha256
andripemd160
. - Type Checker: Do not mark overloaded functions as shadowing other functions.
- Type Checker: Internal library functions must be implemented if declared.
Features:
- C API (
jsonCompiler
): Export thelicense
method. - Code Generator: Optimise the fallback function, by removing a useless jump.
- Inline Assembly: Show useful error message if trying to access calldata variables.
- Inline Assembly: Support variable declaration without initial value (defaults to 0).
- Metadata: Only include files which were used to compile the given contract.
- Type Checker: Disallow value transfers to contracts without a payable fallback function.
- Type Checker: Include types in explicit conversion error message.
- Type Checker: Raise proper error for arrays too large for ABI encoding.
- Type checker: Warn if using
this
in a constructor. - Type checker: Warn when existing symbols, including builtins, are overwritten.
Bugfixes:
- Code Generator: Properly clear return memory area for ecrecover.
- Type Checker: Fix crash for some assignment to non-lvalue.
- Type Checker: Fix invalid "specify storage keyword" warning for reference members of structs.
- Type Checker: Mark modifiers as internal.
- Type Checker: Re-allow multiple mentions of the same modifier per function.
Features:
- Syntax Checker: Deprecated "throw" in favour of require(), assert() and revert().
- Type Checker: Warn if a local storage reference variable does not explicitly use the keyword
storage
.
Bugfixes:
- Code Generator: Correctly unregister modifier variables.
- Compiler Interface: Only output AST if analysis was successful.
- Error Output: Do not omit the error type.
Features:
- Assembly: Add
CREATE2
(EIP86),STATICCALL
(EIP214),RETURNDATASIZE
andRETURNDATACOPY
(EIP211) instructions. - Assembly: Display auxiliary data in the assembly output.
- Assembly: Renamed
SHA3
toKECCAK256
. - AST: export all attributes to JSON format.
- C API (
jsonCompiler
): Use the Standard JSON I/O internally. - Code Generator: Added the Whiskers template system.
- Inline Assembly:
for
andswitch
statements. - Inline Assembly: Function definitions and function calls.
- Inline Assembly: Introduce
keccak256
as an opcode.sha3
is still a valid alias. - Inline Assembly: Present proper error message when not supplying enough arguments to a functional instruction.
- Inline Assembly: Warn when instructions shadow Solidity variables.
- Inline Assembly: Warn when using
jump
s. - Remove obsolete Why3 output.
- Type Checker: Enforce strict UTF-8 validation.
- Type Checker: Warn about copies in storage that might overwrite unexpectedly.
- Type Checker: Warn about type inference from literal numbers.
- Static Analyzer: Warn about deprecation of
callcode
.
Bugfixes:
- Assembly: mark
MLOAD
to have side effects in the optimiser. - Code Generator: Fix ABI encoding of empty literal string.
- Code Generator: Fix negative stack size checks.
- Code generator: Use
REVERT
instead ofINVALID
for generated input validation routines. - Inline Assembly: Enforce function arguments when parsing functional instructions.
- Optimizer: Disallow optimizations involving
MLOAD
because it changesMSIZE
. - Static Analyzer: Unused variable warnings no longer issued for variables used inside inline assembly.
- Type Checker: Fix address literals not being treated as compile-time constants.
- Type Checker: Fixed crash concerning non-callable types.
- Type Checker: Fixed segfault with constant function parameters
- Type Checker: Disallow comparisons between mapping and non-internal function types.
- Type Checker: Disallow invoking the same modifier multiple times.
- Type Checker: Do not treat strings that look like addresses as addresses.
- Type Checker: Support valid, but incorrectly rejected UTF-8 sequences.
Features:
- Implement the Standard JSON Input / Output API
- Support
interface
contracts. - C API (
jsonCompiler
): Add thecompileStandard()
method to process a Standard JSON I/O. - Commandline interface: Add the
--standard-json
parameter to process a Standard JSON I/O. - Commandline interface: Support
--allow-paths
to define trusted import paths. Note: the path(s) of the supplied source file(s) is always trusted. - Inline Assembly: Storage variable access using
_slot
and_offset
suffixes. - Inline Assembly: Disallow blocks with unbalanced stack.
- Static analyzer: Warn about statements without effects.
- Static analyzer: Warn about unused local variables, parameters, and return parameters.
- Syntax checker: issue deprecation warning for unary '+'
Bugfixes:
- Assembly output: Implement missing AssemblyItem types.
- Compiler interface: Fix a bug where source indexes could be inconsistent between Solidity compiled with different compilers (clang vs. gcc) or compiler settings. The bug was visible in AST and source mappings.
- Gas Estimator: Reflect the most recent fee schedule.
- Type system: Contract inheriting from base with unimplemented constructor should be abstract.
- Optimizer: Number representation bug in the constant optimizer fixed.
Features:
- Add
assert(condition)
, which throws if condition is false (meant for internal errors). - Add
require(condition)
, which throws if condition is false (meant for invalid input). - Commandline interface: Do not overwrite files unless forced.
- Introduce
.transfer(value)
for sending Ether. - Code generator: Support
revert()
to abort with rolling back, but not consuming all gas. - Inline assembly: Support
revert
(EIP140) as an opcode. - Parser: Support scientific notation in numbers (e.g.
2e8
and200e-2
). - Type system: Support explicit conversion of external function to address.
- Type system: Warn if base of exponentiation is literal (result type might be unexpected).
- Type system: Warn if constant state variables are not compile-time constants.
Bugfixes:
- Commandline interface: Always escape filenames (replace
/
,:
and.
with_
). - Commandline interface: Do not try creating paths
.
and..
. - Commandline interface: Allow long library names.
- Parser: Disallow octal literals.
- Type system: Fix a crash caused by continuing on fatal errors in the code.
- Type system: Disallow compound assignment for tuples.
- Type system: Detect cyclic dependencies between constants.
- Type system: Disallow arrays with negative length.
- Type system: Fix a crash related to invalid binary operators.
- Type system: Disallow
var
declaration with empty tuple type. - Type system: Correctly convert function argument types to pointers for member functions.
- Type system: Move privateness of constructor into AST itself.
- Inline assembly: Charge one stack slot for non-value types during analysis.
- Assembly output: Print source location before the operation it refers to instead of after.
- Optimizer: Stop trying to optimize tricky constants after a while.
Features:
- Compiler interface: Contracts and libraries can be referenced with a
file:
prefix to make them unique. - Compiler interface: Report source location for "stack too deep" errors.
- AST: Use deterministic node identifiers.
- Inline assembly: introduce
invalid
(EIP141) as an opcode. - Type system: Introduce type identifier strings.
- Type checker: Warn about invalid checksum for addresses and deduce type from valid ones.
- Metadata: Do not include platform in the version number.
- Metadata: Add option to store sources as literal content.
- Code generator: Extract array utils into low-level functions.
- Code generator: Internal errors (array out of bounds, etc.) now cause a reversion by using an invalid instruction (0xfe - EIP141) instead of an invalid jump. Invalid jump is still kept for explicit throws.
Bugfixes:
- Code generator: Allow recursive structs.
- Inline assembly: Disallow variables named like opcodes.
- Type checker: Allow multiple events of the same name (but with different arities or argument types)
- Natspec parser: Fix error with
@param
parsing and whitespace.
Features:
- Optimiser: Performance improvements.
- Output: Print assembly in new standardized Solidity assembly format.
Bugfixes:
- Remappings: Prefer longer context over longer prefix.
- Type checker, code generator: enable access to events of base contracts' names.
- Imports:
import ".dir/a"
is not a relative path. Relative paths begin with directory.
or..
. - Type checker, disallow inheritances of different kinds (e.g. a function and a modifier) of members of the same name
Features:
- Bitshift operators.
- Type checker: Warn when
msg.value
is used in non-payable function. - Code generator: Inject the Swarm hash of a metadata file into the bytecode.
- Code generator: Replace expensive memcpy precompile by simple assembly loop.
- Optimizer: Some dead code elimination.
Bugfixes:
- Code generator: throw if calling the identity precompile failed during memory (array) copying.
- Type checker: string literals that are not valid UTF-8 cannot be converted to string type
- Code generator: any non-zero value given as a boolean argument is now converted into 1.
- AST Json Converter: replace
VariableDefinitionStatement
nodes withVariableDeclarationStatement
- AST Json Converter: fix the camel case in
ElementaryTypeNameExpression
- AST Json Converter: replace
public
field withvisibility
in the function definition nodes
Bugfixes:
- Optimizer: Knowledge about state was not correctly cleared for JUMPDESTs (introduced in 0.4.5)
Features:
- Function types
- Do-while loops: support for a
do <block> while (<expr>);
control structure - Inline assembly: support
invalidJumpLabel
as a jump label. - Type checker: now more eagerly searches for a common type of an inline array with mixed types
- Code generator: generates a runtime error when an out-of-range value is converted into an enum type.
Bugfixes:
- Inline assembly: calculate stack height warning correctly even when local variables are used.
- Code generator: check for value transfer in non-payable constructors.
- Parser: disallow empty enum definitions.
- Type checker: disallow conversion between different enum types.
- Interface JSON: do not include trailing new line.
Bugfixes:
- Type checker: forbid signed exponential that led to an incorrect use of EXP opcode.
- Code generator: properly clean higher order bytes before storing in storage.
Features:
- Inline assembly: support both
suicide
andselfdestruct
opcodes (note:suicide
is deprecated). - Inline assembly: issue warning if stack is not balanced after block.
- Include
keccak256()
as an alias tosha3()
. - Support shifting constant numbers.
Bugfixes:
- Commandline interface: Disallow unknown options in
solc
. - Name resolver: Allow inheritance of
enum
definitions. - Type checker: Proper type checking for bound functions.
- Type checker: fixed crash related to invalid fixed point constants
- Type checker: fixed crash related to invalid literal numbers.
- Type checker:
super.x
does not look upx
in the current contract. - Code generator: expect zero stack increase after
super
as an expression. - Code generator: fix an internal compiler error for
L.Foo
forenum Foo
defined in libraryL
. - Code generator: allow inheritance of
enum
definitions. - Inline assembly: support the
address
opcode. - Inline assembly: fix parsing of assignment after a label.
- Inline assembly: external variables of unsupported type (such as
this
,super
, etc.) are properly detected as unusable. - Inline assembly: support variables within modifiers.
- Optimizer: fix related to stale knowledge about SHA3 operations
Bugfixes:
- Code Generator: Fix library functions being called from payable functions.
- Type Checker: Fixed a crash about invalid array types.
- Code Generator: Fixed a call gas bug that became visible after version 0.4.0 for calls where the output is larger than the input.
- Build System: Fixes to allow library compilation.
This release deliberately breaks backwards compatibility mostly to
enforce some safety features. The most important change is that you have
to explicitly specify if functions can receive ether via the payable
modifier. Furthermore, more situations cause exceptions to be thrown.
Minimal changes to be made for upgrade:
- Add
payable
to all functions that want to receive Ether (including the constructor and the fallback function). - Change
_
to_;
in modifiers. - Add version pragma to each file:
pragma solidity ^0.4.0;
Breaking Changes:
- Source files have to specify the compiler version they are
compatible with using e.g.
pragma solidity ^0.4.0;
orpragma solidity >=0.4.0 <0.4.8;
- Functions that want to receive Ether have to specify the
new
payable
modifier (otherwise they throw). - Contracts that want to receive Ether with a plain "send"
have to implement a fallback function with the
payable
modifier. Contracts now throw if no payable fallback function is defined and no function matches the signature. - Failing contract creation through "new" throws.
- Division / modulus by zero throws.
- Function call throws if target contract does not have code
- Modifiers are required to contain
_
(useif (false) _
as a workaround if needed). - Modifiers: return does not skip part in modifier after
_
. - Placeholder statement
_
in modifier now requires explicit;
. ecrecover
now returns zero if the input is malformed (it previously returned garbage).- The
constant
keyword cannot be used for constructors or the fallback function. - Removed
--interface
(Solidity interface) output option - JSON AST: General cleanup, renamed many nodes to match their C++ names.
- JSON output:
srcmap-runtime
renamed tosrcmapRuntime
. - Moved (and reworked) standard library contracts from inside the compiler to github.com/ethereum/solidity/std
(
import "std";
orimport owned;
do not work anymore). - Confusing and undocumented keyword
after
was removed. - New reserved words:
abstract
,hex
,interface
,payable
,pure
,static
,view
.
Features:
- Hexadecimal string literals:
hex"ab1248fe"
- Internal: Inline assembly usable by the code generator.
- Commandline interface: Using
-
as filename allows reading from stdin. - Interface JSON: Fallback function is now part of the ABI.
- Interface: Version string now semver compatible.
- Code generator: Do not provide "new account gas" if we know the called account exists.
Bugfixes:
- JSON AST: Nodes were added at wrong parent
- Why3 translator: Crash fix for exponentiation
- Commandline Interface: linking libraries with underscores in their name.
- Type Checker: Fallback function cannot return data anymore.
- Code Generator: Fix crash when
sha3()
was used on unsupported types. - Code Generator: Manually set gas stipend for
.send(0)
.
Lots of changes to the documentation mainly by voluntary external contributors.
Features:
- Formal verification: Take external effects on a contract into account.
- Type Checker: Warning about unused return value of low-level calls and send.
- Output: Source location and node id as part of AST output
- Output: Source location mappings for bytecode
- Output: Formal verification as part of json compiler output.
Bugfixes:
- Commandline Interface: Do not crash if input is taken from stdin.
- Scanner: Correctly support unicode escape codes in strings.
- JSON output: Fix error about relative / absolute source file names.
- JSON output: Fix error about invalid utf8 strings.
- Code Generator: Dynamic allocation of empty array caused infinite loop.
- Code Generator: Correctly calculate gas requirements for memcpy precompile.
- Optimizer: Clear known state if two code paths are joined.
Features:
- Context-dependent path remappings (different modules can use the same library in different versions)
Bugfixes:
- Type Checking: Dynamic return types were removed when fetching data from external calls, now they are replaced by an "unusable" type.
- Type Checking: Overrides by constructors were considered making a function non-abstract.
No change outside documentation.
- Allow internal library functions to be called (by "inlining")
- Fractional/rational constants (only usable with fixed point types, which are still in progress)
- Inline assembly has access to internal functions (as jump labels)
- Running
solc
without arguments on a terminal will print help. - Bugfix: Remove some non-determinism in code generation.
- Bugfix: Corrected usage of not / bnot / iszero in inline assembly
- Bugfix: Correctly clean bytesNN types before comparison
- Bugfix: Inline assembly parser:
byte
opcode was unusable - Bugfix: Error reporting: tokens for variably-sized types were not converted to string properly
- Bugfix: Dynamic arrays of structs were not deleted correctly.
- Bugfix: Static arrays in constructor parameter list were not decoded correctly.
- Inline assembly
- Bugfix: Code generation: array access with narrow types did not clean higher order bits
- Bugfix: Error reporting: error reporting with unknown source location caused a crash
BREAKING CHANGES:
- Added new keywords
assembly
,foreign
,fixed
,ufixed
,fixedNxM
,ufixedNxM
(for various values of M and N),timestamp
- Number constant division does not round to integer, but to a fixed point type (e.g.
1 / 2 != 1
, but1 / 2 == 0.5
). - Library calls now default to use DELEGATECALL (e.g. called library functions see the same value as the calling function for
msg.value
andmsg.sender
). <address>.delegatecall
as a low-level calling interface
Bugfixes:
- Fixed a bug in the optimizer that resulted in comparisons being wrong.
- Index access for types
bytes1
, ...,bytes32
(only read access for now). - Bugfix: Type checker crash for wrong number of base constructor parameters.
- Inline arrays, i.e.
var y = [1,x,f()];
if there is a common type for1
,x
andf()
. Note that the result is always a fixed-length memory array and conversion to dynamic-length memory arrays is not yet possible. - Import similar to ECMAScript6 import (
import "abc.sol" as d
andimport {x, y} from "abc.sol"
). - Commandline compiler solc automatically resolves missing imports and allows for "include directories".
- Conditional:
x ? y : z
- Bugfix: Fixed several bugs where the optimizer generated invalid code.
- Bugfix: Enums and structs were not accessible to other contracts.
- Bugfix: Fixed segfault connected to function parameter types, appeared during gas estimation.
- Bugfix: Type checker crash for wrong number of base constructor parameters.
- Bugfix: Allow function overloads with different array types.
- Bugfix: Allow assignments of type
(x) = 7
. - Bugfix: Type
uint176
was not available. - Bugfix: Fixed crash during type checking concerning constructor calls.
- Bugfix: Fixed crash during code generation concerning invalid accessors for struct types.
- Bugfix: Fixed crash during code generating concerning computing a hash of a struct type.
- Breaking Change:
new ContractName.value(10)()
has to be written as(new ContractName).value(10)()
- Added
selfdestruct
as an alias forsuicide
. - Allocation of memory arrays using
new
. - Binding library functions to types via
using x for y
addmod
andmulmod
(modular addition and modular multiplication with arbitrary intermediate precision)- Bugfix: Constructor arguments of fixed array type were not read correctly.
- Bugfix: Memory allocation of structs containing arrays or strings.
- Bugfix: Data location for explicit memory parameters in libraries was set to storage.
- Improved error messages for unexpected tokens.
- Proof-of-concept transcompilation to why3 for formal verification of contracts.
- Bugfix: Arrays (also strings) as indexed parameters of events.
- Bugfix: Writing to elements of
bytes
orstring
overwrite others. - Bugfix: "Successor block not found" on Windows.
- Bugfix: Using string literals in tuples.
- Bugfix: Cope with invalid commit hash in version for libraries.
- Bugfix: Some test framework fixes on windows.
.push()
for dynamic storage arrays.- Tuple expressions (
(1,2,3)
orreturn (1,2,3);
) - Declaration and assignment of multiple variables (
var (x,y,) = (1,2,3,4,5);
orvar (x,y) = f();
) - Destructuring assignment (
(x,y,) = (1,2,3)
) - Bugfix: Internal error about usage of library function with invalid types.
- Bugfix: Correctly parse
Library.structType a
at statement level. - Bugfix: Correctly report source locations of parenthesized expressions (as part of "tuple" story).
- Breaking change in storage encoding: Encode short byte arrays and strings together with their length in storage.
- Report warnings
- Allow storage reference types for public library functions.
- Access to types declared in other contracts and libraries via
.
. - Version stamp at beginning of runtime bytecode of libraries.
- Bugfix: Problem with initialized string state variables and dynamic data in constructor.
- Bugfix: Resolve dependencies concerning
new
automatically. - Bugfix: Allow four indexed arguments for anonymous events.
- Bugfix: Detect too large integer constants in functions that accept arbitrary parameters.
- Bugfix: Returning fixed-size arrays.
- Bugfix: combined-json output of solc.
- Bugfix: Accessing fixed-size array return values.
- Bugfix: Disallow assignment from literal strings to storage pointers.
- Refactoring: Move type checking into its own module.
throw
statement.- Libraries that contain functions which are called via CALLCODE.
- Linker stage for compiler to insert other contract's addresses (used for libraries).
- Compiler option to output runtime part of contracts.
- Compile-time out of bounds check for access to fixed-size arrays by integer constants.
- Version string includes libevmasm/libethereum's version (contains the optimizer).
- Bugfix: Accessors for constant public state variables.
- Bugfix: Propagate exceptions in clone contracts.
- Bugfix: Empty single-line comments are now treated properly.
- Bugfix: Properly check the number of indexed arguments for events.
- Bugfix: Strings in struct constructors.
- Improved commandline interface.
- Explicit conversion between
bytes
andstring
. - Bugfix: Value transfer used in clone contracts.
- Bugfix: Problem with strings as mapping keys.
- Bugfix: Prevent usage of some operators.
- Strings can be used as mapping keys.
- Clone contracts.
- Mapping members are skipped for structs in memory.
- Use only a single stack slot for storage references.
- Improved error message for wrong argument count. (#2456)
- Bugfix: Fix comparison between
bytesXX
types. (#2087) - Bugfix: Do not allow floats for integer literals. (#2078)
- Bugfix: Some problem with many local variables. (#2478)
- Bugfix: Correctly initialise
string
andbytes
state variables. - Bugfix: Correctly compute gas requirements for callcode.