From 0f90c4239a0984c7204ebcbd17c878745fcd76ec Mon Sep 17 00:00:00 2001
From: MetaMask Bot <metamaskbot@users.noreply.github.com>
Date: Tue, 20 Jul 2021 12:33:28 +0000
Subject: [PATCH 1/5] Version v9.8.2

---
 CHANGELOG.md | 15 ++++++++++++++-
 package.json |  2 +-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 71df78542..585915031 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.8.2]
+### Uncategorized
+- Version v9.8.1 RC ([#11517](https://github.com/MetaMask/metamask-extension/pull/11517))
+- Updating CHANGELOG.md
+- Retrieve state after async action before updating state in _setSwapsQuoteRefreshTime ([#11538](https://github.com/MetaMask/metamask-extension/pull/11538))
+- Update CHANGELOG.md header
+- Updating changelog for 9.8.1
+- Version v9.8.1
+- moving some properties to identifiable payload ([#11506](https://github.com/MetaMask/metamask-extension/pull/11506))
+- Converting gas params for tx metrics to decimal GWEI ([#11482](https://github.com/MetaMask/metamask-extension/pull/11482))
+- Using current time in place of block timestamp for completion time metric ([#11483](https://github.com/MetaMask/metamask-extension/pull/11483))
+
 ## [9.8.1]
 ### Changed
 - Adjusting transaction metrics values
@@ -2336,7 +2348,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Uncategorized
 - Added the ability to restore accounts from seed words.
 
-[Unreleased]: https://github.com/MetaMask/metamask-extension/compare/v9.8.1...HEAD
+[Unreleased]: https://github.com/MetaMask/metamask-extension/compare/v9.8.2...HEAD
+[9.8.2]: https://github.com/MetaMask/metamask-extension/compare/v9.8.1...v9.8.2
 [9.8.1]: https://github.com/MetaMask/metamask-extension/compare/v9.8.0...v9.8.1
 [9.8.0]: https://github.com/MetaMask/metamask-extension/compare/v9.7.1...v9.8.0
 [9.7.1]: https://github.com/MetaMask/metamask-extension/compare/v9.7.0...v9.7.1
diff --git a/package.json b/package.json
index 9fb661cbc..61b05b65f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "metamask-crx",
-  "version": "9.8.1",
+  "version": "9.8.2",
   "private": true,
   "repository": {
     "type": "git",

From b7ee6f47f83767f4c1e2ddeebea1db7458b3a4bd Mon Sep 17 00:00:00 2001
From: Dan J Miller <dmiller@kyokan.io>
Date: Tue, 20 Jul 2021 15:07:07 -0230
Subject: [PATCH 2/5] Ensure gas limit estimation for token sends has correct
 default/base gas (#11565)

* Ensure gas limit estimation for token sends has correct default/base gas

* Fix comment change
---
 ui/ducks/send/send.js | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/ui/ducks/send/send.js b/ui/ducks/send/send.js
index 718d78d93..b10f5fa29 100644
--- a/ui/ducks/send/send.js
+++ b/ui/ducks/send/send.js
@@ -183,8 +183,19 @@ async function estimateGasLimitForSend({
   let isSimpleSendOnNonStandardNetwork = false;
 
   // blockGasLimit may be a falsy, but defined, value when we receive it from
-  // state, so we use logical or to fall back to MIN_GAS_LIMIT_HEX.
-  const blockGasLimit = options.blockGasLimit || MIN_GAS_LIMIT_HEX;
+  // state, so we use logical or to fall back to MIN_GAS_LIMIT_HEX. Some
+  // network implementations check the gas parameter supplied to
+  // eth_estimateGas for validity. For this reason, we set token sends
+  // blockGasLimit default to a higher number. Note that the current gasLimit
+  // on a BLOCK is 15,000,000 and will be 30,000,000 on mainnet after London.
+  // Meanwhile, MIN_GAS_LIMIT_HEX is 0x5208.
+  let blockGasLimit = MIN_GAS_LIMIT_HEX;
+  if (options.blockGasLimit) {
+    blockGasLimit = options.blockGasLimit;
+  } else if (sendToken) {
+    blockGasLimit = GAS_LIMITS.BASE_TOKEN_ESTIMATE;
+  }
+
   // The parameters below will be sent to our background process to estimate
   // how much gas will be used for a transaction. That background process is
   // located in tx-gas-utils.js in the transaction controller folder.

From eb3b9e213bc164d14cddad6580842abd5a7d521f Mon Sep 17 00:00:00 2001
From: Daniel <80175477+dan437@users.noreply.github.com>
Date: Tue, 20 Jul 2021 19:17:15 +0200
Subject: [PATCH 3/5] Add support for Polygon (#11545)

* Fix a check for EIP presense
* Add support for Polygon
* Update default Polygon URL
* Trigger Build
* Use a more user-friendly error message for disabled Swaps API calls
---
 app/images/matic-token.png   | Bin 0 -> 16286 bytes
 shared/constants/network.js  |   2 ++
 shared/constants/swaps.js    |  20 ++++++++++++++++++++
 ui/pages/swaps/swaps.util.js |   3 +++
 4 files changed, 25 insertions(+)
 create mode 100644 app/images/matic-token.png

diff --git a/app/images/matic-token.png b/app/images/matic-token.png
new file mode 100644
index 0000000000000000000000000000000000000000..b154c46ea54324347bedc0b9f71ad5acb18b97d6
GIT binary patch
literal 16286
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

literal 0
HcmV?d00001

diff --git a/shared/constants/network.js b/shared/constants/network.js
index 66bd1e949..1d22b5271 100644
--- a/shared/constants/network.js
+++ b/shared/constants/network.js
@@ -49,10 +49,12 @@ export const ETH_SYMBOL = 'ETH';
 export const WETH_SYMBOL = 'WETH';
 export const TEST_ETH_SYMBOL = 'TESTETH';
 export const BNB_SYMBOL = 'BNB';
+export const MATIC_SYMBOL = 'MATIC';
 
 export const ETH_TOKEN_IMAGE_URL = './images/eth_logo.svg';
 export const TEST_ETH_TOKEN_IMAGE_URL = './images/black-eth-logo.svg';
 export const BNB_TOKEN_IMAGE_URL = './images/bnb.png';
+export const MATIC_TOKEN_IMAGE_URL = './images/matic-token.png';
 
 export const INFURA_PROVIDER_TYPES = [ROPSTEN, RINKEBY, KOVAN, MAINNET, GOERLI];
 
diff --git a/shared/constants/swaps.js b/shared/constants/swaps.js
index 00512c0cc..dba447b2c 100644
--- a/shared/constants/swaps.js
+++ b/shared/constants/swaps.js
@@ -6,6 +6,9 @@ import {
   TEST_ETH_TOKEN_IMAGE_URL,
   BNB_TOKEN_IMAGE_URL,
   BSC_CHAIN_ID,
+  POLYGON_CHAIN_ID,
+  MATIC_SYMBOL,
+  MATIC_TOKEN_IMAGE_URL,
 } from './network';
 
 export const QUOTES_EXPIRED_ERROR = 'quotes-expired';
@@ -35,6 +38,14 @@ export const BNB_SWAPS_TOKEN_OBJECT = {
   iconUrl: BNB_TOKEN_IMAGE_URL,
 };
 
+export const MATIC_SWAPS_TOKEN_OBJECT = {
+  symbol: MATIC_SYMBOL,
+  name: 'Matic',
+  address: DEFAULT_TOKEN_ADDRESS,
+  decimals: 18,
+  iconUrl: MATIC_TOKEN_IMAGE_URL,
+};
+
 export const TEST_ETH_SWAPS_TOKEN_OBJECT = {
   symbol: TEST_ETH_SYMBOL,
   name: 'Test Ether',
@@ -52,6 +63,9 @@ const TESTNET_CONTRACT_ADDRESS = '0x881d40237659c251811cec9c364ef91dc08d300c';
 
 const BSC_CONTRACT_ADDRESS = '0x1a1ec25dc08e98e5e93f1104b5e5cdd298707d31';
 
+// It's the same as we use for BSC.
+const POLYGON_CONTRACT_ADDRESS = '0x1a1ec25dc08e98e5e93f1104b5e5cdd298707d31';
+
 export const ETH_WETH_CONTRACT_ADDRESS =
   '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2';
 
@@ -64,13 +78,16 @@ const SWAPS_TESTNET_HOST = 'https://metaswap-api.airswap-dev.codefi.network';
 
 const BSC_DEFAULT_BLOCK_EXPLORER_URL = 'https://bscscan.com/';
 const MAINNET_DEFAULT_BLOCK_EXPLORER_URL = 'https://etherscan.io/';
+const POLYGON_DEFAULT_BLOCK_EXPLORER_URL = 'https://polygonscan.com/';
 
 export const ALLOWED_SWAPS_CHAIN_IDS = {
   [MAINNET_CHAIN_ID]: true,
   [SWAPS_TESTNET_CHAIN_ID]: true,
   [BSC_CHAIN_ID]: true,
+  [POLYGON_CHAIN_ID]: true,
 };
 
+// This is mapping for v1 URLs and will be removed once we migrate to v2.
 export const METASWAP_CHAINID_API_HOST_MAP = {
   [MAINNET_CHAIN_ID]: METASWAP_ETH_API_HOST,
   [SWAPS_TESTNET_CHAIN_ID]: SWAPS_TESTNET_HOST,
@@ -81,17 +98,20 @@ export const SWAPS_CHAINID_CONTRACT_ADDRESS_MAP = {
   [MAINNET_CHAIN_ID]: MAINNET_CONTRACT_ADDRESS,
   [SWAPS_TESTNET_CHAIN_ID]: TESTNET_CONTRACT_ADDRESS,
   [BSC_CHAIN_ID]: BSC_CONTRACT_ADDRESS,
+  [POLYGON_CHAIN_ID]: POLYGON_CONTRACT_ADDRESS,
 };
 
 export const SWAPS_CHAINID_DEFAULT_TOKEN_MAP = {
   [MAINNET_CHAIN_ID]: ETH_SWAPS_TOKEN_OBJECT,
   [SWAPS_TESTNET_CHAIN_ID]: TEST_ETH_SWAPS_TOKEN_OBJECT,
   [BSC_CHAIN_ID]: BNB_SWAPS_TOKEN_OBJECT,
+  [POLYGON_CHAIN_ID]: MATIC_SWAPS_TOKEN_OBJECT,
 };
 
 export const SWAPS_CHAINID_DEFAULT_BLOCK_EXPLORER_URL_MAP = {
   [BSC_CHAIN_ID]: BSC_DEFAULT_BLOCK_EXPLORER_URL,
   [MAINNET_CHAIN_ID]: MAINNET_DEFAULT_BLOCK_EXPLORER_URL,
+  [POLYGON_CHAIN_ID]: POLYGON_DEFAULT_BLOCK_EXPLORER_URL,
 };
 
 export const ETHEREUM = 'ethereum';
diff --git a/ui/pages/swaps/swaps.util.js b/ui/pages/swaps/swaps.util.js
index 068c3f870..160cded10 100644
--- a/ui/pages/swaps/swaps.util.js
+++ b/ui/pages/swaps/swaps.util.js
@@ -77,6 +77,9 @@ const getBaseApi = function (
   const baseUrl = useNewSwapsApi
     ? getBaseUrlForNewSwapsApi(type, chainId)
     : METASWAP_CHAINID_API_HOST_MAP[chainId];
+  if (!baseUrl) {
+    throw new Error(`Swaps API calls are disabled for chainId: ${chainId}`);
+  }
   switch (type) {
     case 'trade':
       return `${baseUrl}/trades?`;

From 6a208556b808976ea7fa6e043977bade884c7d48 Mon Sep 17 00:00:00 2001
From: Dan J Miller <dmiller@kyokan.io>
Date: Wed, 21 Jul 2021 16:00:00 -0230
Subject: [PATCH 4/5] Ensure send slice gas loading state is set to false upon
 gas estimation error (#11581)

---
 ui/ducks/send/send.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/ui/ducks/send/send.js b/ui/ducks/send/send.js
index b10f5fa29..33b20cb30 100644
--- a/ui/ducks/send/send.js
+++ b/ui/ducks/send/send.js
@@ -1037,6 +1037,11 @@ const slice = createSlice({
           });
         }
       })
+      .addCase(computeEstimatedGasLimit.rejected, (state) => {
+        // If gas estimation fails, we should set the loading state to false,
+        // because it is no longer loading
+        state.gas.isGasEstimateLoading = false;
+      })
       .addCase(SET_BASIC_GAS_ESTIMATE_DATA, (state, action) => {
         // When we receive a new gasPrice via the gas duck we need to update
         // the gasPrice in our slice. We call into the caseReducer

From fb26c48234129fb6ef49480f4440efca84634803 Mon Sep 17 00:00:00 2001
From: Dan J Miller <dmiller@kyokan.io>
Date: Wed, 21 Jul 2021 16:46:50 -0230
Subject: [PATCH 5/5] Update changelog for Version-v9.8.2 (#11567)

* Update changelog for Version-v9.8.2

* update changelog
---
 CHANGELOG.md | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 585915031..2c06c88bd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,16 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ## [9.8.2]
-### Uncategorized
-- Version v9.8.1 RC ([#11517](https://github.com/MetaMask/metamask-extension/pull/11517))
-- Updating CHANGELOG.md
-- Retrieve state after async action before updating state in _setSwapsQuoteRefreshTime ([#11538](https://github.com/MetaMask/metamask-extension/pull/11538))
-- Update CHANGELOG.md header
-- Updating changelog for 9.8.1
-- Version v9.8.1
-- moving some properties to identifiable payload ([#11506](https://github.com/MetaMask/metamask-extension/pull/11506))
-- Converting gas params for tx metrics to decimal GWEI ([#11482](https://github.com/MetaMask/metamask-extension/pull/11482))
-- Using current time in place of block timestamp for completion time metric ([#11483](https://github.com/MetaMask/metamask-extension/pull/11483))
+### Changed
+- [1156511545](https://github.com/MetaMask/metamask-extension/pull/11545): Allow MetaMask Swaps to support Polygon network
+
+### Fixed
+- [11565](https://github.com/MetaMask/metamask-extension/pull/11565): Fix gas limit estimation for some tokens on custom networks
+- [11581](https://github.com/MetaMask/metamask-extension/pull/11581): Fixed bug that resulted in sends to some contracts being disabled.
 
 ## [9.8.1]
 ### Changed