CryptoStack Donations

CryptoStack Donations lets your visitors donate cryptocurrency directly to your own wallets with a single, modern “Connect wallet” button. It supports three ecosystems out of the box:

• Bitcoin (Native SegWit)
• Ethereum and EVM chains — Ethereum, Polygon, Base, BNB Smart Chain
• Solana

Donations go straight on-chain to the addresses you configure. The plugin is non-custodial: it never holds, forwards, or has access to funds. There is no account to create, no KYC, and no third-party payment processor.

Why site owners choose it

• One button, many chains. Donors pick the network and asset they already hold.
• No smart contracts. Nothing to deploy, audit, or pay gas to publish. Transfers use each chain’s native capabilities.
• You keep custody. Funds move from the donor’s wallet directly to yours.
• Anti-scam by design. The plugin only ever builds native transfers or transfers of a small, curated list of well-known stablecoins (USDC/USDT). It never calls token approve, never interacts with arbitrary contracts, and never accepts unknown/spam tokens. Donors always review every transaction in their own wallet before signing.
• Lockable settings. Once your wallet addresses are set, lock them to guard against accidental or unauthorized edits.
• Display it anywhere. Gutenberg block, [crypto_donate] shortcode, or classic sidebar widget.
• Light/dark/auto theme to match your site.

How donors pay

The donor connects any WalletConnect-compatible wallet (via Reown AppKit), chooses a network, enters an amount in that asset’s own units (for example BTC, ETH, SOL or USDC), and confirms in their wallet. Depending on chain and wallet support, the donation and the platform fee are sent either in a single batched transaction or as two clearly labelled transactions.

Platform fee (please read)

This plugin is free and always will be. There is no paid version, no “Pro” edition, no license key, no trial period, and no account to register. Every feature the plugin has is available to every user, permanently.

It is funded by a 1% platform fee on donations. The fee travels in the same on-chain flow as the donation itself, to the maintainer’s wallets (they are listed in plain sight in includes/config.php), and the donor reviews every receiving address in their own wallet before signing. This fee is how development of the plugin is financed instead of a paid version. You choose how it applies:

• Inclusive — the fee is taken from the donation amount (the recipient receives 99%).
• On top — the donor pays an extra 1% so the recipient receives 100%.

Nothing is hidden and nothing is locked. The fee is disclosed here, on the plugin’s settings screen, and — most importantly — the donor sees every single receiving address in their own wallet before they sign anything. If you would rather not have the fee, the plugin is GPL: you are free to fork it and change it. Nothing in the code stops you.

WalletConnect / Reown Project ID

Wallet connections use the WalletConnect protocol through Reown AppKit. You need a free Project ID from the Reown dashboard (dashboard.reown.com). Paste it into the plugin settings — it takes a minute and costs nothing.

Important notices

This plugin is a tool for sending cryptocurrency transactions. It is provided “as is”, without warranty. Accepting cryptocurrency donations may carry tax, accounting, and regulatory obligations that differ by country and situation. You are responsible for complying with the laws that apply to you. This plugin is not financial, legal, or tax advice. Always test with a small amount first.

External services

This plugin connects to third-party services to make wallet connections and on-chain transfers work. Nothing is sent until a visitor actively chooses to connect a wallet or send a donation. The plugin performs no background tracking and sends no data to the plugin developer.

WalletConnect / Reown (Reown AppKit) Wallet connectivity is provided by the WalletConnect protocol through Reown AppKit. When a visitor clicks “Connect wallet”, and while a wallet session is active, the bundled AppKit code contacts Reown / WalletConnect endpoints — including relay.walletconnect.org, pulse.walletconnect.org, api.web3modal.org, rpc.walletconnect.org, verify.walletconnect.com, verify.walletconnect.org, echo.walletconnect.com, secure.walletconnect.org and fonts.reown.com — to establish and maintain the encrypted wallet session, resolve wallet metadata, load the modal’s interface assets, and route blockchain RPC requests. The data involved includes your WalletConnect Project ID, the selected chain, wallet/session metadata and, once connected, the visitor’s public wallet address and the transaction they approve. This is required to connect wallets and cannot be performed locally by the plugin. Terms of service: https://reown.com/terms-of-service Privacy policy: https://reown.com/privacy-policy

Note: the bundled AppKit library also contains static connection metadata (RPC and block-explorer URLs) for many other blockchain networks. Only the networks listed in this readme are enabled by this plugin, so those other endpoints are never used or contacted.

Coinbase Wallet SDK (only if a visitor selects Coinbase Wallet) If a visitor connects using Coinbase Wallet, the Coinbase Wallet SDK bundled inside Reown AppKit may contact Coinbase endpoints (for example *.cbhq.net, cca-lite.coinbase.com or keys.coinbase.com) as part of that wallet’s own connection and analytics. This happens only when the visitor chooses Coinbase Wallet. Terms of service: https://www.coinbase.com/legal/user_agreement Privacy policy: https://www.coinbase.com/legal/privacy

mempool.space (Bitcoin donations only) For donations on Bitcoin, the Bitcoin adapter bundled inside Reown AppKit queries the mempool.space API (operated by The Mempool Open Source Project; the Testnet variant of the endpoint is used on Bitcoin Testnet) to look up the unspent transaction outputs (UTXOs) available at the donor’s address, which is required to construct a valid Bitcoin transaction. The data sent is the donor’s public Bitcoin address, and only when a visitor sends a Bitcoin donation. Terms of service: https://mempool.space/terms-of-service Privacy policy: https://mempool.space/privacy-policy

Solana RPC (Solana donations only) For donations on Solana, the bundled code talks to a public Solana JSON-RPC endpoint (by default api.mainnet-beta.solana.com, operated by the Solana Foundation) to read a recent blockhash and broadcast the signed transaction. The data sent is the transaction and related public on-chain information, and only when a visitor sends a Solana donation. Terms of service: https://solana.com/tos Privacy policy: https://solana.com/privacy-policy

Public blockchain networks Completing any donation broadcasts a signed transaction to the relevant public blockchain (Bitcoin, an EVM network such as Ethereum, Polygon, Base or BNB Smart Chain, or Solana). On-chain transactions are public by nature. This is inherent to sending cryptocurrency and is not optional once a donor confirms a transfer.

Source code

The file build/appkit-bundle.js is a compiled (minified) JavaScript bundle. Its human-readable source is:

• assets/src/appkit-bundle.js — the plugin’s own wrapper code, shipped unminified inside this plugin.
• The public npm packages it imports: @reown/appkit (with its Ethers, Solana and Bitcoin adapters), @solana/web3.js and @solana/spl-token.

The full development repository — including the exact build configuration (package.json, vite.config.js) and instructions to reproduce the bundle — is public at https://github.com/Finland93/cryptostack-donations. All other PHP, JavaScript and CSS in this plugin ships unminified.