Web3 Signup & Sign-in Plugin for Botble CMS

Sign up or log in using MetaMask, Trust Wallet, and 300+ Web3 wallets

100% Free • Gasless • No Blockchain Transactions

Overview

The Web3 Signup & Sign-in Plugin for Botble CMS allows customers to register and log in using their crypto wallet instead of email and password. It supports MetaMask, Trust Wallet, Coinbase Wallet, Rainbow, Brave, Rabby, and 300+ wallets via WalletConnect.

This plugin is completely free for both store owners and customers. There are no blockchain transactions, no gas fees, and no smart contracts involved. Authentication is done purely through cryptographic message signing, making it fast, secure, and cost-free.

Developed by Maryam International LLC, this plugin is ideal for modern ecommerce stores that want to offer seamless Web3 authentication while remaining fully compatible with Botble CMS.

🌐 Developer Website: www.codeupp.xyz

Why This Plugin Is 100% Free & Gasless

This plugin does not interact with any blockchain network. Instead, it uses the Sign-In with Ethereum (SIWE) approach, where the user proves wallet ownership by signing a message locally.

Because of this:

No gas fees for users

No transaction fees for store owners

No smart contract deployment

No crypto balance required (even empty wallets work)

WalletConnect Project ID is free to create

The wallet only signs a message locally, and the server verifies it using cryptographic math. Nothing is sent to the blockchain.

How It Works (Authentication Flow)

Customer clicks Connect Wallet on the login or register page

Wallet opens (browser extension) or QR code appears (mobile)

Wallet address is shared with the server

Server generates a one-time nonce (random message)

Customer signs the message in their wallet (free, gasless)

Server verifies the signature using elliptic curve cryptography

If valid, the customer is logged in or registered

No blockchain transaction is created at any point.

Standards & Technologies Used

Standard

Purpose

EIP-6963

Automatically detects multiple wallet extensions and lets users choose which wallet to use

EIP-191 / personal_sign

Secure message signing with Ethereum message prefix

WalletConnect v2

Mobile wallet support via QR code and deep linking

secp256k1

Ethereum cryptographic curve used for signature verification

Supported WalletsDesktop Wallets (Auto-detected)

MetaMask

Rainbow

Coinbase Wallet

Brave Wallet

Rabby

Trust Wallet (extension)

Any EIP-6963 compatible wallet

Mobile Wallets (via WalletConnect)

MetaMask Mobile

Trust Wallet

Rainbow

Coinbase Wallet

imToken

Zerion

Argent

300+ wallets supported by WalletConnect

Key Features

Wallet-based Signup & Login (no email or password required)

Gasless Authentication (no blockchain interaction)

Multi-wallet Detection using EIP-6963

Mobile Wallet Support via WalletConnect QR code

Customer-only Access (vendors blocked from wallet login)

Admin Analytics Dashboard

Automatic Wallet Address Linking

Theme-independent Integration

Secure Nonce-based Signature Verification

Installation

Copy the plugin folder to:
platform/plugins/web3-signup/

Activate the plugin from Admin → Plugins

Run migrations:

Go to Admin → Settings → Others → Web3 Wallet Login

Enable the plugin and enter your WalletConnect Project ID

WalletConnect Project ID (Free)

A WalletConnect Project ID is required for mobile wallet support.

How to get it (100% free):

Visit: https://cloud.walletconnect.com

Create a free account (no credit card required)

Create a new project

Copy the Project ID

Paste it into the plugin settings

WalletConnect’s free tier is more than enough for ecommerce login usage.

Admin Dashboard

The plugin adds a Web3 Signup section in the admin panel with:

Dashboard Metrics

Total Wallet Signups

Total Wallet Sign-ins

Unique Wallet Addresses

Average Sign-ins per User

Signups Table

Wallet Address

Customer Name

Email (real or wallet-only placeholder)

Signup Date

Account Status

Sign-ins Log

Wallet Address

Wallet Used

Customer Name

Email

IP Address

Login Date

Customer Dashboard Experience

When a customer signs up using a wallet:

Sidebar displays a shortened wallet address

Account Settings include:

Full Name (editable)

Email (optional, editable)

Wallet Address (read-only)

Phone number

Customers can later add a real email address

Customers can become vendors later (after adding email)

Email Handling

On signup, a placeholder email is stored internally

Account email field appears empty and editable

Once a real email is added, it replaces the placeholder

Wallet address is always stored separately and never changes

Vendor Compatibility

Wallet login is blocked for vendors

Vendors must register/login using email

Wallet users can later become vendors

Fully compatible with Botble Marketplace

Database ChangesModified Table: ec_customers

Column

Description

eth_address

Wallet address (unique)

web3_nonce

One-time nonce

web3_signed_up_at

Wallet signup timestamp

New Table

web3_login_logs — stores wallet sign-in history

All database changes are automatically removed on uninstall.

Theme Compatibility

Works automatically with:

Shofy

Martfury

Any Botble theme using standard login/register forms

No theme file modifications required.

Security Features

No blockchain transactions

No private keys ever handled

Single-use nonces with replay protection

Dual nonce storage for reliability

Pure PHP cryptographic verification

Ethereum signed message prefix protection

Requirements

PHP 8.1+ (GMP extension enabled)

Botble CMS 7.3+

Botble Ecommerce plugin

(Optional) Botble Marketplace plugin

Support & Contact

Maryam International LLC
🌐 Website: www.codeupp.xyz
📧 Email: maryaminternationalllc@gmail.com
📱 WhatsApp: +971 55 368 2656

php artisan migrate