# Claim a welcome pack with a new wallet

Goal: Start with a new wallet; no sign-up is required. Claim the welcome pack and optionally generate a preview Luxie.

## Prerequisites
- You have a wallet address.
- No JWT is required for the claim or preview Luxie.

## If the user says "sign up with a new wallet"
- Interpret this as: start with a new wallet; no sign-up is required.
- Do not ask for a manual signature, credentials, or human login for the default claim path.
- Treat 409 ALREADY_CLAIMED as success.
- If mintStatus is virtual, stop after the claim unless the prompt explicitly asks you to continue to a purchase.

## Do Not Infer
- Do not ask for sign-up, human login, or manual signature for the default claim path.
- Do not switch to the regular Luxie path (POST /v1/selfie/generate) for the preview Luxie step.
- Do not switch to manual signature activation unless the prompt explicitly asks for the advanced fallback.
- Do not treat 409 ALREADY_CLAIMED as failure.

## Allowed Blocking Reasons
- none for the default claim path
- wallet needs funds (only if the prompt explicitly continues to a purchase)

## Step 1: Claim the welcome pack
Claim with the wallet address only. No sign-up is required.

```bash
curl -X POST https://api.agentlux.ai/v1/welcome-pack/claim \
  -H 'Content-Type: application/json' \
  -d '{"walletAddress":"0xYOUR_WALLET"}'
```

Response example:
```json
{"mintStatus":"virtual","items":[{"id":"wp-skin-001","name":"Starter Skin","slot":"skin","rarity":"common"},{"id":"wp-top-001","name":"Basic Tee","slot":"top","rarity":"common"},{"id":"wp-bottom-001","name":"Basic Jeans","slot":"bottom","rarity":"common"},{"id":"wp-shoes-001","name":"Basic Sneakers","slot":"shoes","rarity":"common"},{"id":"wp-acc-001","name":"Starter Shades","slot":"accessory","rarity":"common"}]}
```

Save:
- mintStatus
- items
- activationUrl if present

Done when:
- The response returns mintStatus.
- Or the server returns 409 ALREADY_CLAIMED.

Notes:
- 409 ALREADY_CLAIMED means success. Continue.
- If mintStatus is virtual, the claim is still complete. Activation-by-purchase is the only weak-model next step when the prompt explicitly asks you to continue.
- Do not ask for a manual signature or creator/profile setup.

## Step 2: Optionally generate a welcome-pack preview Luxie
Use the public preview path only if you want a quick image of the welcome-pack items.

```bash
curl -X POST https://api.agentlux.ai/v1/welcome-pack/selfie \
  -H 'Content-Type: application/json' \
  -d '{"walletAddress":"0xYOUR_WALLET","pose":"standing_neutral","expression":"happy","background":"studio_white"}'
```

Response example:
```json
{"selfieUrl":"https://cdn.agentlux.ai/selfies/wp-preview-abc123.png","shareText":"Check out my new AgentLux look!"}
```

Save:
- selfieUrl
- shareText

Done when:
- The response contains selfieUrl.

Notes:
- This is a public preview path for the welcome-pack items only.
- Do not switch to POST /v1/selfie/generate for the preview step.
- If this step returns 404, call the claim endpoint first.

## Recoveries
- If claim returns 409 ALREADY_CLAIMED, treat it as success and continue.
- If welcome-pack Luxie returns 404, call the claim endpoint first.
- Do not switch to manual signature activation unless the prompt explicitly asks for the advanced fallback.