💱Transfer SRR Ownership By RevealHash

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

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

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

201: Created

{
  "txReceiptId": 0
}

400: Bad Request

{
    "statusCode":400,
    "message":"hash of revealHash does not match the SRR transferCommitment"
}

400: Bad Request

{
    "statusCode":400,
    "message":"metadata is invalid. Check it against the metadata JSON schema. Details: should NOT have additional properties ({"additionalProperty":"unknownField"})."
}

404: Not Found

{
    "statusCode":404,
    "message":"Token 41052230 not found"
}

500: Internal Server Error Transaction Sending Errors - these errors occur after validation but before the transaction is sent to Ethereum.

{
    "statusCode":500,
    "message":"API account is out of funds"
}

500: Internal Server Error Transaction Sending Errors - these errors occur after validation but before the transaction is sent to Ethereum.

{
    "statusCode":500,
    "message":"failed to send transaction toEthereum - internal error"
}

Request Body Example

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

Swagger Endpoint (Test Environment)

Swagger to test

Required Permissions

• You need to have a Licensed User

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