1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use cosmwasm_std::{Addr, Api, Coin, StdResult};
use cw20::{Cw20Coin, Cw20ReceiveMsg};
#[derive(Serialize, Deserialize, JsonSchema)]
pub struct InstantiateMsg {}
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
Create(CreateMsg),
/// Adds all sent native tokens to the contract
TopUp {
id: String,
},
/// Approve sends all tokens to the recipient.
/// Only the arbiter can do this
Approve {
/// id is a human-readable name for the escrow from create
id: String,
},
/// Refund returns all remaining tokens to the original sender,
/// The arbiter can do this any time, or anyone can do this after a timeout
Refund {
/// id is a human-readable name for the escrow from create
id: String,
},
/// This accepts a properly-encoded ReceiveMsg from a cw20 contract
Receive(Cw20ReceiveMsg),
}
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ReceiveMsg {
Create(CreateMsg),
/// Adds all sent native tokens to the contract
TopUp {
id: String,
},
}
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct CreateMsg {
/// id is a human-readable name for the escrow to use later
/// 3-20 bytes of utf-8 text
pub id: String,
/// arbiter can decide to approve or refund the escrow
pub arbiter: String,
/// if approved, funds go to the recipient
pub recipient: String,
/// When end height set and block height exceeds this value, the escrow is expired.
/// Once an escrow is expired, it can be returned to the original funder (via "refund").
pub end_height: Option<u64>,
/// When end time (in seconds since epoch 00:00:00 UTC on 1 January 1970) is set and
/// block time exceeds this value, the escrow is expired.
/// Once an escrow is expired, it can be returned to the original funder (via "refund").
pub end_time: Option<u64>,
/// Besides any possible tokens sent with the CreateMsg, this is a list of all cw20 token addresses
/// that are accepted by the escrow during a top-up. This is required to avoid a DoS attack by topping-up
/// with an invalid cw20 contract. See https://github.com/CosmWasm/cosmwasm-plus/issues/19
pub cw20_whitelist: Option<Vec<String>>,
}
impl CreateMsg {
pub fn addr_whitelist(&self, api: &dyn Api) -> StdResult<Vec<Addr>> {
match self.cw20_whitelist.as_ref() {
Some(v) => v.iter().map(|h| api.addr_validate(h)).collect(),
None => Ok(vec![]),
}
}
}
pub fn is_valid_name(name: &str) -> bool {
let bytes = name.as_bytes();
if bytes.len() < 3 || bytes.len() > 20 {
return false;
}
true
}
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
/// Show all open escrows. Return type is ListResponse.
List {},
/// Returns the details of the named escrow, error if not created
/// Return type: DetailsResponse.
Details { id: String },
}
#[derive(Serialize, Deserialize, Clone, PartialEq, JsonSchema, Debug)]
pub struct ListResponse {
/// list all registered ids
pub escrows: Vec<String>,
}
#[derive(Serialize, Deserialize, Clone, PartialEq, JsonSchema, Debug)]
pub struct DetailsResponse {
/// id of this escrow
pub id: String,
/// arbiter can decide to approve or refund the escrow
pub arbiter: String,
/// if approved, funds go to the recipient
pub recipient: String,
/// if refunded, funds go to the source
pub source: String,
/// When end height set and block height exceeds this value, the escrow is expired.
/// Once an escrow is expired, it can be returned to the original funder (via "refund").
pub end_height: Option<u64>,
/// When end time (in seconds since epoch 00:00:00 UTC on 1 January 1970) is set and
/// block time exceeds this value, the escrow is expired.
/// Once an escrow is expired, it can be returned to the original funder (via "refund").
pub end_time: Option<u64>,
/// Balance in native tokens
pub native_balance: Vec<Coin>,
/// Balance in cw20 tokens
pub cw20_balance: Vec<Cw20Coin>,
/// Whitelisted cw20 tokens
pub cw20_whitelist: Vec<String>,
}