Listing/Delisting an NFT
Listing and delisting on the hyperspace contract
For the beta we will start with allowing users to be able to list and delist NFTs on the hyperspace contract. The Hyperspace contract takes a .5% platform fee that the seller pays. It allows for builders to add custom fees on either buyer or seller side.

Listing

The listing function on the hyperspace contract allows you to set seller fees for anyone who lists on your platform.
Function: createListTx
Inputs:
  • [Required] sellerAddress
    • Type: string
    • Description: The seller of the NFT
  • [Required] price
    • Type: number
    • Description: Price in sol of item
  • [Required] tokenAddress
    • Type: string
    • Description: Token Address to be listed
  • [Required] sellerBroker
    • Type: string
    • Description: The wallet address that collects the seller fees.
    • Please use the treasury wallet address you provided to us in the API form, so we can identify that the call is coming from your platform. If your treasury wallet has changed reach out to us to let us know.
  • [Optional] sellerBrokerBasisPoints
    • Type: number
    • Default Value: 0
    • Description: Basis points that the seller broker can collect
Response:
GetListTxQuery
Example:
Create a listing for a serum surfer for 200 SOL and not collecting a fee if it sells
​
const input: GetListTxQueryVariables = {
tokenAddress: "9ZYc1p5zamyCjbRsp2NNZTQ4sXwKwbf9V5EUYVxpF8nN",
sellerAddress: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C",
price: 200,
sellerBroker: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C",
sellerBrokerBasisPoints: 0
}
​
hsClient.createListTx(input)
​
// Get buffer response from above sign and send to chain
​
Creating a listing my serum surfer for 200 SOL and collecting .5% of fees if it sells
Seller pays 1% (.5% platform to hyperspace and .5% to seller broker)
const input: GetListTxQueryVariables = {
tokenAddress: "9ZYc1p5zamyCjbRsp2NNZTQ4sXwKwbf9V5EUYVxpF8nN",
sellerAddress: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C",
price: 200,
sellerBroker: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C",
sellerBrokerBasisPoints: 50
}
​
hsClient.createListTx(input)
​
// Get buffer response from above sign and send to chain

Delisting

Function: createDelistTx
Inputs:
  • [Required] sellerAddress
    • Type: string
    • Description: The seller of the listing
  • [Required] tokenAddress
    • Type: string
    • Description: The token address of the NFT
Response:
GetDelistTxQuery
Example:
const input: GetDelistTxQueryVariables = {
tokenAddress: "9ZYc1p5zamyCjbRsp2NNZTQ4sXwKwbf9V5EUYVxpF8nN",
sellerAddress: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C",
}
​
hsClient.createDelistTx(input)
Copy link