Skip to content

Commit a8e3d17

Browse files
theekrystalleegitbook-bot
authored andcommitted
update definition for NFT ID #80
1 parent 88d1c78 commit a8e3d17

File tree

3 files changed

+9
-10
lines changed

3 files changed

+9
-10
lines changed

sdks-and-apis/sdks/token-service/get-nft-token-info.md

Lines changed: 2 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ A query that returns information about a non-fungible token (NFT). You request t
44

55
**Token Allowances**
66

7-
Only when a spender is set on an explicit NFT ID of a token, we return the spender ID in the`TokenNftInfoQuery` for the respective NFT. If `approveTokenNftAllowanceAllSerials` is used to approve all NFTs for a given token class and no NFT ID is specified, we will not return a spender ID for all the serial numbers of that token.
7+
Only when a spender is set on an explicit NFT ID of a token, we return the spender ID in the `TokenNftInfoQuery` for the respective NFT. If `approveTokenNftAllowanceAllSerials` is used to approve all NFTs for a given token class and no NFT ID is specified, we will not return a spender ID for all the serial numbers of that token.
88

99
**Query Fees**
1010

@@ -17,14 +17,7 @@ Requesting NFT info by Token ID or Account ID is deprecated.
1717

1818
The request returns the following information:
1919

20-
| Item | Description |
21-
| ----------------- | --------------------------------------------------------------------------------------------------------------- |
22-
| **NFT ID** | The ID of the non-fungible token in x.y.z format. |
23-
| **Account ID** | The account ID of the current owner of the NFT |
24-
| **Creation Time** | The effective consensus timestamp at which the NFT was minted |
25-
| **Metadata** | Represents the unique metadata of the NFT |
26-
| **Ledger ID** | The ID of the network (mainnet, testnet, previewnet). Reference [HIP-198](https://hips.hedera.com/hip/hip-198). |
27-
| **Spender ID** | The spender account ID for the NFT. This is only returned if the NFT ID was specifically approved. |
20+
<table><thead><tr><th width="201.48828125">Item</th><th>Description</th></tr></thead><tbody><tr><td><strong>NFT ID</strong></td><td>The unique ID of a non-fungible token composed of the token ID and serial number in the format: <code>&#x3C;shardNum>.&#x3C;realmNum>.&#x3C;tokenNum>/&#x3C;serialNum></code> (e.g., <code>0.0.1234/1</code>).</td></tr><tr><td><strong>Account ID</strong></td><td>The account ID of the current owner of the NFT</td></tr><tr><td><strong>Creation Time</strong></td><td>The effective consensus timestamp at which the NFT was minted</td></tr><tr><td><strong>Metadata</strong></td><td>Represents the unique metadata of the NFT</td></tr><tr><td><strong>Ledger ID</strong></td><td>The ID of the network (mainnet, testnet, previewnet). Reference <a href="https://hips.hedera.com/hip/hip-198">HIP-198</a>.</td></tr><tr><td><strong>Spender ID</strong></td><td>The spender account ID for the NFT. This is only returned if the NFT ID was specifically approved.</td></tr></tbody></table>
2821

2922
### Methods
3023

sdks-and-apis/sdks/token-service/get-token-info.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Gets information about a fungible or non-fungible token instance.&#x20;
99

1010
The token info query returns the following information:
1111

12-
<table><thead><tr><th width="267">Item</th><th>Description</th></tr></thead><tbody><tr><td><strong>TokenId</strong></td><td>ID of the token instance</td></tr><tr><td><strong>Token Type</strong></td><td>The type of token (fungible or non-fungible)</td></tr><tr><td><strong>Name</strong></td><td>The name of the token. It is a string of ASCII only characters</td></tr><tr><td><strong>Symbol</strong></td><td>The symbol of the token. It is a UTF-8 capitalized alphabetical string</td></tr><tr><td><strong>Decimals</strong></td><td>The number of decimal places a token is divisible by</td></tr><tr><td><strong>Total Supply</strong></td><td>The total supply of tokens that are currently in circulation</td></tr><tr><td><strong>Treasury</strong></td><td>The ID of the account which is set as Treasury</td></tr><tr><td><strong>Custom Fees</strong></td><td>The custom fee schedule of the token, if any</td></tr><tr><td><strong>Fee Schedule Key</strong></td><td>Fee schedule key, if any</td></tr><tr><td><strong>Admin Key</strong></td><td>The key which can perform update/delete operations on the token. If empty, the token can be perceived as immutable (not being able to be updated/deleted)</td></tr><tr><td><strong>KYC Key</strong></td><td>The key which can grant or revoke KYC of an account for the token's transactions. If empty, KYC is not required, and KYC grant or revoke operations are not possible.</td></tr><tr><td><strong>Freeze Key</strong></td><td>The key which can freeze or unfreeze an account for token transactions. If empty, freezing is not possible</td></tr><tr><td><strong>Wipe Key</strong></td><td>The key which can wipe token balance of an account. If empty, wipe is not possible</td></tr><tr><td><strong>Supply Key</strong></td><td>The key which can change the supply of a token. The key is used to sign Token Mint/Burn operations</td></tr><tr><td><strong>Pause Key</strong></td><td>The key that can pause or unpause the token from participating in transactions.</td></tr><tr><td><strong>Pause Status</strong></td><td><p>Whether or not the token is paused.</p><p>false = not paused</p><p>true = paused</p></td></tr><tr><td><strong>Max Supply</strong></td><td>The max supply of the token</td></tr><tr><td><strong>Supply Type</strong></td><td>The supply type of the token</td></tr><tr><td><strong>Default Freeze Status</strong></td><td><p>The default Freeze status (not applicable = null, frozen = false, or unfrozen = true) of Hedera accounts relative to this token. FreezeNotApplicable is returned if Token Freeze Key is empty. Frozen is returned if Token Freeze Key is set and defaultFreeze is set to true. Unfrozen is returned if Token Freeze Key is set and defaultFreeze is set to false.</p><p>FreezeNotApplicable = null;</p><p>Frozen = true;</p><p>Unfrozen = false;</p></td></tr><tr><td><strong>Default KYC Status</strong></td><td><p>The default KYC status (KycNotApplicable or Revoked) of Hedera accounts relative to this token. KycNotApplicable is returned if KYC key is not set, otherwise Revoked.</p><p>KycNotApplicable = null;</p><p>Granted = false;</p><p>Revoked = true;</p></td></tr><tr><td><strong>Auto Renew Account</strong></td><td>An account which will be automatically charged to renew the token's expiration, at autoRenewPeriod interval</td></tr><tr><td><strong>Auto Renew Period</strong></td><td>The interval at which the auto-renew account will be charged to extend the token's expiry</td></tr><tr><td><strong>Expiry</strong></td><td>The epoch second at which the token will expire; if an auto-renew account and period are specified, this is coerced to the current epoch second plus the autoRenewPeriod</td></tr><tr><td><strong>Ledger ID</strong></td><td>The ID of the network the response came from. See <a href="https://hips.hedera.com/hip/hip-198">HIP-198</a>.</td></tr><tr><td><strong>Memo</strong></td><td>Short publicly visible memo about the token, if any</td></tr><tr><td><strong>Metadata Key</strong></td><td>The key which can change the metadata of a token definition or individual NFT.</td></tr><tr><td><strong>Metadata</strong></td><td>The metadata for the token.</td></tr></tbody></table>
12+
<table><thead><tr><th width="267">Item</th><th>Description</th></tr></thead><tbody><tr><td><strong>Token ID</strong></td><td>ID of the token instance</td></tr><tr><td><strong>Token Type</strong></td><td>The type of token (fungible or non-fungible)</td></tr><tr><td><strong>Name</strong></td><td>The name of the token. It is a string of ASCII only characters</td></tr><tr><td><strong>Symbol</strong></td><td>The symbol of the token. It is a UTF-8 capitalized alphabetical string</td></tr><tr><td><strong>Decimals</strong></td><td>The number of decimal places a token is divisible by</td></tr><tr><td><strong>Total Supply</strong></td><td>The total supply of tokens that are currently in circulation</td></tr><tr><td><strong>Treasury</strong></td><td>The ID of the account which is set as Treasury</td></tr><tr><td><strong>Custom Fees</strong></td><td>The custom fee schedule of the token, if any</td></tr><tr><td><strong>Fee Schedule Key</strong></td><td>Fee schedule key, if any</td></tr><tr><td><strong>Admin Key</strong></td><td>The key which can perform update/delete operations on the token. If empty, the token can be perceived as immutable (not being able to be updated/deleted)</td></tr><tr><td><strong>KYC Key</strong></td><td>The key which can grant or revoke KYC of an account for the token's transactions. If empty, KYC is not required, and KYC grant or revoke operations are not possible.</td></tr><tr><td><strong>Freeze Key</strong></td><td>The key which can freeze or unfreeze an account for token transactions. If empty, freezing is not possible</td></tr><tr><td><strong>Wipe Key</strong></td><td>The key which can wipe token balance of an account. If empty, wipe is not possible</td></tr><tr><td><strong>Supply Key</strong></td><td>The key which can change the supply of a token. The key is used to sign Token Mint/Burn operations</td></tr><tr><td><strong>Pause Key</strong></td><td>The key that can pause or unpause the token from participating in transactions.</td></tr><tr><td><strong>Pause Status</strong></td><td><p>Whether or not the token is paused.</p><p>false = not paused</p><p>true = paused</p></td></tr><tr><td><strong>Max Supply</strong></td><td>The max supply of the token</td></tr><tr><td><strong>Supply Type</strong></td><td>The supply type of the token</td></tr><tr><td><strong>Default Freeze Status</strong></td><td><p>The default Freeze status (not applicable = null, frozen = false, or unfrozen = true) of Hedera accounts relative to this token. FreezeNotApplicable is returned if Token Freeze Key is empty. Frozen is returned if Token Freeze Key is set and defaultFreeze is set to true. Unfrozen is returned if Token Freeze Key is set and defaultFreeze is set to false.</p><p>FreezeNotApplicable = null;</p><p>Frozen = true;</p><p>Unfrozen = false;</p></td></tr><tr><td><strong>Default KYC Status</strong></td><td><p>The default KYC status (KycNotApplicable or Revoked) of Hedera accounts relative to this token. KycNotApplicable is returned if KYC key is not set, otherwise Revoked.</p><p>KycNotApplicable = null;</p><p>Granted = false;</p><p>Revoked = true;</p></td></tr><tr><td><strong>Auto Renew Account</strong></td><td>An account which will be automatically charged to renew the token's expiration, at autoRenewPeriod interval</td></tr><tr><td><strong>Auto Renew Period</strong></td><td>The interval at which the auto-renew account will be charged to extend the token's expiry</td></tr><tr><td><strong>Expiry</strong></td><td>The epoch second at which the token will expire; if an auto-renew account and period are specified, this is coerced to the current epoch second plus the autoRenewPeriod</td></tr><tr><td><strong>Ledger ID</strong></td><td>The ID of the network the response came from. See <a href="https://hips.hedera.com/hip/hip-198">HIP-198</a>.</td></tr><tr><td><strong>Memo</strong></td><td>Short publicly visible memo about the token, if any</td></tr><tr><td><strong>Metadata Key</strong></td><td>The key which can change the metadata of a token definition or individual NFT.</td></tr><tr><td><strong>Metadata</strong></td><td>The metadata for the token.</td></tr></tbody></table>
1313

1414
### Methods
1515

support-and-community/glossary.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -793,6 +793,12 @@ A non-custodial wallet is a [decentralized](glossary.md#decentralization) wallet
793793

794794
A unique digital asset with ownership rights that are stored on a distributed network. An NFT can be a one-of-a-kind image, video, composed music, game asset, medical record, event ticket, domain, or other creative media that is tokenized, therefore, can be bought, sold, or traded on a distributed ledger using various cryptocurrencies.
795795

796+
### Non-Fungible Token (NFT) ID
797+
798+
***
799+
800+
The unique ID of a non-fungible token composed of the token ID and serial number in the format: `<shardNum>.<realmNum>.<tokenNum>/<serialNum>` (e.g., `0.0.1234/1`).
801+
796802
### Nonce
797803

798804
***

0 commit comments

Comments
 (0)