Intégrations de collections

Utilisez l’URL links.embed renvoyée par l’API. Cet exemple utilise Woof Pack, un KurvDrop enregistré, vérifié le 7 octobre 2026 dans le catalogue public de Base Sepolia. Remplacez son adresse de contrat par le contract_address de votre propre collection :

<iframe
  src="https://testnet.kurv.fun/embed/84532/0x8354d02d8022f455db9acb235c6f6655c8adabd3"
  title="Woof Pack on KURV"
  loading="lazy"
  width="100%"
  height="420"
  style="max-width:660px;border:0;border-radius:18px"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
></iframe>

Pour une collection Solana, utilisez https://testnet.kurv.fun/embed/solana:devnet/{address}

Le widget affiche l’art ou l’aperçu de la collection, son réseau, sa taille et le nombre de mints confirmés. Il rafraîchit les chiffres visibles de la chaîne toutes les 15 secondes et signale les données périmées. Il n’a ni en-tête de compte, ni navigation, ni bandeau défilant, et ne dépend d’aucun cookie de portefeuille tiers. Sur les sites en HTTPS, le widget d’affichage peut être intégré depuis n’importe quelle origine ; le reste de l’app KURV garde ses restrictions d’intégration existantes.

Le mint_mode du widget est kurv_wallet_handoff : Minter ouvre une fenêtre KURV pour le compte ou le portefeuille de l’acheteur, le prix actuel et l’approbation, et la carte se met à jour quand le mint est terminé. L’iframe ne signe rien et n’encaisse aucun paiement. Les collections importées qui n’ont pas été lancées sur KURV ouvrent plutôt leur rayon de collection.

Le propriétaire d’une collection trouve cet extrait prêt à coller sous Placez ce mint sur votre site, sur la page de la collection. Le widget s’affiche dans la langue de chaque visiteur ; ajoutez ?lang=ja à l’adresse pour en fixer une.

Ne retirez pas allow-popups-to-escape-sandbox : l’autorisation du portefeuille doit se faire en dehors du bac à sable de l’iframe du site parent. Réglez la hauteur selon votre mise en page ; la carte s’adapte jusqu’à une colonne mobile étroite.

Mise en page et apparence

Ajoutez des choix à l’adresse du widget. Le Placez ce mint sur votre site du propriétaire la construit pour vous, avec un aperçu :

<iframe
  src="https://testnet.kurv.fun/embed/84532/0x8354d02d8022f455db9acb235c6f6655c8adabd3?layout=compact&theme=light&accent=ff5a1f"
  title="KURV mint"
  loading="lazy"
  width="100%"
  height="150"
  style="max-width:660px;border:0;border-radius:18px"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
></iframe>

Choix	Valeurs
layout	full, compact, art, noart
theme	dark, light
font	system, serif, mono, rounded
accent	Six chiffres hexadécimaux sans #, comme ff5a1f : le bouton Minter
text	Six chiffres hexadécimaux sans #, comme 160f2b : les mots

Chaque valeur est vérifiée sur le serveur par rapport à cette liste, et toute autre devient la valeur par défaut, si bien qu’aucun CSS de votre part n’atteint la carte. L’adresse ne porte que l’apparence : la carte lit en direct le nom, l’art et les chiffres de la collection, donc une modification sur KURV l’atteint sans changer votre code.

Le connecteur MCP fournit kurv_embed_code pour une adresse déployée. Utilisez les API publiques pour construire un affichage personnalisé, Minter depuis votre page pour un bouton à vous ou votre propre parcours de portefeuille, et Minter depuis votre site pour le contrat lui-même. Les chiffres d’une collection sont des instantanés ; voir Risques et avertissement.