ERC721 Token

Token ERC721 APIs.

Endpoint

{Server URL}/v1/chain/erc721

getBalance

Return an address Token balance.

Parameters

Name	Type	Description
contractAddress	String	Contract address of token.
address	String	Address

Return Value

Name	Type	Description
balance	BigInteger	Token balance of address.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "balance": "10"
        }
    }
}

getMintedTokenId

Return a minted tokenId.

Parameters

Name	Type	Description
transactionId	String	TransactionId of erc721_mint.

Return Value

Name	Type	Description
tokenId	BigInteger	minted tokenId. If it is an error, this is null .

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "tokenId": "1"
        }
    }
}

mint

Create new token with uri data. Only the token owner can do this..

Parameters

Name	Type	Description
contractAddress	String	Contract address of token
sender	String	Address
uri	String	The uri data to store in the token. Max length : 100
tempKey	String	tempKey for "mint"
hashKey	String	hash(tempKey | secretKey)
signature	String	sign( hash ( contractAddress | sender | uri | tempKey | hashKey ) ) by owner's privateKey using signData API
gasPrice	BigDecimal	gasPrice
nonce	BigInteger	nonce value. If it is null, it will be filled in automatically. If acceleration is needed, use the nonce value generated when performing the transaction and use a higher gasPrice than the previous transaction.

Return Value

Name	Type	Description
transactionId	String	Transaction Id
nonce	BigInteger	nonce value

A transactionId is returned, but that doesn't mean it has been added to the Block yet. You should check that the status is 1 by using net_getTransactionStatus.

The generated tokenId can be checked using erc721_getMintedTokenId API.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "transactionId": "0xf7d37be47ce8b563b07aa5e81e17e9722bab2e71374d970a558b45c0ed51df7b",
            "nonce": 32
        }
    }
}

getURI

Returns an owner and uri data of tokenId.

Parameters

Name	Type	Description
contractAddress	String	Contract address of token
address	String	Address
tokenId	BigInteger	Token Id

Return Value

Name	Type	Description
owner	String	Owner's address
uri	String	The uri data of token.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "owner":"0x666cf9aed17a9dfb4ae91b80789dd99803568b11",
            "uri":"0xaff42527a42d60ca3fb548fd799b01e6f57e309cd12c226881487266cd5dd2c9"
        }
    }
}

transfer

Transfer NFT owner from from-address to to-address.

Parameters

Name	Type	Description
contractAddress	String	Contract address of token
sender	String	Sender address
toAddress	String	To address
tokenId	BigInteger	Token Id
tempKey	String	tempKey for "transfer"
hashKey	String	hash(tempKey | fromAddress' secretKey)
signature	String	sign( hash ( contractAddress | sender | toAddress | tokenId | tempKey | hashKey ) ) by formAddress's privateKey using signData API
gasPrice	BigDecimal	gasPrice
nonce	BigInteger	nonce value. If it is null, it will be filled in automatically. If acceleration is needed, use the nonce value generated when performing the transaction and use a higher gasPrice than the previous transaction.

Return Value

Name	Type	Description
transactionId	String	Transaction Id
none	BigInteger	nonce value

A transactionId is returned, but that doesn't mean it has been added to the Block yet. You should check that the status is 1 by using net_getTransactionStatus.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "transactionId": "0xf7d37be47ce8b563b07aa5e81e17e9722bab2e71374d970a558b45c0ed51df7b",
            "noce": 32
        }
    }
}

transferFrom

Transfer NFT owner from from-address to to-address by spender address.

Parameters

Name	Type	Description
contractAddress	String	Contract address of token
sender	String	Sender address
fromAddress	String	From address
toAddress	String	To address
tokenId	BigInteger	Token Id
tempKey	String	tempKey for "transfer"
hashKey	String	hash(tempKey | fromAddress' secretKey)
signature	String	sign( hash ( contractAddress | sender | fromAddress | toAddress | tokenId | tempKey | hashKey ) ) by address's privateKey using signData API
gasPrice	BigDecimal	gasPrice
nonce	BigInteger	nonce value. If it is null, it will be filled in automatically. If acceleration is needed, use the nonce value generated when performing the transaction and use a higher gasPrice than the previous transaction.

Return Value

Name	Type	Description
transactionId	String	Transaction Id
nonce	BigInteger	nonce value

A transactionId is returned, but that doesn't mean it has been added to the Block yet. You should check that the status is 1 by using net_getTransactionStatus.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "transactionId": "0xf7d37be47ce8b563b07aa5e81e17e9722bab2e71374d970a558b45c0ed51df7b",
            "nonce": 32
        }
    }
}

approve

Approve token from owner-address to spender-address.

Parameters

Name	Type	Description
contractAddress	String	Contract address of token
sender	String	Sender address
spender	String	Spender address
tokenId	BigInteger	Token Id
tempKey	String	tempKey for "approve"
hashKey	String	hash(tempKey | fromAddress' secretKey)
signature	String	sign( hash ( contractAddress | sender | spender | tokenId | tempKey | hashKey ) ) by formAddress's privateKey using signData API
gasPrice	BigDecimal	gasPrice
nonce	BigInteger	nonce value. If it is null, it will be filled in automatically. If acceleration is needed, use the nonce value generated when performing the transaction and use a higher gasPrice than the previous transaction.

Return Value

Name	Type	Description
transactionId	String	Transaction Id

A transactionId is returned, but that doesn't mean it has been added to the Block yet. You should check that the status is 1 by using net_getTransactionStatus.

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "transactionId": "0xf7d37be47ce8b563b07aa5e81e17e9722bab2e71374d970a558b45c0ed51df7b",
            "nonce": 32
        }
    }
}

getApproved

Returns an allowed token spender from owner address.

Parameters

Name	Type	Description
contractAddress	String	Contract address of token.
address	String	Owner address
tokenId	BigInteger	Token Id

Return Value

Name	Type	Description
address	String	Spender's address

Example

{
    "jsonrpc": "2.0",
    "id": "00456",
    "result": {
        "resultCode": "200",
        "resultMessage": "Success",
        "resultData": {
            "address": "0x666cf9aed17a9dfb4ae91b80789dd99803568b11"
        }
    }
}