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. 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. 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. 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.

com/terms-of-service

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)

com) as part of that wallet’s own connection and analytics. This happens only when the visitor chooses Coinbase Wallet.

com/legal/user_agreement

com/legal/privacy

space (Bitcoin donations only)

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.

space/terms-of-service

space/privacy-policy

Solana RPC (Solana donations only)

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.

com/tos

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

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.

com/Finland93/cryptostack-donations. All other PHP, JavaScript and CSS in this plugin ships unminified.