From c276086f3fcce0317abd45452d74c18aa0522ed9 Mon Sep 17 00:00:00 2001 From: Denton Liu Date: Thu, 25 Aug 2016 15:43:04 -0400 Subject: Write about what fallback functions cannot do --- docs/contracts.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/contracts.rst b/docs/contracts.rst index e9fc4526..b257dcbb 100644 --- a/docs/contracts.rst +++ b/docs/contracts.rst @@ -434,6 +434,14 @@ Ether (without data). In such a context, there is very little gas available to the function call (to be precise, 2300 gas), so it is important to make fallback functions as cheap as possible. +In particular, the following operations will consume more gas than the stipend provided to a fallback function: + +- Writing to storage +- Creating a contract +- Calling an external function which consumes a large amount of gas + +Please ensure you test your fallback function thoroughly to ensure the execution cost is less than 2300 gas before deploying a contract. + :: contract Test { -- cgit