https://github.com/chrisco512/wax
A simple, zero-dependency smart contract framework for Arbitrum Stylus, written in Zig
https://github.com/chrisco512/wax
arbitrum ethereum wasm zig
Last synced: 9 months ago
JSON representation
A simple, zero-dependency smart contract framework for Arbitrum Stylus, written in Zig
- Host: GitHub
- URL: https://github.com/chrisco512/wax
- Owner: chrisco512
- Created: 2025-02-14T03:35:13.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-28T19:14:19.000Z (over 1 year ago)
- Last Synced: 2025-04-06T13:40:29.706Z (about 1 year ago)
- Topics: arbitrum, ethereum, wasm, zig
- Language: Zig
- Homepage: https://docs.arbitrum.io
- Size: 282 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Wax
A simple, zero-dependency smart contract framework for Arbitrum Stylus, written in Zig
## Philosophy
- Simple router-based app framework
- Supports middleware
- Tiny binaries
- Maximum performance
- Learn it in an afternoon (even with zero Zig experience)
- Avoid esoteric language features wherever possible
- Stick with basic building blocks as much as possible: functions, structs, arrays, enums
- Easily testable
## Dependencies
This code is running on a pre-release of Zig 0.14 (which is due in next couple of weeks). Install Zig from master, see: https://ziglang.org/download/.
You'll also need Arbitrum Nitro dev node to test, which depends on Docker. See: https://docs.arbitrum.io/run-arbitrum-node/run-nitro-dev-node
In addition, you'll need cargo stylus to deploy: https://github.com/OffchainLabs/cargo-stylus
## Running Examples
After all dependencies are installed. Make sure you have Arbitrum Nitro Dev node running locally by following instructions from link above.
Navigate to examples/counter and run `zig build`. It will produce a `main.wasm` file in `examples/counter/zig-out/bin`. Navigate to that directory and then run:
```bash
> RPC=http://localhost:8547
> PRIVATE_KEY=0xb6b15c8cb491557369f3c7d2c287b053eb229daa9c22138887752191c9520659
> cargo stylus deploy --no-verify --endpoint $RPC --private-key $PRIVATE_KEY --wasm-file=main.wasm
```
It will produce output similar to:
```bash
stripped custom section from user wasm to remove any sensitive data
contract size: 1.4 KB
deployed code at address: 0x1bac7c33af7313d0ac112a3c7bbc3314fc181ef7 deployment tx hash: 0x9ec6bb6672fe3c6141390b77688290f4202c73a5e2c88fc2acd0f6efc429db64 wasm already activated!
```
Although your contract address and tx hash will be different. Set the contract address to a local variable:
```bash
> CONTRACT=0x1bac7c33af7313d0ac112a3c7bbc3314fc181ef7
```
Then, using Foundry's `cast` (https://getfoundry.sh/), invoke the smart contract's `count` and `increment` methods:
```bash
❯ cast call --rpc-url $RPC --private-key $PRIVATE_KEY $CONTRACT "count()(uint256)"
0
❯ cast send --rpc-url $RPC --private-key $PRIVATE_KEY $CONTRACT "increment()()"
❯ cast call --rpc-url $RPC --private-key $PRIVATE_KEY $CONTRACT "count()(uint256)"
1
```
## Notice
This code is still in early-stage development and should not be used in production.