Ally Wallet is an open source browser plugin for the DeFi ecosystem, providing users with a better-to-use and more secure multi-chain swap experience.
You can Download the latest Ally here.
To help dapp developers support and integrate Ally Wallet more easily, we recommend you use our integration solution that has almost NO development cost and does not introduce any uncertainty:
- Install Node.js version 14 or later
- Install Yarn
npm install -g yarn - Run
yarnto install dependency
Run yarn build:dev:mv3 to develop with file watching and development log(you can see request sent by dapp in website console in this mode and notification will not close when focus lost)
Run yarn build:pro:mv3 to build a production package, it's in dist folder
below 4 scripts all live in different context!
for all async request and encrypt things.
user's keyrings, password and wallet personal preference data all stored in chrome local storage.
it has 2 main controllers:
-
walletControllerit expose methods to background window, so other scripts can access these methods with
runtime.getBackgroundPage, e.g.ui.js. -
providerControllerit handles request from pages(dapp request).
injected at document_start, share the same dom with dapp, use broadcastChannel to tap pageProvider.
the main purpose is inject pageProvider.js and pass messages between pageProvider.js and background.js.
this script is injected into dapp's context through content-script. it mounts ethereum to window.
when dapp use window.ethereum to request, it will send message to content-script with broadcastChannel and wait for it's response.
then the content-script will send message to background with runtime.connect.
after background receive the message, it will use providerController to handle the request. and keep the message channel in sessionSevice for later communicate.
it's used by 3 pages which share the same js code, but the template html is different for respective purpose.
-
notification.htmltriggered by dapp to request user's permission.
-
index.htmlopened in browser tab for better user interaction experience.
-
popup.htmluser click the extension icon on the right of address bar, the popup will show.
Thanks for contributions from MetaMask team to browser extension wallet community, Ally uses (or forks) them to make web3 better.