/sendTransactionToEvmContractWithRawHex

1 min

POST

Sends a transaction to an EVM smart contract, with the data already compiled to binary and encoded in hex. The data must be encoded according to the ABI spec, starting with 0x...

See https://solidity.readthedocs.io/en/develop/abi-spec.html for spec info. This function refers only to EVM smart contracts.

NOTE: Success or failure in this API call does not necessarily mean success or failure in the transaction itself. For one example, the transaction may succeed, but the "success" response to the client can be lost if the internet is down for the client. To verify the status of the transaction:

Call /getCurrentToken and store it in the DB.
Send your transaction. The transaction created uses the token from step 1.
Call /getTransactionByToken using your token from /getCurrentToken to track the current status of the transaction you just sent.

return: JSON object ready to be sent to the MPC by the function sendTransaction.

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

        sendTransactionToEvmContractWithRawHex(
                  account_id=1,
                  contract_address="0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
                  amount="0",
                  gas_price="50000000000",
                  gas_limit=70000, 
                  raw_data_in_hex="0xa90....fbb00",
                  validate_transaction=True,
                  description="example",
                  specificFromAddress="0x4aA.....DcefF",
                  evm_coin_symbol="ETH",
                  max_priority_fee="1000000000"
              )

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

{
          "FunctionData": {
              "ApprovalRequestStatus": 3,
              "CoinType": "CELO",
              "Transactions": [
                  {
                      "AmountToTransfer": "600",
                      "DestinationAddress": "3Qnv...g3"
                  }
              ]
          },
          "Meta": {
              "AccessToken": "f192762c...",
              "Destination": "045bd19d...",
              "Source": "6f8fd2e8...",
              "Time": "2024-09-29 20:48:21.158"
          }
      }

account_idintegerThe account ID to use in this operation.

contract_addressstringThe address of the contract to send to.

amountstringThe amount send via this transaction, in Wei.

gas_priceintegerThe amount to pay for a unit of gas, in Wei. In London fork currencies, this is the maximum fee to pay per gas unit.

gas_limitintegerThe maximum units of gas to spend for this transaction, which must be at least 21500, call /getGasLimitSuggestedForTransactionToEvmContractWithRawHex to see a suggested limit based on the state of the node.

raw_data_in_hexstringBinary data parsed and encoded according to the ABI spec above. It starts with 0x...

validate_transactionbooleanWhen true, the MPC wallet will access the node (using eth_call) to check if the transaction is likely to fail and will block the transaction if it is.

descriptionstringText for describing the transaction in your records. This is not sent to the blockchain.

specificFromAddressstringThe deposit address to send from - can not be used if the account is defined as an Omnibus account

evm_coin_symbolstringThe coin symbol of the EVM network where the smart contract is deployed, for example ETH, CELO, etc...

max_priority_feestringThe max priority fee to tip the miner in EIP1559 EVM / ERC-20 transactions. (See <a href="https://metamask.io/1559/" target="_blank">https://metamask.io/1559/</a> for details.)

transaction_external_initiator_providerbooleanFor internal use only - data that indicates that an external provider (i.e. MetaMask) initiates the transaction. External clients should not set this.

acceptstringGenerated from available response content types

bodyobjectRequest data for an Ethereum transaction.

200success

curl --request POST \
     --url '/sendTransactionToEvmContractWithRawHex?account_id=1&contract_address=0xE4Fd4d9190075de22826DdeC437594d27fb549Ab&amount=6000&gas_price=1&gas_limit=21500&raw_data_in_hex=0xa90...00&validate_transaction=False&description=example&specificFromAddress=0x862842A56B5D5F30B7d519cCe683983F57499cE6&evm_coin_symbol=ETH&transaction_external_initiator_provider=True' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "AccountId": 1,
     "CoinType": "ETH",
     "DataForContract": {
     "FunctionName": "transfer",
     "ParametersFieldsTypesAndValues": [
     {
     "ParameterType": "address",
     "ParameterValue": "0xEDF9C138F990b4ed9b7cb83F6ad8fF76017572B9"
     }
     ],
     "validateTransaction": "true"
     },
     "Fee": {
     "GasLimit": 21500,
     "GasPrice": "100000000000"
     },
     "IsMetaMaskTransaction": "False",
     "SpecificFromAddress": "0x862842A56B5D5F30B7d519cCe683983F57499cE6",
     "Transactions": [
     {
     "AmountToTransfer": "6000",
     "DestinationAddress": "0x04e5C3F98ac6711baDd357A76E8FEAe226Dd60c7"
     }
     ],
     "UserDescription": "transferExample",
     "Meta": {
     "FunctionName": "sendTransactionToEvmContractWithRawHex",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'