# BlockReceipt

> Generate a verified Proof of Payment receipt from any blockchain transaction. Free, instant, shareable.

BlockReceipt is a web tool that takes a blockchain transaction hash and generates a beautiful, downloadable payment receipt — no signup, no wallet connection, no fees.

## What it does

- Accepts any transaction hash from 7 supported blockchains
- Auto-detects the chain from the hash format
- Fetches live on-chain data (amount, sender, recipient, block, timestamp, gas fee)
- Detects ERC-20 / TRC-20 token transfers (USDT, USDC, etc.) — shows actual token amount, not 0 ETH
- Renders a minimal, premium receipt card
- Allows download as PNG or PDF
- Generates a shareable URL: `https://blockreceipt.xyz/tx/{hash}`

## Supported blockchains

- **Ethereum** (ETH + ERC-20 tokens) — via public JSON-RPC
- **Base** (ETH L2 by Coinbase) — via public JSON-RPC
- **Arbitrum** (ETH L2) — via public JSON-RPC
- **Optimism** (ETH L2) — via public JSON-RPC
- **BNB Chain** (BNB + BEP-20 tokens) — via public JSON-RPC
- **TRON** (TRX + TRC-20 tokens like USDT) — via Tronscan API
- **Solana** (SOL + SPL tokens) — via Solana mainnet RPC

## URL structure

- `https://blockreceipt.xyz/` — Input page (paste hash, select chain)
- `https://blockreceipt.xyz/tx/{hash}` — Direct receipt URL, auto-resolves from hash

**Example shareable receipt:**
`https://blockreceipt.xyz/tx/0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060`

## How to use (for agents)

To generate a receipt for a transaction:
1. Navigate to `https://blockreceipt.xyz/tx/{transaction_hash}`
2. The chain is auto-detected from the hash format:
   - `0x` + 64 hex chars → EVM chain (Ethereum, Base, Arbitrum, Optimism, BNB Chain)
   - 64 hex chars (no `0x`) → TRON
   - Base58, 87-88 chars → Solana
3. The receipt renders automatically — no interaction required

To share a receipt with a user, construct: `https://blockreceipt.xyz/tx/{hash}`

## No authentication required

BlockReceipt requires no API keys, no account, no wallet connection. All data is sourced from public blockchain nodes and explorers.

## Data sources

- EVM chains: public JSON-RPC via publicnode.com
- TRON: Tronscan public API (apilist.tronscanapi.com)
- Solana: api.mainnet-beta.solana.com
- Token prices: CoinGecko free API
- Chain logos: logo.dev Crypto Logo API