Andromeda
ADO LibraryBuild AppsDevelop ADOsCLIWeb Application Docs
Andromeda Archives
Andromeda Archives
  • Platform and Framework
    • Introduction to AndromedaOS
    • ADO Classes
    • Andromeda Messaging Protocol
      • Kernel
      • ADO Database
      • Economics Engine
      • Virtual File System
    • ADO Base
      • AndromedaMsg V1.0.0
      • AndromedaQuery V1.0.0
    • Common Types
    • Deployed Contracts
  • Andromeda Digital Objects
    • Introduction to ADOs
    • Auction V1.0.0
    • App V1.0.1
    • Crowdfund V1.0.0
    • CW20 V1.0.0
    • CW20 Staking V1.0.0
    • CW721 V1.0.0
    • CW20 Exchange V1.0.0
    • Lockdrop V1.0.0
    • Marketplace V1.0.0
    • Merkle-Airdrop V1.0.0
    • Rate Limiting Withdrawals V1.0.0
    • Splitter V1.0.0
    • Timelock V1.0.0
  • Andromeda Apps
    • Introduction to Apps
    • Crowdfunding App
    • Auctioning App
    • Cw20 Staking App
    • Marketplace App
  • Developing an ADO
    • Getting Started
      • Instantiation
      • Execution
      • Queries
      • Testing
    • ADO Example
    • ADO Submissions
  • Andromeda CLI
    • Introduction
    • Help and Shortcuts
    • ADO
    • Bank
    • Chain
    • Env
    • Gql
    • Tx
    • OS
    • Wallet
    • Wasm
    • Clearing CLI Data
    • Clear and Exit
  • Chain
    • Running a Node
    • Staking and Rewards
  • Andromeda Dashboard
    • Tokenomics Dashboard
    • Dashboard API
  • Additional Resources
    • GitHub
    • Website
    • White Paper
Powered by GitBook

Additional Resources

  • Github
  • Website

Community

  • Discord
  • Telegram

Socials

  • Twitter
  • Medium
  • Youtube
On this page
  • Defining our App
  • Defining the Messages
  • CW721
  • Marketplace
  • App
  • Instantiating the App
  • Interacting with the App
  • Mint NFTs
  • Send NFT to Marketplace to be Sold
  • Buy the NFT
  • Conclusion

Was this helpful?

  1. Andromeda Apps

Marketplace App

Deploying an NFT Marketplace App

PreviousCw20 Staking AppNextGetting Started

Last updated 11 months ago

Was this helpful?

If unfamiliar with the steps of deploying an app, go back to the where we explain in detail all the different parts of deploying an App.

If any of the messages in this example do not work, you might want to cross reference the messages with the ADO specific section which always contains the latest ADO versions to make sure they are correct. Other than that the logic will remain the same.

Make sure to read the before going through building an app.

Defining our App

You can also use CW20 tokens as the purchasing tokens for the NFTs in the marketplace.

For this App, we will be selling NFTs using the for native tokens. The steps that will be performed:

  • Mint NFTs

  • Setup the marketplace

  • Send the NFTs to the marketplace to be sold

  • Buy the NFTs

Defining the Messages

The components/ADOs we would need:

  • (NFT contract)

Although not necessary, if you are unfamiliar with these ADOs, it is suggested to read through each of the them before deploying an app.

Let us first start by representing the instantiation message for each of our ADOs:

Keep in mind that the app takes these messages as base64 encoded.

CW721

Make sure to set the minter as your own address.

{
"name":"MarketplaceNFTs",
"symbol":"MNFT",
"minter":"<your-address>",
"kernel_address":"andr14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9shptkql"
}

As base64:

eyJuYW1lIjoiTWFya2V0cGxhY2VORlRzIiwic3ltYm9sIjoiTU5GVCIsIm1pbnRlciI6ImFuZHIxZ2Z6c3UwdmVmcnYydjlnNWdrdm1oazNjZWd1MjA4cGV2dXQ2dWgiLCJrZXJuZWxfYWRkcmVzcyI6ImFuZHIxNGhqMnRhdnE4ZnBlc2R3eHhjdTQ0cnR5M2hoOTB2aHVqcnZjbXN0bDR6cjN0eG1mdnc5c2hwdGtxbCJ9

Marketplace

You can specify the authorized CW20 addresses here if you plan to use CW20 tokens to purchase the NFTs. In our cases we are using native so we only have to specify the kernel address.

{
"kernel_address":"andr14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9shptkql"
}

As base64:

eyJrZXJuZWxfYWRkcmVzcyI6ImFuZHIxNGhqMnRhdnE4ZnBlc2R3eHhjdTQ0cnR5M2hoOTB2aHVqcnZjbXN0bDR6cjN0eG1mdnc5c2hwdGtxbCJ9

App

{
  "name": "Marketplace App",
  "app_components": [
    {
      "name": "NFTs",
      "ado_type": "cw721",
      "component_type":{
      "new":"eyJuYW1lIjoiTWFya2V0cGxhY2VORlRzIiwic3ltYm9sIjoiTU5GVCIsIm1pbnRlciI6ImFuZHIxZ2Z6c3UwdmVmcnYydjlnNWdrdm1oazNjZWd1MjA4cGV2dXQ2dWgiLCJrZXJuZWxfYWRkcmVzcyI6ImFuZHIxNGhqMnRhdnE4ZnBlc2R3eHhjdTQ0cnR5M2hoOTB2aHVqcnZjbXN0bDR6cjN0eG1mdnc5c2hwdGtxbCJ9"
       }
     },
    {
      "name": "marketplace",
      "ado_type": "marketplace",
      "component_type":{ 
      "new":"eyJrZXJuZWxfYWRkcmVzcyI6ImFuZHIxNGhqMnRhdnE4ZnBlc2R3eHhjdTQ0cnR5M2hoOTB2aHVqcnZjbXN0bDR6cjN0eG1mdnc5c2hwdGtxbCJ9"
        }
    }
  ],
  "kernel_address":"andr14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9shptkql"
  }

There are several components found here. A simple name for the app, the components of the app itself and a reference to the “Kernel”. Each component of the app provides two values: a name used for referencing for other components within the app, and the base64 encoded instantiation message.

Instantiating the App

First, let us open the CLI by running andr in our terminal. We then need to choose the chain we want to deploy on. Run "chain use" in the CLI and select the testnet that you want to deploy on. For this example I will be using the Andromeda test-net Galileo-3.

If this is the first time using the CLI make sure to run "wallet add <wallet-name>"in order to create a wallet. Then go to that chain's faucet (usually located in their discord) and request tokens.

We have already uploaded the App ADO to the Andromeda testnet. A simple way to check the latest code id for the App ADO is to query it from the ADODB using the chain you want to use.

In the CLI, while connected to the chain of choice, run:

os adodb getcodeid app-contract

The code Id to use will be returned.

Now we can instantiate our App. We will be using our wasm command to instantiate our app:

Do not copy and paste the command below as it will not work. Make sure to make the appropriate changes before running the command.

Replace the <code_id> with the returned code-id for the app ADO.

wasm instantiate <app-code-id> '{"name": "Marketplace App","app_components": [{"name": "NFTs","ado_type": "cw721","component_type":{"new":"eyJuYW1lIjoiTWFya2V0cGxhY2VORlRzIiwic3ltYm9sIjoiTU5GVCIsIm1pbnRlciI6ImFuZHIxZ2Z6c3UwdmVmcnYydjlnNWdrdm1oazNjZWd1MjA4cGV2dXQ2dWgiLCJrZXJuZWxfYWRkcmVzcyI6ImFuZHIxNGhqMnRhdnE4ZnBlc2R3eHhjdTQ0cnR5M2hoOTB2aHVqcnZjbXN0bDR6cjN0eG1mdnc5c2hwdGtxbCJ9"}},{"name": "marketplace","ado_type": "marketplace","component_type":{ "new":"eyJrZXJuZWxfYWRkcmVzcyI6ImFuZHIxNGhqMnRhdnE4ZnBlc2R3eHhjdTQ0cnR5M2hoOTB2aHVqcnZjbXN0bDR6cjN0eG1mdnc5c2hwdGtxbCJ9"}}],"kernel_address":"andr14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9shptkql"}'

You will be using the contract addresses that were instantiated for you instead of the ones in this tutorial.

Interacting with the App

Mint NFTs

We will only mint one NFT in this example as the process for selling more NFTs will be the same. Feel free to mint as many as you want.

Now we need to mint an NFT to send to the marketplace.

{
"mint": {
            "token_id":"1",
            "owner":"<your-address>",
            "token_uri":"https://gateway.pinata.cloud/ipfs...",
            "extension": {
                "publisher": "Andromeda"
              }            
        }
}
wasm execute <cw721-contract-address> '{"mint": {"token_id":"1","owner":"andr1gfzsu0vefrv2v9g5gkvmhk3cegu208pevut6uh","token_uri":"https://gateway.pinata.cloud/ipfs...","extension": {"publisher": "Andromeda"}}}'

Send NFT to Marketplace to be Sold

In order to start a sale on the NFT, we need to send it to the marketplace ADO.

The token Id is 1 here since that is what we had assigned to our NFT when minting.

{
    "send_nft": {
        "contract": "<marketplace-contract-address>",
        "token_id": "1",
        "msg": "eyJzdGFydF9zYWxlIjogeyJwcmljZSI6IjEwMDAwIiwiY29pbl9kZW5vbSI6ICJ1YW5kciIsInVzZXNfY3cyMCI6IGZhbHNlfX0="
    }
}

The attached message is a start_sale message to start the auction when the NFT is sent.

You can add a start time, end time, and a recipient to receive the funds of the sale. By ommitting them, we are specifying that the sale should start immediately, does not expire unless we decide to cancel it, and that the funds from the sale should go to the sender ie. our address.

{
"start_sale":{
    "price": "10000",
    "coin_denom":"uandr",
    "uses_cw20": false
    }
}
wasm execute <cw721-contract-address> '{"send_nft": {"contract": "andr18dacalhasfqs45dz5tmsa38278svz5elvys83rfas9tz7n9eh5vs8gx6cp","token_id": "1","msg": "eyJzdGFydF9zYWxlIjogeyJwcmljZSI6IjEwMDAwIiwiY29pbl9kZW5vbSI6ICJ1YW5kciIsInVzZXNfY3cyMCI6IGZhbHNlfX0="}}'

Buy the NFT

Now let us buy the NFT. On the CLI:

Make sure to use a wallet other than the owner of the NFT as the owner cannot buy the NFT.

wallet use <wallet-name>
{
"buy":{
    "token_id":"1",
    "token_address":"<cw721-contract-address>"
    }
}

Make sure to attach funds to the message equal to the listed price of the NFT which is 1000uandr in our case.

wasm execute <marketplace-contract-address> '{"buy":{"token_id":"1","token_address":"<cw721-contract-address>"}}' 

Conclusion

We have seen in this example how we can easily sell NFTs using our marketplace ADO. You can customize this application as you see fit. Some possible modifications you can make for this application:

  • Add start and end times for the NFT sale.

  • Use a CW20 token as the purchasing token for the NFTs.

  • Add a splitter recipient to the start sale message to directly split all the funds made from the NFT sales to any amount of addresses. You can even have the splitter send some of the tokens to another ADO and execute some message there.

The Kernel address used here might be outdated in the future. Check our to get the latest Kernel or run "chain config" in CLI which will also display the address.

If you do not have the CLI downloaded, go to the section to get the latest version.

first example
Introduction to Apps
Marketplace ADO
CW721
Marketplace
deployed contracts
Introduction to Apps
Transaction
Start Sale
Buy the NFT