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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mybucks.online/p2p.gifts/how-it-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
