How benjiewheeler/gift.star works
gift.star combines a Svelte web app for creating and managing token claim links with a WAX smart contract that creates, cancels, and claims them. The main journey is a creator preparing a link, the contract securing its token and claim data, and a claimant using the corresponding private key to claim it; the frontend also exposes link views and transaction-derived link lookup. Edges reflect README statements or shown client calls; connections from individual pages to the contract are unverified because their source was not excerpted.
Main entry points: index.ts Link and balance queries · gift_star.cpp Gift link actions · [id]/+page.svelte Claim link view · create/+page.svelte Create link
Components 17
Gift web app
- Home page
frontend/src/routes/+page.svelte - Create link
frontend/src/routes/trading/create/+page.svelte - Claim link view
frontend/src/routes/trading/link/[id]/+page.svelte - Creator links
frontend/src/routes/trading/links/+page.svelte - Wallet session
frontend/src/lib/store.ts - Interface components
frontend/src/lib/components/ui
Chain client
- Contract client
frontend/src/lib/contract.ts - Link and balance queries
frontend/src/lib/index.ts
Contract lifecycle
- Gift link actions
contract/contract/src/gift_star.cpp - Contract declarations
contract/contract/include/gift_star.hpp - Link records
contract/contract/src/gift_star.cpp
External services
- WAX API
- Transaction history APIs
- Light API
- eosio.token-compatible token
Other components
- Gift creator
- Link claimant
Connections 13
- Gift creator → Create link: prepares gift
- Link claimant → Claim link view: opens link
- Gift creator → Gift link actions: creates or cancels
- Link claimant → Gift link actions: claims with key
- Create link → Gift link actions: submits actions
- Claim link view → Gift link actions: submits claim
- Creator links → Link and balance queries: loads links
- Claim link view → Link and balance queries: loads link
- Link and balance queries → Contract client: loads contract
frontend/src/lib/index.ts - Link and balance queries → WAX API: reads tables
frontend/src/lib/index.ts - Link and balance queries → Transaction history APIs: looks up transaction
frontend/src/lib/index.ts - Link and balance queries → Light API: fetches balances
frontend/src/lib/index.ts - Gift link actions → eosio.token-compatible token: supports token standard