This project was started as a way for me to learn ASP/.NET Blazor and .NET EF Core. Expect there to be lots of room for improvement in this project.
The goals of this project are as follows
- Cross-platform Explorer for the Signum Blockchain built using .NET Core technologies.
- Allows easy navigation of blockchain entities along with linked entities
- Provide localization options across the site.
Ultimately this has been a vehicle to help me learn and solidify my development skills.
- The explorer needs a Signum Node that uses a MariaDB backend (NO H2 file DB support)
- Addition of Indexes and Views to the DB (Currently managed by the application and these should be added upon startup so long as your connection strings are setup correctly.)
- Access to your MariaDB Signum DB as needed based on how your deploying the application. (Firewall, and DB GRANT permissions setup.)
- For Windows, IIS is the preferred way to deploy, however the application can be run on it's own as long as you are able to configure your webserver/proxy redirect to point to the appropriate port.
- For Linux, I have not been able to try this yet. Will know more once i try to deploy there.
- This is meant to run as a Blazor SERVER application. Because of this it uses a "Signal-R" connection, which is essentially an abstraction over WebSockets. Make sure you're setup for this when trying to access the site from outside your local network via any reverse proxy/web server you have setup.
This should be automated now. Scripts included for reference purposes.
Your DB will need some additional Views and Indexes added. This is a manual process at this
time so using your DB access tool of choice you will find a series of .sql scripts for Views and Indexes located here:
DB Scripts . These scripts will add necessary views to allow the explorer to function properly.
There are a couple files that will help configure the connection strings that are needed to connect to your MariaDB.
appsettings.json and appsettings.production.json .
The main areas of concern in these files are as follows and stick the the format in the files to replace the information needed to match your environment.:
SRSConnection- Signum Node Connection StringExplorerConnection- Explorer DB Connection String (You won't have a DB setup for this. The app will create it for you as long as the connection string is setupMariaDBSettings- Define the MariaDB version that you are using (Recommend using version 10.6 as this is what i've built it with, however >10.3 is likely to work without any issues).
"ConnectionStrings": {
"SQLiteConnection": "Data Source=SignumExplorerDB.db",
"SRSConnection": "server=srs-node-pool;user=signum;password=signumpassword;database=signum",
"ExplorerConnection": "server=srs-node-pool;user=signum;password=signumpassword;database=explorer"
},
"MariaDBSettings": {
"Version": "10.6.4-mariadb"
},
"AllowedHosts": "*",
"Urls": "http://localhost:4100;http://localhost:4101",The application is designed to be Cross-platform. As such it can be hosted in Windows via IIS or on Linux using some sort of reverse proxy. This information may not be all encompassing of what's necessary to get the site running, but will give some insight into what's necessary.
- This is a good starting point to help on [this https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/?view=aspnetcore-7.0]
The project is in active development so bugs/issues are to be expected. I'm open to others playing with and helping increase/update the functionality. If you feel like donating to help my developer journey please do so at this Signum Address:
- Current development is being done with version 7 of .NET Core, EF Core, and Pomelo.EnittyFramework.
- The most recent Visual Studio 2022 is recommended and may be required to help with ease of development.
- Pomelo EF Core should be compatible with .NET Core 7
- This app will be updated to .NET Core 8 once released