dg-world-marketplace-sdk
v2.1.6
Published
BAG Marketplace SDK Library
Downloads
180
Readme
Basic Usage
To get started with the Metaverse SDK, follow these steps:
Install the SDK on your Decentraland scene by running the following command:
npm i -B dg-world-marketplace-sdk@latest
Add this line at the start of your game.ts file, or any other TypeScript files that require it:
import { DgWorldMarketplace, MarketplaceOptions, } from "dg-world-marketplace-sdk";
Install the SDK on your Decentraland scene by running the following command:
new DgWorldMarketplace({ previewEnv: "prod" as any, network: "MATIC" as any, engine, zoneId: YOUR_ZONE_ID, });
Advanced Usage
For more complex projects, the Metaverse SDK offers additional features and customization options to help developers achieve their desired outcomes. Some advanced usage scenarios include:
Install the SDK on your Decentraland scene by running the following command:
npm i -B dg-world-marketplace-sdk@latest
Add this line at the start of your game.ts file, or any other TypeScript files that require it:
import { DgWorldMarketplace, MarketplaceOptions, } from "dg-world-marketplace-sdk";
Then while initializing the DgWorldMarketplace Class you have all of the following parameters:
const opts: MarketplaceOptions = { previewEnv: "prod" as any, network: "MATIC" as any, engine, zoneId: YOUR_ZONE_ID, debug: true, lang: { noFundsTitle: "No Funds", noFundsDesc: "Sorry, you do not have enough BAG", noFundsButton: "No Funds", approveIceTitle: "Approve BAG", approveIceDesc: "Authorize the Store contract to operate BAG on your behalf", approveIceWait: "Please wait. The transaction is being processed", approveIceRejected: "You need to authorize the Store contract to be able to buy this item", buyFor: "Buy for:", authorize: "Authorize", reject: "Reject", transactionProccessing: "Please wait. The transaction is being processed", purchaseSucceed: "Purchased succeed! You will need to refresh the page to see the wearable in your backpack.", purchaseFailed: "Purchased failed. Please try again.", wait: "Wait", buy: "Buy", openPaymentLink: "Open Payment Link", nftNotAvailable: "NFT not available", }, }; const dgMarketplace = new DgWorldMarketplace(opts);
Keep in mind that the Decentraland SDK only supports one canvas. Therefore, if you want to use your own canvas instead of the one generated by the Marketplace SDK, you need to pass that canvas as a parameter when instantiating the Marketplace SDK.
const opts: MarketplaceOptions = { // other options canvas: yourCanvasInstance, };
After instantiating the class, we can listen to the different events that we want.
// emited when the sdk is ready to connect to the blockchain dgMarketplace.on("web3Ready", () => { log("web3Ready"); }); // emited after the sdk connect to the websocket dgMarketplace.on("websocketsReady", () => { log("websocketsReady"); }); // emited after the sdk fetch the variables dgMarketplace.on("variablesReady", () => { log("variablesReady"); log(dgMarketplace.getVariables()); }); // emited last, when all the sdk is ready dgMarketplace.on("ready", () => { log("ready"); }); // emited when any error happens, notice that err could be null or undefined, depending on the error dgMarketplace.on("error", (err) => { log(err); });