All notable changes to Solang will be documented here.
- The
string.concat()
andbytes.concat()
builtin functions are supported. seanyoung
- BREAKING The non-standard extension of concatenating strings using the
+
operator has been removed, usestring.concat()
instead. seanyoung
This release improves the Solana developer experience, since now required accounts can be specified using annotations. For Polkadot, compatibility with Ethereum Solidity has been increased further, it is now possible to write EIP-1967 compatible proxy contracts. There are many fixes all over the code base.
- Solana the required accounts for instructions can now be specified using function annotations. LucasSte
contract Foo { @account(oneAccount) @signer(mySigner) @mutableAccount(otherAccount) @mutableSigner(otherSigner) function bar() external returns (uint64) {} }
- The language server can now format Solidity source code using the
forge-fmt
crate. chioni16 - The langauge server can now do go references, go to implementation, and go to type definition. chioni16
- Polkadot
Panic
errors can now be caught in try-catch statements xermicus - Polkadot custom errors are now supported xermicus
- Polkadot now supporting the
address.code
builtin xermicus
- Solana the data field of AccountInfo can now be modified. LucasSte
- The vscode extension now uses the solang binary in the path, if available. seanyoung
- Fixed a bug in the ABI encoding of dynamic arrays. xermicus
- Fixed a bug where loading from a storage struct member was not considered a storage read. xermicus seanyoung
- Fixed a compiler crash caused by chained assignments like
return a = b
. xermicus - Variables declared in the return parameters no longer ignore the
storage
location. xermicus
- BREAKING: Solana the contract Solidity type can no longer be used. This type used to represent a single address, but this does not make sense as there are many accounts associated with a contract call. LucasSte
The language server is much improved, and many fixes all over.
- Go to definition is now implemented in the language server. chioni16
- The parser has been updated to be compatible with Ethereum Solidity v0.8.21. seanyoung
- Polkadot Support for runtimes built with on
polkadot-v1.0.0
- breaking Resolving import paths now matches solc more closely, and only resolves relative
paths when specified as
./foo
or../foo
. seanyoung - Solana The
lamports
anddata
fields oftx.accounts
can be modified again. LucasSte - Solana The
address.transfer()
andaddress.send()
functions no longer change any balances in the error case if there was an overflow (e.g. not enough balance). LucasSte - Solana When collecting the required accounts, ensure that the writer and signer bits are set correctly if the same account is used multiple times. LucasSte
- It is not longer necessary to save a Solidity file, in order for the language server to pick up changes to the file. chioni16
- The negate operator
-
now checks for overflow at runtime, and other math overflow fixes. seanyoung - Fixed a bug where accessing the function selector of virtual functions might cause a compiler panic. xermicus
- Fixed a bug where the strength reduce optimization pass removed overflow checks on optimized multiplications. xermicus
- Fixed a bug where external function variables were not marked as
read
when they were called by the semantic analyzer, which could lead to the external function call being eliminated spuriously. xermicus - Fixed a bug in
try-catch
where a failed transfer trapped the contract instead of handling it in a catch all block. xermicus
- The Substrate target has been renamed to Polkadot. xermicus
- Polkadot
assert()
andrequire()
is now implemented as a transction revert, rather than a trap. The error data is returned, and encoded the same as on Ethereum. Error data is now passed to the calling contract, all the way up the call stack. xermicus - Polkadot constructor can be non-payable. xermicus
- Storage variables are now always written to, regardless whether the contract does read them or not. Prior behavior was to not write to storage variables if they are not read, which can remove wanted side effects, because unused storage variables may be used in future versions of the contract. xermicus
- Solana seeds can now be of type
address
orbytesN
, in addition tobytes
. seanyoung
- Write environment configuration into Substrate metadata. xermicus
- Tornado cash as an exemplary integration test for Substrate chain extensions. xermicus
is_contract
runtime API is available as a builtin for Substrate. xermicus- The
wasm-opt
optimizer now optimizes the Wasm bytecode on the Substrate target. xermicus - Call flags are now available for Substrate. xermicus
- Read compiler configurations from toml file. salaheldinsoliman
- Accounts declared with
@payer(my_account)
can be accessed with the syntaxtx.accounts.my_account
. LucasSte delegatecall()
builtin has been added for Substrate. xermicusget_contents_of_file_no
for Solang parser. BenTheKushset_code_hash()
builtin has been aded for Substrate. xermicus
- Diagnostics do not include large numbers anymore. seanyoung
- Correctly parse and resolve
require(i < 2**255)
. seanyoung - Virtual function are available for call. xermicus
- Allow
.wrap()
and.unwrap()
user defined type methods in constants. xermicus @inheritdoc
now works with bases of bases. seanyoung- Allow destructures to assign to storage variables. seanyoung
- Do not allow push and pop in fixed length arrays. LucasSte
- Improve unused variable elimination to remove unused arrays. LucasSte
- Salt argument should be of type
bytes32
. seanyoung - Allow return vallues to be ignored in try-catch statements. seanyoung
- Optimize modifiers' CFGs. xermicus
- Fix an error whereby building large contracts would cause an LLVM error. LucasSte
- A constructor for a Solana contract cannot run twice on the same data account. seanyoung
- Split the
call
anddeploy
dispatches on Substrate. xermicus
- Minimum Supported Rust Version (MSRV) is Rust
1.68
. @payer
annotation declares an account in a constructor. LucasSte- Do not allow
.call()
functions in functions declared as view. seanyoung - Storage accessor function matches solc, and returns struct members if the sole return value is a single struct seanyoung
- breaking Constructor annotations above a constructor can either declare an account or receive a literal parameter. LucasSte
contract MyContract { @payer(acc) // Declares account acc @space(2+3) // Only literals or constant expressions allowed @seed(myseed) // NOT ALLOWED constructor(bytes myseed) {} }
- Annotations placed before constructor arguments refer to the latter. LucasSte
contract MyContract { @payer(acc) // Declares account acc @space(2+3) // Only literals or constant expressions allowed constructor(@seed bytes myseed) {} // When an annotations refers to a parameter, the former must appear right before the latter. }
The parser and semantic analysis stage of Solang have gone through a security audit. All security issues have been fixed.
- The CLI now has a
--release
option, which disables printing of errors salaheldinsoliman - Substrate: chain extensions can be now used. xermicus
- Solidity error definitions are now parsed. seanyoung
- The Ethereum Solidity parser and semantic analysis tests are now run on Solang sema during
cargo test
. seanyoung - If a function returns a
storage
reference, then not returning a value explicitly is an error, since the reference must refer to an existing storage variable. seanyoung - Many small improvements have been made to the parser and semantic analysis, improving compatibility with Ethereum Solidity. seanyoung xermicus LucasSte
- Solana: Addresses are now base58 encoded when formated with
"address:{}".format(address)
. LucasSte - Substrate: No longer use the prefixed names for seal runtime API calls, which grants small improvements in contract sizes. xermicus
- The Solana units
sol
andlamports
are now supported, e.g.10 sol
and100 lamports
. seanyoung - User defined operators are now supported. This is a feature in Ethereum Solidity v0.8.19. seanyoung
- Solana: if a contract uses the
SystemAccount
,ClockAccount
, or other standard builtin accounts, then this is automatically added to the IDL. LucasSte - Substrate: The content of the debug buffer is formatted in a human readable way. This vastly improves its readability, allowing to spot API runtime return codes, runtime errors and debug prints much easier. salaheldinsoliman
- Solana: contracts with a seed for the constructor do not require a signer in the Anchor IDL seanyoung
- Fix panic when lexing ".9" at the beginning of a file. seanyoung
- Forbid ABI encoding and decoding of recursive types. xermicus
- Treat enums as 8bit uint in constant hashing. xermicus
- Fix compilation failure with -g for the substrate target. salaheldinsoliman
- Fixed incorrect ABI encoding for user defined types. xermicus seanyoung
- Fixed incorrect ABI encoding for struct with fields of type
bytesN
xermicus - Fixed incorrect handling of recursive struct fields. xermicus
- Fixed a bug in our Common Subexpression Elimination optimization pass LucasSte
- Math overflow is now always enabled, unless the math happens with an
unchecked { .. }
block. The--math-overflow
command line option has been removed. seanyoung - Substrate: the SCALE encoder and decoder now uses a much better implementation written in our CFG intermediate format. xermicus
- Substrate: When instantiating a new contract without providing a salt, the salt we be derived from the output of the new
instantiation_nonce
runtime API. xermicus - Minimal Supported Rust Version is
1.65.0
- No longer silently overwrite contract artifacts, if the same contract is defined more than once in different locations seanyoung
- Solidity mappings can now have named key and named value types. seanyoung
- Solang now uses LLVM 15. LucasSte
- Solidity on Solana now required the Anchor framework for the client code, and the
@solana/solidity.js
Typescript library is no longer compatible with Solidity. - When casting hex literal numbers into the
bytesN
type, the hex literal may use leading zeros to match the size with the accordingbytesN
, which aligns solang withsolc
. xermicus
- Many bugs have been fixed by seanyoung, LucasSte and xermicus
- Typos throughout the code have been fixed. omahs
- The Anchor IDL data structure is now generated for every Solana contract, although the actual IDL json file is not yet saved. LucasSte
- The Solana target now utilizes eight byte Anchor discriminators for function dispatch instead of the four byte Ethereum selectors. LucasSte
- The deployment of contracts on Solana now follows the same scheme as Anchor. seanyoung
- Compares between rational literals and integers are not allowed. seanyoung
- Overriding the function selector value is now done using the
@selector([1, 2, 3, 4])
syntax, and the old syntaxselector=hex"12345678"
has been removed. msg.sender
was not implemented correctly on Solana, and has now been removed. seanyoung- Solang now uses LLVM 14. LucasSte
We are happy to release solang v0.2.0
codenamed Berlin
today. Aside from
containing many small fixes and improvements, this release marks a milestone
towards maturing our Substrate compilation target: any regressions building up
since ink!
v3.0 are fixed, most notably the metadata format (shoutout and many
thanks to external contributor extraymond) and
event topics. Furthermore, we are leaving ink!
version 3 behind us, in favor
of introducing compatibility with the recent ink!
4 beta release and the latest
substrate contracts node v0.22.1
.
- Solana / breaking: The try-catch construct is no longer permitted on Solana, as it never worked. Any CPI error will abort the transaction. seanyoung
- Solana: Introduce new sub-command
solang idl
which can be used for generating a Solidity interface file from an Anchor IDL file. This can be used for calling Anchor Contracts on Solana. seanyoung - Substrate: Provide specific Substrate builtins via a "substrate" file. The
Hash
type fromink!
is the firstink!
specific type made available for Solidity contracts. xermicus - Substrate: Introduce the
--log-api-return-codes
CLI flag, which changes the emitted code to print return codes forseal
API calls into the debug buffer. xermicus - Introduce function name mangling for overloaded functions and constructors, so that they can be represented properly in the metadata. xermicus
- The Solana target now uses Borsh encoding rather than eth abi encoding. This is aimed at making Solang contracts Anchor compatible. LucasSte
- Substrate / breaking: Supported node version is now pallet contracts
v0.22.1
. xermicus - Substrate / breaking: Remove the deprecated
random
builtin. xermicus
- Whenever possible, the parser does not give up after the first error. salaheldinsoliman
- Constant expressions are checked for overflow. salaheldinsoliman
- AddMod and MulMod were broken. This is now fixed. LucasSte
- Substrate / breaking: Solang is now compatible with
ink!
version 4 (beta). xermicus - Substrate: Switched ABI generation to use official
ink!
crates, which fixes all remaining metadata regressions. extraymond and xermicus - Substrate: Allow constructors to have a name, so that multiple constructors are
supported, like in
ink!
. xermicus - All provided examples as well as most of the Solidity code snippets in our documentation are now checked for succesful compilation on the Solang CI. xermicus
- Substrate: Fix events with topics. The topic hashes generated by Solang
contracts are now exactly the same as those generated by
ink!
. xermicus
- Introduce sub-commands to the CLI. Now we have dedicated sub-commands for
compile
,doc
,shell-completion
and thelanguage-server
, which makes for a cleaner CLI. seanyoung - On Solana, emitted events are encoded with Borsh encoding following the Anchor format. LucasSte
- The ewasm target has been removed, since ewasm is not going to implemented on Ethereum. The target has been reused for an new EVM target, which is not complete yet. seanyoung
- Substrate: Concrete contracts must now have at least one public function. A
public function is in a contract, if it has public or external functions, if
it has a receive or any fallback function or if it has public storage items
(those will yield public getters). This aligns solang up with
ink!
. xermicus
- Solana v1.11 is now supported. seanyoung
- On Solana, programs now use a custom heap implementation, just like on
Substrate. As result, it is now possible to
.push()
and.pop()
on dynamic arrays in memory. seanyoung - Arithmetic overflow tests are implemented for all integer widths, salaheldinsoliman
- Add an NFT example for Solana LucasSte
- Add a wrapper for the Solana System Program LucasSte
- The selector for functions can be overriden with the
selector=hex"abcd0123"
syntax. seanyoung - Shell completion is available using the
solang shell-completion
subcommand. xermicus - Add support for the
create_program_address()
andtry_find_program_address()
system call on Solana seanyoung - Substrate: The
print()
builtin is now supported and will write to the debug buffer. Additionally, error messages from therequire
statements will now be written to the debug buffer as well. The Substrate contracts pallet prints the contents of the debug buffer to the console for RPC ("dry-run") calls in case theruntime::contracts=debug
log level is configured. xermicus
- DocComments
/** ... */
are now permitted anywhere. seanyoung - Function calls to contract functions via contract name are no longer possible, except for functions of base contracts. xermicus
- Added spl-token integration for Solana
- Solang now generates code for inline assembly, including many Yul builtins
- The documentation has been re-arranged for readability.
- The solang parser can parse the same syntax as Ethereum Solidity 0.8.
- Fixed many parser issues. Now solang-parser parses all files in the
Ethereum Solidity test suite. First run
git submodule update --init --recursive
to fetch the test files, and then run the test withcargo test --workspace
.
- Added support for Solidity user types
- Support
using
syntax on file scope - Support binding functions with
using
- Implemented parsing and semantic analysis of yul (code generation is to follow)
- The language server uses the
--import
and--importmap
arguments - On Solana, it is possible to set the accounts during CPI using the
accounts:
call argument.
- Fixed associativity of the power operator
- A huge amount of fixes improving compatibility with solc
- On Solana, the accounts that were passed into the transactions are listed in
the
tx.accounts
builtin. There is also a builtin structAccountInfo
- A new common subexpression elimination pass was added, thanks to LucasSte
- A graphviz dot file can be generated from the ast, using
--emit ast-dot
- Many improvements to the solidity parser, and the parser has been spun out
in it's own create
solang-parser
.
- Solang now uses LLVM 13.0, based on the Solana LLVM tree
- The ast datastructure has been simplified.
- Many bugfixes across the entire tree.
- Added support for solc import mapppings using
--importmap
- Added support for Events on Solana
msg.data
,msg.sig
,msg.value
,block.number
, andblock.slot
are implemented for Solana- Implemented balance transfers using
.send()
and.transfer()
on Solana - Implemented retrieving account balances on Solana
- Verify ed25519 signatures with
signatureVerify()
on Solana - Added support for Rational numbers
- The address type and value type can changed using
--address-length
and--value-length
command line arguments (for Substrate only)
- Solana now requires v1.8.1 or later
- On Solana, the return data is now provided in the program log. As a result, RPCs are now are now supported.
- On the solang command line, the target must be specified.
- The Solana instruction now includes a 64 bit value field
- Many fixes to the parser and resolver, so solidity compatibility is much improved, thanks to sushi-shi.
- The Sawtooth Sabre target has been removed.
- The generic target has been removed.
- Added a strength reduce pass to eliminate 256/128 bit multiply, division, and modulo where possible.
- Visual Studio Code extension can download the Solang binary from github releases, so the user is not required to download it themselves
- The Solana target now has support for arrays and mapping in contract storage
- The Solana target has support for the keccak256(), ripemd160(), and sha256() builtin hash functions.
- The Solana target has support for the builtins this and block.timestamp.
- Implement abi.encodePacked() for the ethereum abi encoder
- The Solana target now compiles all contracts to a single
bundle.so
BPF program. - Any unused variables, events, or contract variables are now detected and warnings are given, thanks to LucasSte
- The
immutable
attribute on contract storage variables is now supported. - The
override
attribute on public contract storage variables is now supported. - The
unchecked {}
code block is now parsed and supported. Math overflow still is unsupported for types larger than 64 bit. assembly {}
blocks are now parsed and give a friendly error message.- Any variable use before it is given a value is now detected and results in a undefined variable diagnostic, thanks to LucasSte
- Solang now uses LLVM 12.0, based on the Solana LLVM tree
- Fix a number of issues with parsing the uniswap v2 contracts
- ewasm: staticcall() and delegatecall() cannot take value argument
- Fixed array support in the ethereum abi encoder and decoder
- Fixed issues in arithmetic on non-power-of-2 types (e.g. uint112)
- Added a constant folding optimization pass to improve codegen. When variables fold to constant values, they are visible in the hover in the extension
- For Substrate and Solana, address literals can specified with their base58 notation, e.g.
address foo = address"5GBWmgdFAMqm8ZgAHGobqDqX6tjLxJhv53ygjNtaaAn3sjeZ";
- Solana account storage implemented for
bytes
,string
, and structs - Implemented
delete
for Solana
- The Substrate target produces a single .contract file
- The Substrate target now uses the salt argument for seal_instantiate()
- Libraries are allowed to have constant variables
- Fixed ethereum abi encoding/decoding of structs and enums
- Solana now returns an error if account data is not large enough
- Fixed storage bytes push() and pop()
- Ewasm uses precompiles for keccak hashing
- Various ewasm fixes for Hyperledger Burrow
- New Visual Studio Code extension developed under Hyperledger Mentorship programme
- Added language server for use in vscode extension
- Implemented primitives types and operations for Solana
- Functions can be declared outside of contracts
- Constants can be declared outside of contracts
- String formatting using python style "..{}..".format(n)
- Function types are implemented
- An experimental Solana target has been added
- Binaries are generated for Mac
- The Substrate target requires Substrate 2.0
event
can be declared and emitted withemit
- Function modifiers have been implemented
- Tags in doc comments are parsed and resolved
- All major Solidity language features implemented, see our language status page: https://solang.readthedocs.io/en/latest/status.html
import
directives are supported- New
--importpath
command line argument to specify directories to search for imports - Contracts can have base contracts
- Contracts can be abstract
- Interfaces are supported
- Libraries are supported
- The
using
libraryfor
type syntax is supported
- Solang now uses llvm 10.0 rather than llvm 8.0
- In line with Solidity 0.7.0, constructors no longer need a visibility argument