CIP-99

CIP-99 (Proof of Onboarding) es la propuesta de mejora de Cardano que define un estándar para campañas de reclamo de tokens mediante código QR. Claimpaign es una implementación de referencia de este estándar.

Qué define CIP-99

El estándar especifica:

• Un esquema de URI (web+cardano://claim/v1) que las wallets registran para gestionar
• Un endpoint de faucet al que las wallets envían la dirección del destinatario
• El formato de petición y respuesta entre wallet y faucet
• El manejo de errores y códigos de estado

Formato del URI

Cada código de claim genera un URI como este:

web+cardano://claim/v1?faucet_url=https%3A%2F%2Fclaimpaign.com%2Fapi%2Fclaim&code=SUMMIT_a3bf9c

Cuando una wallet escanea este código QR:

1. Reconoce el protocolo web+cardano://claim
2. Extrae la URL del faucet y el código de claim
3. Envía una petición POST con la dirección del destinatario
4. Recibe los ada, tokens o NFTs en la transacción de respuesta

Por qué importa un estándar

Metadatos de transacción

Cada transacción de Claimpaign incluye metadatos con la etiqueta 8414 de CIP-10 para identificación on-chain.

Transacción de claim

{
  "label": 8414,
  "metadata": {
    "app": "claimpaign.com",
    "campaign": "a1b2c3d4e5f6…",
    "version": "1"
  }
}

Transacción de topup

{
  "label": 8414,
  "metadata": {
    "app": "claimpaign.com",
    "version": "1"
  }
}

El campo campaign contiene sha256(randomSalt + campaignId), calculado una vez al crear la campaña. Esto permite correlacionar todos los claims de una campaña en la blockchain sin exponer el ID interno de la campaña.

Autores

CIP-99 fue creado por Adam Dean, Alex Dochioiu y "Carl." La propuesta completa está disponible en GitHub.