/Magic.Crypto.Blazor

Repository using encapsulated JS interoperability in Blazor. Currently supports the Pact lang JS library.

Primary LanguageC#MIT LicenseMIT

Magic Crypto Blazor

Welcome to Magic Crypto Blazor! This repository contains two projects within the solution:

  • Crypto.Blazor.Core
  • Crypto.MauiBlazor.Wallet

These projects aim to make blockchain API calls easier to utilize within C# and Blazor applications. While most blockchain APIs and libraries use JavaScript, this project integrates these JavaScript libraries to be more accessible in C# Blazor environments. The Crypto.MauiBlazor.Wallet project is a secure way for users to track their crypto through open-source, easily changeable code.

Crypto.Blazor.Core

Crypto.Blazor.Core is a C# Razor library for Blazor projects, currently supporting Kadena with limited functionality. The primary goal is to utilize the pact-lang-api JavaScript library, the official JS library created by the Kadena development team, without rewriting it in C#. This approach ensures easy updates and maintenance by leveraging the official Kadena library.

Nuget Package

Key Features

  • Kadena Support: Integration with the pact-lang-api library for seamless interaction with Kadena's blockchain.
  • Encapsulated JS Interoperability: Uses service initiation to interact with the pact-lang-api library, minimizing overhead.
  • Wallet and Chain Balance Checks: Check the balance of a KDA wallet across all chains, multiple wallets at once, and individual chain balances.

Current Methods

  • GetKdaChainBalance

    public async Task<KdaChainBalance> GetKdaChainBalance(string walletAddr, int chainId)
public async Task<KdaChainBalance> GetKdaChainBalance(string walletAddr, string chainIdString)

  • UpdateKdaVersion

    public async Task UpdateKdaVersion()

  • GetKdaWalletAsync

    public async Task<List<KdaWallet>> GetKdaWalletAsync(IEnumerable<string> walletAddr)
public async Task<KdaWallet> GetKdaWalletAsync(string walletAddr)

Example Usage

To initiate and use the CryptoService in your Blazor application:

  1. In Program.cs, add the service configuration:

    MagicCryptoServiceConfig.Configure(builder.Services);

  2. Inject the CryptoService into your component:

    @inject CryptoService _CryptoService

  3. Use the service methods:

    // Example with multiple addresses
string[] addresses = ["address1","address2"];
List<KdaWallet> Wallets = await _CryptoService.GetKdaWalletAsync(addresses);

// Example with a single address
KdaWallet Wallet = await _CryptoService.GetKdaWalletAsync("address1");

// Example with chain balance
KdaChainBalance WalletBalance = await _CryptoService.GetKdaChainBalance("address1", 2);

// Example with all chain balances
List<KdaChainBalance> AllChainBalances = await _CryptoService.GetKdaAllChainBalancesAsync("address1");

Rate Limiting

The Kadena Chainweb API has a rate limit of 50 calls per second. Within the CryptoService, a hardcoded rate limit of 40 calls per 1.3 seconds is set to prevent abuse and accidental IP bans. This default setting provides a 38.5% reduction in the rate limit, ensuring smooth operation and compliance with Kadena's rate limits.

Crypto.MauiBlazor.Wallet

The Crypto.MauiBlazor.Wallet project is a MAUI Blazor application designed to provide a secure environment for users to check their cryptocurrency wallets. It currently supports Kadena using the pact-lang-api JavaScript library, as well as Binance.US and the Coin Market Cap API.

Key Features

  • Kadena Support: Check your Kadena wallet balances, chains, and totals using the pact-lang-api library.
  • Binance.US and Coin Market Cap API: Fetch the latest cryptocurrency prices every two hours to ensure usage stays within the free subscription limits (under 10k tokens per month).
  • Data Encryption: All data entered into the application is encrypted using the password you choose. The password is stored as a hash, making it irreversible and secure.

Security

  • Password-Based Encryption: It is crucial to choose a secure password as it is used to encrypt all your data.
  • No Password Recovery: If you forget your password, you will need to reset it, which will delete all your current data stored in the application.
  • Future Enhancements: Plans to add functionality for changing your password while logged in, ensuring safe conversion of encryptions.

Current Functionality

  • Kadena Wallet Management: View your Kadena wallet details, including chain balances and totals.
  • Price Fetching: Uses the Coin Market Cap API to fetch recent cryptocurrency prices every two hours, staying within the free subscription limits.

Future Goals

  • Protocol for Data Storage: Create a protocol to make it easier to integrate additional wallets and blockchains.
  • Community-Driven API Integrations: Allow users to write their own JavaScript code for API calls to other wallets, and share their code as easily sharable packages.
  • Enhanced Tax Accounting: Address frustrations with existing crypto tax software by allowing additional layers of data storage and updates, especially in situations like the Celsius Network bankruptcy.

Installation and Usage

  • Running the Application: The application is developed within MAUI Blazor and is currently unsigned. To avoid installation warnings, it is recommended to run the code through your Visual Studio IDE.
  • Platform Compatibility: The application is designed to be universal across all operating systems, including Mac, Windows, and Linux.

Example Usage

To start using the application, follow these steps:

  1. Clone the Repository: Clone the Magic Crypto Blazor repository to your local machine.

    git clone https://github.com/your-username/magic-crypto-blazor.git

  2. Open in Visual Studio: Open the solution in Visual Studio.

  3. Build and Run: Build the solution and run the Crypto.MauiBlazor.Wallet project.

Future Plans

  • Expanding support for additional blockchain APIs.
  • Enhancing functionality and adding more features to both projects.
  • Ensuring robust security and ease of use for developers and end-users.