← All posts

Extra Docs for Blockchain Events

• Written by Josh Wolff
  1. Context Required Depending on the Event Group
  2. Event Group Descriptions
  3. Account State Descriptions

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.
  • 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.
  • 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.
  • 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 in staking you receive a reward for the lock-up. In stashing, you do not receive a reward.
  • 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.

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

Hi! I'm Josh. I'm building a platform to make interacting with blockchains easy. The blog highlights how to use the API, feature developments, newletters, and other important information.