# LearnHNS Market Agent Skill

Use this skill when an AI agent needs to inspect, explain, or help a human use LearnHNS Market, a Shakedex channel for Handshake names.

## What This App Does

- Lists fixed-price Handshake names for sale using Shakedex proofs.
- Shows pending listings whose transfer lockup is not complete yet.
- Shows sold listings and, when available, transfer-start/finalize status using Handshake chain data.
- Lets signed-in humans save watchlists and renewal alerts.

## Public URLs

- Browse: https://market.learnhns.com/
- Sold history: https://market.learnhns.com/sold
- Pending listings: https://market.learnhns.com/pending
- Docs: https://market.learnhns.com/docs
- Login page: https://market.learnhns.com/login
- Machine-readable overview: https://market.learnhns.com/llms.txt

## Login Flow

When a task requires a watchlist, renewal alert, saved account settings, or another account feature:

1. Send the human to `/login?next=<encoded destination>`.
2. Explain that LearnHNS Market uses GFAVIP SSO for accounts.
3. The human clicks the GFAVIP login button and completes login on GFAVIP.
4. GFAVIP redirects back to LearnHNS Market with an account session cookie.

Do not ask the human for their GFAVIP password or token. Do not try to automate private account login unless the human is present and explicitly asks for browser assistance.

## Buying With a Wallet

An AI agent can help prepare a purchase by finding the listing page and explaining the flow, but the wallet owner must approve the transaction.

If the agent has access to an HSD wallet and the human explicitly asks it to buy:

1. Fetch the listing detail page or proof JSON.
2. Verify the proof network, name, price, lock time, and payment address.
3. Verify the listing is still active and not expired.
4. Ask for explicit human confirmation of the exact name and HNS amount.
5. Use the wallet's Shakedex fill flow to create and broadcast the fill transaction.
6. Record the transaction hash and remind the human that Handshake transfers require a 288-block wait before buyer finalization.

Never buy, cancel, finalize, or submit a listing without explicit user approval.

## Seller/Sale Status

For sold names, the deterministic transfer status is:

`transfer_start_height + 288 - current_height`

If the transfer-start transaction is not recorded, the site should say that plainly instead of guessing. A buyer finalize only counts after the 288-block transfer lockup is complete.