Token Setup Guide

Ensure your wallet is open and connected and that you have registered with the website (hub). Go to products and click add, then choose the token product type. 

Field descriptions:

Tags csv - For tokens and NFAs, add relevant tags in csv format like "nfa, collection name, categories" etc or if it is a token add "token, token name" etc.

Product Name - Will show up as the product title/label/name and will be cut off at 50 characters on the main products list. 

Details - A description of the token or NFA, cuts off at 100 characters on the main products list. It may be a good idea to state if it is an NFA that can be purchased using the smart contract functions in the wallet instead of using the integrated address purchase option. You won't need to keep your app online in this case but should check in once a day to keep your NFA listed and delete your product when if it has sold using wallet functions.

Respond Amount - .00001 is the minumum amount and also the amount that should be specified if it is an NFA since those are a token with a max supply of what ever the smallest possible amount is which is .00001. For tokens, this is the amount of tokens to send when purchased, this can be set at the product level or at the integrated address level. If you want to specify the amount of tokens to send at the integrated address level, set the integrated address respond amounts accordingly which will override the default product respond amount. To set product level amounts for one buying option, set the respond amount to the desired amount at the product level and set the integrated address amount to 0.

Inventory - Can be specified at the product level and/or the integrated address level. Integrated address inventory will override the product level inventory until it reaches 0, then it will start deducting inventory from the product inventory. Integrated address level inventory is useful for products that have different buying options for different amounts of tokens etc. The seller app will try to check your token amounts to make sure that you don't try to sell more than you have, if this happens then it should send a refund to the buyer for the original amount in Dero.

SCID - This is the smart contract id used in the Engram asset explorer to view the smart contract and available functions and should be 64 characters in length. There are no checks in place currently so make sure to check that it is correct. 

For this example we'll add 2 integrated addresses to show how to sell one at a time or 5 tokens at once at different prices.

Fill out the product submission for and click submit. 

Submitting tokens

 

Scroll down and click add integrated address.
 

Fill out the integrated address form. Leave SCID blank in this case since it is one type of token and we've already entered the SCID in at the product level. The price is .1 Dero for one Test Token. and there are 10 of these available. Click submit with status active to publish and display the product immediately.

Integrated address form

You can scroll down and click add integrated address again to create a buying option for 5 Test Tokens for the same Dero/Token ratio.

Second integrated address

The integrated address form mostly represents what is shown in the wallets when entered into the send field as an address. 

Field Descriptions:

Comment - The comment shown in the wallet when the I.A. is entered into the send field.

Ask Amount - The amount / price denominated in Dero shown in the wallet.

Respond Amount - The amount of tokens that will be sent with the response to the buyer, overrides product level unless set to 0. It is best to set this to 0 if it's an NFA and set the product level respond amount to .00001 instead.

Port - The port shown in the wallet, can be just about any integer number (64bit).

SCID - Leave blank to use the SCID set at the product level or enter a different one to override or provide different tokens for different buying options (I.A.s). This might be useful for utility tokens or proving purchase of different options.

Inventory - The amount of items available for this buying option (overrides product level inventory unless set to 0). If you have 100 tokens and you sell 10 at a time then inventory should be 10.

Status - Whether or not the integrated address is active, it will delist the buying option when set to inactive and refund any purchases made to the address while in inactive state.

Expiration - NOTE: Feature not supported in wallets yet. Integrated addresses can have an expiration date, if provided, the date in utc time will stop the listing and set the address to inactive. 

 

The product list should now show a product resembling the second one shown in the list with 2 buying option below. 

Product List