metamask-onboarding.cjs.js 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240
  1. 'use strict';
  2. function _interopDefault (ex) { return (ex && (typeof ex === 'object') && 'default' in ex) ? ex['default'] : ex; }
  3. var Bowser = _interopDefault(require('bowser'));
  4. /*! *****************************************************************************
  5. Copyright (c) Microsoft Corporation.
  6. Permission to use, copy, modify, and/or distribute this software for any
  7. purpose with or without fee is hereby granted.
  8. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
  9. REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  10. AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
  11. INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  12. LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
  13. OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  14. PERFORMANCE OF THIS SOFTWARE.
  15. ***************************************************************************** */
  16. function __awaiter(thisArg, _arguments, P, generator) {
  17. function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
  18. return new (P || (P = Promise))(function (resolve, reject) {
  19. function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
  20. function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
  21. function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
  22. step((generator = generator.apply(thisArg, _arguments || [])).next());
  23. });
  24. }
  25. function __generator(thisArg, body) {
  26. var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
  27. return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
  28. function verb(n) { return function (v) { return step([n, v]); }; }
  29. function step(op) {
  30. if (f) throw new TypeError("Generator is already executing.");
  31. while (_) try {
  32. if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
  33. if (y = 0, t) op = [op[0] & 2, t.value];
  34. switch (op[0]) {
  35. case 0: case 1: t = op; break;
  36. case 4: _.label++; return { value: op[1], done: false };
  37. case 5: _.label++; y = op[1]; op = [0]; continue;
  38. case 7: op = _.ops.pop(); _.trys.pop(); continue;
  39. default:
  40. if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
  41. if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
  42. if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
  43. if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
  44. if (t[2]) _.ops.pop();
  45. _.trys.pop(); continue;
  46. }
  47. op = body.call(thisArg, _);
  48. } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
  49. if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
  50. }
  51. }
  52. var ONBOARDING_STATE = {
  53. INSTALLED: 'INSTALLED',
  54. NOT_INSTALLED: 'NOT_INSTALLED',
  55. REGISTERED: 'REGISTERED',
  56. REGISTERING: 'REGISTERING',
  57. RELOADING: 'RELOADING',
  58. };
  59. var EXTENSION_DOWNLOAD_URL = {
  60. CHROME: 'https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn',
  61. FIREFOX: 'https://addons.mozilla.org/firefox/addon/ether-metamask/',
  62. DEFAULT: 'https://metamask.io',
  63. };
  64. // sessionStorage key
  65. var REGISTRATION_IN_PROGRESS = 'REGISTRATION_IN_PROGRESS';
  66. // forwarder iframe id
  67. var FORWARDER_ID = 'FORWARDER_ID';
  68. var Onboarding = /** @class */ (function () {
  69. function Onboarding(_a) {
  70. var _b = _a === void 0 ? {} : _a, _c = _b.forwarderOrigin, forwarderOrigin = _c === void 0 ? 'https://fwd.metamask.io' : _c, _d = _b.forwarderMode, forwarderMode = _d === void 0 ? Onboarding.FORWARDER_MODE.INJECT : _d;
  71. this.forwarderOrigin = forwarderOrigin;
  72. this.forwarderMode = forwarderMode;
  73. this.state = Onboarding.isMetaMaskInstalled()
  74. ? ONBOARDING_STATE.INSTALLED
  75. : ONBOARDING_STATE.NOT_INSTALLED;
  76. var browser = Onboarding._detectBrowser();
  77. if (browser) {
  78. this.downloadUrl = EXTENSION_DOWNLOAD_URL[browser];
  79. }
  80. else {
  81. this.downloadUrl = EXTENSION_DOWNLOAD_URL.DEFAULT;
  82. }
  83. this._onMessage = this._onMessage.bind(this);
  84. this._onMessageFromForwarder = this._onMessageFromForwarder.bind(this);
  85. this._openForwarder = this._openForwarder.bind(this);
  86. this._openDownloadPage = this._openDownloadPage.bind(this);
  87. this.startOnboarding = this.startOnboarding.bind(this);
  88. this.stopOnboarding = this.stopOnboarding.bind(this);
  89. window.addEventListener('message', this._onMessage);
  90. if (forwarderMode === Onboarding.FORWARDER_MODE.INJECT &&
  91. sessionStorage.getItem(REGISTRATION_IN_PROGRESS) === 'true') {
  92. Onboarding._injectForwarder(this.forwarderOrigin);
  93. }
  94. }
  95. Onboarding.prototype._onMessage = function (event) {
  96. if (event.origin !== this.forwarderOrigin) {
  97. // Ignoring non-forwarder message
  98. return undefined;
  99. }
  100. if (event.data.type === 'metamask:reload') {
  101. return this._onMessageFromForwarder(event);
  102. }
  103. console.debug("Unknown message from '" + event.origin + "' with data " + JSON.stringify(event.data));
  104. return undefined;
  105. };
  106. Onboarding.prototype._onMessageUnknownStateError = function (state) {
  107. throw new Error("Unknown state: '" + state + "'");
  108. };
  109. Onboarding.prototype._onMessageFromForwarder = function (event) {
  110. return __awaiter(this, void 0, void 0, function () {
  111. var _a;
  112. return __generator(this, function (_b) {
  113. switch (_b.label) {
  114. case 0:
  115. _a = this.state;
  116. switch (_a) {
  117. case ONBOARDING_STATE.RELOADING: return [3 /*break*/, 1];
  118. case ONBOARDING_STATE.NOT_INSTALLED: return [3 /*break*/, 2];
  119. case ONBOARDING_STATE.INSTALLED: return [3 /*break*/, 3];
  120. case ONBOARDING_STATE.REGISTERING: return [3 /*break*/, 5];
  121. case ONBOARDING_STATE.REGISTERED: return [3 /*break*/, 6];
  122. }
  123. return [3 /*break*/, 7];
  124. case 1:
  125. console.debug('Ignoring message while reloading');
  126. return [3 /*break*/, 8];
  127. case 2:
  128. console.debug('Reloading now to register with MetaMask');
  129. this.state = ONBOARDING_STATE.RELOADING;
  130. location.reload();
  131. return [3 /*break*/, 8];
  132. case 3:
  133. console.debug('Registering with MetaMask');
  134. this.state = ONBOARDING_STATE.REGISTERING;
  135. return [4 /*yield*/, Onboarding._register()];
  136. case 4:
  137. _b.sent();
  138. this.state = ONBOARDING_STATE.REGISTERED;
  139. event.source.postMessage({ type: 'metamask:registrationCompleted' }, event.origin);
  140. this.stopOnboarding();
  141. return [3 /*break*/, 8];
  142. case 5:
  143. console.debug('Already registering - ignoring reload message');
  144. return [3 /*break*/, 8];
  145. case 6:
  146. console.debug('Already registered - ignoring reload message');
  147. return [3 /*break*/, 8];
  148. case 7:
  149. this._onMessageUnknownStateError(this.state);
  150. _b.label = 8;
  151. case 8: return [2 /*return*/];
  152. }
  153. });
  154. });
  155. };
  156. /**
  157. * Starts onboarding by opening the MetaMask download page and the Onboarding forwarder
  158. */
  159. Onboarding.prototype.startOnboarding = function () {
  160. sessionStorage.setItem(REGISTRATION_IN_PROGRESS, 'true');
  161. this._openDownloadPage();
  162. this._openForwarder();
  163. };
  164. /**
  165. * Stops onboarding registration, including removing the injected forwarder (if any)
  166. *
  167. * Typically this function is not necessary, but it can be useful for cases where
  168. * onboarding completes before the forwarder has registered.
  169. */
  170. Onboarding.prototype.stopOnboarding = function () {
  171. if (sessionStorage.getItem(REGISTRATION_IN_PROGRESS) === 'true') {
  172. if (this.forwarderMode === Onboarding.FORWARDER_MODE.INJECT) {
  173. console.debug('Removing forwarder');
  174. Onboarding._removeForwarder();
  175. }
  176. sessionStorage.setItem(REGISTRATION_IN_PROGRESS, 'false');
  177. }
  178. };
  179. Onboarding.prototype._openForwarder = function () {
  180. if (this.forwarderMode === Onboarding.FORWARDER_MODE.OPEN_TAB) {
  181. window.open(this.forwarderOrigin, '_blank');
  182. }
  183. else {
  184. Onboarding._injectForwarder(this.forwarderOrigin);
  185. }
  186. };
  187. Onboarding.prototype._openDownloadPage = function () {
  188. window.open(this.downloadUrl, '_blank');
  189. };
  190. /**
  191. * Checks whether the MetaMask extension is installed
  192. */
  193. Onboarding.isMetaMaskInstalled = function () {
  194. return Boolean(window.ethereum && window.ethereum.isMetaMask);
  195. };
  196. Onboarding._register = function () {
  197. return window.ethereum.request({
  198. method: 'wallet_registerOnboarding',
  199. });
  200. };
  201. Onboarding._injectForwarder = function (forwarderOrigin) {
  202. var container = document.body;
  203. var iframe = document.createElement('iframe');
  204. iframe.setAttribute('height', '0');
  205. iframe.setAttribute('width', '0');
  206. iframe.setAttribute('style', 'display: none;');
  207. iframe.setAttribute('src', forwarderOrigin);
  208. iframe.setAttribute('id', FORWARDER_ID);
  209. container.insertBefore(iframe, container.children[0]);
  210. };
  211. Onboarding._removeForwarder = function () {
  212. var _a;
  213. (_a = document.getElementById(FORWARDER_ID)) === null || _a === void 0 ? void 0 : _a.remove();
  214. };
  215. Onboarding._detectBrowser = function () {
  216. var browserInfo = Bowser.parse(window.navigator.userAgent);
  217. if (browserInfo.browser.name === 'Firefox') {
  218. return 'FIREFOX';
  219. }
  220. else if (['Chrome', 'Chromium'].includes(browserInfo.browser.name || '')) {
  221. return 'CHROME';
  222. }
  223. return null;
  224. };
  225. Onboarding.FORWARDER_MODE = {
  226. INJECT: 'INJECT',
  227. OPEN_TAB: 'OPEN_TAB',
  228. };
  229. return Onboarding;
  230. }());
  231. module.exports = Onboarding;