Usage

This is a detailed explanation of the features provided by the NFT module.

Contents

NameDescription

Issue NFT.

Transfer the ownership right of the issued NFT.

Burn the issued NFT.

Parameters required to call API.

1. mint

Issue NFT and record the result on the chain network.

Parameters

NameTypeExample

wallet

Object (FirmaWalletService)

You can check how to use your wallet in the "firma-js of the Github repository".

tokenURI

String

"https://firmachain.org/nft/metadata/bcf5cdajs-ff12...-d2han89nnha1"

txMisc

(Not required)

Object (TxMisc)

{fee:200000,gas:163821,memo:"custom message"}

Return value

{
  code: 0,
  height: 1175104,
  rawLog: '[{
            "events": [{
              "type": "message",
              "attributes": [
                {"key":"action","value":"Mint"},
                {"key":"Owner","value":"firma1trqyle9m2nvyafc2n25frkpwed2504y6avgfzr"},
                {"key":"nftID","value":"76"}
              ]
            }]
          }]',
  transactionHash: '2F257E674FB3EA...DE83D18D963F320',
  gasUsed: 71996,
  gasWanted: 200000
}

2. transfer

Transfer the ownership right of the issued NFT and record the result of the transfer on the chain network.

Parameters

NameTypeExample

wallet

Object (FirmaWalletService)

You can check how to use your wallet in the "firma-js of the Github repository".

toAddress

String

"firma1nssuz67am2uwc2hjgvphg0fmj3k9l6cx65ux9u"

nftID

String

"16"

txMisc

(Not required)

Object (TxMisc)

{fee:200000,gas:163821,memo:"custom message"}

Return value

{
  code: 0,
  height: 1175663,
  rawLog: '[{
            "events": [{
              "type":"message",
              "attributes":[{
                "key":"action",
                "value":"Transfer"
              }]
            }]
          }]',
  transactionHash: 'A862717FEDB9212...D71833B10BCC756',
  gasUsed: 77461,
  gasWanted: 200000
}

3. burn

Following are the features offered in order to search the issued NFTs.

Parameters

NameTypeExample

wallet

Object (FirmaWalletService)

You can check how to use your wallet in the "firma-js of the Github repository".

nftID

String

"16"

txMisc

(Not required)

Object (TxMisc)

{fee:200000,gas:163821,memo:"custom message"}

Return value

{
  code: 0,
  height: 1175693,
  rawLog: '[{
            "events": [{
              "type":"message",
              "attributes": [{"key":"action","value":"Burn"}]
            }]
          }]',
  transactionHash: '6174F2D9D8C7D37...811BCCE8A15CD5C',
  gasUsed: 63177,
  gasWanted: 200000
}

4. Parameter Description

NameDescription

wallet

Unique wallet parameter created from the user’s Mnemonic. This parameter can be called by using the Wallet.fromMnemonic function from the FirmaSDK module.

toAddress

For this parameter, please enter your FirmaChain wallet address.

nftID

For this parameter, Unique ID of the issued NFT.

txMisc

This object contains the gas fee that is deducted when a transaction is called upon.

* The default gas fee is set at 0.02fct.

tokenURI

Metadata address describing the NFT.

Last updated