# Send AI Walllet Payment System to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ai-walllet-payment-system",
    "name": "AI Walllet Payment System",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/cerbug45/ai-walllet-payment-system",
    "canonicalUrl": "https://clawhub.ai/cerbug45/ai-walllet-payment-system",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ai-walllet-payment-system",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ai-walllet-payment-system",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "requirements.txt",
      "ultra_secure_wallet_v13_MAXIMUM_SECURITY.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ai-walllet-payment-system",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-28T23:57:16.774Z",
      "expiresAt": "2026-05-05T23:57:16.774Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ai-walllet-payment-system",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ai-walllet-payment-system",
        "contentDisposition": "attachment; filename=\"ai-walllet-payment-system-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ai-walllet-payment-system"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ai-walllet-payment-system"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ai-walllet-payment-system",
    "downloadUrl": "https://openagent3.xyz/downloads/ai-walllet-payment-system",
    "agentUrl": "https://openagent3.xyz/skills/ai-walllet-payment-system/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ai-walllet-payment-system/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ai-walllet-payment-system/agent.md"
  }
}
```
## Documentation

### Overview

This skill enables AI agents to securely manage cryptocurrency wallets and perform blockchain transactions. It provides encrypted key storage, multi-factor authentication, and secure transaction processing for Ethereum-based payments.

Repository: https://github.com/cerbug45/AI-Wallet-Payment-System
Author: cerbug46
Version: 13.0
Language: Python 3.8+

### Primary Capabilities

Creates and manages Ethereum cryptocurrency wallets
Encrypts private keys with military-grade cryptography
Performs secure ETH transactions via Web3
Implements TOTP-based two-factor authentication
Provides comprehensive audit logging
Offers rate limiting and abuse prevention

### Use Cases

AI agents that need to make automated payments
Secure wallet management for applications
Educational demonstrations of crypto security
Testing blockchain integrations
Building payment-enabled AI systems

### Step 1: System Dependencies

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y python3-dev libsqlcipher-dev build-essential libssl-dev

macOS:

brew install sqlcipher openssl python@3.11

Windows:

# Install Visual Studio Build Tools 2019+
# Download from: https://visualstudio.microsoft.com/downloads/
# Select "Desktop development with C++" workload

### Step 2: Clone Repository

git clone https://github.com/cerbug45/AI-Wallet-Payment-System.git
cd AI-Wallet-Payment-System

### Step 3: Python Environment

# Create isolated virtual environment
python3 -m venv venv

# Activate environment
source venv/bin/activate  # Linux/macOS
# OR
venv\\Scripts\\activate     # Windows

# Upgrade pip
pip install --upgrade pip

### Step 4: Install Python Dependencies

# Core dependencies
pip install web3==6.0.0
pip install pysqlcipher3==1.2.0
pip install cryptography==41.0.0
pip install argon2-cffi==23.1.0
pip install pyotp==2.9.0
pip install qrcode==7.4.0
pip install pillow==10.0.0

# Optional: Install all at once
pip install -r requirements.txt

Dependency Breakdown:

web3 - Ethereum blockchain interaction
pysqlcipher3 - Encrypted SQLite database
cryptography - AES/ChaCha20 encryption
argon2-cffi - Password hashing
pyotp - TOTP 2FA implementation
qrcode - QR code generation for 2FA
pillow - Image processing for QR codes

### Step 5: Environment Configuration

Create .env file in project root:

# Required Configuration
WEB3_PROVIDER_URL=https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID
BACKUP_ENCRYPTION_KEY_FINGERPRINT=<generated-key>

# Optional Configuration
DATABASE_PATH=./secure_wallets.db
LOG_LEVEL=INFO
RATE_LIMIT_ENABLED=true
MAX_REQUESTS_PER_MINUTE=2
MAX_REQUESTS_PER_HOUR=20
SESSION_TIMEOUT_MINUTES=15

Generate Backup Encryption Key:

openssl rand -hex 32
# Copy output to BACKUP_ENCRYPTION_KEY_FINGERPRINT

Get Infura Project ID:

Sign up at https://infura.io/
Create new project
Copy Project ID from dashboard
Use in WEB3_PROVIDER_URL

### Step 6: Verify Installation

python -c "from ultra_secure_wallet_v13_MAXIMUM_SECURITY import MaximumSecurityPaymentAPI; print('✅ Installation successful')"

### Basic Usage Example

from ultra_secure_wallet_v13_MAXIMUM_SECURITY import MaximumSecurityPaymentAPI
import getpass
import os

# Load environment variables
from dotenv import load_dotenv
load_dotenv()

# Get master password securely (NEVER hardcode!)
master_password = getpass.getpass("Enter master password: ")

# Initialize API
api = MaximumSecurityPaymentAPI(master_password)

# Create new wallet
wallet = api.create_wallet(
    wallet_id="my_ai_wallet",
    metadata={
        "agent_name": "PaymentBot",
        "purpose": "automated_payments"
    }
)

if wallet['success']:
    print(f"✅ Wallet created!")
    print(f"   Address: {wallet['address']}")
    print(f"   📱 Setup 2FA with: {wallet['totp_uri']}")
    print(f"   🔑 Backup codes: {wallet['backup_codes']}")
    
    # CRITICAL: Save MFA secret and backup codes securely!
    # Store in password manager or encrypted vault

# Check balance
balance = api.get_balance("my_ai_wallet")
print(f"💰 Balance: {balance['balance_eth']} ETH")

# Send transaction (requires TOTP from authenticator app)
totp_code = input("Enter 6-digit TOTP code: ")
tx = api.send_transaction(
    wallet_id="my_ai_wallet",
    to_address="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    amount_eth=0.001,  # Send 0.001 ETH
    totp_code=totp_code
)

if tx['success']:
    print(f"✅ Transaction sent!")
    print(f"   TX Hash: {tx['tx_hash']}")

# Always cleanup sensitive data
api.cleanup()

### Command Line Demo

# Run built-in demo
python ultra_secure_wallet_v13_MAXIMUM_SECURITY.py

# Follow prompts:
# 1. Enter strong master password (20+ chars)
# 2. System creates demo wallet
# 3. Displays active security features
# 4. Shows wallet address and 2FA setup

### Password Requirements

The system enforces strict password policies:

# Minimum requirements
- Length: 20+ characters
- Uppercase letters: 1+
- Lowercase letters: 1+
- Digits: 1+
- Special characters: 1+
- Entropy: 80+ bits

Recommended Password Generation:

# Generate strong password
openssl rand -base64 32

# Or use password manager:
# - 1Password
# - Bitwarden
# - LastPass
# - KeePassXC

### Two-Factor Authentication Setup

After creating a wallet, you'll receive:

TOTP Secret - Store in password manager
QR Code URI - Scan with authenticator app
Backup Codes - Save offline securely

Compatible Authenticator Apps:

Google Authenticator
Authy
Microsoft Authenticator
1Password (has built-in TOTP)

### Rate Limiting Configuration

Edit in code or environment:

# Default limits
MAX_REQUESTS_PER_MINUTE = 2   # Per wallet/IP
MAX_REQUESTS_PER_HOUR = 20    # Per wallet/IP
LOCKOUT_DURATION = 3600       # 1 hour in seconds

### Audit Logging

All operations are logged to secure_wallet.log:

# View logs
tail -f secure_wallet.log

# Filter for specific wallet
grep "my_ai_wallet" secure_wallet.log

# Check for security events
grep -E "SECURITY|ERROR|FAILED" secure_wallet.log

### Using with AI Agents

class PaymentAgent:
    def __init__(self, master_password):
        self.wallet_api = MaximumSecurityPaymentAPI(master_password)
        self.wallet_id = "agent_wallet"
        
    async def process_payment(self, recipient, amount, totp):
        """Process automated payment"""
        
        # Check balance first
        balance = self.wallet_api.get_balance(self.wallet_id)
        
        if balance['balance_eth'] < amount:
            return {"error": "Insufficient funds"}
        
        # Execute transaction
        result = self.wallet_api.send_transaction(
            wallet_id=self.wallet_id,
            to_address=recipient,
            amount_eth=amount,
            totp_code=totp
        )
        
        return result
    
    def cleanup(self):
        self.wallet_api.cleanup()

### Environment-Specific Configuration

Development/Testnet:

# Use Sepolia testnet
WEB3_PROVIDER_URL=https://sepolia.infura.io/v3/YOUR_PROJECT_ID

# Or Goerli
WEB3_PROVIDER_URL=https://goerli.infura.io/v3/YOUR_PROJECT_ID

Production/Mainnet:

# Ethereum mainnet
WEB3_PROVIDER_URL=https://mainnet.infura.io/v3/YOUR_PROJECT_ID

# Enable all security features
RATE_LIMIT_ENABLED=true
REQUIRE_2FA=true
AUDIT_LOGGING=true

### Backup and Recovery

Export Wallet Backup:

# Encrypted backup creation
api.export_wallet_backup("my_wallet", backup_password="strong-backup-pwd")
# Creates: wallet_backup_20240215_123456.enc

Restore from Backup:

# Import encrypted backup
api.import_wallet_backup(
    "wallet_backup_20240215_123456.enc",
    backup_password="strong-backup-pwd"
)

### Test on Testnet First

Never test with real ETH on mainnet!

# 1. Get testnet ETH
# Visit: https://sepoliafaucet.com/
# Enter your wallet address
# Receive free test ETH

# 2. Configure testnet
export WEB3_PROVIDER_URL=https://sepolia.infura.io/v3/YOUR_PROJECT_ID

# 3. Run tests
python ultra_secure_wallet_v13_MAXIMUM_SECURITY.py

### Unit Testing

# Install test dependencies
pip install pytest pytest-cov pytest-mock

# Run tests (if available)
pytest tests/

# With coverage
pytest --cov=ultra_secure_wallet_v13_MAXIMUM_SECURITY tests/

### What This System Actually Provides

✅ Implemented Security Features:

Encrypted database (SQLCipher AES-256)
Strong password hashing (Argon2id)
Private key encryption (ChaCha20-Poly1305)
TOTP two-factor authentication
Rate limiting and lockout
Audit logging
Input validation
Memory wiping

❌ Not Implemented (Despite Header Claims):

Hardware Security Module (HSM) integration
Trusted Platform Module (TPM) support
Post-quantum cryptography
Multi-signature wallets
Quantum random number generation
Most of the 500+ listed features

### Production Checklist

Before using in production:

Professional security audit completed
 Penetration testing performed
 Code review by security experts
 Insurance/liability coverage obtained
 Disaster recovery plan documented
 Incident response procedures ready
 Regular security updates scheduled
 Compliance requirements verified (KYC/AML if applicable)
 Multi-signature wallet implemented for large amounts
 Cold storage setup for long-term holdings

### Risk Acknowledgment

This system is experimental and educational.

⚠️ No warranty provided
⚠️ Use at your own risk
⚠️ Authors not liable for lost funds
⚠️ Not professionally audited
⚠️ May contain security vulnerabilities
⚠️ Suitable for small amounts only

### Common Issues

Problem: "ModuleNotFoundError: No module named 'pysqlcipher3'"

# Solution: Install system dependencies first
sudo apt-get install libsqlcipher-dev
pip install pysqlcipher3

Problem: "Web3 provider not connected"

# Solution: Check Infura URL and API key
echo $WEB3_PROVIDER_URL
# Should output: https://mainnet.infura.io/v3/YOUR_PROJECT_ID

Problem: "Argon2 too slow / system freeze"

# Solution: Reduce Argon2 parameters in code
# Edit MaxSecurityConfig:
ARGON2_MEMORY_MB = 128  # Reduce from 512
ARGON2_ITERATIONS = 4   # Reduce from 16

Problem: "Rate limit exceeded"

# Solution: Wait for cooldown or increase limits
# Limits reset after 1 hour
# Or edit rate limit config

### Documentation

Web3.py Docs
Ethereum Development Docs
Argon2 Specification
TOTP RFC 6238

### Security Best Practices

OWASP Cryptographic Storage Cheat Sheet
NIST Password Guidelines
CWE Top 25 Software Weaknesses

### Ethereum Tools

Etherscan - Blockchain explorer
Remix IDE - Smart contract development
MetaMask - Browser wallet

### 🤝 Contributing

Contributions welcome! Areas needing improvement:

Testing: Add comprehensive test suite
Documentation: Improve code documentation
Security: Implement claimed features properly
Performance: Optimize Argon2 parameters
Features: Real HSM integration, multi-sig support
UI: Web interface or CLI improvements

### 📞 Support

GitHub Issues: https://github.com/cerbug45/AI-Wallet-Payment-System/issues
Username: cerbug46
Repository: cerbug45/AI-Wallet-Payment-System

### 📄 License

MIT License - See LICENSE file for details

Last Updated: February 2024
Skill Version: 1.0
Code Version: 13.0
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: cerbug45
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-28T23:57:16.774Z
- Expires at: 2026-05-05T23:57:16.774Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ai-walllet-payment-system)
- [Send to Agent page](https://openagent3.xyz/skills/ai-walllet-payment-system/agent)
- [JSON manifest](https://openagent3.xyz/skills/ai-walllet-payment-system/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ai-walllet-payment-system/agent.md)
- [Download page](https://openagent3.xyz/downloads/ai-walllet-payment-system)