Transfer ETH

Returns a transaction for sending the native token between addresses.

Securitybearer or cookie
Request
path Parameters
chain
required
string (ChainName)

The blockchain chain label.

Value: "ethereum"
Request Body schema: application/json
signature
string
args
Array of any

List of the function arguments.

from
string (ETHAddress) ^0[xX][a-fA-F0-9]{40}$

An ethereum address.

nonce
integer <int64>

Nonce to use for the transaction execution.

gasPrice
integer <int64>

Gas price to use for the transaction execution.

gasFeeCap
integer <int64>

Gas fee cap to use for the 1559 transaction execution.

gasTipCap
integer <int64>

Gas priority fee cap to use for the 1559 transaction execution.

gas
integer <int64>

Gas limit to set for the transaction execution.

to
string (ETHAddress) ^0[xX][a-fA-F0-9]{40}$

An ethereum address.

value
string

Amount (in wei) to send with the transaction.

signAndSubmit
boolean
Default: false

If the from address is an HSM address and this flag is set to true, the transaction will be automatically signed and submitted to the blockchain.

nonceManagement
boolean
Default: false

If the from address is an HSM address and this flag is set to true, MultiBaas will keep track of the nonce and set it accordingly. This is particularly useful when submitting multiple transactions concurrently or in a very short period of time. If this flag is set to true and a nonce is provided, it will reset the nonce tracker to the given nonce (useful if the nonce tracker is out of sync).

preEIP1559
boolean
Default: false

If set to true, forces a legacy type transaction. Otherwise an EIP-1559 transaction will created if the network supports it.

signer
string (ETHAddress) ^0[xX][a-fA-F0-9]{40}$

An ethereum address.

formatInts
string
Default: "auto"

Mode to format integer outputs in the function call's responses. There are 3 possible modes:

  • auto (the default option), where number format is decided by its type:
    • If the type has size at most 32 bits, then the number is returned verbatim.
    • If the type has size larger than 32 bits, then the number is returned as a string.
  • as-numbers, where all numbers are returned as strings.
  • as-strings, where all numbers are returned verbatim.
timestamp
string

Call the function at a specific timestamp. Only available for read functions calls and if the historical_blocks_feature is enabled (see the plan endpoint). Mutually exclusive with the blockNumber parameter.

blockNumber
string

Call the function at a specific block. Only available for read functions calls and if the historical_blocks_feature is enabled (see the plan endpoint). Mutually exclusive with the timestamp parameter.

contractOverride
boolean

If set to true the given address and contract don't need to be linked for the function to be called.

object (PreviewArgs)

Ephemeral configuration for previewing the effect of a Type Conversion on a contract function call.

Responses
200

OK

4XX

Client error.

5XX

Server error.

post/chains/{chain}/transfers
Request samples
application/json
{
  • "signature": "string",
  • "args": [
    ],
  • "from": "string",
  • "nonce": 0,
  • "gasPrice": 0,
  • "gasFeeCap": 0,
  • "gasTipCap": 0,
  • "gas": 0,
  • "to": "string",
  • "value": "string",
  • "signAndSubmit": false,
  • "nonceManagement": false,
  • "preEIP1559": false,
  • "signer": "string",
  • "formatInts": "auto",
  • "timestamp": "string",
  • "blockNumber": "string",
  • "contractOverride": true,
  • "preview": {
    }
}
Response samples
application/json
{
  • "status": 0,
  • "message": "string",
  • "result": {
    }
}
Copyright © Curvegrid 2022. All right reserved.