💱Transfer SRR Ownership By RevealHash

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

POST <base_url>/startrail/api/v1/srr/{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.

Path Parameters

Name	Type	Description
tokenId*	String	Startrail Registry Record Token ID

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