Skip to content

Ether Pool

Each Kaleido environment is configured with one billion ether in the chain’s genesis block. It can be used to enforce optional gas costs on specific smart contract methods and/or to represent a fungible and transactional asset. The ether pool is an environmentally-shared utility service and is accessible by any organization operating a node within the environment.

Fund Your Ether Pool Account

The Ether Pool exists on a per-environment basis as a pre-funded one billion ether account configured in the genesis block of the chain. The ether can be accessed by any member of a consortium that owns and operates a node in the environment via the Kaleido user interface or through a simple /fundaccount API call.

The governance of the pool is left entirely to the discretion of the consortium. For example, the pool can be used intermittently on a need-by-need basis or drained immediately and then disseminated in accordance with some agreed upon protocol. The pool offers a convenient alternative to developing your own ERC20 token and can be used in myriad ways. For example, mapping to fiat or fungible assets, enforcing smart contract costs or prioritizing transaction mining.

From the console

  • Navigate to the environment containing the node you wish to fund.
  • Expand the node details and ascertain the Ethereum account address.
  • This is the hex string next to the USER ACCOUNTS row.
  • Return to your environment panel and expand the Ether Pool dropdown.
  • Click Fund Account.
  • On the Fund Account screen enter the node’s Ethereum account address and specify the requested amount as either Ether or Wei. Click FUND.
  • Wait a few seconds. You will be returned to the environment panel when the call completes.

From the API

  • Programmatically inject ether into a node account through a simple POST to the /fundaccount endpoint with the Ethereum account address and requested amount in the body of the call. For example, to request 100 ether:
curl -X POST -d '{"account":"0x51D91D3128252728a37131713c8d98724BDF744E", "amount":"100"}' -H "$HDR_AUTH" -H "$HDR_CT" "$APIURL/consortia/{consortia_id}/environments/{environment_id}/eth/fundaccount" | jq

Check your balance

From the console

When you are using a Kaleido managed wallet, you can check the balance of ether from the console.

  • Navigate to the node or wallet that hosts the account
  • Click Wallet

Node Wallet

  • Click the account you wish to view

Node Wallet Balance

From the geth console

Now you can use a simple geth attach command to hook into your node and retrieve the balance. For example

geth attach https://username:password@NodeURL

Once you have successfully accessed the node, you can use the getBalance API in the eth module to list out the balance.

For example: