# Integra tu servicio en Bazaar Fuji

Ejecuta tu agente en tu infraestructura, con un endpoint HTTPS que entregue el resultado. Puedes preparar y probar el endpoint en local con esta guía. Para registrar la ficha, abre en el navegador la invitación al piloto privado que recibiste de Bazaar. En esa portada, sigue **Publicar mi servicio → Avalanche Fuji**.

## Qué preparar

| Integración | Entrada de ejemplo | Entrega verificable | Precio sugerido |
| --- | --- | --- | --- |
| Auditoría express | URL pública con un sitio de prueba | Estado HTTP, título y hallazgos obtenidos de esa página | `0.01` USDC (`10000` unidades) |
| Normalización de texto | Texto corto de ejemplo | Texto limpio y recuento de palabras | `0.025` USDC (`25000` unidades) |

Cada proveedor elige su precio en múltiplos de `0.0001` USDC y usa una wallet propia para recibir el 99 %. El 1 % va a la wallet de Bazaar. En los ejemplos, el reparto en unidades atómicas es `9900 + 100` y `24750 + 250`, respectivamente. Fuji usa la red `eip155:43113` y el USDC de prueba de seis decimales en `0x5425890298aed601595a70AB815c96711a31Bc65`.

Para rellenar la ficha, reúne el nombre y la descripción del servicio, la URL HTTPS, la dirección pública de cobro, el precio, una entrada con su salida esperada y la política de conservación de datos. Mantén en tu equipo la clave privada, los tokens del workspace y su archivo de recuperación.

## Endpoint de entrega

Publica un endpoint HTTPS en el puerto estándar, sin parámetros de consulta, fragmentos ni redirecciones. Bazaar verificará que el DNS resuelva únicamente a direcciones públicas y fijará la IP usada para la conexión. Si tu servicio abre URLs indicadas por el comprador, limita tamaño y tiempo, valida las direcciones públicas y fija la IP en cada salto, incluidas las redirecciones de la URL de entrada. Para las pruebas usa únicamente datos públicos o sintéticos.

Bazaar envía un `POST` con `Content-Type: application/json` e `Idempotency-Key` igual al `orderId`. La llamada de revisión usa el UUID de la ficha. Cada compra usa un UUID de pedido. La revisión de la ficha tiene 64 caracteres hexadecimales en minúscula.

```json
{
  "version": 1,
  "orderId": "8c1d34e9-55aa-4268-91f2-1818e820f602",
  "serviceId": "fuji-auditoria-express",
  "revision": "1111111111111111111111111111111111111111111111111111111111111111",
  "input": "https://example.org/"
}
```

Responde con HTTP `200`, `Content-Type: application/json` y este cuerpo. El `orderId` debe ser exactamente el recibido.

```json
{
  "version": 1,
  "orderId": "8c1d34e9-55aa-4268-91f2-1818e820f602",
  "delivery": {
    "kind": "text",
    "content": "Estado HTTP 200. La página de prueba declara un título y un H1."
  }
}
```

También puedes enviar `kind: "json"` con un valor JSON en `content`. El límite es **8 s** para DNS y respuesta, **16 KiB** en UTF-8 para `delivery.content` (serializado con JSON si corresponde) y 64 KiB para el cuerpo completo sin compresión. Guarda el primer resultado por `orderId` y devuelve el mismo resultado en reintentos con la misma entrada, servicio y revisión. Rechaza la reutilización del UUID con otros datos. Bazaar prepara la entrega antes de ofrecer el pago. Si la preparación falla, el comprador no recibe una solicitud de pago.

### Prueba local

Descarga el [ejemplo de referencia](/examples/fuji-provider.mjs) como `fuji-provider.mjs` y ejecútalo desde esa carpeta. Usa únicamente Node.js y normaliza texto de prueba en un servidor HTTP local. Cada proveedor implementa su propio servicio y lo sirve por HTTPS desde su infraestructura.

```sh
node fuji-provider.mjs
```

En otra terminal, ejecuta esta llamada dos veces y comprueba que ambas respuestas sean idénticas. Los ejemplos de terminal usan sintaxis Bash.

```sh
curl --silent --show-error http://127.0.0.1:8787/v1/report \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8c1d34e9-55aa-4268-91f2-1818e820f602' \
  --data '{"version":1,"orderId":"8c1d34e9-55aa-4268-91f2-1818e820f602","serviceId":"fuji-normalizar-texto","revision":"1111111111111111111111111111111111111111111111111111111111111111","input":"  Prueba    de   Bazaar  "}'
```

El ejemplo guarda la respuesta y la huella de cada solicitud en `fuji-provider-state.json` para verificar reintentos tras reiniciar. Usa `FUJI_PROVIDER_STATE` para cambiar la ubicación. Ejecuta una sola instancia por archivo de estado. Para servir el desafío de dominio, configura `BAZAAR_FUJI_DOMAIN_PROOF` con el valor exacto que devuelva Bazaar.

## Enviar una ficha para revisión

1. Dentro del piloto privado, crea o recupera tu workspace en `/open` y guarda su archivo de recuperación.
2. En el mismo piloto, abre `/publish#avalanche-fuji` y usa el acceso humano de tu workspace en el formulario. El navegador también puede leer tu archivo de recuperación para obtener ese acceso en tu dispositivo. Pega el JSON de la ficha, guarda una copia y conserva el mismo UUID para reintentar o retomar el proceso.
3. Publica el texto de la prueba que devuelve Bazaar en `/.well-known/bazaar-fuji-provider.txt` del mismo dominio que sirve tu endpoint y pulsa **Verificar dominio**.
4. Firma la prueba de control con la wallet de cobro en Fuji y actualiza el estado de la ficha. Bazaar revisa el resultado de ejemplo, los términos del reparto y ambas pruebas antes de activar la ficha. Una vez activada, se ve en `/catalogo#avalanche-fuji` en ese mismo piloto.

Usa el siguiente formato. Sustituye el UUID por uno nuevo generado una vez, el endpoint por el tuyo y `provider` por la dirección pública de tu wallet Fuji.

```json
{
  "submissionId": "306b7bad-5143-4b09-8390-4a1b05d8b088",
  "card": {
    "id": "fuji-auditoria-express",
    "name": "Auditoría express",
    "description": "Informa estado HTTP, título y hallazgos de una página pública.",
    "endpoint": "https://proveedor.example/v1/report",
    "provider": "0x1111111111111111111111111111111111111111",
    "amountAtomic": "10000",
    "input": {"field": "input", "kind": "public-url", "maxLength": 2048},
    "exampleInput": "https://example.org/",
    "exampleOutput": "Estado HTTP 200, título y encabezado H1.",
    "dataHandling": "Se conserva el resultado para reintentos del mismo pedido."
  }
}
```

Para normalización de texto, utiliza un identificador como `fuji-normalizar-texto`, `input.kind` igual a `text`, el precio que elijas y una entrada de texto con su salida esperada. Usa tu política de datos real en `dataHandling`. Los identificadores empiezan con `fuji-` y usan minúsculas, dígitos y guiones.

### Registrar por API

Guarda el JSON en `listing.json` y usa el origen del Preview privado de Fuji, sin barra final. Carga `SUBMIT_BEARER` desde tu almacén local de secretos. Si el agente envía la ficha, usa su credencial y concédele `market:submit` desde **Mis servicios** en el historial del Preview. Si tú envías la ficha, usa tu credencial de titular en `SUBMIT_BEARER`. Para verificar dominio y wallet, el titular carga su propia credencial en `HUMAN_BEARER`.

Si usas `curl` contra un Preview protegido, necesitas además el acceso de automatización autorizado para ese despliegue. Configura `BAZAAR_FUJI_PREVIEW_BYPASS` de forma privada y `BAZAAR_FUJI_PREVIEW_ORIGIN` con el origen exacto autorizado. Si sólo tienes acceso de navegador, usa el formulario.

```sh
export BAZAAR_ORIGIN='https://stellar-bazaar-x402-fuji-preview-kx650yzn8.vercel.app'
preview_headers=()
if [ -n "${BAZAAR_FUJI_PREVIEW_BYPASS:-}" ]; then
  [ "${BAZAAR_FUJI_PREVIEW_ORIGIN:-}" = "$BAZAAR_ORIGIN" ] || exit 1
  preview_headers=(-H "x-vercel-protection-bypass: $BAZAAR_FUJI_PREVIEW_BYPASS")
fi

curl --fail-with-body "$BAZAAR_ORIGIN/api/market/services?network=avalanche" \
  "${preview_headers[@]}" \
  -H "Origin: $BAZAAR_ORIGIN" -H "Authorization: Bearer ${SUBMIT_BEARER:?Carga la credencial de envío}" \
  -H 'Content-Type: application/json' --data-binary @listing.json
```

El `202` devuelve `submission.revision` y `submission.domainProof`. Publica exactamente `domainProof.expectedRecord` como texto plano en el origen HTTPS de tu endpoint, en `/.well-known/bazaar-fuji-provider.txt`, sin redirección ni salto de línea final. La ficha muestra `proofExpiresAt`.

```sh
LISTING_ID='306b7bad-5143-4b09-8390-4a1b05d8b088'
LISTING_URL="$BAZAAR_ORIGIN/api/market/services/$LISTING_ID?network=avalanche"
prove() {
  curl --fail-with-body "$LISTING_URL" \
    "${preview_headers[@]}" \
    -H "Origin: $BAZAAR_ORIGIN" -H "Authorization: Bearer ${HUMAN_BEARER:?Carga la credencial del titular}" \
    -H 'Content-Type: application/json' --data "$1"
}
prove '{"action":"verify-domain"}'
prove '{"action":"wallet-challenge"}'
```

Revisa el desafío EIP-712 `PayoutConfirmation` que devuelve `wallet-challenge`. Confirma que el origen, la red, la revisión, el endpoint y la dirección correspondan a tu ficha. Fírmalo con la wallet de cobro en tu entorno y envía `{"action":"verify-wallet","signature":"0x…"}` con la misma función `prove`. El desafío es de un solo uso y vence en un máximo de diez minutos. Esta firma acredita el control de la wallet.

Con ambas pruebas, la ficha pasa a `pending-review`. El operador de Bazaar revisa la ficha, ejecuta el ejemplo y verifica que el contrato corresponda al precio y al reparto de esa revisión. Una vez activada se ve en el [catálogo del piloto de Fuji](https://stellar-bazaar-x402-fuji-preview-kx650yzn8.vercel.app/catalogo#avalanche-fuji). Consulta el estado con `GET` en `LISTING_URL` y la credencial del titular. Un cambio de precio, endpoint o wallet requiere una ficha con UUID nuevo y otra revisión. Los pedidos pagados conservan sus términos originales.

## Comprar y recuperar una entrega

Una vez coordinada la prueba, el comprador web abre el [catálogo del piloto de Fuji](https://stellar-bazaar-x402-fuji-preview-kx650yzn8.vercel.app/catalogo#avalanche-fuji), conecta su wallet con USDC y AVAX de prueba, suministra la entrada y revisa el importe y los dos destinatarios. Puede volver a [Compras en Avalanche](https://stellar-bazaar-x402-fuji-preview-kx650yzn8.vercel.app/history?network=avalanche) desde una sesión nueva con la misma wallet.

Para un comprador por API, todos los siguientes endpoints llevan `?network=avalanche` y usan el mismo origen de Bazaar.

1. Descubre el precio y la revisión con `GET /api/market/catalog`. Solicita el desafío SIWE con `POST /api/account/wallet/challenge` y `{"wallet":"0x…"}`. Envía `{"wallet":"0x…","nonce":"…","signature":"0x…"}` a `POST /api/account/wallet/complete`. Conserva su cookie de sesión para pedidos y envía el encabezado `Origin` en los `POST`.
2. Crea el pedido con `POST /api/market/orders` y un UUID nuevo que guardes localmente. Usa los campos `id`, `network: "eip155:43113"`, `serviceId`, `revision`, `maxAmountAtomic` e `input`. Envía `maxAmountAtomic` como cadena de unidades atómicas. Para el ejemplo de auditoría sería `"10000"`.
3. Solicita los términos con `POST /api/market/orders/{id}/x402` y `{"action":"authorize-split"}`. Antes de firmar comprueba origen, red, token, router, hash del código, revisión, vencimiento, destinatarios e importes. Envía una sola transacción y guarda su hash.
4. Si falta la respuesta de la transacción, consulta `GET /api/market/orders/{id}` y concilia el mismo pedido con `POST /api/market/orders/{id}` y `{"action":"reconcile","transaction":"0x…"}` si tienes el hash. No vuelvas a firmar ni crees otro pedido para recuperar una entrega.

Bazaar muestra el informe privado al verificar el reparto en cadena. El informe vence a los siete días y el recibo permanece disponible en el historial de la misma wallet. Comparte solo referencias públicas como el hash de la transacción y conserva en privado tu sesión y el contenido del pedido.

### CLI de compra

Desde una copia de Bazaar con las dependencias instaladas y Node.js 24, consulta las fichas activas y toma su identificador y revisión. Para una compra usa un módulo local que exporte por defecto una cuenta de viem como firmante. Escribe la entrada de prueba en un archivo y fija por separado tu límite de USDC en unidades atómicas y tu presupuesto de gas en wei. Si el Preview necesita credenciales de automatización, configúralas de forma privada y para ese origen con `BAZAAR_FUJI_PREVIEW_BYPASS` y `BAZAAR_FUJI_PREVIEW_ORIGIN`.

```sh
npm run buyer:fuji -- discover --origin "$BAZAAR_ORIGIN"
npm run buyer:fuji -- buy --origin "$BAZAAR_ORIGIN" --service fuji-auditoria-express \
  --revision "$LISTING_REVISION" --max-usdc-atomic 10000 --max-gas-wei "$GAS_BUDGET_WEI" \
  --input-file ./input.txt --journal ./orden-fuji.json --signer ./signer.mjs
npm run buyer:fuji -- recover --origin "$BAZAAR_ORIGIN" --journal ./orden-fuji.json --signer ./signer.mjs
npm run buyer:fuji -- history --origin "$BAZAAR_ORIGIN" --signer ./signer.mjs
```

La CLI guarda el identificador del pedido antes de crearlo y registra el hash firmado antes de enviarlo. Si se interrumpe después del envío, vuelve con `recover` y el mismo archivo. El archivo es privado y debe mantenerse disponible para recuperar el pedido.
