> For the complete documentation index, see [llms.txt](https://docs.mybucks.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mybucks.online/p2p.gifts/how-it-works.md).

# How it works

**p2p.gifts** is a browser-only **P2P crypto gifting wizard**—gift crypto to anyone with no signup, no app install, and nothing stored on a server. Everything runs in your browser.

### The idea

You create a temporary **digital cash envelope** (a one-time wallet), send funds to it, and share a branded gift card (with a QR code) to the person you're gifting. They scan the QR and claim the funds instantly.

**p2p.gifts** is part of the [mybucks.online](https://mybucks.online) project and uses the same **digital cash envelope** (**seedless, disposable wallet** framework) and key-derivation technology, tailored for a simple gifting flow.

### Step by step

#### 1. Create a gift wallet

Click **Start Gifting** on the welcome screen. The wizard **auto-fills** a strong random passphrase and PIN. Together, these derive a one-time wallet address — no seed phrase, no private key file.

You can edit either field or tap the **refresh** icon next to it to generate new random values (the new value is copied to your clipboard). **We encourage you to keep the auto-generated credentials** rather than typing your own — they are designed for one-time gift wallets and meet the app's strength checks. If you do customise them, they must still pass the strength meter before you can continue.

> The passphrase and PIN exist only in your browser tab. If you close or refresh the page before saving the gift card, they are gone forever.

#### 2. Fund the wallet

Pick a network (Ethereum, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, or Base) and send crypto to the displayed address. You can scan the QR code or copy the address.

**Tip:** Include a small amount of native tokens (ETH, MATIC, etc.) for gas fees when sending other tokens, so the receiver can claim without extra steps.

#### 3. Design the gift card

Choose a card style:

* **Classic** — clean design with colour themes (Modern Blue, Elegant Purple, Festive Gold, Minimalist Dark, Crypto Gradient)
* **Custom** — upload your own background image (PNG/JPG, up to 8 MB) or use a preset

Add an optional gift note with Markdown formatting — bold, italic, headings, and line breaks all work.

#### 4. Share

Download the gift card as a PNG or copy the gifting link. Send it however you like — DM, email, print it out, or slip it into a greeting card.

### How the receiver claims

The receiver scans the QR code on the gift card (or opens the gifting link). This takes them to [app.mybucks.online](https://app.mybucks.online), where they can access the wallet and transfer the funds to their own address — no signup, no app install.

### What's under the hood

* Wallet keys are derived client-side from the passphrase + PIN using [mybucks.online](https://mybucks.online) core library
* No backend, no database, no API keys — the app is a static site hosted on GitHub Pages
* The gift card is rendered in-browser and exported as a PNG using `html-to-image`
* The gifting link encodes a token (not the raw passphrase) that the claim app can decode

### Related

* [Disclaimers](/p2p.gifts/disclaimers.md)
* [Terms of Use](/p2p.gifts/terms-of-use.md)
* [Privacy Policy](/p2p.gifts/privacy-policy.md)
* [FAQ](/p2p.gifts/faq-and-safety.md)
* [License](/p2p.gifts/license.md)
* [Mybucks.online Terms of Use (claiming on app.mybucks.online)](/more/terms-of-use.md)