Home Cryptocurency ExchangesEthereum Blockchain – Connectors | Microsoft Docs
Ethereum Blockchain – Connectors | Microsoft Docs

Ethereum Blockchain – Connectors | Microsoft Docs

Ethereum is a smart contract blockchain. With the Ethereum Blockchain connector, you can perform actions such as submitting transactions, reading contract state, and trigger flows on contract updates.

In this article

This connector is available in the following products and regions:

Creating the connection object

Once you choose your Ethereum connector, you’ll be prompted for setting up your connection. Your connection will point to an RPC endpoint and can optionally provide an Ethereum account that can be used for signing. This signing is only necessary for performing write actions on the blockchain: Deploy smart contract or Execute smart contract function (incurring gas cost). The connectors support two variations of transaction signing:

  • Private Key
    • You must provide your private key to the connection. During execution, your transaction is signed within the connector and the signed payload is sent to the RPC endpoint using SendRawTransaction.
  • On-node signing
    • You must provide your Ethereum address and password. In this case, signing will occur within the node sitting behind the RPC endpoint. As a prerequisite, you must create the account on the node. In this case, SendTransaction is used which does not leave the account unlocked on the node.

Important

You may only specify one authentication type per connection.

PrivateFor

For connectors that update contract state, you may specify the privateFor property if connecting to a Quorum transaction node (Tessera or Constellation). When specifying the connection object, you must use the on-node signing approach. To specify the privateFor property, select Add new parameter at the bottom of the connector. Once selecting privateFor, you may add a comma separated list of public keys that should have access to this private state.

Note

Due to a limitation in Quorum, when using privateFor the account is unlocked for a short period of time. For this reason, it is recommended that this node is only accessible by using a secure API key.

Known limitations

  • Indexed events are not currently supported.
  • Bytes32 return type not supported for privateFor transactions.
  • When using privateFor to call a smart contract function, the estimated gas limit is automatically doubled due to account for a gas estimation bug.

Creating a connection

To connect your account, you will need the following information:

Name Type Description
Ethereum RPC Endpoint securestring

Ethereum RPC Endpoint

Private Key securestring

Your private key (eg. 0x612a07ccb…)

Account Address string

Your existing Account Address

Account Password securestring

Your account Password

Throttling Limits

Name Calls Renewal Period
API calls per connection 60 60 seconds

Actions

Deploy smart contract

Deploy smart contract.

Parameters

Name Key Required Type Description

Contract ABI

abi True string

The smart contract ABI.

Smart Contract Function Parameters

parameters True dynamic

The smart contract constructor parameters.

Gas Price in Wei

gasPrice string

Optional: gas price in wei in non-hex format.

Gas Limit

gasLimit string

Optional: gas limit in non-hex format.

Private For List

privateForKeyList string

[Quorum] Optional: list of public keys that are allowed to see this transaction (eg. Q2/x…, 2mN… ).

Returns

The deploy smart contract action result

Execute smart contract function (incurring gas cost)

Execute smart contract function (incurring gas cost).

Parameters

Name Key Required Type Description

Contract ABI

abi True string

The smart contract ABI.

Smart Contract Address

contractAddress True string

The smart contract address.

Smart Contract Function Name

functionName True string

The name of the function to invoke.

Smart Contract Function Parameters

parameters True dynamic

The parameters of the function.

Gas Price in Wei

gasPrice string

Optional: gas price in wei in non-hex format.

Gas Limit

gasLimit string

Optional: gas limit in non-hex format.

Private For List

privateForKeyList string

[Quorum] Optional: list of public keys that are allowed to see this transaction (eg. Q2/x…, 2mN… ).

Returns

The execute smart contract function action result

Get smart contract state (all properties)

Get smart contract state (all properties).

Parameters

Name Key Required Type Description

Contract ABI

abi True string

The smart contract ABI.

Smart Contract Address

contractAddress True string

The smart contract address.

Returns

The outputs of this operation are dynamic.

Query smart contract function (incurring no gas cost)

Query smart contract function (incurring no gas cost).

Parameters

Name Key Required Type Description

Contract ABI

abi True string

The smart contract ABI.

Smart Contract Address

contractAddress True string

The smart contract address.

Smart Contract Function Name

functionName True string

The Function Name.

Smart Contract Function Parameters

parameters True dynamic

The input parameters to the function.

Returns

The outputs of this operation are dynamic.

Triggers

When a smart contract event occurs

When a smart contract event occurs.

Parameters

Name Key Required Type Description

Contract ABI

abi string

The smart contract ABI.

Smart Contract Address

contractAddress string

The smart contract address.

Event Name

eventName string

Event name.

Returns

The outputs of this operation are dynamic.

Definitions

DeploySmartContractResult

The deploy smart contract action result

Name Path Type Description

Smart Contract Address

ContractAddress string

The smart contract address

Transaction Hash

TransactionHash string

The transaction hash

ExecuteSmartContractFunctionResult

The execute smart contract function action result

Name Path Type Description

Transaction Hash

TransactionHash string

The transaction hash

Source

Leave a Reply

Your email address will not be published. Required fields are marked *

Human Verification: In order to verify that you are a human and not a spam bot, please enter the answer into the following box below based on the instructions contained in the graphic.