Marketplace

Introduction

The Marketplace ADO is a smart contract that allows you to sell your NFTs in a marketplace. The seller sends their NFT to the Marketplace ADO and attaches the sale options such as the price and funds used to purchase the NFT. Once the NFT is sent, the sale will start at the time specified by the seller.

Purchasing the NFT can be customized to work with one of the following options:

• Native: By specifying the denom of the chain in the StartSale message.

• CW20: By specifying the contract address of the CW20 token to be used in the StartSale. The CW20 tokens allowed to be set as the purchasing token can be restricted by specifying authorized_cw20_address at instantiation. If this is not specified, then any CW20 token can be set.

Each sale is assigned an Id which starts at 1 and increments for each new sale.

Ado_type: marketplace

InstantiateMsg

Rust

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

}

JSON

{
"authorized_cw20_address":"andr1...",
"kernel_address":"andr1..."
}

Name	Type	Description
authorized_cw20_address	Option<AndrAddr>	Optional CW20 address to authorize to be used as the purchasing coin for the NFTs in the marketplace sale. If not specified, then any CW20 can be set as the purchasing coin.
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

ReceiveNft

Receives a token from a SendNft and starts an auction based on the given parameters in the StartSale struct.

This message is not called by the user on this ADO, but is the case that handles receiving NFTs from a CW721 ADO.

Rust

 pub enum ExecuteMsg {
  ReceiveNft(Cw721ReceiveMsg)
}

Cw721ReceiveMsg

pub struct Cw721ReceiveMsg {
    pub sender: String,
    pub token_id: String,
    pub msg: Binary,
}

The msg in the Cw721ReceiveMsg should be a base64 encoded binary of a Cw721HookMsg.

Start Sale

A CW721 hook message that starts a new sale with the given parameters.

Rust

pub enum Cw721HookMsg {
    StartSale {
     price: Uint128,
     coin_denom: String
     start_time: Option<MillisecondsExpiration>,
     duration: Option<MillisecondsDuration>,
     uses_cw20: bool,
     recipient: Option<Recipient>,
       }
   }

JSON

{
    "start_sale": {
          "price":"500000",
          "coin_denom": "uandr"
          "start_time": 1663334970211,
          "duration": 60000000,
          "uses_cw20": false,
          "recipient":{
                "address":"andr1..."
                }
    }
}

Name	Type	Description
price	Uint128	The price of the NFT, which is the amount of coin_denom needed to buy the NFT.
coin_denom	String	The denom to be used to buy the NFT. Can be either a CW20 or native funds. For CW20, provide the contract address e.g. "andr1...". For native provide the denom e.g. "uandr".
start_time	Option<MillisecondsExpiration>	Optional start time in milliseconds since epoch. If not specified, then the sale will start immediately.
duration	Option<MillisecondsDuration>	Optional duration for the sale in milliseconds from the start_time. If not specified then the sale never expires.
uses_cw20	bool	Whether a CW20 token is used to purchase the NFT or not.
recipient	Option<Recipient>	Optional address to receive the funds from the NFT sale. If not specified, then the funds will go to the sender of the NFT.

---

Receive

Receives tokens from a CW20 Send message to be used to buy an NFT.

This message is not called by the user on this ADO, but is the case that handles receiving CW20 tokens from a CW20 ADO.

Rust

 pub struct Cw20ReceiveMsg {
    pub sender: String,
    pub amount: Uint128,
    pub msg: Binary,
}

pub enum ExecuteMsg {
     Receive(Cw20ReceiveMsg),
    }

In order to buy and NFT using a CW20, you need to define the message of the Cw20ReceiveMsg as a Cw721HookMsg.

Buy (CW20)

Buys an NFT using the sent CW20 tokens.

You need to get the base64 encoded representation of the JSON message and attach it as the msg field for the CW20 Send message.

The Owner of the NFT is not allowed to buy it.

Rust

pub enum Cw20HookMsg {
    Buy {
        token_id: String,
        token_address: String,
    },
}

JSON

{
"buy":{
    "token_id":"1",
    "token_address":"andr1..."
    }
}

Name	Type	Description
token_id	String	The token id of the NFT you want to buy.
token_address	String	The address of the NFT contract the NFT belongs to.

---

UpdateSale

Update the price and denom for the sale of the token.

Only available to the NFT owner.

Rust

pub enum ExecuteMsg {
    UpdateSale {
        token_id: String,
        token_address: String,
        price: Uint128,
        coin_denom: String,
        uses_cw20: bool,
        recipient:Option<Recipient>
    }
}

JSON

{
"update_sale":{
    "token_id":"1",
    "token_address":"andr1...",
    "price":"100",
    "coin_denom":"uandr",
    "uses_cw20": false,
    "recipient":{
        "address":"andr1..."
        }
    }
}

Name	Type	Description
token_id	String	The Id of the token to update the sale for.
token_address	String	The address of the cw721 contract that minted the token.
price	Uint128	The price of the NFT, which is the amount of coin_denom needed to buy the NFT.
coin_denom	String	The denom to be used to buy the NFT. Can be either a CW20 or native funds. For CW20, provide the contract address e.g. "andr1...". For native provide the denom e.g. "uandr".
uses_cw20	bool	Whether a CW20 token is used to purchase the NFT or not.
recipient	Option<Recipient>	Optional address to receive the funds from the NFT sale. If not specified, then the funds will go to the sender of the NFT.

Buy

Buys the NFT that is for sale.

Dont forget to attach the required funds.

The Owner of the NFT is not allowed to buy it.

Rust

pub enum ExecuteMsg { 
 Buy {
        token_id: String,
        token_address: String,
     }
  }

JSON

{
"buy":{
    "token_id":"1",
    "token_address":"andr1..."
    }
}

Name	Type	Description
token_id	String	The Id of the NFT to buy.
token_address	String	The address of the cw721 that minted the NFT to buy.

CancelSale

Cancels the sale for the specified NFT.

Only the NFT owner can cancel the sale.

Rust

pub enum ExecuteMsg {
    CancelSale {
        token_id: String,
        token_address: String,
    }
}

JSON

{
"cancel_sale":{
    "token_id":"1",
    "token_address":"andr1..."
    }
}

Name	Type	Description
token_id	String	The Id of the NFT to cancel the sale for.
token_address	String	The address of the cw721 that minted the NFT to cancel the sale for.

Base Executes

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

QueryMsg

LatestSaleState

Gets the latest sale state for the given token. This will either be the current sale if there is one in progress or the last completed one.

Rust

 pub enum QueryMsg {
 #[returns(SaleStateResponse)]
 LatestSaleState {
        token_id: String,
        token_address: String,
     }
  }

JSON

{
"latest_sale_state":{
    "token_id":"1",
    "token_address":"andr1..."
    }
}

Name	Type	Description
token_id	String	The Id of the token to check.
token_address	String	The address of the cw721 that minted the NFT to check.

SaleStateResponse

Rust

pub struct SaleStateResponse {
    pub sale_id: Uint128,
    pub coin_denom: String,
    pub price: Uint128,
    pub status: Status,
    pub start_time: Expiration,
    pub end_time: Expiration,
    pub recipient: Option<Recipient>,
}

JSON

{
"sale_id":"3",
"coin_denom":"uandr",
"price":"100",
"status":"open",
"start_time":{
    "expiration":{
        "at_time":"1146593483949835832"
    }
 },
"end_time":{
    "expiration":{
           "at_time":"1246593483949835832"
    } 
  }
}

Name	Type	Description
sale_id	Uint128	The Id of the sale. The first sale has an Id of 1 and each sale after it increments the Id by 1.
coin_denom	String	The denom used in the sale.
price	Uint128	The price of the NFT.
status	Status	The status of the sale which can be one of the following options: -Open -Expired -Executed -Cancelled
start_time	Expiration	The time the sale on the NFT will start.
end_time	Expiration	The time the the sale on the NFT will end.
recipient	Option<Recipient>	The address that will receive the funds from the sale of the NFT.

SaleState

Gets the sale state for the given sale Id.

Rust

pub enum QueryMsg
#[returns(SaleStateResponse)]
 SaleState {
        sale_id: Uint128,
    }
}

JSON

{
"sale_state":{
    "sale_id":"1"
    }
}

Name	Type	Description
sale_id	Uint128	The Id of the sale to check.

Returns a SaleStateResponse.

SaleIds

Queries the sale Ids of the specified token.

Rust

pub enum QueryMsg {
     #[returns(SaleIdsResponse)]
     SaleIds {
        token_id: String,
        token_address: String,
    }
 }

JSON

{
"sale_ids":{
    "token_id":"1",
    "token_address":"andr1..."
    }
}

Name	Type	Description
token_id	String	The Id of the token to check the sale for.
token_address	String	The address of the cw721 that minted the NFT.

Returns the Ids of the sales that have been conducted on the NFT.

SaleInfosForAddress

Get sale information on the provided CW721 token address.

Rust

pub enum QueryMsg {
 #[returns(Vec<SaleInfo>)]
 SaleInfosForAddress {
        token_address: String,
        start_after: Option<String>,
        limit: Option<u64>,
    }
 }

JSON

{
"sale_infos_for_address":{
    "token_address":"andr1..."
    }
}

Name	Type	Description
token_address	String	The cw721 contract address to check the sales for.
start_after	Option<String>	Optional parameter to specify which SaleInfo to start from. If none specified index 0 will be used.
limit	Option<u64>	Optional parameter to specify how many SaleInfo to query. If none specified a default limit of 10 is used. The maximum limit is 30.

SaleInfo

A Vec<SaleInfo> is returned.

Rust

pub struct SaleInfo {
    pub sale_ids: Vec<Uint128>,
    pub token_address: String,
    pub token_id: String,
}

Name	Type	Description
sale_ids	Vec<Uint128>	The Ids of the sales conducted on the NFT.
token_address	String	The cw721 contract address.
token_id	String	The Id of the token.

Base Queries

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