Bequesting a token

Send a token to an account that you have previously generated. This feature allows you to create decentralised experiences with onchain proof where a user requires no prior blockchain experience.

This feature is in beta and there will be unexpected side effects if the body parameters aren't used.

Send/bequest a token to an account

POST https://hedera-serverless-consensus.vercel.app/api/token/bequest

This endpoint allows you to send a token to user as a permissioned function, provide the encrypted keys and ids of the receiver and token.

Headers

Name	Type	Description
Authentication*	string	The API_SECRET_KEY from th e client's environment variables.

Request Body

Name	Type	Description
encrypted_receiver_key*	String	Encrypted private key of receiver
token_id*	String	ID of token to send
receiver_id*	String	Account id of receiving account
amount*	Number	amount of tokens to send
decimals	Number	Explicitly set decimals of the token

200 Token sent to user

{
    "data": {
        "amount": "1",
        "receiver_id": "0.0.2120537",
        "transaction_id": "0.0.1156@1634128052.72220023"
    }
}

422: Unprocessable Entity Encrypted key too short

{
    "errors": [
        "\"encrypted_receiver_key\" length must be 241 characters long"
    ]
}