# StraitsX Hackathon Shirts

> AI-native storefront on the Agentic Storefront Protocol (Aisle).
> Humans use a GUI. Agents use this file.

This store sells in XSGD on Avalanche (avalanche-fuji).
Do not scrape HTML. Do not open a checkout page.

## For agents
1. Read the agent card: https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/agent.json
2. Load machine catalog: https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/catalog.json
3. Pay via x402 POST https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/buy (expect HTTP 402) or StraitsX POST https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/checkout
4. Fetch receipts at https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/orders/{orderId}

## Discovery
- Agent card (JSON): https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/agent.json
- Catalog (ACP JSON): https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/catalog.json
- These instructions: https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/llms.txt

## Checkout rails
- Rail A x402: POST https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/buy
  - Expect HTTP 402 Payment Required with PAYMENT-REQUIRED.
  - Pay exact amount in XSGD to the merchant address, then retry with PAYMENT-SIGNATURE (tx hash).
- Rail B StraitsX virtual card: POST https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/checkout
  - Issue a one-time card via StraitsX MCP, scoped to spend cap, merchant whitelist, and expiry.
  - Burn the card after success.

## Receipts
- GET https://aisle-2shyifyca-itzsihuis-projects.vercel.app/s/hackathon-shirts/orders/{orderId}

## Currency
- Token: XSGD
- Decimals: 6
- Asset: 0xd769410dc8772695A7f55a304d2125320A65c2a5
- Network: avalanche-fuji (chain 43113)
- Merchant payTo: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266