evrmore-accounts 1.0.0

Evrmore blockchain-based authentication for web applications

Evrmore Accounts

Evrmore Accounts

A secure wallet-based authentication system for Evrmore blockchain applications

Overview

Evrmore Accounts is a Python package that provides wallet-based authentication using Evrmore blockchain. It builds on the Evrmore Authentication library to provide a complete account management system for web applications.

Features

• 🔑 Wallet-based authentication - Users sign challenges with their Evrmore wallet
• 🔒 JWT token management - Secure session handling with JSON Web Tokens
• 📁 SQLite backend - Simple, file-based database for session and challenge storage
• 👤 Automatic user management - Users are created on first authentication
• 🌐 Complete API server - Ready-to-use API server for authentication endpoints
• 🖥️ Demo web interface - Example application showing the complete authentication flow
• 📱 JavaScript client library - Easy integration with web applications

Installation

pip3 install evrmore-accounts

Quick Start

Running the API Server

python3 -m evrmore_accounts.app

This will start a Flask application with both the API endpoints and a web interface available at http://localhost:5000.

Running the Demo

Open http://localhost:5000/demo in your web browser to see the authentication flow in action.

Integration Example

Check out the simple_integration_example.html file for an example of how to integrate Evrmore Accounts with your web application.

API Endpoints

Endpoint	Method	Description
/api/challenge	POST	Generate a challenge for a user
/api/authenticate	POST	Authenticate with a signed challenge
/api/validate	GET	Validate a JWT token
/api/user	GET	Get authenticated user information
/api/logout	POST	Invalidate a JWT token (logout)

JavaScript Library

Add the Evrmore Accounts JavaScript library to your web application:

<script src="https://cdn.manticore.technology/evrmore-accounts.js"></script>

Initialize the library and create a sign-in button:

// Initialize Evrmore Accounts
EvrmoreAccounts.init({
  apiUrl: 'http://your-api-server.com/api',
  autoRefresh: true,
  debug: false
});

// Create a sign-in button
EvrmoreAccounts.initSignInButton('#sign-in-button');

// Listen for authentication state changes
EvrmoreAccounts.onAuthStateChanged(function(user) {
  if (user) {
    console.log('User is signed in:', user);
    // Show authenticated UI
  } else {
    console.log('User is signed out');
    // Show sign-in UI
  }
});

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/manticoretechnologies/evrmore-accounts.git
cd evrmore-accounts

# Create a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip3 install -e .

Running Tests

python3 test_evrmore_accounts.py

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

• Website: manticore.technology
• GitHub: github.com/manticoretechnologies
• Email: [e-mail]