Crowdsales

The rate is the conversion between wei and the smallest and indivisible token unit. So, if you are using a rate of 1 with a ERC20Detailed token with 3 decimals called TOK, 1 wei will give you 1 unit, or 0.001 TOK.

fallback function DO NOT OVERRIDE Note that other contracts will transfer funds with a base gas stipend of 2300, which is not enough to call buyTokens. Consider calling buyTokens directly when purchasing tokens from a contract.

low level token purchase DO NOT OVERRIDE This function has a non-reentrancy guard, so it shouldn’t be called by another nonReentrant function.

Validation of an incoming purchase. Use require statements to revert state when conditions are not met. Use super in contracts that inherit from Crowdsale to extend their validations. Example from CappedCrowdsale.sol’s _preValidatePurchase method: super._preValidatePurchase(beneficiary, weiAmount); require(weiRaised().add(weiAmount) ⇐ cap);

Validation of an executed purchase. Observe state and use revert statements to undo rollback when valid conditions are not met.

Source of tokens. Override this method to modify the way in which the crowdsale ultimately gets and sends its tokens.

Executed when a purchase has been validated and is ready to be executed. Doesn’t necessarily emit/send tokens.

Override for extensions that require an internal state to check for validity (current user contributions, etc.)

Override to extend the way in which ether is converted to tokens.

Determines how ETH is stored/forwarded on purchases.

Constructor, takes token wallet address.

Checks the amount of tokens left in the allowance.

Overrides parent behavior by transferring tokens from wallet.

Overrides delivery by minting tokens upon purchase.

Constructor, takes maximum amount of wei accepted in the crowdsale.

Checks whether the cap has been reached.

Extend parent behavior requiring purchase to respect the funding cap.

Sets a specific beneficiary’s maximum contribution.

Returns the cap of a specific beneficiary.

Returns the amount contributed so far by a specific beneficiary.

Extend parent behavior requiring purchase to respect the beneficiary’s funding cap.

Extend parent behavior to update beneficiary contributions.

Validation of an incoming purchase. Use require statements to revert state when conditions are not met. Use super to concatenate validations. Adds the validation that the crowdsale must not be paused.

Reverts if not in crowdsale time range.

Constructor, takes crowdsale opening and closing times.

Checks whether the period in which the crowdsale is open has already elapsed.

Extend parent behavior requiring to be within contributing period.

Extend crowdsale.

Extend parent behavior requiring beneficiary to be whitelisted. Note that no restriction is imposed on the account sending the transaction.

Must be called after crowdsale ends, to do some extra finalization work. Calls the contract’s finalization function.

Can be overridden to add finalization logic. The overriding function should call super._finalization() to ensure the chain of finalization is executed entirely.

Withdraw tokens only after crowdsale ends.

Overrides parent by storing due balances, and delivering tokens to the vault instead of the end user. This ensures that the tokens will be available by the time they are withdrawn (which may not be the case if _deliverTokens was called later).

Constructor, creates RefundEscrow.

Investors can claim refunds here if crowdsale is unsuccessful.

Checks whether funding goal was reached.

Escrow finalization task, called when finalize() is called.

Overrides Crowdsale fund forwarding, sending funds to escrow.