liqnft / candy-shop

Ethereum, Polygon, Solana NFT Marketplace JS Library

Candy Shop: NFT Marketplace JS Library

Candy Shop is an open source JavaScript library that allows anyone to launch an NFT marketplace on Ethereum, Polygon and/or Solana in minutes.

• Website
• Documentation
• Starter Repo (React app with various shop configurations out of the box)
• Demo (corresponds to code in /example folder)
• Support
• Contribute

Why Candy Shop?

• Open Source. Built by developers for developers.
• Decentralized. Support the decentralized movement. NFT transactions are on-chain and powered by Metaplex auction house program.
• Easy to Integrate. Create a fully functional marketplace in minutes.
• Serverless. No need to maintain your own backend to have a performant marketplace
• Seamless User Experience. Provide a simple and user friendly experience for browsing, buying and selling NFTs.
• Lower Fees for Buyers. Users save on fees when they transact on your marketplace.
• Get a Share of Fees. Earn 20% of the 1% transaction fee.
• More Visibility. Your NFT listings will be showcased on LIQNFT.com, giving your project better visibility while still retaining control and ownership of your own marketplace.

Key Features

• Basic SOL/MATIC marketplace
• Custom SPL/ERC20 token marketplace
• Multi-currency marketplace (e.g. SOL + SPL token)
• Multi-collection marketplace
• Fully customized marketplace
• NFT auctions
• Verified NFT collections
• Search for NFTs
• Edition NFT drop
• Pay with credit card [in beta]

Install Candy Shop

To get started, please refer to the docs.

npm install @liqnft/candy-shop

or

yarn add @liqnft/candy-shop

Release Notes

Check out the release notes here.

candy-shop's Issues

-

ReferenceError: window is not defined on Next.js

There's a few places where the window object is being referenced:

https://github.com/LIQNFT/candy-shop/search?q=%22window.%22

This is breaking Next.js apps (we are using SSR) and there's no easy way to fix this without hacks. I think this could be solved in the library by adding checks to make sure window is defined?

Handle error response in API call

candy-shop/sdk/src/api/backend/OrderAPI.ts

Line 87 in bd935b9

.then((response) => response.data?.result);

Transaction too large using custom SPL token

Hello! I've been trying out the project for the first time for that past couple of days. I've been able to get nfts listed so far, but when I try to purchase them with my custom SPL token, I get the following error Transaction too large: 1267 > 1232:

{err: Error: Transaction too large: 1267 > 1232
    at assert (http://localhost:1234/index.47330d7d.js:29…}
err: Error: Transaction too large: 1267 > 1232 at assert (http://localhost:1234/index.47330d7d.js:293038:27) at Transaction._serialize (http://localhost:1234/index.47330d7d.js:293408:9) at Transaction.serialize (http://localhost:1234/index.47330d7d.js:293389:21) at sendTx (http://localhost:1234/index.47330d7d.js:282880:102) at async buyAndExecuteSale (http://localhost:1234/index.47330d7d.js:282858:29) at async CandyShop.buy (http://localhost:1234/index.47330d7d.js:283006:24)
message: "Transaction too large: 1267 > 1232"
stack: "Error: Transaction too large: 1267 > 1232\n    at assert (http://localhost:1234/index.47330d7d.js:293038:27)\n    at Transaction._serialize (http://localhost:1234/index.47330d7d.js:293408:9)\n    at Transaction.serialize (http://localhost:1234/index.47330d7d.js:293389:21)\n    at sendTx (http://localhost:1234/index.47330d7d.js:282880:102)\n    at async buyAndExecuteSale (http://localhost:1234/index.47330d7d.js:282858:29)\n    at async CandyShop.buy (http://localhost:1234/index.47330d7d.js:283006:24)"
[[Prototype]]: Object
[[Prototype]]: Object

The store is on mainnet-beta

Here's my config:

// publickKey.ts
export const CREATOR_ADDRESS = '4AQHWYvT647XtdoW7KcVzjEwG3ZqmMDhBpZ316yJWrTp';
export const TREASURY_MINT = 'DKzkt1r6QctnQFx5hMnGomcMimXqVfAyBhMcoKHcBiNK';

// CandyShopContent.tsx
{
        currencySymbol: '$ROUNDIE',
        currencyDecimals: 0,
        priceDecimals: 0,
        volumeDecimals: 1
}

And here's my fork of this project with this behavior: https://github.com/the-roundies/candy-shop

Any clues as to what might be going wrong?

Alternative for qs library

Might wanna look into https://www.npmjs.com/package/query-string, it's a lot smaller in size

try ti buy a nft ,it still show Processing purchase...

i am try to testing buy a nft at https://candy.liqnft.com/marketplace. and my local martplace staill same. it shows Processing purchase... always.

Rarity score

Feature request to add rarity score from known NFT collections

The price in the activity component shows SOL instead of the currency symbol

candy-shop/core/ui/src/public/Activity/index.tsx

Lines 134 to 137 in 7720623

	{`${(Number(trade.price) / candyShop.baseUnitsPerCurrency).toLocaleString(undefined, {
	minimumFractionDigits: candyShop.priceDecimalsMin,
	maximumFractionDigits: candyShop.priceDecimals
	})} SOL`}

SSC Genesys RPC no longer active - broken bids

This needs to be updated to mainnet or similar RPC as users are unable to bid on auctions that use this call to ssc.genesysgo

candy-shop/example/sol/constants/formConfiguration.ts

Line 13 in 510a9ea

mainnetConnectionUrl: 'https://ssc-dao.genesysgo.net/',