Ethers support and notification callbacks

With this release, you can now use ethers.js versions ^4.0.20 and ^5.0-beta-137 in addition to our continuing web3.js versions 0.20 and 1.0 support.

Also included is a new callback feature that allows you to handle notifications first before optionally passing them on to Assist's notification UI. This means you can use your own UI instead of what Assist provides, and/or update other elements of your Dapp based on notifications.

Details for the new callbacks can be found in the documentation at https://github.com/blocknative/assist/tree/master#handling-notifications

Stalls are warnings and new Truffle only

This release changes the stall event from an error with a red notification and no continuing timer to a warning with a yellow notification and a continuing timer. This reflects the fact that a stalled transaction may still complete.

Also included in this release is Truffle 4 contract support. Since Truffle 4 uses web3js 1.0 style contracts, we no longer support older Truffle contracts that still use web3js 0.20 style contracts. If you are using Assist with older Truffle contracts, please update to a newer version of Truffle.

Wallet neutral on-boarding

Since more wallets are available in desktop browsers, either built into the browser (Opera) or via extensions (MetaMask, Dapper, etc.), we now support a more generic on-boarding flow.

For example, if on-boarding with no wallet installed, the initial step now looks like this since we no longer presume MetaMask as the target wallet to install:

If MetaMask is then installed, the remaining steps use our existing MM specific guidance. If a different wallet is installed, subsequent guidance will not include the MM specific images or reference MM in the instructions.

This release also improves accessibility by supporting the esc key to dismiss modal dialogs. Use of truffle contracts is made easier by detecting them automatically so the developer does not need to explicitly declare truffle contract use in the configuration. And stall notifications now support a custom timeout in the config, so you can increase the time before show stalls on mainnet. The default is 30 seconds.

• FEATURE: Enhancement/remove metamask language images (#295)
• FEATURE: Add custom timeout for txStall event (#272)
• FEATURE: Automatic contract type detection on a contract-by-contract basis (#286)
• FEATURE: Close on-boarding and wallet check modal dialogs with esc key (#271)
• BUG: Fix missing return (#293)
• BUG: Add missing messages parameter (#289)

Bug fixes

• Access web3 object on window if available to ensure reload on network change (#261, #282)
• Propagate errors to promievent (#280)
• Add check to make sure contract parameter is on txObj (#277)
• Relax internal gas estimation error handling (#275)

Dapper detection

This release adds:

• Dapper Wallet detection if the provider answers truthy to isDapper (#268). Also refined the wallet detection code.

• Fixed returned contract result to valid falsey values (#273)

Fix for text on mobile

• remove MetaMask specific language on mobile (#265)

Bug and documentation fix

• Fixed typo with contract method call documentation (#259)
• Added resolving init onboard promise (#262)

Regression fix

This minor release fixes a regression with 0.8.4:

• uglify build error (#255)

Bug fixes and more tests

• validate config on init (#230)
• return promiEvent from modernSend and modernWeb3 Transaction calls (#192) - This is an API breaking change
• fixed issue running with local genache (#232)
• fixed issue and consistency with transaction inline custom messages (#236, #242)
• fixed a bug with wrapped contracts missing some methods (#238)
• documentation improvements (#250, #252)
• standardize web3Functions networkId return type to Number
• add end-to-end tests (#201)

Mobile fixes

• remove MetaMask specific language (#224)
• added condition so that mobile wallet dialog will show when user is on a mobile device and is not in a mobile dapp browser (#225)
• Add touch handlers to not supported modals if on mobile (#227)