The Stylus SDK

Overview

The Stylus SDK enables smart contract developers to write programs for Arbitrum chains written in the Rust programming language. Stylus programs are compiled to WebAssembly and can then be deployed on-chain to execute alongside Solidity smart contracts. Stylus programs are not only orders of magnitude cheaper and faster but also enable what was thought to be previously impossible for WebAssembly: EVM-interoperability.

For information about deploying Rust smart contracts, see the Cargo Stylus CLI Tool. For more information about Stylus, see Stylus: A Gentle Introduction. For a simpler intro to Stylus Rust development, see the Quick Start guide.

Comprehensive documentation on the Rust SDK can be found here.

Feature highlights

The SDK makes it easy to develop Ethereum ABI-equivalent Stylus contracts in Rust. It provides a full suite of types and shortcuts that abstract away the details of Ethereum's storage layout, making it easy to just write Rust. For an in depth exploration of the features, please see comprehensive Feature Overview.

Some of the features available in the SDK include:

Generic, storage-backed Rust types for programming Ethereum-equivalent smart contracts
Simple macros for writing Solidity structs and entrypoints that get converted to SDK-types internally
Powerful primitive types backed by the feature-rich alloy-rs/crate

Rust programs implemented with the Stylus SDK can call and be called by Solidity smart contracts through Ethereum ABIs and also share the same storage layout.

```rust use stylussdk::{alloyprimitives::U256, prelude::*};

// Generate Solidity-equivalent, Rust structs backed by storage. sol_storage! { #[entrypoint] pub struct Counter { uint256 number; } }

[external]

impl Counter { // Gets the number value from storage. pub fn number(&self) -> Result> { Ok(self.number.get()) } // Sets a number in storage to a user-specified value. pub fn setnumber(&mut self, newnumber: U256) -> Result<(), Vec> { self.number.set(new_number); Ok(()) } } ```

Additionally, the Stylus SDK supports #[no_std] for contracts that wish to opt out of the standard library. In fact, the entire SDK is available from #[no_std], so no special feature flag is required. This can be helpful for reducing binary size, and may be preferable in pure-compute use cases like cryptography.

Most users will want to use the standard library, which is available since the Stylus VM supports rustc's wasm32-unknown-unknown target triple. In the future we may add wasm32-wasi too, along with floating point and SIMD, which the Stylus VM does not yet support.

Don't know Rust?

The Stylus VM supports more than just Rust. In fact, any programming language that compiles down to WebAssembly could in principle be deployed to Stylus-enabled chains. The table below includes the official ports of the SDK, with more coming soon.

| Repo | Use cases | License | |:-----------------|:----------------------------|:------------------| | Rust SDK | Everything! | Apache 2.0 or MIT | | C/C++ SDK | Cryptography and algorithms | Apache 2.0 or MIT | | Bf SDK | Educational | Apache 2.0 or MIT | | Cargo Stylus | Deploying Stylus programs | Apache 2.0 or MIT |

Want to write your own? Join us in the #stylus channel on discord!

Developing Stylus Programs

The Stylus SDK is just one of the building blocks in creating and deploying WebAssembly programs to Arbitrum chains. To create a new Stylus project from a hello-world example and deploy it onchain, check out some of our tools below:

| Repo | Use cases | License | |:-----------------|:----------------------------|:------------------| | Stylus Hello World | Rust Stylus starter template | Apache 2.0 or MIT | | Cargo Stylus CLI | Deploying Stylus programs | Apache 2.0 or MIT |

License

This project is licensed under either of

at your option.

The SPDX license identifier for this project is MIT OR Apache-2.0.