← 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.