All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Add GrantPermissions action to PermissionsController (#780)
- Add
PermissionController.revokePermissionForAllSubjectsaction (#764)
- BREAKING: Rename NotificationController to AnnouncementController (#697)
- The
NotificationControllerclass is nowAnnouncementController. - The controller
notificationsstate has been renamed toannouncements. - All other exported types including the word "notification" have been updated to use the word "announcement" instead.
- The
- Move
@keystonehq/metamask-airgapped-keyringto dependencies (#757)
27.1.0 [DEPRECATED]
- Now the
KeyringControllersupports theQRKeyringfrom@keystonehq/metamask-airgapped-keyring. Developers can enable the import of accounts from a QR hardware wallet. A new optional parameter,setAccountLabelfrom thePreferencesController, should be passed to theKeyringControllerto enable this new functionality. (#685)- UPDATE: This is broken. Consumers are encouraged to upgrade to 27.1.1.
- Bump
eth-phishing-detectversion from 1.1.14 to 1.1.16 (#742) - Bump
@metamask/contract-metadatafrom 1.31.0 to 1.33.0 (#730)
- Improve error message when attempting to import an invalid private key (#739)
- BREAKING: Further reduce load on Infura by removing non-critical data from the fallback implementation of the Gas API (#712)
- In GasFeeEstimates – the type of the object returned by
fetchGasEstimatesViaEthFeeHistoryas well as type ofgasFeeEstimatesstored in GasFeeController —historicalBaseFeeRange,baseFeeTrend,latestPriorityFeeRange,historicalPriorityFeeRange,priorityFeeTrend, andnetworkCongestioncan now be null. You should update your code to account for this. - The ExistingFeeHistoryBlock and NextFeeHistoryBlock types were inconvenient to use and are no longer public. You should use FeeHistoryBlock instead.
- The BlockFeeHistoryDatasetFetcher class has been removed. There is no replacement.
- The
calculateBaseFeeRange,calculateBaseFeeTrend,calculateNetworkCongestion,calculatePriorityFeeRange, andcalculatePriorityFeeTrendfunctions have been removed. There are no replacements.
- In GasFeeEstimates – the type of the object returned by
- Update AssetsContractController to make
userAddressofgetTokenStandardAndDetailsoptional (#717)
- Fix RateLimitController so that the rate limit is not reset aggressively (#716)
- Add PermissionController and SubjectMetadataController (#692)
- Add RateLimitController (#698)
- Add
revokePermissionsto PermissionController actions (#708)
- BREAKING: Fetch and return token image as part of
getDetailscalls on ERC721Standard and ERC1155Standard (#702)- This change is breaking because it requires that the AssetsContractController (on which the ERC721Standard and ERC1155Standard are instantiated) be passed a listener for onPreferencesStateChange from the PreferencesController so that it can use the user's preferred IPFSGateway to fetch any images hosted on IPFS. Consumers will have to pass onPreferencesStateChange in an options object (first arg) to the AssetsContractController constructor when initializing.
- Reduce load on Infura in gas estimate API fallback (#705)
- Update
fetchBlockFeeHistoryto account for nonexistentbaseFeePerGas(#703) - Update
fetchBlockFeeHistoryto account for test chains with a few number of blocks (#699) - Expose
WebSocketvia endowments for network access (#696) - Bump
@metamask/metamask-eth-abisfrom ^2.1.0 to 3.0.0 (#681)
- Make the userAddress argument to the getDetails method on the ERC20Standard class optional. (#674)
- Add optional third argument to method
checkAndUpdateSingleCollectibleOwnershipStatuson CollectiblesController, which contains the userAddress and chainId to check asset ownership against. If not included, the method will still check against the currently configured selectedAddress and chainId configured in the CollectiblesController (#672) - Add
getTokenStandardAndDetailsmethod on AssetsContractController which determines whether the input contract conforms to particular known token standard (ERC20,ERC721orERC1155) and returns the detected standard along with some key values/details about that the contract and/or specified token within that contract (#667)
-
- BREAKING - Standardize ERC721/1155/20 method names (#667)
- Renames many methods on the AssetsContractController to include the contract type they are used by in the name in a standardized structure (i.e.
getAssetName->getERC721AssetNameandbalanceOfERC1155Collectible->getERC1155BalanceOf). - Consumers will need to look at the AssetsContractController for any methods they consume and adapt names accordingly.
- Add
checkAndUpdateSingleCollectibleOwnershipStatusmethod (#669)
-
- BREAKING: Rename
checkAndUpdateCollectibleOwnershipStatustocheckAndUpdateAllCollectibleOwnershipStatus(#669) - Previously incorrectly released as minor version bump 23.1.0.
- Consumers who used
checkAndUpdateCollectibleOwnershipStatusmust update it's name tocheckAndUpdateAllCollectibleOwnershipStatus.
- BREAKING: Rename
23.1.0 [DEPRECATED]
- Add checkAndUpdateSingleCollectibleOwnershipStatus method (#669)
- Add method to check and update collectible ownership state (#664)
- Add method to set a collectible as favorite (#623)
- Update GasFeeController to use
eth_feeHistoryto compute gas fee recommendations when MetaSwap API is down (#614) - Update GasFeeController to expose additional data sourced from the MetaSwap API in support of design updates to "edit gas fee" functionality in extension (#632), (#646, #660)
- Breaking Add caller-specified error for ApprovalController.clear (#656)
- The new caller-specified error is mandatory. Consumers must add this error when calling the clear method for method to function properly.
- Fix polling initialization for collectibles (#662)
- BREAKING: Change IPFS URL generation to use subdomains and cidV1s over cidV0s, in order to enhance origin based security in our use of IPFS assets (#655)
- Consumers using an IPFS gateway(s) which does not support IPFS subdomain formats will need to set the new config value 'useIPFSSubdomains' on CollectiblesController to false in order to have continued IPFS resolution support.
- BREAKING: remove chainid normalization (#651)
- This is breaking for anyone who adapted consumption of CollectiblesController to make use of v21.0.0. The chainId in the collectibles state shape is no longer normalized to decimal.
- Fix collectibles collection images (#650)
- Fix issue where chainId key in AllCollectibles & AllCollectibleContracts is formatted differently in manual collectible add and detection add flows. (#648)
- BREAKING: Add openSeaEnabled preference (#645)
- Consumers of the collectibleDetectionController and collectibleController who wish to continue use of OpenSea's API and AutoDetection will either need to configure openSeaEnabled to true after instantiating the controller now or expose a toggle for users to change the openSeaEnabled state in the preferences controller.
- Change expected shape of OpenSea contract API to use collections (#628)
- Modify requirements for adding OpenSea detected contract (#644)
- BREAKING: Add detection params (userAddress, chainId) and remove duplicate source of truth (#636)
- Both collectibles and collectibleContracts are removed from CollectiblesController state.
- Consumers who use these pieces of state will need to migrate to use the AllCollectibles and AllCollectiblesContracts state instead.
- Add new method
addCollectibleVerifyOwnershipto CollectiblesController (#635) - Add setting in PreferencesController to enable/disable collectible autoDetection and check against it in CollectibleDetectionController (#638)
- Use user preferred ipfs gateway, as set in PreferencesController, to resolve ipfs based assets in CollectiblesController (#637)
- BREAKING: Remove polling start call in detection controllers' constructors (#629)
- Consumers of either of the TokenDetection and CollectibleDetection controllers who wish to immediately start polling upon instantiation will need to call the start method on the controller immediately after instantiation.
- Remove ApprovalController.has signature overloads (#624)
- BREAKING: Split AssetsDetectionController into CollectiblesDetectionController and TokenDetectionController (#619)
- Consumers of the AssetsDetectionController will have to now import both TokenDetectionController and CollectibleDetectionController and split up the calling of any methods accordingly.
- BREAKING: Set the
CurrencyRateControllerpropertyconversionDatetonullif fetching the data fails. (#621)- Consumers of the
CurrencyRateControllerwill need to ensure their code anticipates thatconversionDatewill sometimes be set tonull.
- Consumers of the
- BREAKING: ERC1155 support (#615)
CollectiblesControllerrequiresgetOwnerOf,balanceOfERC1155CollectibleanduriERC1155Collectibleproperties in the constructor which are methods fromAssetsContractController.
- Add support for custom networks by querying the blockchain as default and add support for IPFS metadata URIs (#616)
- Bump @metamask/contract-metadata from 1.29.0 to 1.30.0 (#607)
- Add client id header to GasFeeController (#597)
- Improve transaction state management for custom networks (#598)
- Make TokenRatesController support fiat conversion for more networks (#585)
- BREAKING: Simplify type of BaseControllerV2 state (#496)
- Controllers based upon BaseControllerV2 might need to update their types.
- Custom interfaces/classes will no longer be allowed in the controller state. Simple objects only.
- Enable HTTP caching for the dynamic token list managed by the TokenListController (#594)
- BREAKING: Remove
syncTokensmethod from the TokenListController (#590)
- Fix bug that allowed
getGasFeeEstimatesAndStartPollingto initiate multiple simultaneous fetch requests (#586) - Fix bug that cause an invalid tokenList to be in controller state when active network is not supported by our tokenList API (#588)
- Improve transaction state management (#582)
- TransactionController improvement to reconcile the data between local and remote sources (Etherscan) and avoid misleading display of gas and/or status information.
- Bump immer from 8.0.1 to 9.0.6 (#581)
- Change AbortController to default import (#579)
- Fix error thrown when polyfilled AbortController is instantiated as a named import.
- Add AbortController polyfill (#575)
- 15.0.0 introduced the use of the global AbortController to this package. The global AbortController was first introduced in Node 15, so this unintentionally broke support for the minimum Node version this package should support, which is Node 12. By polyfilling the AbortController, we restore Node 12 support.
- BREAKING: Update TokensController allTokens state structure to make network/chainID parent of account (#572)
- The shape of allTokens state field on TokensController has been reorganized. Consumers of the TokensController will have to migrate existing token state to new shape.
- BREAKING: ignoredTokens changed to allIgnoredTokens (#570)
- a new state field on the TokensController - allIgnoredTokens - now manages ignoredTokens by network and accountAddress, ignoredTokens is now the array of token address strings (previously an array of full token objects) that have been hidden by the user for the currently active network and accountAddress pair. Consumers of the TokensController will have to migrate existing ignoredTokens array to allIgnoredTokens object.
- BREAKING: Improve BaseControllerV2 messenger type (#556)
- This is a breaking change, because anyone extending BaseControllerV2 will now be required to supply an additional generic parameter.
- BREAKING: Remove redundant default export from util.ts (#574)
- This is breaking for consumers who use the default import of the utils module, and will require using named imports instead.
- BREAKING: Removing aggregator from TokenListToken (#564)
- This is breaking because the the DynamicToken and TokenListToken types no longer contain an aggregators field. Consumers will have to remove aggregators for objects using this type.
- BREAKING: Migrate ApprovalController to BaseControllerV2 (#555)
- This is a breaking change because the BaseControllerV2 migration is breaking, and the 'resolve' method has been renamed to 'accept'.
- Speed up token detection for most popular 1000 tokens (#568)
- Cancel inflight request during chainId change and useStaticTokenList flag change (#571)
- Update the token list API host (#563)
- Bump @metamask/contract-metadata from 1.28.0 to 1.29.0 (#569)
- Reduce frequency of token list updates (#561)
- Previously it would update the token list upon any preference or network configuration change. Now it only restarts polling when the network switches or when the
useStaticTokenListflag changes.
- Previously it would update the token list upon any preference or network configuration change. Now it only restarts polling when the network switches or when the
- Added the ability to limit the number of transactions stored (default is 40) (#550)
- Added the ability to speedUp and stop based on provided gasValues from consumer (#535)
- Consolidate token list controller data. (#527)
- Adds 3 fields:
address,aggregators, andoccurrencesto static tokens
- Adds 3 fields:
- Controller messenger selector subscriptions (#551)
14.0.2 - 2021-07-28
- Fix
resetPollingfunctionality (#546)- This fix addresses a bug that was discovered in
resetPollinginGasFeeControllerfunctionality being called too frequently.
- This fix addresses a bug that was discovered in
- Improve token list API error handling (#541)
14.0.1 - 2021-07-28 [DEPRECATED]
- Ensure gas estimate fetching in gasFeeController correctly handles responses with invalid number of decimals (#544)
- Bump @metamask/contract-metadata from 1.27.0 to 1.28.0 (#540)
14.0.0 - 2021-07-27 [DEPRECATED]
- BREAKING Add EIP1559 support including
speedUpTransactionandstopTransaction(#521)- The breaking change here is that consumers of this repo now have to check if the transaction object includes a gas price and fetch and add it themselves (if need be).
- Make equality comparisons for token and collectible addresses in TokensController and CollectiblesController case insensitive (#537)
- Reset gas fee estimate polling onNetworkStateChange in the gasFeeController (#534)
- Update AssetDetectionController to handle new fetch limits for the OpenSea collectibles api (#536)
- Add options to GasFeeController fetchGasFeeEstimates (#526)
13.0.0 - 2021-07-12
- BREAKING: Remove AssetsController and add CollectiblesController and TokensController in its place (#518)
12.1.0 - 2021-07-09
- Support for custom network and gas estimation (#505)
- A fallback for the token list API service based on user preference (#517)
12.0.0 - 2021-07-07
- Add GasFeeController to provide gas fee estimates #494
- BREAKING: Add chainId support to TokenRatesControllers #476
- The breaking change here is that TokenRatesController constructor now requires a onNetworkStateChange listener
- Add iconUrl to Token type in TokenListController #512
11.0.0 - 2021-07-02
- We accidentally shipped a breaking change in v10.2.0. The changelog has been updated to explain the breaking change, and it has been republished as v11.0.0.
10.2.0 - 2021-06-30 [DEPRECATED]
- BREAKING: Add TokenListController to fetch the token list from token services API (#478)
- The breaking change here is that
AssetsDetectionControllernow requiresgetTokenListStateas a constructor parameter.
- The breaking change here is that
- Update
@ethereumjs-txto@ethereumjs/txand add@ethereumjs/commonto support EIP1559 compliant transactions (#489)
10.1.0 - 2021-06-07
- Export BaseControllerV2 Json type (#482)
- Skip token detection for tokens that are already tracked (#480)
- BREAKING: Fix stale conversionRate after switching network (#465)
- The breaking change is the change in type of the
conversionRatestate of theCurrencyRateController- it's now nullable.
- The breaking change is the change in type of the
9.1.0 - 2021-05-20
- Add support for unicode domains to PhishingController (#471)
- AssetsController collectibles metadata improvements (#454)
- Add
getStateaction to BaseControllerV2 (#457)
- BREAKING: Migrate CurrencyRateController to BaseControllerV2 (#372)
- Add BaseControllerV2 support to ComposableController (#447)
- Update eth-keyring-controller (#460)
- Export BaseControllerV2 and ControllerMessenger (#462)
- Improve restricted messenger types for controllers (#461)
- Document all ControllerMessenger generic parameters (#456)
- Bump @metamask/contract-metadata from 1.24.0 to 1.25.0 (#444)
8.0.0 - 2021-04-15
- Add restricted controller messenger (#378)
- BREAKING: Update minimum Node.js version to v12 (#441)
- BREAKING: Replace controller context (#387)
- Bump @metamask/contract-metadata from 1.23.0 to 1.24.0 (#440)
- Update lint rules (#442, #426)
- Don't remove collectibles during auto detection (#439)
7.0.0 - 2021-04-06
- Ability to indicate if a transaction was added from the users local device and account creation time (#436)
- BREAKING: Organize assets by chainid (#435)
- Support longer token symbols via wallet_watchAsset (#433)
6.2.1 - 2021-03-23
- Restore BN export (#428)
6.2.0 - 2021-03-23 [WITHDRAWN]
- Add the Notification Controller (to support "what's new" type announcements in-app) (#329)
- Add support for specifying a custom nonce (#381)
- Explicitly add ethereumjs-tx as a package.json dependency (#392)
- Add
typesmanifest field to package.json (#391) - Use "options bag" for parameters for BaseControllerV2 constructor (#388)
- Ensure
uuiddependency is type-checked (#403) - Update TypeScript to v4.2 (#369)
- Asset metadata type conditionally requires error field, disallows for non-errors (#395)
- Improve TransactionMeta type:
statusnow an enum, error conditional on status, default error added for failed etherscan transaction (#406) NetworkControllerno longer a required controller ofTypedMessageManager(#416)- Update
selectedAddresswhen identities are updated inPreferencesController.updateIdentities(#415) - Add contract address validation to
AssetsContractController.getCollectibleTokenURI(#414) - Add descriptive error messages to empty
toThrowcall (#422)
- Fix
signTransactiontransaction parameter type (#400) - [BREAKING] Consistently use BN type for token balances (#398)
6.1.1 - 2021-03-12
- Add controller messaging system (#377)
6.1.0 - 2021-03-10
- Add Base Controller v2 (#358)
- Add
babel-runtimedependency required byethjs-query(#341) - Add Dependabot config (#343)
- Add chainId to every transaction (#349)
- Add normalizeTokenTx for incoming transactions (#380)
- Bump elliptic from 6.5.3 to 6.5.4 (#383)
- Update prettier from v2.1.1 to v2.2.1 (#376)
- Remove AlethioTransactionMeta (#374)
- Improve JSON types (#373)
- Add BaseControllerV2 state metadata (#371)
- Update to TypeScript 4.1 (#370)
- Constrain BaseController state to be valid JSON (#366)
- Update ESLint config to v5 (#368)
- Use
unknownrather thananyfor BaseController state (#365) - BaseController send patches to state subscribers (#363)
- TransactionController gas and approve transaction improvements (#350)
- Extract CryptoCompare API to a separate module (#353)
- Move tests alongside code under test (#354)
- Bump @metamask/contract-metadata from 1.22.0 to 1.23.0 (#357)
- Remove Alethio to get incoming token transactions, using etherscan instead (#351)
- Prevent
ApprovalControllercounting mismatch (#356) - Update
sinonand@types/sinonto latest versions (#352) - Fix
tsconfig.jsonindentation (#355) - Replace
fetch-mockwithnock(#340) - Update
ethereumjs-walletfrom v0.6.5 to v1.0.1 (#347) - Update
@metamask/eslint-configfrom v3 to v4.1.0 (#344) - Update
uuidfromv3.3.3tov8.3.2(#346) - Update approval controller test import (#339)
- Update
typedoc(#342) - Remove unused test module (#338)
- Replace
await-semaphorewithasync-mutex(#334) - Update
eth-json-rpc-filtersin lockfile (#336)
- Fix AbstractMessageManager error (#367)
- Enforce the usage of
chainIdinstead ofnetworkIdinNetworkController(#324)
6.0.1 - 2021-02-05
- Update
typedocfrom v0.15 to v20.20 (#333) - Update
@metamask/contract-metadatafrom v1.19 to v1.22 (#332) - Bump node-notifier from 8.0.0 to 8.0.1 (#323)
- Add
safelyExecuteWithTimeoutforaccountTracker.refresh(#331) - Add try/catch for
assetsContract.getBalanceOf(#328)
6.0.0 - 2021-01-19
- Remove default approval controller type (#321)
- Enforce the usage of
chainIdinstead ofnetworkIdinNetworkController(#324)
5.1.0 - 2020-12-02
- Updated automatically detected assets (#318)
- Robustified
wallet_watchAssetsparams validation, and improved errors (#317)
5.0.0 - 2020-11-19
ApprovalController(#309)- Add user-defined default type
- Add
Date.now()timestamps to request (approval.time) - Enable
haslookups bytypeonly
- Breaking:
ApprovalController: Require types for all requests (#309) ApprovalController: RenameApprovalInfointerface toApproval(#309)PhishingController: Makeno-cachefetch option explicit (#297)- Make package compatible with Node 12 (#287)
ApprovalController: Fix faultyoriginparameter type check (#309)- The type check was too loose, and would've permitted some invalid origins.
4.2.0 - 2020-11-13
- Expose
ApprovalControllercount state (#306) KeyringControlleronLock/onUnlockevent handlers (#307)
- Properly initialize
ApprovalController(#306)
4.1.0 - 2020-11-10
ApprovalControllerapproval count methods (#304)
4.0.2 - 2020-11-09
- Unpin
eth-sig-utildependency (#302)
4.0.1 - 2020-11-09
- Fix
ApprovalControllerexport (#300)
4.0.0 - 2020-11-09
- Add
ApprovalController(#289)
- Allow configuring
CurrencyControllerto always fetch USD rate (#292)
- BREAKING: Remove
NetworkStatusController(#298)
3.2.0 - 2020-10-21
- Add
addNewAccountWithoutUpdatemethod (#288)
3.1.0 - 2020-09-23
- Update various dependencies
3.0.1 - 2020-09-15
- Remove
If-None-Matchheader from phishing config requests (#277)
3.0.0 - 2020-09-11
- Use Infura v3 API (#267)
2.0.5 - 2020-08-18
- Add prepublishOnly build script (#260)
2.0.4 - 2020-08-18
- Use jsDelivr instead of the GitHub API for content (#256)
- Lower phishing config poll rate to 1 req/hr (#257)
- Use renamed
eth-rpc-errorpackage (#252)
2.0.3 - 2020-07-27
- TransactionsController: Bugfix cancel / speedup transactions (#248)
2.0.2 - 2020-07-14
- TransactionsController: Fetch incoming token transactions (#247)
2.0.1 - 2020-06-18
- Update
PhishingControllerendpoint to use GitHub API (#244)
2.0.0 - 2020-05-07
- Rebrand as
@metamask/controllers(#226) - Use yarn & drop
npm-shrinkwrap.json(#193)
- Remove shapeshift controller (#209)