/requestSignForReceiveWithAuthorizationParameters

1 min

POST

Send request to sign TransferWithAuthorization parameters for 'TransferWithAuthorization' smart contract function. Before calling 'getTransferWithAuthorizationParametersAfterSign' with this function output, you should wait until the signature is ready (~10 seconds).

Return: JSON containing the status of the approval request and the signed data.

-------------------- Request --------------------

        requestSignForReceiveWithAuthorizationParameters(
                account_id=1,
                contract_address="3tf9.....72kkd",
                to_address="fdjs9.....2fr4f",
                from_address="0fd02....82f34",
                vm_coin_symbol="ETH",
                valid_after=1,
                token_name=Optional[str] = None,
                deadline=86400,
                transfer=TRUE
            );

-------------------- Response --------------------

{
    "FunctionData": {
              "ApprovalRequestStatus": 2,
              "EIP712EncodingVersion": "v4",
              "Payload": {
                  "domain": {
                      "chainId": 1,
                      "name": "MyApp",
                      "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC",
                      "version": "1"
                  },
                  "message": {
                      "contents": "Hello, Bob!",
                      "recipient": {
                          "name": "Bob",
                          "wallet": "0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB"
                      }
                  },
                  "primaryType": "Message",
                  "types": {
                      "EIP712Domain": [
                          {"name": "name", "type": "string"},
                      ],
                      "Message": [
                          {"name": "contents", "type": "string"},
                      ],
                      "Person": [
                          {"name": "name", "type": "string"},
                      ]
                  }
              }
          },
    "Meta": {
        "AccessToken": "6276...79fe",
        "Destination": "0453...9d56",
        "Source": "fc581...42f3",
        "Time": "2025-02-10 13:05:23.729"
    }
}

account_idintegerThe account ID the tokens will be transferred from.

contract_addressstringthe address of the smart contract.

to_addressstringAddress that the token will be transferred to.

spenderstringthe spender who will call the transfer function with the 'owner' tokens.

valueintegerhow much tokens in smallest units the spender is allowed to transform in the name of owner.

evm_coin_symbolstringsymbol for the evm coin.

token_namestringThe name of the token (optional, if None then name is taken from the contracts 'name' function). If token name length is bigger then 32 characters, the name should be provided to the function

valid_afterintegertime until 'permit' call can be made with the signed parameters in seconds (default value is 86400, one day).

ownerstringThe owner of the tokens that permits to transfer from him. Has to be either Hot Evm address or one of its deposit addresses if its an endpoint account. If owner is None then Hot Evm address is used

deadlineintegertime until 'permit' call can be made with the signed parameters in seconds (default value is 86400, one day).

acceptstringGenerated from available response content types

bodyobject

200success

curl --request POST \
     --url '/requestSignForReceiveWithAuthorizationParameters?account_id=1&contract_address=0x0A687dC222DeB849a109eb3978cf3f8B1FE87a7a&to_address=0x0A687dC222DeB849a109eb3978cf3f8B1FE87a7a&spender=0x53C39FFd56EE07e081a53bd176baf20DBE24e19B&value=1000&evm_coin_symbol=ETH&token_name=ETH&valid_after=1&owner=0x53C39FFd56EE07e081a53bd176baf20DBE24e19B&deadline=24*60*60' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "FunctionData": {
     "AccountId": 1,
     "CoinType": "ETH",
     "DataToSign": {
     "EIP712EncodingVersion": "v3",
     "Payload": {
     "domain": {
     "chainId": 17000,
     "name": "Permit",
     "verifyingContract": "0x0A687dC222DeB849a109eb3978cf3f8B1FE87a7a",
     "version": "1"
     },
     "message": {
     "deadline": 1707313326,
     "owner": "0x53C39FFd56EE07e081a53bd176baf20DBE24e19B",
     "spender": "0x53C39FFd56EE07e081a53bd176baf20DBE24e19B",
     "value": "1000"
     },
     "primaryType": "Permit"
     }
     },
     "SpecificFromAddress": "0x53C39FFd56EE07e081a53bd176baf20DBE24e19B"
     },
     "Meta": {
     "FunctionName": "requestSignForPermitParameters",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'