1 stable release

1.2.2 Jan 24, 2024

#5 in #cw1

Download history 584/week @ 2024-05-21 839/week @ 2024-05-28 471/week @ 2024-06-04 1127/week @ 2024-06-11 629/week @ 2024-06-18 621/week @ 2024-06-25 591/week @ 2024-07-02 758/week @ 2024-07-09 685/week @ 2024-07-16 643/week @ 2024-07-23 536/week @ 2024-07-30 498/week @ 2024-08-06 487/week @ 2024-08-13 351/week @ 2024-08-20 213/week @ 2024-08-27 508/week @ 2024-09-03

1,657 downloads per month
Used in 4 crates (3 directly)

Apache-2.0

8KB
64 lines

CW1 Spec: Proxy Contracts

CW1 is a specification for proxy contracts based on CosmWasm. It is a very simple, but flexible interface designed for the case where one contract is meant to hold assets (or rights) on behalf of other contracts.

The simplest example is a contract that will accept messages from the creator and resend them from its address. Simply by making this transferable, you can then begin to transfer non-transferable assets (eg. staked tokens, voting power, etc).

You can imagine more complex examples, such as a "1 of N" multisig, or conditional approval, where "sub-accounts" have the right to spend a limited amount of funds from this account, with a "admin account" retaining full control.

The common denominator is that they allow you to immediately execute arbitrary CosmosMsg in the same transaction.

Messages

Execute{msgs} - This accepts Vec<CosmosMsg> and checks permissions before re-dispatching all those messages from the contract address. It emits the following attributes:

Key Value
"action" "execute"
"owner" [msg sender]

Queries

CanExecute{sender, msg} - This accepts one CosmosMsg and checks permissions, returning true or false based on the permissions. If CanExecute returns true then a call to Execute from that sender, with the same message, before any further state changes, should also succeed. This can be used to dynamically provide some client info on a generic cw1 contract without knowing the extension details. (eg. detect if they can send coins or stake)

Dependencies

~3.5–5.5MB
~114K SLoC