diff --git a/content/references/protocol-reference/transactions/transaction-types/nftokencanceloffer.md b/content/references/protocol-reference/transactions/transaction-types/nftokencanceloffer.md new file mode 100644 index 0000000000..dc27c489e9 --- /dev/null +++ b/content/references/protocol-reference/transactions/transaction-types/nftokencanceloffer.md @@ -0,0 +1,83 @@ +--- +html: nftokencanceloffer.html +parent: transaction-types.html +blurb: Cancel existing token offers to buy or sell an NFToken. +labels: + - NFTs, Non-fungible Tokens +--- +# NFTokenCancelOffer + +The `NFTokenCancelOffer` transaction can be used to cancel existing token offers created using `NFTokenCreateOffer`. + +##Example {{currentpage.name}} JSON + +{ + "TransactionType": "NFTokenCancelOffer", + "Account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", + "TokenIDs": "000100001E962F495F07A990F4ED55ACCFEEF365DBAA76B6A048C0A200000007" + } + + +## Permissions + +An existing offer, represented by an `NFTokenOffer` object, can be cancelled by: + + + +* The account that originally created the `NFTokenOffer`. +* The account in the `Destination` field of the `NFTokenOffer`, if one is present. +* The issuer of the token identified by the `TokenUID` field in the `NFTokenOffer` object, if the token has the `lsfIssuerCanCancelOffers` flag set. +* Any account, if the `NFTokenOffer` specifies an expiration time and the close time of the parent ledger in which the `NFTokenCancelOffer` is included is greater than the expiration time. + +This transaction removes the listed `NFTokenOffer` object from the ledger, if present, and adjusts the reserve requirements accordingly. It is not an error if the `NFTokenOffer` cannot be found: if that is the case, the transaction should complete successfully. + +{% include '_snippets/tx-fields-intro.md' %} + +
| Field Name + | +Required? + | +JSON Type + | +Internal Type + | +Description + | +
TransactionType
+ |
+ Yes + | +string + | +UINT16 + | +NFTokenCancelOffer transaction type. The integer identifier is 28.
+ |
+
TokenIDs
+ |
+ Yes + | +array + | +VECTOR256 + | +An array of TokenID objects, each identifying the NFTokenOffer object that should be cancelled by this transaction.
+
+It is an error if an entry in this list points to an object that is not an |
+