# Higgler.org

> Caribbean digital marketplace and crypto wallet — vendors run themed storefronts (food, hotel, events, transportation, rentals, services, retail, recreation, digital media, default) and customers pay with crypto (CBC tokens on Hyperledger Besu) or Stripe.

Higgler connects local Caribbean vendors with customers through 10 specialized storefront themes. Each theme has tailored layouts, cart, and checkout flows. Customers can fund a wallet via Stripe-hosted Checkout, hold balance in CBC tokens, and pay vendors directly. Logistics handled by Uber Direct (local delivery in Jamaica) and Kajay (US-to-Jamaica freight).

## Public pages

- [Storefronts directory](https://higgler.org/): browse all stores
- [Store map](https://higgler.org/map): geo view of vendors
- [Store home](https://higgler.org/store/{storeName}): vendor landing page
- [Product detail](https://higgler.org/product/{id}): one product
- [NFT marketplace](https://higgler.org/nft/marketplace): platform NFTs
- [Costco (platform store)](https://higgler.org/costco): drop-ship via Kajay

## Theme-specific paths

- Food menu: `/store/{name}/menu`
- Events: `/store/{name}/events`
- Digital media: `/store/{name}/content`
- Hotel rooms: `/store/{name}/venues`, `/store/{name}/calendar`
- Generic categories: `/store/{name}/categories`, `/store/{name}/category/{id}`
- Custom CMS pages: `/store/{name}/page/{slug}`
- Cart / checkout: `/store/{name}/cart`, `/store/{name}/checkout`

## API (concierge-network, base `https://api.higgler.org`)

Auth header: `authkey: <token>` (OTP-issued; some routes accept `Authorization: Bearer <token>`).

- [Public storefronts](https://api.higgler.org/blockchain/storefronts): `GET` list of stores
- [Store products](https://api.higgler.org/product?storeName={name}): `GET` products by store
- [Product detail](https://api.higgler.org/product/{id}): `GET` one product
- [OTP login](https://api.higgler.org/otp/login): `POST {email}` → sends 6-digit code
- [OTP verify](https://api.higgler.org/otp/verify): `POST {email, code}` → returns auth token
- [Order create](https://api.higgler.org/order/create): `PUT` create pending order
- [Order pay](https://api.higgler.org/order/pay): `POST` settle on chain
- [Wallet balance](https://api.higgler.org/blockchain/balance/{address}): `GET` CBC balance
- [Fund wallet](https://api.higgler.org/stripe/create-price): server-authoritative pricing → checkout session redirect

## Reference documentation

- [Full reference](https://higgler.org/llms-full.txt): expanded API + page taxonomy + agent purchase flow
- [Sitemap](https://higgler.org/sitemap.xml): all crawlable URLs

## Citation

- Store: `https://higgler.org/store/{storeName}`
- Product: `https://higgler.org/product/{id}`
- General: `https://higgler.org`