From eab9e58e7e6b815e7dfb288510b49d52fe579fe2 Mon Sep 17 00:00:00 2001 From: Chris Ward Date: Wed, 16 Jan 2019 17:11:23 +0200 Subject: [PATCH] Add call warning into main docs and remove FAQ item --- docs/frequently-asked-questions.rst | 12 ------------ docs/units-and-global-variables.rst | 4 ++++ 2 files changed, 4 insertions(+), 12 deletions(-) diff --git a/docs/frequently-asked-questions.rst b/docs/frequently-asked-questions.rst index 4635d577e..3b59af81b 100644 --- a/docs/frequently-asked-questions.rst +++ b/docs/frequently-asked-questions.rst @@ -54,18 +54,6 @@ Yes, you can use ``abi.encodePacked``:: } } - -Why is the low-level function ``.call()`` less favorable than instantiating a contract with a variable (``ContractB b;``) and executing its functions (``b.doSomething();``)? -============================================================================================================================================================================= - -If you use actual functions, the compiler will tell you if the types -or your arguments do not match, if the function does not exist -or is not visible and it will do the packing of the -arguments for you. - -See `ping.sol `_ and -`pong.sol `_. - What happens if you send ether along with a function call to a contract? ======================================================================== diff --git a/docs/units-and-global-variables.rst b/docs/units-and-global-variables.rst index 59acfcff8..e44caa8f2 100644 --- a/docs/units-and-global-variables.rst +++ b/docs/units-and-global-variables.rst @@ -199,6 +199,10 @@ Members of Address Types For more information, see the section on :ref:`address`. +.. warning:: + You should avoid using ``.call()`` when executing another contract function as it bypasses the compiler type checking, + function existence check, and argument packing. + .. warning:: There are some dangers in using ``send``: The transfer fails if the call stack depth is at 1024 (this can always be forced by the caller) and it also fails if the recipient runs out of gas. So in order