3.1.0

(cherry picked from commit 242400e9ea)

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 3.1.0 (unreleased)
+## 3.1.0 (2020-06-23)
 
 ### New features
  * `SafeCast`: added functions to downcast signed integers (e.g. `toInt32`), improving usability of `SignedSafeMath`. ([#2243](https://github.com/OpenZeppelin/openzeppelin-contracts/pull/2243))

contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/contracts",
-  "version": "3.1.0-rc.0",
+  "version": "3.1.0",
   "description": "Secure Smart Contract library for Solidity",
   "files": [
     "**/*.sol",

contracts/utils/Address.sol

@@ -66,6 +66,9 @@ library Address {
      * If `target` reverts with a revert reason, it is bubbled up by this
      * function (like regular Solidity function calls).
      *
+     * Returns the raw returned data. To convert to the expected return value,
+     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
+     *
      * Requirements:
      *
      * - `target` must be a contract.
@@ -88,18 +91,13 @@ library Address {
     }
 
     /**
-     * @dev Performs a Solidity function call using a low level `call`,
+     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
-     * transferring `value` wei. A plain`call` is an unsafe replacement for a
+     * but also transferring `value` wei to `target`.
-     * function call: use this function instead.
-     *
-     * If `target` reverts with a revert reason, it is bubbled up by this
-     * function (like regular Solidity function calls).
      *
      * Requirements:
      *
-     * - `target` must be a contract.
      * - the calling contract must have an ETH balance of at least `value`.
-     * - calling `target` with `data` must not revert.
+     * - the called Solidity function must be `payable`.
      *
      * _Available since v3.1._
      */

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "openzeppelin-solidity",
-  "version": "3.1.0-rc.0",
+  "version": "3.1.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzeppelin-solidity",
-  "version": "3.1.0-rc.0",
+  "version": "3.1.0",
   "description": "Secure Smart Contract library for Solidity",
   "files": [
     "/contracts/**/*.sol",