📘
TEOS User Guides
Contact CoreLedgerPrivacy Policy
TEOS API
TEOS API
  • 👋Welcome to TEOS API
  • Get started
  • TEOS API overview
    • Terms and concepts
      • Asset
      • Spark
      • Wallet
      • Supply
      • Warp
      • Invoice
      • Transaction
    • Architecture note
      • Tenant setup options
    • Authentication
    • Versioning
  • Using TEOS API
    • Postman examples
    • Rate limits
    • Dealing with blockchain transactions
      • How to get Ether for signing transactions
      • Transaction creation and submission
        • First transaction creation and submission for a new address on the private blockchain
    • Handling errors
      • 1xxxx codes
      • 2xxxx codes
      • 3xxxx codes
    • TEOS Events
    • Warp search
  • TEOS API references
    • TEOS API Swagger (OpenAPI)
  • Using additional APIs of TEOS Platform
    • User authentication flow with TEOS Authentication service and TMS
    • Device authorization flow with TxServer and TEOS Authentication service
    • Adding wallet to the TEOS Platform flow with TxServer and TEOS API
    • Using TxServer API
      • TxServer API (OpenAPI)
      • Key Pair Generation. Transaction Signing
      • Device Restoration
    • Using TEOS Authentication service
      • TEOS Authentication Service API
    • Using TMS API
      • TMS API Swagger (OpenAPI)
      • Handling errors
      • Changelog
    • Using Discovery Service
  • FAQ
  • Changelog
    • v0.9
    • Non-versioned changes
    • Previous versions (not supported)
  • Troubleshooting
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. Using TEOS API
  2. Dealing with blockchain transactions

How to get Ether for signing transactions

Ether distribution mechanism for SparkNet and DevilNet tenants, Ether distribution limits

PreviousDealing with blockchain transactionsNextTransaction creation and submission

Last updated 1 year ago

Was this helpful?

There is a gas cost for every transaction which must be paid for in Ether. TEOS Platform is integrated with several blockchains, depending on the selected option there are two approaches to getting Ether:

  • If Ethereum Mainnet is used, then TEOS API consumer takes care about making sure its end users have enough Ether to sign transactions (normally wallet owners should buy Ether to be able to operate)

  • If private blockchains (or DevilNet) are used, then TEOS API consumer shouldn't care about Ether necessary for gas costs paying because TEOS Platform provides the mechanism for Ether distribution described below

Ether distribution mechanism in TEOS Platform for private blockchains

Please, note that this mechanism is valid only for SparkNet, DevilNet. It does NOT work for Ethereum MainNet

How mechanism works

All newly registered addresses, which create transaction (post asset, create, destroy, transfer sparks or run warp) first time, get some Ether automatically. As soon as received Ether is nearly consumed (balance is less than 10% of original amount), address is automatically refilled.

Important thing to note: Ether is distributed via transfer transactions, so it takes some time. Sending Ether to a new address is triggered only when this address is used as an author of transaction, so you need to wait until Ether is received in order to submit the transaction signed by this address successfully. In case address doesn't have enough Ether, transaction will be revoked by blockchain because of the lack of gas. about the flow for creating first transaction for a new address

Limits

All tenants have the same limit of Ether distribution per month. We need these limits to prevent malicious behavior. Right now limit is 100 Ether per tenant per month (30 days) but we keep the right to change it.

Limits are the same for development and productive environments but they are not summarized. So, if you run one tenant on development environment and one tenant on productive environement, you have 100 Ether limit per month for each tenant.

In case the tenant reaches its limit, tenant admin receives a notification to the email (email is provided to CoreLedger when tenant is being setup). As soon as the limit is reached for the tenant, new addresses won't get Ether, old addresses won't be refilled until month (30 days) is over.

If you think that your business case needs another amount of Ether, please, contact your CoreLedger manager.

SparkNet
Read more