/sendTransactionToEvmContractWithContractInfo

1 min

POST

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: Dict, e.g. {"FunctionName":"transfer","ParametersFieldsTypesAndValues":[["address","0xEDF9...2B9"], ["uint256","100000000000000000"]]}

example: sendTransactionToEvmContractWithContractInfo(1,"0xde0B...BAe","0","50000000000",70000, "transfer",[["address","0xEDF9C...2B9"], ["uint256","100000000000000000"]],True,"false","transferExample",None,"1000000000","ETH")

account_idintegerThe account ID to use in this operation.

contract_addressstringThe address of the contract to send to.

amountstringthe amount to send with 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 /getGasLimitSuggestedForTransactionToEvmContractWithContractInfo to see a suggested limit based on the state of the node.

function_namestringThe name of the function to call, e.g. "foo" (with no params)

parameters_fields_types_and_valuesobjectThe list of pairs of "type" and value for each parameter in the function (see <a href="https://docs.soliditylang.org/en/develop/abi-spec.html" target="_blank">https://docs.soliditylang.org/en/develop/abi-spec.html</a> for the full specifications).

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.

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

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

acceptstringGenerated from available response content types

bodyobjectRequest data for an Ethereum transaction.

200success

curl --request POST \
     --url '/sendTransactionToEvmContractWithContractInfo?account_id=1&contract_address=0x04e5C3F98ac6711baDd357A76E8FEAe226Dd60c7&amount=6000&gas_price=100000000000&gas_limit=21500&function_name=transfer&parameters_fields_types_and_values=%22None%22&validate_transaction=False&description=transferExample&specificFromAddress=0x862842A56B5D5F30B7d519cCe683983F57499cE6&evm_coin_symbol=ETH' \
     --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": "sendTransactionToEvmContractWithContractInfo",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'