5 releases (stable)

3.0.0 Jul 11, 2024
2.0.0 May 1, 2024
2.0.0-rc Apr 25, 2024
1.4.0 Apr 15, 2024
1.2.2 Jan 24, 2024

#4 in #cw1

Download history 695/week @ 2024-07-22 630/week @ 2024-07-29 443/week @ 2024-08-05 559/week @ 2024-08-12 236/week @ 2024-08-19 285/week @ 2024-08-26 433/week @ 2024-09-02 204/week @ 2024-09-09 172/week @ 2024-09-16 137/week @ 2024-09-23 92/week @ 2024-09-30 46/week @ 2024-10-07 128/week @ 2024-10-14 31/week @ 2024-10-21 59/week @ 2024-10-28 56/week @ 2024-11-04

278 downloads per month
Used in 2 crates

Apache-2.0 and LGPL-3.0

43KB
664 lines

CW1 Whitelist

This may be the simplest implementation of CW1, a whitelist of addresses. It contains a set of admins that are defined upon creation. Any of those admins may Execute any message via the contract, per the CW1 spec.

To make this slightly less minimalistic, you can allow the admin set to be mutable or immutable. If it is mutable, then any admin may (a) change the admin set and (b) freeze it (making it immutable).

While largely an example contract for CW1, this has various real-world use-cases, such as a common account that is shared among multiple trusted devices, or trading an entire account (used as 1 of 1 mutable). Most of the time, this can be used as a framework to build your own, more advanced cw1 implementations.

Allowing Custom Messages

By default, this doesn't support CustomMsg in order to be fully generic among blockchains. However, all types are Generic over T, and this is only fixed in handle. You can import this contract and just redefine your handle function, setting a different parameter to ExecuteMsg, and you can produce a chain-specific message.

Running this contract

You will need Rust 1.44.1+ with wasm32-unknown-unknown target installed.

You can run unit tests on this via:

cargo test

Once you are happy with the content, you can compile it to wasm via:

RUSTFLAGS='-C link-arg=-s' cargo wasm
cp ../../target/wasm32-unknown-unknown/release/cw1_whitelist.wasm .
ls -l cw1_whitelist.wasm
sha256sum cw1_whitelist.wasm

Or for a production-ready (optimized) build, run a build command in the repository root: https://github.com/CosmWasm/cw-plus#compiling.

Dependencies

~4–17MB
~201K SLoC