Payment Links

What are Payment Links?

Payment links are shareable URLs that let anyone send you a private stealth payment. When you register a .dust name, you automatically get a personal payment link at/pay/yourname. You can also create custom links with specific names, descriptions, and emoji icons for different purposes — like invoicing, tips, or donations.

The receiver doesn't need to connect a wallet to create a link — only the sender needs a wallet to pay. Every payment goes to a fresh one-time stealth address derived via ECDH, so no on-chain link exists between the sender and the recipient's main address.

Creating a Link

1. 01

   Go to /links/create

   Navigate to the Links page and click Create Link. Choose the Simple Payment template (other types like Digital Product and Payment Request are coming soon).
2. 02

   Set a name and optional description

   Give your link a descriptive name (e.g., "Coffee Tips"). Pick an emoji and background color. Add an optional description to tell payers what the link is for. The amount is open by default — senders choose how much to pay.
3. 03

   Link generated with unique slug

   The app generates a unique slug from your link name, mapped to your stealth meta-address. Your link URL follows the pattern pay/yourname/slug and resolves to a .dust subdomain like slug.yourname.dust.
4. 04

   Share via QR code or URL

   Copy the link URL or open the QR modal to display a scannable code. The QR encodes the full payment URL. You can share it anywhere — social media, messaging apps, email, or print it out.

Paying a Link

1. 01

   Sender visits the payment link

   The sender opens the URL in their browser. The page shows the recipient's .dust name, a shield icon, and two tabs: Send with Wallet for direct payment, or QR / Address for manual transfer from any wallet.
2. 02

   Sender sees amount, memo, and recipient

   For custom links with a slug, the displayed name is slug.username.dust. For personal links, it shows username.dust. The sender enters the amount and reviews the details before proceeding.
3. 03

   Sender connects wallet

   If not already connected, the sender clicks Connect Wallet to link their browser wallet (MetaMask, WalletConnect, etc.). The page resolves the recipient's stealth meta-address from the on-chain ERC-6538 registry.
4. 04

   Payment sent to a one-time stealth address

   The sender's browser derives a fresh stealth address via ECDH using the recipient's meta-address. The ETH is sent directly to this new address. The sender never learns the recipient's actual wallet address.
5. 05

   Announcement posted via ERC-5564

   An announcement event is emitted on-chain so the recipient's stealth scanner can detect the incoming payment. The recipient claims the funds through their normal scanning flow — no extra steps needed.

Link Management

View all your created links at /links. Each link card shows the name, emoji, .dust subdomain, view count, and payment count. Click a card to see full details, or use the quick actions to copy the link URL or open the QR modal.

Your personal link (based on your .dust name) always appears at the top of the list. Custom links are displayed below with their individual stats. You can click any custom link to view its detail page at /links/[id].

How It Stays Private

The payment link URL contains no sensitive data — just the recipient's .dust name and an optional link slug. The stealth address is computed entirely client-side by the sender's browser using ECDH key agreement. The recipient claims incoming payments via their normal stealth scanner, which monitors ERC-5564 announcement events.

Because each payment generates a unique stealth address, an observer cannot link multiple payments to the same recipient — even if they all came through the same payment link. The link itself is just a convenient entry point; the privacy guarantees come from the underlying stealth address protocol.