Timelock

The Timelock ADO or Escrow ADO is a smart contract built to hold funds (Native coins) for a period of time until the set condition is satisfied.

There are two main conditions that can be used by the contract:

• Expiration: A time expiration to when the funds can be released.

• MinimumFunds: A minimum amount of funds to be deposited before they can be released.

Once a condition is satisfied, the funds can be released by anyone.

Ado_type: timelock

InstantiateMsg

Rust

pub struct InstantiateMsg {
    pub kernel_address:String,
    pub owner: Option<String>,
}

JSON

{
"modules": [
        {
          "name": "address-list",
          "address":"andr1...",
          "is_mutable": true
        },
        ...
    ],
"kernel_address":"andr1..."
}

Name	Type	Description
kernel_address	String	Contract address of the kernel contract to be used for AMP messaging. Kernel contract address can be found in our deployed contracts.
owner	Option<String>	Optional address to specify as the owner of the ADO being created. Defaults to the sender if not specified.

ExecuteMsg

HoldFunds

Holds sent funds in escrow.

Rust

pub enum ExecuteMsg {
    HoldFunds {
        condition: Option<EscrowCondition>,
        recipient: Option<Recipient>,
    },
}

JSON

{
    "hold_funds": {
        "recipient":{
             "address":"andr1..."
         },
        "condition": {
            "expiration":360000000
        }
    }
}

Name	Type	Description
recipient	Option<Recipient>	Optional recipient address. If not set, defaults to the sender.
condition	Option<EscrowCondition>	An optional condition to unlock the Escrow.

EscrowCondition

Enum used to specify the condition which must be met in order for the Escrow to unlock.

The Expiration timestamp is taken in nanosecond precision. Using another precision will give a "Time in the past" error.

pub enum EscrowCondition {
    Expiration(MillisecondsExpiration),
    MinimumFunds(Vec<Coin>),
}

EscrowCondition Type	Type	Description
Expiration	MillisecondsExpiration	Requires a given time to be reached. The time is specified in milliseconds.
MinimumFunds	Vec<Coin>	Requires a minimum amount of funds to be deposited.

ReleaseFunds

Releases any held funds by the specified recipient.

Rust

pub enum ExecuteMsg {
    ReleaseFunds {
    recipient_addr:Option<String>,
    start_after:Option<String>,
    limit:Option<u32>
    }
}

JSON

{
    "release_funds": {
    
       "recipient_addr":"andr1...",
       "limit":"15"
    }
}

Name	Type	Description
recipient_addr	Option<String>	Optional address to release the funds for. Will default to the sender if not specified.
start_after	Option<String>	An optional address for which to start after, used for pagination.
limit	Option<u32>	Optional limit to the number of timelocks to attempt to unlock. Defaults to 10 and can be set to a maximum of 30.

ReleaseSpecificFunds

Release funds held by the owner to the recipient. (The recipient has to be the same as the one defined when the owner executed HoldFunds)

Rust

pub enum ExecuteMsg {
ReleaseSpecificFunds {
        owner: String,
        recipient_addr: Option<String>,
    }
  } 

JSON

{
"release_specific_funds": {
   "owner":"andr1...",
   "recipient_addr": "andr1..."
     }
 }
  

Name	Type	Description
owner	String	The address of the funds to be released.
recipient_addr	Option<String>	Optional address to receive the released funds. Will default to the sender if not specified.

Base Executes

The rest of the execute messages can be found in the ADO Base section.

QueryMsg

GetLockedFunds

Query any held funds for an address.

Rust

pub enum QueryMsg {
    #[returns(GetLockedFundsResponse)]
    GetLockedFunds{
        owner: String,
        recipient:String
    }
}

JSON

{
    "get_locked_funds": {
        "owner": "andr1...",
        "recipient":"andr1..."
    }
}

Name	Type	Description
owner	String	The address of the owner of the funds.
recipient	String	The address of the recipient of the funds.

GetLockedFundsResponse

Rust

pub struct GetLockedFundsResponse {
    pub funds: Option<Escrow>,
}

JSON

{
    "funds": {
          "coins":[{
            "amount": "1000",
            "denom": "uandr"
        },
        ...
        ],
        
        "recipient": "andr1...",
        
        "condition": {
            "expiration": {
              "at_height": 175849
              }
        }
    }
}

Name	Type	Description
funds	Option<Escrow>	Optional Escrow with the held funds and related information.

GetLockedFundsForRecipient

Rust

pub enum QueryMsg {
   #[returns(GetLockedFundsForRecipientResponse)]
   GetLockedFundsForRecipient {
        recipient: String,
        start_after: Option<String>,
        limit: Option<u32>,
    }
  }

JSON

{
 "get_locked_funds_for_recipient":{
   "recipient":"andr1...",
   "limit":"15"
   }
 }
       

Name	Type	Description
recipient	String	The address of the recipient..
start_after	Option<String>	An optional address for which to start after, used for pagination.
limit	Option<u32>	Optional limit to the number timelocks to attempt to query. Defaults to 10 and can be set to a maximum of 30.

GetLockedFundsForRecipientResponse

Rust

pub struct GetLockedFundsForRecipientResponse {
    pub funds: Vec<Escrow>,
}

JSON

{
    "funds": {
        "coins":[{
            "amount": "1000",
            "denom": uandr
        },
        ...
        ],
        
        "recipient":{
            "addr":"andr1..."
        },
        
        "condition": {
            "expiration": {
              "at_height": 13249238492
              }
        }
    }
}

Name	Type	Description
funds	Vec<Escrow>	Optional Escrow with the held funds and related information.

Escrow

The time-lock contract uses a basic struct to store a record of funds being held.

pub struct Escrow {
    pub coins: Vec<Coin>,
    pub condition: Option<EscrowCondition>,
    pub recipient: Recipient,
}

Name	Type	Description
coins	Vec<Coin>	Funds being held within the Escrow.
condition	Option<EscrowCondition>	Optional condition for the Escrow.
recipient	Recipient	The recipient of the funds once condition is satisfied.

Base Queries

The rest of the query messages can be found in the ADO Base section.