Learn to build web applications with Taproot Assets by solving CORS and authentication barriers.
# Clone the workshop
git clone https://github.com/privkeyio/taproot-assets-webdev-examples.git
cd taproot-assets-webdev-examples
# Start all demos
./scripts/start-workshop.shThen visit http://localhost:8999/part0-setup/ to begin!
All workshop parts run on one server (port 8999):
- Part 0: http://localhost:8999/part0-setup/
- Part 1: http://localhost:8999/part1-cors-demo/
- Part 2: http://localhost:8999/part2-gateway-connection/
- Part 3: http://localhost:8999/part3-starter/
- Part 3 React: http://localhost:5173/ (runs separately with
bun run dev)
Navigate seamlessly between parts using the built-in navigation buttons!
- Part 0: REST Gateway setup walkthrough
- Part 1: Experience CORS/auth barriers firsthand
- Part 2: Mint, send, and receive assets via gateway
- Part 3: Build a live portfolio viewer
- Part 3 React: Modern framework integration with React + Vite
Duration: ~90 minutes
The Problem:
- Browsers block direct TAPD API calls (CORS)
- Macaroon authentication is complex
- TLS certificates cause issues
The Solution:
- REST Gateway acts as a proxy
- Handles CORS and auth automatically
- Clean REST API for browsers
- REST Gateway Repository
- Taproot Assets Documentation
- Polar Development Environment
- Polar Taproot Assets Guide
Found a bug? Have an improvement? Contributions are welcome!
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
Built with ❤️ by Kyle Santiago / PrivKey
Ready? Run ./scripts/start-workshop.sh and visit http://localhost:8999/part0-setup/