using System; using System.Globalization; using System.IO; using System.Linq; using System.Threading.Tasks; using BTCPayServer.Abstractions.Extensions; using BTCPayServer.Abstractions.Models; using BTCPayServer.Client.Models; using BTCPayServer.Lightning; using BTCPayServer.Lightning.CLightning; using BTCPayServer.Services; using BTCPayServer.Views.Manage; using BTCPayServer.Views.Server; using BTCPayServer.Views.Stores; using BTCPayServer.Views.Wallets; using Microsoft.Extensions.Configuration; using NBitcoin; using NBitcoin.RPC; using OpenQA.Selenium; using OpenQA.Selenium.Chrome; using OpenQA.Selenium.Support.UI; using Xunit; namespace BTCPayServer.Tests { public class SeleniumTester : IDisposable { public IWebDriver Driver { get; set; } public ServerTester Server { get; set; } public WalletId WalletId { get; set; } public string StoreId { get; set; } public static readonly TimeSpan ImplicitWait = TimeSpan.FromSeconds(5); public async Task StartAsync() { Server.PayTester.NoCSP = true; await Server.StartAsync(); var windowSize = (Width: 1200, Height: 1000); var builder = new ConfigurationBuilder(); builder.AddUserSecrets("AB0AC1DD-9D26-485B-9416-56A33F268117"); var config = builder.Build(); // Run `dotnet user-secrets set RunSeleniumInBrowser true` to run tests in browser var runInBrowser = config["RunSeleniumInBrowser"] == "true"; // Reset this using `dotnet user-secrets remove RunSeleniumInBrowser` var chromeDriverPath = config["ChromeDriverDirectory"] ?? (Server.PayTester.InContainer ? "/usr/bin" : Directory.GetCurrentDirectory()); var options = new ChromeOptions(); if (!runInBrowser) { options.AddArguments("headless"); } options.AddArguments($"window-size={windowSize.Width}x{windowSize.Height}"); options.AddArgument("shm-size=2g"); options.AddArgument("start-maximized"); if (Server.PayTester.InContainer) { // Shot in the dark to fix https://stackoverflow.com/questions/53902507/unknown-error-session-deleted-because-of-page-crash-from-unknown-error-cannot options.AddArgument("--disable-dev-shm-usage"); Driver = new OpenQA.Selenium.Remote.RemoteWebDriver(new Uri("http://selenium:4444/wd/hub"), new RemoteSessionSettings(options)); var containerIp = File.ReadAllText("/etc/hosts").Split('\n', StringSplitOptions.RemoveEmptyEntries).Last() .Split('\t', StringSplitOptions.RemoveEmptyEntries)[0].Trim(); TestLogs.LogInformation($"Selenium: Container's IP {containerIp}"); } else { var cds = ChromeDriverService.CreateDefaultService(chromeDriverPath); cds.EnableVerboseLogging = true; cds.Port = Utils.FreeTcpPort(); cds.HostName = "127.0.0.1"; cds.Start(); Driver = new ChromeDriver(cds, options, // A bit less than test timeout TimeSpan.FromSeconds(50)); } ServerUri = Server.PayTester.ServerUri; Driver.Manage().Window.Maximize(); TestLogs.LogInformation($"Selenium: Using {Driver.GetType()}"); TestLogs.LogInformation($"Selenium: Browsing to {ServerUri}"); TestLogs.LogInformation($"Selenium: Resolution {Driver.Manage().Window.Size}"); GoToRegister(); Driver.AssertNoError(); } public void PayInvoice(bool mine = false, decimal? amount = null) { if (amount is not null) { Driver.FindElement(By.Id("test-payment-amount")).Clear(); Driver.FindElement(By.Id("test-payment-amount")).SendKeys(amount.ToString()); } Driver.WaitUntilAvailable(By.Id("FakePayment")); Driver.FindElement(By.Id("FakePayment")).Click(); TestUtils.Eventually(() => { Driver.WaitForElement(By.Id("CheatSuccessMessage")); }); if (mine) { MineBlockOnInvoiceCheckout(); } } public void MineBlockOnInvoiceCheckout() { retry: try { Driver.FindElement(By.CssSelector("#mine-block button")).Click(); } catch (StaleElementReferenceException) { goto retry; } } /// /// Use this ServerUri when trying to browse with selenium /// Because for some reason, the selenium container can't resolve the tests container domain name /// public Uri ServerUri; internal IWebElement FindAlertMessage(StatusMessageModel.StatusSeverity severity = StatusMessageModel.StatusSeverity.Success) { return FindAlertMessage(new[] { severity }); } internal IWebElement FindAlertMessage(params StatusMessageModel.StatusSeverity[] severity) { var className = string.Join(", ", severity.Select(statusSeverity => $".alert-{StatusMessageModel.ToString(statusSeverity)}")); IWebElement el; try { var elements = Driver.FindElements(By.CssSelector(className)); el = elements.FirstOrDefault(e => e.Displayed); if (el is null) el = elements.FirstOrDefault(); if (el is null) el = Driver.WaitForElement(By.CssSelector(className)); } catch (NoSuchElementException) { el = Driver.WaitForElement(By.CssSelector(className)); } if (el is null) throw new NoSuchElementException($"Unable to find {className}"); if (!el.Displayed) throw new ElementNotVisibleException($"{className} is present, but not displayed: {el.GetAttribute("id")} - Text: {el.Text}"); return el; } public string Link(string relativeLink) { return ServerUri.AbsoluteUri.WithoutEndingSlash() + relativeLink.WithStartingSlash(); } public void GoToRegister() { Driver.Navigate().GoToUrl(Link("/register")); } public string RegisterNewUser(bool isAdmin = false) { var usr = RandomUtils.GetUInt256().ToString().Substring(64 - 20) + "@a.com"; TestLogs.LogInformation($"User: {usr} with password 123456"); Driver.FindElement(By.Id("Email")).SendKeys(usr); Driver.FindElement(By.Id("Password")).SendKeys("123456"); Driver.FindElement(By.Id("ConfirmPassword")).SendKeys("123456"); if (isAdmin) Driver.FindElement(By.Id("IsAdmin")).Click(); Driver.FindElement(By.Id("RegisterButton")).Click(); Driver.AssertNoError(); CreatedUser = usr; return usr; } string CreatedUser; public TestAccount AsTestAccount() { return new TestAccount(Server) { RegisterDetails = new Models.AccountViewModels.RegisterViewModel() { Password = "123456", Email = CreatedUser } }; } public (string storeName, string storeId) CreateNewStore(bool keepId = true) { // If there's no store yet, there is no dropdown toggle if (Driver.PageSource.Contains("id=\"StoreSelectorToggle\"")) { Driver.FindElement(By.Id("StoreSelectorToggle")).Click(); } GoToUrl("/stores/create"); var name = "Store" + RandomUtils.GetUInt64(); TestLogs.LogInformation($"Created store {name}"); Driver.WaitForElement(By.Id("Name")).SendKeys(name); var rateSource = new SelectElement(Driver.FindElement(By.Id("PreferredExchange"))); Assert.Equal("Kraken (Recommended)", rateSource.SelectedOption.Text); rateSource.SelectByText("CoinGecko"); Driver.WaitForElement(By.Id("Create")).Click(); Driver.FindElement(By.Id("StoreNav-StoreSettings")).Click(); Driver.FindElement(By.Id($"SectionNav-{StoreNavPages.General.ToString()}")).Click(); var storeId = Driver.WaitForElement(By.Id("Id")).GetAttribute("value"); if (keepId) StoreId = storeId; return (name, storeId); } public void EnableCheckout(CheckoutType checkoutType, bool bip21 = false) { GoToStore(StoreNavPages.CheckoutAppearance); if (checkoutType == CheckoutType.V2) { Driver.SetCheckbox(By.Id("UseClassicCheckout"), false); Driver.WaitForElement(By.Id("OnChainWithLnInvoiceFallback")); Driver.SetCheckbox(By.Id("OnChainWithLnInvoiceFallback"), bip21); } else { Driver.SetCheckbox(By.Id("UseClassicCheckout"), true); } Driver.FindElement(By.Id("Save")).SendKeys(Keys.Enter); Assert.Contains("Store successfully updated", FindAlertMessage().Text); Assert.True(Driver.FindElement(By.Id("UseClassicCheckout")).Selected); } public Mnemonic GenerateWallet(string cryptoCode = "BTC", string seed = "", bool? importkeys = null, bool isHotWallet = false, ScriptPubKeyType format = ScriptPubKeyType.Segwit) { var isImport = !string.IsNullOrEmpty(seed); GoToWalletSettings(cryptoCode); // Replace previous wallet case if (Driver.PageSource.Contains("id=\"ChangeWalletLink\"")) { Driver.FindElement(By.Id("ActionsDropdownToggle")).Click(); Driver.WaitForElement(By.Id("ChangeWalletLink")).Click(); Driver.WaitForElement(By.Id("ConfirmInput")).SendKeys("REPLACE"); Driver.FindElement(By.Id("ConfirmContinue")).Click(); } if (isImport) { TestLogs.LogInformation("Progressing with existing seed"); Driver.FindElement(By.Id("ImportWalletOptionsLink")).Click(); Driver.FindElement(By.Id("ImportSeedLink")).Click(); Driver.FindElement(By.Id("ExistingMnemonic")).SendKeys(seed); Driver.SetCheckbox(By.Id("SavePrivateKeys"), isHotWallet); } else { var option = isHotWallet ? "Hotwallet" : "Watchonly"; TestLogs.LogInformation($"Generating new seed ({option})"); Driver.FindElement(By.Id("GenerateWalletLink")).Click(); Driver.FindElement(By.Id($"Generate{option}Link")).Click(); } Driver.FindElement(By.Id("ScriptPubKeyType")).Click(); Driver.FindElement(By.CssSelector($"#ScriptPubKeyType option[value={format}]")).Click(); Driver.ToggleCollapse("AdvancedSettings"); if (importkeys is bool v) Driver.SetCheckbox(By.Id("ImportKeysToRPC"), v); Driver.FindElement(By.Id("Continue")).Click(); if (isImport) { // Confirm addresses Driver.FindElement(By.Id("Confirm")).Click(); } else { // Seed backup FindAlertMessage(); if (string.IsNullOrEmpty(seed)) { seed = Driver.FindElements(By.Id("RecoveryPhrase")).First().GetAttribute("data-mnemonic"); } // Confirm seed backup Driver.FindElement(By.Id("confirm")).Click(); Driver.FindElement(By.Id("submit")).Click(); } WalletId = new WalletId(StoreId, cryptoCode); return new Mnemonic(seed); } /// /// Assume to be in store's settings /// /// /// public void AddDerivationScheme(string cryptoCode = "BTC", string derivationScheme = "tpubD6NzVbkrYhZ4XxNXjYTcRujMc8z8734diCthtFGgDMimbG5hUsKBuSTCuUyxWL7YwP7R4A5StMTRQiZnb6vE4pdHWPgy9hbiHuVJfBMumUu-[legacy]") { if (!Driver.PageSource.Contains($"Setup {cryptoCode} Wallet")) { GoToWalletSettings(cryptoCode); } Driver.FindElement(By.Id("ImportWalletOptionsLink")).Click(); Driver.FindElement(By.Id("ImportXpubLink")).Click(); Driver.FindElement(By.Id("DerivationScheme")).SendKeys(derivationScheme); Driver.FindElement(By.Id("Continue")).Click(); Driver.FindElement(By.Id("Confirm")).Click(); FindAlertMessage(); } public void AddLightningNode() { AddLightningNode(null, true); } public void AddLightningNode(string connectionType = null, bool test = true) { var cryptoCode = "BTC"; if (!Driver.PageSource.Contains("Connect to a Lightning node")) { GoToLightningSettings(); } var connectionString = connectionType switch { LightningConnectionType.CLightning => $"type=clightning;server={((CLightningClient)Server.MerchantLightningD).Address.AbsoluteUri}", LightningConnectionType.LndREST => $"type=lnd-rest;server={Server.MerchantLnd.Swagger.BaseUrl};allowinsecure=true", _ => null }; if (connectionString == null) { Assert.True(Driver.FindElement(By.Id("LightningNodeType-Internal")).Enabled, "Usage of the internal Lightning node is disabled."); Driver.FindElement(By.CssSelector("label[for=\"LightningNodeType-Internal\"]")).Click(); } else { Driver.FindElement(By.CssSelector("label[for=\"LightningNodeType-Custom\"]")).Click(); Driver.WaitForElement(By.Id("ConnectionString")).Clear(); Driver.FindElement(By.Id("ConnectionString")).SendKeys(connectionString); if (test) { Driver.FindElement(By.Id("test")).Click(); Assert.Contains("Connection to the Lightning node successful.", FindAlertMessage().Text); } } Driver.FindElement(By.Id("save")).Click(); Assert.Contains($"{cryptoCode} Lightning node updated.", FindAlertMessage().Text); var enabled = Driver.FindElement(By.Id($"{cryptoCode}LightningEnabled")); if (enabled.Text == "Enable") { enabled.Click(); Assert.Contains($"{cryptoCode} Lightning payments are now enabled for this store.", FindAlertMessage().Text); } } public Logging.ILog TestLogs => Server.TestLogs; public void ClickOnAllSectionLinks() { var links = Driver.FindElements(By.CssSelector("#SectionNav .nav-link")).Select(c => c.GetAttribute("href")).ToList(); Driver.AssertNoError(); foreach (var l in links) { TestLogs.LogInformation($"Checking no error on {l}"); Driver.Navigate().GoToUrl(l); Driver.AssertNoError(); } } public void Dispose() { if (Driver != null) { try { Driver.Quit(); } catch { // ignored } Driver.Dispose(); } Server?.Dispose(); } internal void AssertNotFound() { Assert.Contains("404 - Page not found", Driver.PageSource); } internal void AssertAccessDenied() { Assert.Contains("- Denied FundStoreWallet(WalletId walletId = null, int coins = 1, decimal denomination = 1m) { walletId ??= WalletId; GoToWallet(walletId, WalletsNavPages.Receive); Driver.FindElement(By.Id("generateButton")).Click(); var addressStr = Driver.FindElement(By.Id("Address")).GetAttribute("data-text"); var address = BitcoinAddress.Create(addressStr, ((BTCPayNetwork)Server.NetworkProvider.GetNetwork(walletId.CryptoCode)).NBitcoinNetwork); for (var i = 0; i < coins; i++) { bool mined = false; retry: try { await Server.ExplorerNode.SendToAddressAsync(address, Money.Coins(denomination)); } catch (RPCException) when (!mined) { mined = true; await Server.ExplorerNode.GenerateAsync(1); goto retry; } } Driver.Navigate().Refresh(); Driver.FindElement(By.Id("CancelWizard")).Click(); return addressStr; } private void CheckForJSErrors() { //wait for seleniun update: https://stackoverflow.com/questions/57520296/selenium-webdriver-3-141-0-driver-manage-logs-availablelogtypes-throwing-syste // var errorStrings = new List // { // "SyntaxError", // "EvalError", // "ReferenceError", // "RangeError", // "TypeError", // "URIError" // }; // // var jsErrors = Driver.Manage().Logs.GetLog(LogType.Browser).Where(x => errorStrings.Any(e => x.Message.Contains(e))); // // if (jsErrors.Any()) // { // TestLogs.LogInformation("JavaScript error(s):" + Environment.NewLine + jsErrors.Aggregate("", (s, entry) => s + entry.Message + Environment.NewLine)); // } // Assert.Empty(jsErrors); } public void GoToWallet(WalletId walletId = null, WalletsNavPages navPages = WalletsNavPages.Send) { walletId ??= WalletId; Driver.Navigate().GoToUrl(new Uri(ServerUri, $"wallets/{walletId}")); if (navPages == WalletsNavPages.PSBT) { Driver.FindElement(By.Id("WalletNav-Send")).Click(); Driver.FindElement(By.Id("PSBT")).Click(); } else if (navPages != WalletsNavPages.Transactions) { Driver.FindElement(By.Id($"WalletNav-{navPages}")).Click(); } } public void GoToUrl(string relativeUrl) { Driver.Navigate().GoToUrl(new Uri(ServerUri, relativeUrl)); } public void GoToServer(ServerNavPages navPages = ServerNavPages.Index) { Driver.FindElement(By.Id("Nav-ServerSettings")).Click(); if (navPages != ServerNavPages.Index) { Driver.FindElement(By.Id($"SectionNav-{navPages}")).Click(); } } public void AddUserToStore(string storeId, string email, string role) { if (Driver.FindElements(By.Id("AddUser")).Count == 0) { GoToStore(storeId, StoreNavPages.Users); } Driver.FindElement(By.Id("Email")).SendKeys(email); new SelectElement(Driver.FindElement(By.Id("Role"))).SelectByValue(role); Driver.FindElement(By.Id("AddUser")).Click(); Assert.Contains("User added successfully", FindAlertMessage().Text); } public void AssertPageAccess(bool shouldHaveAccess, string url) { GoToUrl(url); Assert.DoesNotMatch("404 - Page not found