FAQ

Frequently Asked Questions

What is metadata?

If you provide rich digital asset metadata, applications like Vessel Marketplace can pull in these data and easily display them in-app. Digital assets on a given smart contract are typically represented solely by a unique identifier (such as the token ID in ERC1155). Metadata allows these assets to have additional properties, such as a name, description, attributes, and images.

What is the difference between mutable and immutable metadata?

Immutable metadata cannot be edited as they are fixed in the smart contract, whereas you can alter mutable metadata.

How do you create unique variations of a NFT?

After you set up your Token within the Vessel dashboard, you can use the clone method of the Game API to create unique variations of your token.

For example:

You have a token template for a Great Sword (com.fungames.epicrpg.greatsword) and you want to create a copy of this sword within your game for a given user. You can do so by means of the following POST request:

Create a clone token based on parent fqTn

POSThttps://game-api.openvessel.io/tokens/manage/{fqTn}/clone

Path parameters

fqTn*string

Fully qualified token name

Header parameters

Body

application/json

tostring

Address of the token receiver

mutablePropertiesobject

Arbitrary mutable properties

cloneMutablePropertiesboolean

Should mutable properties of parent token be clonned as well

displayInDiscoveryboolean

The flag that controls display in the Discovery

Response

202400401403404405409429500

Accepted

Body

*/*

response*ManageResponseCloneTokenResponse (object)

Request

JavaScriptCurl

const response = await fetch('https://game-api.openvessel.io/tokens/manage/{fqTn}/clone', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "response": {
    "txHash": "text",
    "description": "text",
    "details": {
      "fqTn": "text"
    }
  }
}

This creates the following token:

com.fungames.epicrpg.greatsword:1

A second POST request to the same endpoint mints an additional clone of that token:

com.fungames.epicrpg.greatsword:2

Developers typically use this method as a way to track each minted NFT individually within their projects.

Do you have a test project that you can provide us?

Vessel has a Unity test project which is available to be shared. https://github.com/OpenVesselIO/Wallet-SDK-Unity-DemoApp

What are the gas fees for consumers utilizing your blockchain?

There are none at this time.

Who should I contact for support?

Please reach out to [e-mail] with any questions or issues.

Why does my app keep getting “Connection Failed” when it requests a Wallet Connection to Vessel on iOS?

Make sure you have added the following code in Xcode to your Info.plist. If your issue persists, reach out to [e-mail] for additional assistance.

<key>LSApplicationQueriesSchemes</key>
	<array>
		<string>vesselwa</string>
	</array>

Why can’t I see a minted token in my Vessel app?

This can happen if you minted the token in the production environment but you are running the Vessel app in another environment. Verify that your Vessel app is pointing to the production environment by taking the following steps:

1. Open the Vessel app.

2. Click the Profile tab, at the bottom right.

3. On the profile page, click the settings gear at the top right.

4. Scroll down to the bottom and click the Logout button.

5. After you log out, click and hold the Vessel logo at the top left for five seconds. A dropdown appears from which you can choose your environment. Make sure PRODUCTION is selected.

6. Log in again.

What does Vessel provide for my app?

Vessel provides out-of-the-box blockchain infrastructure for your mobile application, allowing you to offer your users the capability to mint, buy, sell, and store NFTs with ease. Vessel allows you to focus on your app design, content, and users, while making it easy to have a full-featured blockchain application. Plus, you can set a fee on secondary sales or peer-to-peer trading, so that you keep earning long after the initial item sale.

Customization

You can tailor your Vessel storefront exactly to your project, and can create a fully customizable landing page and marketplace.

Liquidity and discoverability

Consumers use the Vessel iOS & Android application to discover, purchase, and sell rare digital items. By listing your game on Vessel, you open up your items to a large user base of gamers, traders, and crypto enthusiasts. This increases both the liquidity of your items and the discoverability of your app.