Hghlights

Migrate Nethermind users to Blast

Nethermind has ended its free Starknet RPC service. All existing users who have Nethermind configured as a free RPC vendor in profiles are automatically migrated to Blast instead.

Full changes

Features

• 230f24a: migrate nethermind users to blast

Misc

• b116e2c: remove unmaintained audit workflow
• 95822e3: bump rust and fix clippy lints

Full Changelog: v0.4.1...v0.4.2

Hghlights

Updated JSON-RPC version

The target JSON-RPC version has been updated from v0.8.0 to v0.8.1. The compatibility warning is no longer displayed when using an up-to-date node.

Braavos compatibility warnings

Some Barrvos account classes suffer from JSON-RPC v0.8.x compatibility issue due to an extra check on resource bounds. This release adds a warning message when attempting to import, deploy, or use these affected classes.

Full changes

Features

• 5ab6e82: braavos compatibility warning
• 96d2ebf: use cairo compiler v2.11.4
• 52ecbca: bump jsonrpc version to 0.8.1

Misc

• d83e898: update termux-packages rev

Full Changelog: v0.4.0...v0.4.1

This is a breaking release which switches to use JSON-RPC spec v0.8.0.

Support for pre-v3 transactions has also been dropped. Starkli v0.4.0+ releases no longer allow paying transaction fees in ETH.

Full changes

Features

• 065e39d: switch to JSON-RPC v0.8.0

Misc

• e7a9f03: remove outdated references to --compiler-version
• d846cd4: update termux-packages rev

Full Changelog: v0.3.8...v0.4.0

Hghlights

Revamped Sierra->CASM support

This release introduces the capability to automatically infer the right Sierra->CASM compiler version to use based on the Sierra class artifact alone. Previously, this was done with the --compiler-version option, which is now no longer relevant and thus deprecated and ignored. A warning is shown when this option is still used. It will be removed in a future breaking release. If you were not using --compiler-version to begin with, this change does not affect you in any visible way.

Support for Sierra v1.7,0 is also added. This is the target Sierra version for Cairo compiler v2.10.0+. It's currently only activated on testnet.

OZ account versions 0.20.0 and 1.0.0

Class hashes for the OpenZeppelin preset account contract of versions v0.20.0 and v1.0.0 have been added to the known account class list. The starkli account oz init command now uses the v1.0.0 class hash.

Full changes

Features

• ba05989: infer compiler version from sierra bytecode
• 24a2bc4: oz account 0.20.0 and 1.0.0

Misc

• ef2c804: switch to artifact workflow v4
• 6773f22: update termux-packages rev

Full Changelog: v0.3.7...v0.3.8

Hghlights

ETH fee token deprecation

The main change with this release is the deprecation of using ETH as fee token, i.e. sending pre-v3 transactions. A warning is displayed when you ignore --fee-token (to fall back to using ETH) or explicitly using ETH with --fee-token eth or --eth.

In the next breaking release (i.e. v0.4.0), the fallback (when no fee token setting is provided) will change to STRK instead. The option to use ETH for fees, however, will remain in place until Starknet officially disables pre-v3 transactions.

Custom block option for storage command

The storage command now accepts the --block option as expected.

New bytearray scheme

A new scheme bytearray has been added for argument resolution with the Cairo type ByteArray. It's documented in the Starkli book here.

Full changes

Features

• 0a17a9b: deprecate ETH fee token
• 4c92ac0: custom block for storage command
• b0944c1: bytearray: scheme

Misc

• c0e8136: fix typo "stakrliup" with "starkliup" (#110)

Full Changelog: v0.3.6...v0.3.7

Highlights

New Cairo compiler versions

Built-in Cairo compiler versions now include 2.9.1, which is now used by default as v2.9.x uses the same Sierra revision as v2.8.x.

Easier scripting with STARKNET_KEYSTORE_PASSWORD env var

A new environment variable STARKNET_KEYSTORE_PASSWORD has been added to allow scripts to be easily configured to run non-interactively. It has the same effect as the --keystore-password option.

Argent account contract v0.4.0 support

Argent argent contract v0.4.0 contains a breaking change on the constructor signature. Starkli has now been updated to use this new signature. Previous versions of Starkli cannot deploy the latest Argent account (though fetching and using them were not affected).

New Braavos account class hash

Added new hash as of extension version v3.80.7.

New OZ account class hashes

OZ class hashes for v0.15.0 to v0.19.0 have been added.

Full changes

Features

• 0fcc31d: support new Braavos class hash when fetching (#109)
• 2cff069: support cairo compiler v2.9.x
• 55a1bb4: update built-in katana account list
• c20135e: oz account contracts 0.15.0-0.19.0
• 1bed333: STARKNET_KEYSTORE_PASSWORD env var

Fixed

• 5b4f853: Argent account v0.4.0 deployment

Misc

• 4d45ec1: upgrade rust to 1.83
• 8d55d17: update starknet-rs to latest release
• b819661: unify tty color check
• df10e5b: remove AnyProvider usage
• 669a6f0: make Ledger support option

Full Changelog: v0.3.5...v0.3.6

Highlights

New Cairo compiler versions

Built-in Cairo compiler versions now include 2.8.2.

Match all patch compiler versions

Starkli now supports ignoring the patch portion of the compiler when declaring, and it would automatically match the latest minor version. For example:

starkli declare --compiler-version 2.8 ...

Note that ideally users shouldn't have to specify a version at all, as it's usually automatically inferred from the network being used. That said, it might still be useful in some cases.

Full changes

Features

• 14ad06f: upgrade cairo compiler to 2.8.2
• 22db631: allow omitting compiler patch version

Misc

• db63131: upgrade Rust toolchain to 1.81.0

Full Changelog: v0.3.4...v0.3.5

Highlights

New Cairo compiler versions

The built-in compiler versions have been changed to v2.6.4 and v2.7.1.

Support for JSON-RPC-formatted classes

Previously, to redeclare a class one must fetch the class with the --parse flag to convert the over-the-wire class format to the one from compiler output. The same goes for calculating class hashes with class-hash.

Users can now directly declare or compute class hashes for these wire-format classes. This now works:

starkli class-by-hash --network sepolia SOME_CLASS_HASH_HERE > class.json
starkli declare --network mainnet ./class.json

without having to use --parse on the class-by-hash command.

Custom OpenZeppelin account class hash

It's now possible to supply a custom account class hash when initializing an OZ account:

starkli account oz init --class-hash xxxx

starkliup improvements

Since the last release, several improvements have been made on starkliup, including proper support for Fish shell. These changes are continuously deployed, so they have been available before this release was cut.

Full changes

Features

• 689d03f: upgrade cairo compiler to 2.7.1
• 56e044b: hashing and declaring jsonrpc-formatted classes
• 0e9b706: custom OZ account class hash
• e2210b1: upgrade cairo compiler to 2.6.4 and 2.7.0
• 56fcee1: support new Argent contract class hash (#92)

Fixed

• c730f64: starkliup: incorrect zsh detection with SHELL
• 950b63e: starkliup: env script POSIX compliance
• bb2bc2c: starkliup: support Fish shell

Misc

• 7fef2a7: chore: bump time dependency version

Full Changelog: v0.3.3...v0.3.4

This release contains minor improvements:

A new abi command has been added for quickly extracting ABI from class artifact files, and optionally displaying them as a Pythonic serialized string for other toolings:

starkli abi class.json --flatten --pythonic

The USDC token address has been added to the mainnet address book as usdc. Users can now more easily invoke commands involving USDC:

starkli invoke usdc transfer 0x1234 u256:123

The call command now has a new option --block for specifying the block to execute the query on:

starkli call eth balanceOf 0x1234 --block 100

where the --block option takes any block number, hash, or the latest or pending tags.

Features

• e0d2798: add abi command
• 0f3493f: mainnet address book entry for usdc
• 61650d9: --block option for call command

Full Changelog: v0.3.2...v0.3.3

This release brings Ledger support to Starkli. Users can now use Ledger as a signer for any command expecting one. This is now the recommended way of managing accounts with a significant amount of funds:

A new page on the Starkli book has been added as a complete guide on using Ledger with Starkli. Check out the page for more details.

Support for OpenZeppelin account contract v0.14.0 has also been added.

Features

• 4fc808d: read public key from Ledger wallet
• 721c433: get ledger app version
• 825adea: raw hash blind signing with Ledger
• 0c1627c: use Ledger as signer via --ledger-path
• 2a2e672: oz account contract 0.14.0
• 92d3897: user-friendly EIP-2645 path parsing
• 05172e0: eip-2645 echo command
• b4eea71: display public key on Ledger by default

Fixed

• dca7d91: ledger path from env var not using extension

Misc

• c83b648: use latest starknet-rs rev

Full Changelog: v0.3.1...v0.3.2