Startrail APIs
  • 🛫Startrail PORT: All in one document for API/SDK
    • 🔀URL per environment
  • Issue transfer api
    • 📬Issue & Transfer SRR (NFT)
      • Request Signed URL for Upload/Download Files
      • File Information Metadata
      • Issue & Transfer
      • Webhook Setup
    • 📂Collection
      • Create Collection
      • Get Collection of LUW
    • 📢Change Logs
      • v1.2.0
      • v1.1.0
      • v1.0.1
  • Metadata Schema
    • 🪅Startrail Registry (SRR)
      • Version 2.2
      • Version 2.1
      • Version 2.0
    • 📤Transfer
      • Version 1.2
      • Version 1.1
      • Version 1.0
    • ☸️Custom History
      • Custom History of Exhibition
        • Version 1.2
      • Custom History of Auction
        • Version 1.3
      • Custom History of Appraisal
        • Version 1.1
      • Custom History of Restoration
        • Version 1.0
      • Custom History of Offchain
        • Version 1.1
  • Get SRR API
    • Get Owned SRRs
    • Get SRR by Collection contract address and Token Id
      • 🚫Get SRR by Token Id
    • Description Of SRR Data
  • Ethereum Signature Validator API
    • 🔏Ethereum Signature Validator API
      • Change Logs
  • Startrail SDK Js
    • 🔰Introduction
    • 🏃Getting Started
      • RPC endpoint and chainId
    • 💳Wallet Methods
    • 🔮Startrail API Methods
      • Add Custom Histories To SRRs
      • Approve SRR By Commitment
      • Bulk
      • Check ERC2981 Royalty
      • Create Collection
      • Convert Metadata
      • Create SRR
      • Transfer Collection Ownership
      • Transfer SRR To Ethereum Address
      • Transfer From With Provenance
      • Update Metadata
    • 📱Login Providers
      • Interface
      • Whitelabeling/Customizing
        • Email Password
      • Hints
      • Multi Factor Account Management
    • 🦊MetaMask
    • 🎎Authentication Integration
    • 👾Errors
    • 📢Change logs
      • v1.35.0
      • v1.34.0
      • v1.33.2
      • v1.33.1
      • v1.32.0
      • v1.31.1
      • v1.30.6
      • v1.30.5
      • v1.30.4
      • v1.30.3
      • v1.30.2
      • v1.30.1
      • v1.30.0
      • v1.29.1
      • v1.29.0
      • v1.28.2
      • v1.28.1
      • v1.28.0
      • v1.27.1
      • v1.27.0
      • v1.26.0
      • v1.25.2(Security Patch)
  • Startrail API
    • 💱Transfer SRR Ownership By RevealHash
    • Get Transaction Data
    • Get Metadata By tokenid
  • Subgraph
    • 📊A introduction of subgraph
    • How to retrieve SRR metadata
Powered by GitBook

©2023 Startbahn, Inc.

On this page
  • Transfer With Default Collection
  • Transfer With Custom Collection
  • Request Body Example
  • Swagger Endpoint (Test Environment)
  • Required Permissions

Was this helpful?

  1. Startrail API

Transfer SRR Ownership By RevealHash

Executes blockchain transaction to transfer an ownership of an SRR to another Ethereum address.

Previousv1.25.2(Security Patch)NextGet Transaction Data

Last updated 9 months ago

Was this helpful?

Transfer With Default Collection

POST <base_url>/startrail/api/v1/srr/{tokenId}/transferByReveal

Transfer With Custom Collection

POST <base_url>/startrail/api/v1/srr/{contractAddress}/{tokenId}/transferByReveal

Please replace <base_url> as explained .

Transfer SRR to a new owner providing a reveal hash, the hash of matches the commitment given in the approval stage.

Default collection address is not supported in Transfer With Custom Collection. Please use Transfer With Default Collection instead.

Path Parameters

Name
Type
Description

tokenId*

String

Startrail Registry Record Token ID

contractAddress

String

The address of collection contract

Request Body

Name
Type
Description

revealHash*

String

The key generated on Port Dashboard in advance for future transfer

to*

String

Next owner's EOA address. Both lowercase and mixed case which is compatible with EIP55 are accepted

isIntermediary

Boolean

{
  "txReceiptId": 0
}
{
    "statusCode":400,
    "message":"hash of revealHash does not match the SRR transferCommitment"
}
{
    "statusCode":400,
    "message":"metadata is invalid. Check it against the metadata JSON schema. Details: should NOT have additional properties ({"additionalProperty":"unknownField"})."
}
{
    "statusCode":404,
    "message":"Token 41052230 not found"
}
{
    "statusCode":500,
    "message":"API account is out of funds"
}
{
    "statusCode":500,
    "message":"failed to send transaction toEthereum - internal error"
}

Request Body Example

{
  "revealHash": "0x335929a4e59b0860ec04c620c1284dace74c00f7eadaadce7a18d6deba6c544e",
  "to": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  "isIntermediary": false
}

Swagger Endpoint (Test Environment)

Required Permissions

  • You need to have a Licensed User

You must pass the revealHash which you generated at via Startrail-Sdk-Js in order to complate transfer

💱
here
Swagger to test
approveSRRByCommitment()