Basic Usage

To get started with the Metaverse SDK, follow these steps:

1. Install the SDK on your Decentraland scene by running the following command:

   npm i -B dg-world-marketplace-sdk@latest

2. 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";

3. 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:

1. Install the SDK on your Decentraland scene by running the following command:

   npm i -B dg-world-marketplace-sdk@latest

2. 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";

3. 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);

4. 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,
   };

5. 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);
   });