ARCHIVE/xrpl-dev-portal
1
0
Fork 0
mirror of https://github.com/XRPLF/xrpl-dev-portal.git synced 2025-11-21 20:25:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

add nft api topic

Browse Source
This commit is contained in:
ddawson
2023-04-06 15:37:43 -07:00
parent 9036769770
commit a7eecd8289
4 changed files with 776 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
content/concepts/tokens/nft-apis.md Normal file
View File

@@ -0,0 +1,57 @@
---
html: nft-apis.html
parent: non-fungible-tokens.html
blurb: Specialized APIs let you access useful NFT metadata.
labels:
- Non-fungible Tokens, NFTs
---
# NFT APIs
This page lists the transactions and requests associated with NFTs as a handy reference.
## NFT Objects
- [NFToken][] data type - The NFT object stored on the ledger.
- Ledger Objects
- [NFTokenOffer object][] - An offer to buy or sell an NFT.
- [NFTokenPage object][] - An NFT page holds a maximum of 32 NFT objects. In practice, each NFT page typically holds 16-24 NFTs.
## NFT Transactions
- [NFTokenMint][] - Create an NFT.
- [NFTokenCreateOffer][] - Create an offer to buy or sell an NFT.
- [NFTokenCancelOffer][] - Cancel an offer to buy or sell an NFT.
- [NFTokenAcceptOffer][] - Accept an offer to buy or sell an NFT.
- [NFTokenBurn][] - Permanently destroy an NFT.
## NFT requests
- [account_nfts method][] - Get a list of non-fungible tokens owned by an account.
- [nft_buy_offers method][] - Get a list of buy offers for a specified NFToken object.
- [nft_sell_offers method][] - Get a list of sell offers for a specified NFToken object.
- [subscribe method][] - Listen for updates about a particular subject. For example, a marketplace can publish real-time updates on the status of NFTs listed on their platform.
- [unsubscribe method][] - Stop listening for updates about an NFT.
## Clio
Clio servers enhance overall network performance by handling requests for information based on cached information, freeing up validators on the XRP Ledger to focus on processing transactions. In addition to all of the common XRP Ledger request types, the Clio server handles additional request types that provide more detailed responses.
### Clio-specific NFT requests
- [nft_info](nft_info.html) - Get current status information about the specified NFT.
- [nft_history](nft_history.html) - Get past transaction metadata for the specified NFT.
<!--
[nfts_by_issuer](nfts_by_issuer.html) - Get a list of all NFTs created by the specified issuer.
-->
You can access a public Clio server by sending a request to its URL and Clio port (typically 51233). Public Clio API servers come with no SLAs nor any responsibility to be fixed on priority. If your business use case requires continual monitoring and information requests, consider setting up your own Clio server instance. See [install-clio-on-ubuntu-linux](install-clio-on-ubuntu-linux.html).
<!--{# common link defs #}-->
{% include '_snippets/rippled-api-links.md' %}
{% include '_snippets/tx-type-links.md' %}
{% include '_snippets/rippled_versions.md' %}

23
content/concepts/tokens/non-fungible-tokens.md
View File

@@ -6,9 +6,9 @@ labels:
- Non-fungible Tokens, NFTs - Non-fungible Tokens, NFTs
--- ---
# Non-Fungible Tokens Overview # Non-Fungible Tokens
The XRP Ledger supports non-fungible tokens (NFTs, or “nifties” in the vernacular) natively. Non-fungible tokens serve to encode ownership of unique physical, non-physical, or purely digital goods, such as works of art or in-game items. The XRP Ledger natively supports non-fungible tokens (NFTs, or “nifties” in the vernacular). Non-fungible tokens serve to encode ownership of unique physical, non-physical, or purely digital goods, such as works of art or in-game items.
_(Added by the [NonFungibleTokensV1_1 amendment][].)_ _(Added by the [NonFungibleTokensV1_1 amendment][].)_
@@ -64,25 +64,6 @@ You can destroy a `NFToken` you own using the [NFTokenBurn transaction][]. If th
For more info about transferring `NFToken` objects, see [Trading NFTokens on the XRP Ledger](non-fungible-token-transfers.html). For more info about transferring `NFToken` objects, see [Trading NFTokens on the XRP Ledger](non-fungible-token-transfers.html).
## Reference
- [NFToken][] data type
- Ledger Objects
- [NFTokenOffer object][]
- [NFTokenPage object][]
- Transactions
- [NFTokenMint transaction][]
- [NFTokenCreateOffer transaction][]
- [NFTokenCancelOffer transaction][]
- [NFTokenAcceptOffer transaction][]
- [NFTokenBurn transaction][]
- API Methods
- [account_nfts method][]
- [nft_sell_offers method][]
- [nft_buy_offers method][]
- [nft_info method][] (Clio server only)
<!--{# common link defs #}--> <!--{# common link defs #}-->
{% include '_snippets/rippled-api-links.md' %} {% include '_snippets/rippled-api-links.md' %}
{% include '_snippets/tx-type-links.md' %} {% include '_snippets/tx-type-links.md' %}

700
content/references/http-websocket-apis/public-api-methods/clio-methods/nft_history.md Normal file
View File

@@ -0,0 +1,700 @@
---
html: nft_history.html
parent: clio-methods.html
blurb: Retrieve the history of ownership and transfers for the specified NFT using Clio server's `nft_history_` API.
labels:
- Non-fungible Tokens, NFTs
---
# nft_history
[[Source]](https://github.com/XRPLF/clio/blob/4a5cb962b6971872d150777881801ce27ae9ed1a/src/rpc/handlers/NFTHistory.cpp "Source")
The `nft_history` command asks the Clio server for past transaction metadata for the [NFT](non-fungible-tokens.html) being queried. [New in: Clio v1.1.0](https://github.com/XRPLF/clio/releases/tag/1.1.0 "BADGE_BLUE")
**Note** `nft_history` returns only _successful_ transactions associated with the NFT.
## Request Format
An example of the request format:
<!-- MULTICODE_BLOCK_START -->
*WebSocket*
```json
{
"id": 1,
"command": "nft_history",
"nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
}
```
*JSON-RPC*
```json
{
"method": "nft_history",
"params": [
{
"nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
}
]
}
```
<!-- MULTICODE_BLOCK_END -->
<!-- To DO: Add an example command to the assets/js/apitool-methods-ws.js file. The WebSocket Tool requires access to a publicly available Clio server.
[Try it! >](websocket-api-tool.html#nft_history)-->
The request contains the following parameters:
| `Field` | Type | Description |
|:---------------|:---------------------------|:-------------------------------|
| `nft_id` | String | A unique identifier for the non-fungible token (NFT). |
| `ledger_hash` | String | _(Optional)_ A 20-byte hex string for the ledger version to use. (See [Specifying Ledgers][]) |
| `ledger_index` | String or Unsigned Integer | _(Optional)_ The [ledger index][] of the ledger to use, or a shortcut string to choose a ledger automatically. Do not specify the `ledger_index` as `closed` or `current`; doing so forwards the request to the P2P `rippled` server and the `nft_history` API is not available on `rippled`. (See [Specifying Ledgers][]) |
If you do not specify a ledger version, Clio uses the latest validated ledger.
## Response Format
An example of a successful response:
<!-- MULTICODE_BLOCK_START -->
*WebSocket*
```json
{
"id": 0,
"type": "response",
"result": {
"ledger_index_min": 21377274,
"ledger_index_max": 27482261,
"transactions": [
{
"meta": {
"AffectedNodes": [
{
"DeletedNode": {
"FinalFields": {
"Flags": 1,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"RootIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Balance": "1079999928",
"BurnedNFTokens": 1,
"Flags": 0,
"MintedNFTokens": 2,
"OwnerCount": 0,
"Sequence": 27479932
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "6745C90D426A198852939F3F3B97C8467C16147969BF68C773702BED477F4C1B",
"PreviousFields": {
"Balance": "979999940",
"OwnerCount": 1,
"Sequence": 27479931
},
"PreviousTxnID": "377B9A2DBA9448911BDC3C241104C2F6BAE0BF62A2E32976E0FCE33ED945EA8E",
"PreviousTxnLgrSeq": 27481755
}
},
{
"DeletedNode": {
"FinalFields": {
"Amount": "100000000",
"Flags": 0,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"NFTokenOfferNode": "0",
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"OwnerNode": "0",
"PreviousTxnID": "B2E36CBAE4C0E329A0FA373DBC853AE871F9EC0371C6299FE0955F689671F015",
"PreviousTxnLgrSeq": 27481778
},
"LedgerEntryType": "NFTokenOffer",
"LedgerIndex": "9E6D53863A5A5CC3A2FADD774BD744512AE7AFF4E6EAD77FAD4BBCE9C7746F28"
}
},
{
"DeletedNode": {
"FinalFields": {
"Flags": 0,
"NFTokens": [
{
"NFToken": {
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469"
}
}
],
"PreviousTxnID": "377B9A2DBA9448911BDC3C241104C2F6BAE0BF62A2E32976E0FCE33ED945EA8E",
"PreviousTxnLgrSeq": 27481755
},
"LedgerEntryType": "NFTokenPage",
"LedgerIndex": "A955EBAD4AE6261466FBEEEBF6A59591AC8C831FFFFFFFFFFFFFFFFFFFFFFFFF"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"Balance": "919999964",
"Flags": 0,
"OwnerCount": 1,
"Sequence": 27481215
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "AE8FB07137E82BB9D143CE00DFE437A67EDF336EFE8A505BD749B70BF30EF4CD",
"PreviousFields": {
"Balance": "1019999964"
},
"PreviousTxnID": "B2E36CBAE4C0E329A0FA373DBC853AE871F9EC0371C6299FE0955F689671F015",
"PreviousTxnLgrSeq": 27481778
}
},
{
"CreatedNode": {
"LedgerEntryType": "NFTokenPage",
"LedgerIndex": "B30D15755A95CFCA216ABF1296FDD4511BCC313EFFFFFFFFFFFFFFFFFFFFFFFF",
"NewFields": {
"NFTokens": [
{
"NFToken": {
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469"
}
}
]
}
}
},
{
"DeletedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"RootIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26"
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Fee": "12",
"Flags": 0,
"LastLedgerSequence": 27481810,
"NFTokenBuyOffer": "9E6D53863A5A5CC3A2FADD774BD744512AE7AFF4E6EAD77FAD4BBCE9C7746F28",
"Sequence": 27479931,
"SigningPubKey": "EDFD4B44B6CA8F281C85D417EC4717579CA5BA8E74FE066BB5A27851159D350DA0",
"TransactionType": "NFTokenAcceptOffer",
"TxnSignature": "6C7FFDC2781A10FF342E75301D88D5A0D9B5D8B9AF02D3EDC2D07876B13D3E6441C24A86D7FBE9CE5C4E2D03D9A770BC6C388212EADCFE4D24F1E3DED3345E01",
"hash": "F53B8310C329774829EE89D0D373673D8AFC4178BB989CEDCDDE94E40FD0B6CD",
"ledger_index": 27481792,
"date": 733964382
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"CreatedNode": {
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E",
"NewFields": {
"Flags": 1,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"RootIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E"
}
}
},
{
"CreatedNode": {
"LedgerEntryType": "NFTokenOffer",
"LedgerIndex": "9E6D53863A5A5CC3A2FADD774BD744512AE7AFF4E6EAD77FAD4BBCE9C7746F28",
"NewFields": {
"Amount": "100000000",
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc"
}
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"Balance": "1019999964",
"Flags": 0,
"OwnerCount": 1,
"Sequence": 27481215
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "AE8FB07137E82BB9D143CE00DFE437A67EDF336EFE8A505BD749B70BF30EF4CD",
"PreviousFields": {
"Balance": "1019999976",
"OwnerCount": 0,
"Sequence": 27481214
},
"PreviousTxnID": "6455F2D867E7F9C54C725A4AC86B3940277F1E21A0021E5CED1BC2E8D920677F",
"PreviousTxnLgrSeq": 27481410
}
},
{
"CreatedNode": {
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26",
"NewFields": {
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"RootIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26"
}
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"Amount": "100000000",
"Fee": "12",
"Flags": 0,
"LastLedgerSequence": 27481796,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"Owner": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Sequence": 27481214,
"SigningPubKey": "ED196A74C27132D2D1563E50841B6FE1D7AE2EF331E3B2BE889DA88CE1A7974637",
"TransactionType": "NFTokenCreateOffer",
"TxnSignature": "C59B5E3CD80DACC2573A2D197F073DD1F4EA8E5DF4AE9572A724BD0F405349C48B0A462696C3CE5E9B12A86BC2FBDA9974CA3D6C864053D1DE179F347C06FC01",
"hash": "B2E36CBAE4C0E329A0FA373DBC853AE871F9EC0371C6299FE0955F689671F015",
"ledger_index": 27481778,
"date": 733964341
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Balance": "979999940",
"BurnedNFTokens": 1,
"Flags": 0,
"MintedNFTokens": 2,
"OwnerCount": 1,
"Sequence": 27479931
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "6745C90D426A198852939F3F3B97C8467C16147969BF68C773702BED477F4C1B",
"PreviousFields": {
"Balance": "979999952",
"MintedNFTokens": 1,
"OwnerCount": 0,
"Sequence": 27479930
},
"PreviousTxnID": "79FA1C8DD916E147892D765CBE798D8D7C0073FF6BF64ED3A80DCA79ABFA065E",
"PreviousTxnLgrSeq": 27481745
}
},
{
"CreatedNode": {
"LedgerEntryType": "NFTokenPage",
"LedgerIndex": "A955EBAD4AE6261466FBEEEBF6A59591AC8C831FFFFFFFFFFFFFFFFFFFFFFFFF",
"NewFields": {
"NFTokens": [
{
"NFToken": {
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469"
}
}
]
}
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Fee": "12",
"Flags": 8,
"LastLedgerSequence": 27481774,
"NFTokenTaxon": 0,
"Sequence": 27479930,
"SigningPubKey": "EDFD4B44B6CA8F281C85D417EC4717579CA5BA8E74FE066BB5A27851159D350DA0",
"TransactionType": "NFTokenMint",
"TransferFee": 10000,
"TxnSignature": "C95A7819CA1F5229B0818FEBD21DA28892FB64CD70C169D0E4911688E57047CDEFAD273A72D255BC388BE5A96FCBF26657C62EFBC240746047D818A219BB8A0F",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469",
"hash": "377B9A2DBA9448911BDC3C241104C2F6BAE0BF62A2E32976E0FCE33ED945EA8E",
"ledger_index": 27481755,
"date": 733964271
},
"validated": true
}
],
"nft_id": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"validated": true
},
"warnings": [
{
"id": 2001,
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
}
]
}
```
*JSON-RPC*
```json
"result": {
"ledger_index_min": 21377274,
"ledger_index_max": 27482261,
"transactions": [
{
"meta": {
"AffectedNodes": [
{
"DeletedNode": {
"FinalFields": {
"Flags": 1,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"RootIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Balance": "1079999928",
"BurnedNFTokens": 1,
"Flags": 0,
"MintedNFTokens": 2,
"OwnerCount": 0,
"Sequence": 27479932
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "6745C90D426A198852939F3F3B97C8467C16147969BF68C773702BED477F4C1B",
"PreviousFields": {
"Balance": "979999940",
"OwnerCount": 1,
"Sequence": 27479931
},
"PreviousTxnID": "377B9A2DBA9448911BDC3C241104C2F6BAE0BF62A2E32976E0FCE33ED945EA8E",
"PreviousTxnLgrSeq": 27481755
}
},
{
"DeletedNode": {
"FinalFields": {
"Amount": "100000000",
"Flags": 0,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"NFTokenOfferNode": "0",
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"OwnerNode": "0",
"PreviousTxnID": "B2E36CBAE4C0E329A0FA373DBC853AE871F9EC0371C6299FE0955F689671F015",
"PreviousTxnLgrSeq": 27481778
},
"LedgerEntryType": "NFTokenOffer",
"LedgerIndex": "9E6D53863A5A5CC3A2FADD774BD744512AE7AFF4E6EAD77FAD4BBCE9C7746F28"
}
},
{
"DeletedNode": {
"FinalFields": {
"Flags": 0,
"NFTokens": [
{
"NFToken": {
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469"
}
}
],
"PreviousTxnID": "377B9A2DBA9448911BDC3C241104C2F6BAE0BF62A2E32976E0FCE33ED945EA8E",
"PreviousTxnLgrSeq": 27481755
},
"LedgerEntryType": "NFTokenPage",
"LedgerIndex": "A955EBAD4AE6261466FBEEEBF6A59591AC8C831FFFFFFFFFFFFFFFFFFFFFFFFF"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"Balance": "919999964",
"Flags": 0,
"OwnerCount": 1,
"Sequence": 27481215
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "AE8FB07137E82BB9D143CE00DFE437A67EDF336EFE8A505BD749B70BF30EF4CD",
"PreviousFields": {
"Balance": "1019999964"
},
"PreviousTxnID": "B2E36CBAE4C0E329A0FA373DBC853AE871F9EC0371C6299FE0955F689671F015",
"PreviousTxnLgrSeq": 27481778
}
},
{
"CreatedNode": {
"LedgerEntryType": "NFTokenPage",
"LedgerIndex": "B30D15755A95CFCA216ABF1296FDD4511BCC313EFFFFFFFFFFFFFFFFFFFFFFFF",
"NewFields": {
"NFTokens": [
{
"NFToken": {
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469"
}
}
]
}
}
},
{
"DeletedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"RootIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26"
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Fee": "12",
"Flags": 0,
"LastLedgerSequence": 27481810,
"NFTokenBuyOffer": "9E6D53863A5A5CC3A2FADD774BD744512AE7AFF4E6EAD77FAD4BBCE9C7746F28",
"Sequence": 27479931,
"SigningPubKey": "EDFD4B44B6CA8F281C85D417EC4717579CA5BA8E74FE066BB5A27851159D350DA0",
"TransactionType": "NFTokenAcceptOffer",
"TxnSignature": "6C7FFDC2781A10FF342E75301D88D5A0D9B5D8B9AF02D3EDC2D07876B13D3E6441C24A86D7FBE9CE5C4E2D03D9A770BC6C388212EADCFE4D24F1E3DED3345E01",
"hash": "F53B8310C329774829EE89D0D373673D8AFC4178BB989CEDCDDE94E40FD0B6CD",
"ledger_index": 27481792,
"date": 733964382
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"CreatedNode": {
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E",
"NewFields": {
"Flags": 1,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"RootIndex": "33A64DE4A5B00FDB23036216653F1059C5ED7546E502DE878500DF667D61551E"
}
}
},
{
"CreatedNode": {
"LedgerEntryType": "NFTokenOffer",
"LedgerIndex": "9E6D53863A5A5CC3A2FADD774BD744512AE7AFF4E6EAD77FAD4BBCE9C7746F28",
"NewFields": {
"Amount": "100000000",
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc"
}
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"Balance": "1019999964",
"Flags": 0,
"OwnerCount": 1,
"Sequence": 27481215
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "AE8FB07137E82BB9D143CE00DFE437A67EDF336EFE8A505BD749B70BF30EF4CD",
"PreviousFields": {
"Balance": "1019999976",
"OwnerCount": 0,
"Sequence": 27481214
},
"PreviousTxnID": "6455F2D867E7F9C54C725A4AC86B3940277F1E21A0021E5CED1BC2E8D920677F",
"PreviousTxnLgrSeq": 27481410
}
},
{
"CreatedNode": {
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26",
"NewFields": {
"Owner": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"RootIndex": "C20BE23C0678A107CFACF3AA60A7A8E912A43685FB4FC87EFE8420F146FA5E26"
}
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "rHKjdRD2aHzEojrioJb4tw6p4i7FS1hUkc",
"Amount": "100000000",
"Fee": "12",
"Flags": 0,
"LastLedgerSequence": 27481796,
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"Owner": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Sequence": 27481214,
"SigningPubKey": "ED196A74C27132D2D1563E50841B6FE1D7AE2EF331E3B2BE889DA88CE1A7974637",
"TransactionType": "NFTokenCreateOffer",
"TxnSignature": "C59B5E3CD80DACC2573A2D197F073DD1F4EA8E5DF4AE9572A724BD0F405349C48B0A462696C3CE5E9B12A86BC2FBDA9974CA3D6C864053D1DE179F347C06FC01",
"hash": "B2E36CBAE4C0E329A0FA373DBC853AE871F9EC0371C6299FE0955F689671F015",
"ledger_index": 27481778,
"date": 733964341
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Balance": "979999940",
"BurnedNFTokens": 1,
"Flags": 0,
"MintedNFTokens": 2,
"OwnerCount": 1,
"Sequence": 27479931
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "6745C90D426A198852939F3F3B97C8467C16147969BF68C773702BED477F4C1B",
"PreviousFields": {
"Balance": "979999952",
"MintedNFTokens": 1,
"OwnerCount": 0,
"Sequence": 27479930
},
"PreviousTxnID": "79FA1C8DD916E147892D765CBE798D8D7C0073FF6BF64ED3A80DCA79ABFA065E",
"PreviousTxnLgrSeq": 27481745
}
},
{
"CreatedNode": {
"LedgerEntryType": "NFTokenPage",
"LedgerIndex": "A955EBAD4AE6261466FBEEEBF6A59591AC8C831FFFFFFFFFFFFFFFFFFFFFFFFF",
"NewFields": {
"NFTokens": [
{
"NFToken": {
"NFTokenID": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469"
}
}
]
}
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "rGS43H57KGnvsDapj796XXo3g5qWcQxqmA",
"Fee": "12",
"Flags": 8,
"LastLedgerSequence": 27481774,
"NFTokenTaxon": 0,
"Sequence": 27479930,
"SigningPubKey": "EDFD4B44B6CA8F281C85D417EC4717579CA5BA8E74FE066BB5A27851159D350DA0",
"TransactionType": "NFTokenMint",
"TransferFee": 10000,
"TxnSignature": "C95A7819CA1F5229B0818FEBD21DA28892FB64CD70C169D0E4911688E57047CDEFAD273A72D255BC388BE5A96FCBF26657C62EFBC240746047D818A219BB8A0F",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469",
"hash": "377B9A2DBA9448911BDC3C241104C2F6BAE0BF62A2E32976E0FCE33ED945EA8E",
"ledger_index": 27481755,
"date": 733964271
},
"validated": true
}
],
"nft_id": "00082710A955EBAD4AE6261466FBEEEBF6A59591AC8C831F16E5DA9C00000001",
"validated": true
},
"warnings": [
{
"id": 2001,
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
}
]
}
```
<!-- MULTICODE_BLOCK_END -->
The response follows the [standard format][], with a successful result containing the following fields:
| `Field` | Type | Description |
|:-------------------|:---------------------------|:---------------------------|
| `nft_id` | String | A unique identifier for the non-fungible token (NFT). |
| `ledger_index_min` | Integer - [Ledger Index][] | The ledger index of the earliest ledger actually searched for transactions. |
| `ledger_index_max` | Integer - [Ledger Index][] | The ledger index of the most recent ledger actually searched for transactions. |
| `limit` | Integer | The `limit` value used in the request. (This may differ from the actual limit value enforced by the server.) |
| `marker` | [Marker][] | Server-defined value indicating the response is paginated. Pass this to the next call to resume where this call left off. |
| `transactions` | Array | Array of transactions matching the request's criteria, as explained below. |
| `validated` | Boolean | If included and set to `true`, the information in this response comes from a validated ledger version. Otherwise, the information is subject to change. |
**Note:** The server may respond with different values of `ledger_index_min` and `ledger_index_max` than you provided in the request, for example if it did not have the versions you specified on hand.
Each transaction object includes the following fields, depending on whether it was requested in JSON or hex string (`"binary":true`) format.
| `Field` | Type | Description |
|:---------------|:---------------------------------|:-------------------------|
| `ledger_index` | Integer | The [ledger index][] of the ledger version that included this transaction. |
| `meta` | Object (JSON) or String (Binary) | If `binary` is True, then this is a hex string of the transaction metadata. Otherwise, the transaction metadata is included in JSON format. |
| `tx` | Object | (JSON mode only) JSON object defining the transaction |
| `tx_blob` | String | (Binary mode only) Unique hashed String representing the transaction. |
| `validated` | Boolean | Whether or not the transaction is included in a validated ledger. Any transaction not yet in a validated ledger is subject to change. |
For definitions of the fields returned in the `tx` object, see [Transaction Metadata](transaction-metadata.html).
## Possible Errors
* Any of the [universal error types][].
* `invalidParams` - One or more fields are specified incorrectly, or one or more required fields are missing.
* `actMalformed` - The [Address][] specified in the `account` field of the request is not formatted properly.
* `lgrIdxMalformed` - The ledger specified by the `ledger_index_min` or `ledger_index_max` does not exist, or if it does exist but the server does not have it.
* `lgrIdxsInvalid` - Either the request specifies a `ledger_index_max` that is before the `ledger_index_min`, or the server does not have a validated ledger range because it is [not synced with the network](server-doesnt-sync.html).
{% include '_snippets/rippled_versions.md' %}
{% include '_snippets/rippled-api-links.md' %}

17
dactyl-config.yml
View File

@@ -852,6 +852,11 @@ pages:
targets: targets:
- ja - ja
- md: concepts/tokens/nft-apis.md
targets:
- en
- ja
- md: concepts/tokens/freezes.md - md: concepts/tokens/freezes.md
targets: targets:
- en - en
@@ -3512,12 +3517,24 @@ pages:
- en - en
- ja - ja
# TODO: translate
- md: references/http-websocket-apis/public-api-methods/clio-methods/nft_history.md
targets:
- en
- ja
# TODO: translate # TODO: translate
- md: references/http-websocket-apis/public-api-methods/clio-methods/nft_info.md - md: references/http-websocket-apis/public-api-methods/clio-methods/nft_info.md
targets: targets:
- en - en
- ja - ja
# TODO: translate
- md: references/http-websocket-apis/public-api-methods/clio-methods/nfts_by_issuer.md
targets:
- en
- ja
- name: Utility Methods - name: Utility Methods
html: utility-methods.html html: utility-methods.html
parent: public-api-methods.html parent: public-api-methods.html