Repository files navigation

Solana NFT Marketplace program with NFT Trading & Auction

• Prepare anchor development environments
• Prepare aroun 12 SOL in the deploy wallet keypair
• Confirm Network cluster inAnchor.toml file : f.e.[programs.devnet],cluster = "devnet"
• Confirm deploy authority wallet keypair location : f.e. `wallet = "/home/ubuntu/deploy-keypair.json"
• Configure solana cli with deploy authority keypair and deploying cluster : f.e.solana config set -h
• Build program withanchor build
• Copy and paste the result deploy scripts from Build terminal message : f.e.solana program deploy /home/ubuntu/project/target/deploy/mugs_marketplace.so

• Delete the program keypair in/target/deploy/mugs_marketplace-keypair.json
• Build project withanchor build. This will generate new keypair
• Get the address of new keypair withsolana address --keypair ./target/deploy/mugs_marketplace-keypair.json
• Change program addresses in project code.Anchor.toml,/program/Mugs_Marketplace/src/lib.rs
• Build program object again withanchor build
• Deploy newly built so file withsolana program deploy

Able to run all commands in/cli/command.ts file by runningyarn ts-node xxx.When you get this error
Error: Provider local is not available on browser.You can run this commandexport BROWSER= once.

• Installnode andyarn
• Installts-node as global command
• Confirm the solana wallet preparation inpackage.json:/root/.config/solana/creator.json in test case

• Initialize program withinit command
• Should configure the marketplace fee withupdate_fee command
• Should add at least onetreasury wallet withadd_treasury command for the fee distribution
• Should Initialize user PDA withinit_user command for the first time usage

Initialize Program with creating Global PDA account as Contract Deployer.

Get global PDA info of program. This will show marketplace fee the treasury wallet distributions.

Admin able to update the Marketplace Fee with this command as Admin.

• sol_fee is the fee in permyraid

Admin able to add the team treasury wallet distribution rate for the marketplace fee charge.

• address is the treasury wallet
• rate is the wallet's distribution rate by permyraid

Admin able to remove the team treasury wallet.

• address is the treasury wallet

Initialize User Data PDA for Escrow Balance & Traded Volume.This command should be executed for the first time usage of each traders.

Get user PDA info for traders. This will show user escrow balance and traded volume info.

• address is the trader wallet address

Transfer NFT from Sender wallet or it's listed Escrow Account to the Recipient.

• address is the NFT mint address
• recipient is the recipient wallet address

List NFT for sale as Seller.

• address is the NFT mint address
• price_sol is the listing price of NFT

Cancel Listing of NFT as Seller.

• address is the NFT mint address

Purchase the Listed NFT withBuy Now price as Buyer.

• address is the NFT mint address

Make offer for a particular Listed NFT as Buyer.

• address is the NFT mint address
• price is the offering price. Should be in range ofx1 ~ x0.5 of listed price

Cancel maden offer for a particular Listed NFT as Buyer.

• address is the NFT mint address

Accpet proper offer from a certain Buyer as Seller.

• address is the NFT mint addres
• buyer is the Offer provider address

Create Auction for a particular NFT for funny trading as Seller.

• address is the NFT mint address
• start_price is the bidding start price
• min_increase is the minimum increasing amount for the higer bidding
• duration is the auction period since started time by second
• reserve if this is 1, then the auction is reserve to start from the first bid placed date. Default 0

Participate in auction with higher bidding as Buyer.

• address is the NFT mint address
• price is the higher bidding price. Should be more than the latest bid + min_increase_amount

Claim NFT for winner as Buyer when auction is ended.

• address is the NFT mint address

Cancel auction as Seller if there is no bid until auction ended.

• address is the NFT mint address

Get nft Sell Data PDA info for a particular listed NFT status.

• address NFT mint address

Get Offer Data PDA info for a particular Offer status.

• address NFT mint address
• buyer is the offer provider address

Get Auction Data PDA info for a particular auction status.

• address NFT mint address

Get all listed NFTs info which is active for sale now.

Get all offers info for a particular NFT which is active for accept now.

Get all auctions info which is live now or not claimed ended auction.

For the FE side web3 integration, the scripts inlib directory can be use without no change.The only thing the FE dev should change is providingweb3 connection & theanchor program object from idl.There is the code part for thekeypair wallet basedcli environement case incli/scripts.Should configure properly inBROWSER environment.

This script will fetch past Txs reacted with Our Marketplace Smartcontract. Then will parse an activity from each Txs so that use the info for DB sync up.
yarn be