Web3Keys Documentation

Introduction

Web3Keys is a comprehensive blockchain identity management system that provides secure key management, digital identity solutions, and Bitcoin SV (BSV) wallet functionality. This documentation will guide you through the features and usage of the platform.

Key Features

Military-grade Encryption

All your private keys are encrypted with AES-256 encryption, ensuring maximum security for your digital assets.

Sovereign Identity

Take control of your digital identity with self-sovereign identity management using blockchain technology.

Multiple Key Derivation

Generate different keys for various purposes from a single seed phrase using BIP32/44 derivation paths.

BSV Wallet

Send, receive, and manage your Bitcoin SV with our integrated wallet functionality.

Digital Signatures

Sign and verify documents and messages using your cryptographic keys.

Blockchain Integration

Interact with the Bitcoin SV blockchain for transactions and data storage.

Getting Started

Account Creation

To get started with Web3Keys, you need to create an account:

Visit the home page
Enter your email address and create a strong password
Optionally, you can provide your own mnemonic phrase or let the system generate one for you
Click "Register" to create your account

Important: Your password is used to encrypt your keys. Make sure to use a strong password and keep it safe. If you lose your password, you may lose access to your keys.

Key Management

After registration, you'll have access to your dashboard where you can view all your derived keys:

Identity Key (m/44'/236'/0'/0/0) - For self-attestation and sovereign identity
Financial Key (m/44'/0'/0'/0/0) - For BSV transactions and asset management
Property Key (m/44'/236'/1'/0/0) - For physical and digital property rights
Contractual Key (m/44'/236'/0'/0/1) - For business relationships and agreements
Document Key (m/44'/236'/3'/0/0) - For document signing and verification
Privacy Key (m/44'/236'/4'/0/0) - For privacy-preserving interactions
Messages Key (m/44'/236'/5'/0/0) - For secure messaging and communication

Using the BSV Wallet

The Web3Keys platform includes a fully-functional Bitcoin SV wallet that allows you to:

Accessing Your Wallet

To access your BSV wallet:

Log in to your account
Navigate to the Dashboard
Click on the "BSV Wallet" button

Wallet Features

Balance Check - View your current BSV balance in satoshis
Send BSV - Transfer BSV to other addresses
OP_RETURN Transactions - Store data on the blockchain using OP_RETURN
Combined Transactions - Send BSV and store data in a single transaction

Creating Transactions

To create a transaction:

Navigate to the Wallet page
Enter your password to unlock your wallet
Select the type of transaction you want to create (Send, OP_RETURN, or Combined)
Fill in the required information (destination address, amount, data)
Click the appropriate button to create and broadcast your transaction

Warning: Blockchain transactions are irreversible. Always double-check the destination address and amount before sending.

Technical Reference

Key Derivation Paths

Web3Keys uses BIP32/44 derivation paths to generate different keys from a single seed phrase. Here's a reference of the paths used:

Key Type	Derivation Path	Purpose
Identity	`m/44'/236'/0'/0/0`	Self-attestation and sovereign identity
Financial	`m/44'/0'/0'/0/0`	Financial transactions and asset management
Property	`m/44'/236'/1'/0/0`	Physical and digital property rights
Contractual	`m/44'/236'/0'/0/1`	Business relationships and agreements
Document	`m/44'/236'/3'/0/0`	Document signing and verification
Privacy	`m/44'/236'/4'/0/0`	Privacy-preserving interactions
Messages	`m/44'/236'/5'/0/0`	Secure messaging and communication

API Endpoints

The BSV wallet uses the following Whatsonchain API endpoints:

// Get address balance
GET https://api.whatsonchain.com/v1/bsv/main/address/{address}/balance

// Get unspent outputs (UTXOs)
GET https://api.whatsonchain.com/v1/bsv/main/address/{address}/confirmed/unspent

// Broadcast transaction
POST https://api.whatsonchain.com/v1/bsv/main/tx/raw
Body: { "txhex": "raw_transaction_hex" }

Security Best Practices

Use a Strong Password - Your password should be at least 12 characters long and include uppercase letters, lowercase letters, numbers, and special characters.
Backup Your Mnemonic - Store your mnemonic phrase in a secure location. Consider using offline storage methods like paper wallets or metal backups.
Keep Your Software Updated - Always use the latest version of Web3Keys to benefit from security improvements.
Be Careful with Public Computers - Avoid accessing your wallet from public or untrusted computers.
Verify Addresses - Always double-check addresses before sending transactions.
Start with Small Amounts - When trying new features, start with small amounts to minimize risk.

Troubleshooting

Common Issues

Unable to Log In

If you're having trouble logging in:

Ensure you're using the correct email and password
Check if caps lock is enabled
Clear your browser cache and cookies
Try using a different browser

Transaction Errors

If you encounter errors when creating transactions:

Make sure your address has sufficient funds
Check your internet connection
Ensure you've unlocked your wallet with the correct password
Try refreshing the page and attempting the transaction again

Balance Not Updating

If your balance isn't updating:

Wait a few minutes and refresh the page
Check the transaction status on a block explorer
Ensure the Whatsonchain API is operational