ChainEngine

ChainEngine is the simplest blockchain integration platform for a game developer. We provide SDKs, API, and no-code tools to make it easy for a game developer to start building NFT-based games.

To learn more about ChainEngine, please read our Overview or jump right into Quick Start

Chainengine Frontend SDK

Install and Setup

To install Chainengine Frotend SDK to your project:

NPM

npm install --save chainengine-frontend-sdk

YARN

yarn add chainengine-frontend-sdk

Configuration

To use Chainengine Frontend SDK the only parameter you need to provide is the Game ID

import { ChainEngineSdk } from 'chainengine-frontend-sdk';

sdk = new ChainEngineSdk(YOUR_PROJECT_ID);

Connect

In order to authenticate user, sdk.wallet.connect must be called. Uppon the first call, our Provider Selector Modal is displayed so the Player can select how he wants to authenticate.

sdk.wallet.connect MUST be called everytime your page is reloaded, but you probable want to display the Provider Selector Modal only after an user interaction, like when the user clicks on Login button.

In order to call sdk.wallet.connect() only when the user is already authenticated, you can use sdk.isAuthenticatedOrPending():

if (sdk.isAuthenticatedOrPending()) {
  sdk.wallet.connect();
}

Usage

After authenticating your Player you can interact with the other methods of the SDK. Here is the options that are currently available

WALLET

| Method | Description | Parameters | Returns | | ------------------------- | ------------------------- | ---------- | --------------- | | sdk.wallet.connect() | Authenticates Player | ApiMode? | Promise<void> | | sdk.wallet.getApiMode() | Gets connected ApiMode | | ApiMode | | sdk.wallet.getInfo() | Get Player info | | IPlayer | | sdk.wallet.logout() | Remove Player credentials | | void |

IPlayer example

{
 playerId: "40608c49-8a4f-4d0e-b7c5-11db9f0d58cb",
 walletAddress: "0x30B8dE91a8608c3000A28464Ddd4bB8b167F5C52",
 token: {
   sub: "40608c49-8a4f-4d0e-b7c5-11db9f0d58cb",
   walletAddress: "0x30B8dE91a8608c3000A28464Ddd4bB8b167F5C52",
   iat: 1665407792,
   exp: 1667999792,
   jwt: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI0MDYwOGM0OS04YTRmLTRkMGUtYjdjNS0xMWRiOWYwZDU4Y2IiLCJ3YWxsZXRBZGRyZXNzIjoiMHgzMEI4ZEU5MWE4NjA4YzMwMDBBMjg0NjREZGQ0YkI4YjE2N0Y1QzUyIiwiaWF0IjoxNjY1NDA3NzkyLCJleHAiOjE2Njc5OTk3OTJ9.fT9zDtBHKsRuOzVFP4dtnzffaZfUNcBzTICPzRwLKRE"
 },
 authProvider: "google",
 email: "[email protected]",
 phoneNumber: null
}

NFT

| Method | Description | Parameters | Returns | | ------------------ | -------------------------------------------- | ----------------------------------------------------------- | --------------------- | | sdk.nft.getById | Gets a single NFT that belongs to the player | NFTId: string | Promise<IPlayer> | | sdk.nft.getAll | Gets all NFTs that belongs to the Player | | IPaginated<IPlayer> | | sdk.nft.transfer | Transfers a NFT to another Wallet | { walletAddress: string; nftId: string; amount: number; } | Promise<void> |

INft example

{
  id: "af32e3ed-0de6-4b46-aa5f-18ea21d7f921",
  contractAddress: "0x107aC429D35adAb2e08d7C487000B48B8BA618Cf",
  onChainId: "22",
  chain: "mumbai",
  transactionHash: "0x94ed526e3e1a873b16539eeaf95dc826923d61ff9ba8062c9586f4da4d8016b7",
  accountId: "a0d89369-5524-40c3-bede-cef445633451",
  gameId: "9b45ddac-1714-4af6-addf-4406e2bb054c",
  status: "ONCHAIN",
  metadata: {
    name: "Example NFT",
    description: "This is an Example NFT. It has a huge supply",
    image: "http://api.chainengine.xyz/nfts/af32e3ed-0de6-4b46-aa5f-18ea21d7f921/image",
    attributes: null,
    URI: "ipfs://QmZa9mVH5HJFmoiS5tMTfQi3edbyWMjN9EtYKBBqhyrrMx"
  },
  holders: {
    bf9aad6f-8851-400f-bb3e-1bcb4c1dad9a: 110,
    09c0682a-7f10-4f0d-b83f-fe41949f8458: 100,
    40608c49-8a4f-4d0e-b7c5-11db9f0d58cb: 100
  },
  supply: 999,
  supplyAvailable: 689,
  createdAt: "2022-09-23T14:51:56.010Z"
}

IPaginated example

{
  page: 1,
  offset: 0,
  total: 10,
  items: [
    {
      nfts: INft[]
    }
  ]
}

MARKETPLACE

| Method | Description | Parameters | Returns | | ----------------------------- | --------------------------------- | ------------------- | ------------------------------- | | sdk.marketplace.getListings | Gets listings related to the Game | | Promise<ListingResponseDto[]> | | sdk.marketplace.getListing | Gets a single Listing | listingId: string | Promise<ListingResponseDto> | | sdk.marketplace.buy | Buy a listing offer | listindId: string | Promise<ContractTransaction> |

ListingResponseDto example

{
    id: "b87bf781-7283-4ddd-bba9-2eedd300d284",
    nft: INft,
    amount: 10,
    price: 1,
    receiverWallet: "0x359ea9Bc6d3c771d18905dB828ed5c4a655B61d2",
    protocolOffer: {
      parameters: {
        offerer: "0x59F06e983964bA5DD9b788f33fa1e5201b6BdDb3",
        zone: "0x0000000000000000000000000000000000000000",
        zoneHash: "0x3000000000000000000000000000000000000000000000000000000000000000",
        startTime: "1664999732",
        endTime: "115792089237316195423570985008687907853269984665640564039457584007913129639935",
        orderType: 0,
        offer: [
          {
            itemType: 3,
            token: "0x107aC429D35adAb2e08d7C487000B48B8BA618Cf",
            identifierOrCriteria: "22",
            startAmount: "10",
            endAmount: "10"
          }
        ],
        consideration: [
          {
            itemType: 0,
            token: "0x0000000000000000000000000000000000000000",
            identifierOrCriteria: "0",
            startAmount: "1000000000000000000",
            endAmount: "1000000000000000000",
            recipient: "0x359ea9Bc6d3c771d18905dB828ed5c4a655B61d2"
          }
        ],
        totalOriginalConsiderationItems: 1,
        salt: "0x00000000d86e742f62e10600",
        conduitKey: "0x0000000000000000000000000000000000000000000000000000000000000000",
        counter: 0
      },
      signature: "string-with-signature"
    },
    status: "active"
  }