Extra Docs for Blockchain Events
• Written by Josh Wolff
Context Required Depending on the Event Group
The list below$$ describes which fields in the primary_event_context
dictionary are required depending on the type of NFT event.
nft_list
- owner
- price
nft_de_list
- owner
nft_buy
- owner
- buyer
- price
nft_make_offer
- buyer
- price
nft_accept_offer
- owner
- buyer
- price
nft_cancel_offer
- buyer
nft_update_price
- owner
- price
nft_create_auction
- owner
- price
nft_bid_auction
- buyer
- price
nft_redeem_auction
- owner
- buyer
- price
nft_cancel_auction
- owner
nft_make_loan_offer
- owner
- price
nft_accept_loan_offer
- owner
- creditor
- price
nft_default_on_loan
- owner
- creditor
nft_pay_back_loan
- owner
- creditor
- price
nft_rent_nft
- owner
- buyer
nft_return_rented_nft
- owner
- buyer
nft_list_for_rent
- owner
- price
nft_de_list_for_rent
- owner
p2p_trade
- owner
- sender
- receiver
nft_stash_nft
- owner
nft_unstash_nft
- owner
- receiver
nft_stake_nft
- owner
nft_unstake_nft
- owner
nft_transfer_nft
- owner
- sender
- receiver
nft_burn_nft
- owner
nft_mint_nft
- price
- buyer
nft_mint_master_edition
- owner
nft_metadata_update
- n/a
nft_unknown
- n/a
ata_close_account
- n/a
ata_create_account
- n/a
set_authority
- n/a
sol_escrow_transfer
- n/a
validation
- n/a
preparation
- n/a
multi_sig_transaction
- n/a
Event Group Descriptions
This list describes succintly to what each event refers.
- nft_list
- The listing of an NFT for sale, such as on MagicEden.
- nft_de_list
- The removal of a listing.
- nft_buy
- The purchase of an NFT for sale.
- nft_make_offer
- An offer made on an NFT, which may or may not be listed for sale.
- nft_accept_offer
- An acceptance of an existing offer made on an NFT, which may or may not have been listed for sale.
- nft_cancel_offer
- The cancellation of an offer previously made.
- nft_update_price
- The owner updated a price of a listed NFT.
- nft_create_auction
- The NFT was put up for auction.
- nft_bid_auction
- A bid was made on an NFT listed for auction.
- nft_redeem_auction
- The final sale price of the NFT was accepted, or the auction was closed and the NFT sold for the highest price.
- nft_cancel_auction
- The auction was cancelled.
- nft_make_loan_offer
- The NFT was offered as collateral for a loan.
- nft_accept_loan_offer
- The loan was accepted by a
creditor
.
- The loan was accepted by a
- nft_default_on_loan
- The previous owner of the NFT did not pay back the loan in time and so defaulted. The NFT was then transferred to the
creditor
.
- The previous owner of the NFT did not pay back the loan in time and so defaulted. The NFT was then transferred to the
- nft_pay_back_loan
- The owner paid back the loan and received the NFT they put up as collateral in return.
- nft_rent_nft
- The NFT was rented to the
renter
.
- The NFT was rented to the
- nft_return_rented_nft
- The NFT was returned to the owner by the renter.
- nft_list_for_rent
- The NFT was listed for rent.
- nft_de_list_for_rent
- The rental listing was removed.
- p2p_trade
- A P2P trade was made involving the NFT.
- nft_stash_nft
- The NFT was stashed in a vault. This is different from
staking
because instaking
you receive a reward for the lock-up. Instashing
, you do not receive a reward.
- The NFT was stashed in a vault. This is different from
- nft_unstash_nft
- The NFT was unstashed.
- nft_stake_nft
- The NFT was staked.
- nft_unstake_nft
- The NFT was unstaked.
- nft_transfer_nft
- The NFT was transferred to a new owner.
- nft_burn_nft
- The NFT was burned.
- nft_mint_nft
- The NFT was created.
- nft_mint_master_edition
- A master edition for the NFT was created.
- nft_metadata_update
- The metadata of the NFT was updated.
- nft_unknown
- An unknown event involving the NFT occurred.
- ata_close_account
- An associated token account was closed.
- ata_create_account
- An associated token account was created.
- set_authority
- The authority for the associated token account of the NFT was changed.
- sol_escrow_transfer
- SOL was transferred from/to escrow.
- validation
- A validation, intermediate step before a more important transaction, was made.
- preparation
- A preparation, intermediate step before a more important transaction, was made.
- multi_sig_transaction
- A transaction was signed with a multi-sig. We try to decode the underlying transaction and return this instead. If we are unable, we return
multi_sig_transaction
.
- A transaction was signed with a multi-sig. We try to decode the underlying transaction and return this instead. If we are unable, we return
Account State Descriptions
- loaning
- The NFT is being held in escrow as collateral for a loan.
- listing
- The NFT is listed for sale.
- listing_for_rent
- The NFT is lised for rent.
- staking
- The NFT is staked in return for a reward.
- holding
- The NFT is held in the wallet.
- burned
- The NFT was permanently burned.
- renting
- The NFT is being rented.
- auctioning
- The NFT is being auctioned.
- stashing
- The NFT is being stashed.
Written by Josh Wolff