Cunhe pelo seu site

Use o seu próprio conector de carteira EVM e a ABI pública. A cunhagem do KurvDrop é uma operação ERC-20, e não uma cunhagem payable em ETH. O ETH cobre o gás da rede. As fases de cunhagem grátis ainda podem cobrar a taxa de serviço da coleção, então use a cotação em vez de presumir custo zero.

Este exemplo trata de uma fase pública sem módulo de leilão e limita o pagamento à cotação exata. Ele usa uma carteira de navegador fornecida pelo visitante, nunca uma chave privada de servidor. Mostre ao comprador o total, o custo em token adicional e a rede, e obtenha a confirmação dele antes de executar as gravações de aprovação e de cunhagem.

import {
  createPublicClient, createWalletClient, custom, erc20Abi,
  http, zeroAddress, zeroHash,
} from 'viem';
import { baseSepolia } from 'viem/chains';

const api = 'https://testnet.kurv.fun';
const { abi } = await fetch(`${api}/api/v1/contracts/kurvdrop`).then(r => r.json());
const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });
const walletClient = createWalletClient({ chain: baseSepolia, transport: custom(window.ethereum) });
const [account] = await walletClient.requestAddresses();
await walletClient.switchChain({ id: baseSepolia.id });

// Woof Pack, verified in KURV's Base Sepolia catalog.
const address = '0x8354d02d8022f455db9acb235c6f6655c8adabd3';
const { collection: live } = await fetch(
  `${api}/api/v1/collections/84532/${address}`
).then(r => r.json());
if (live.contract_type !== 'KurvDrop' || live.mint.active_phase_id === null) {
  throw new Error('No public mint phase is available.');
}
const phaseId = BigInt(live.mint.active_phase_id);
const quantity = 1n;
const phase = await publicClient.readContract({ address, abi, functionName: 'getPhase', args: [phaseId] });
if (phase.module !== zeroAddress || phase.merkleRoot !== zeroHash) {
  throw new Error('This example supports only public phases without an auction module.');
}
const paymentToken = await publicClient.readContract({ address, abi, functionName: 'paymentToken' });
const [maxTotalCost] = await publicClient.readContract({ address, abi, functionName: 'quoteMint', args: [phaseId, quantity] });

// Display these amounts using each token's on-chain decimals and symbol.
const required = new Map([[paymentToken.toLowerCase(), maxTotalCost]]);
if (phase.token !== zeroAddress && phase.tokenPrice > 0n) {
  const token = phase.token.toLowerCase();
  required.set(token, (required.get(token) ?? 0n) + phase.tokenPrice * quantity);
}

// Run only after the buyer reviews and confirms the displayed amounts.
for (const [token, amount] of required) {
  const allowance = await publicClient.readContract({ address: token, abi: erc20Abi, functionName: 'allowance', args: [account, address] });
  if (allowance >= amount) continue;
  // Reset an existing allowance for tokens requiring zero before a new approval.
  if (allowance > 0n) {
    const reset = await walletClient.writeContract({ account, address: token, abi: erc20Abi, functionName: 'approve', args: [address, 0n] });
    await publicClient.waitForTransactionReceipt({ hash: reset });
  }
  const approved = await walletClient.writeContract({ account, address: token, abi: erc20Abi, functionName: 'approve', args: [address, amount] });
  await publicClient.waitForTransactionReceipt({ hash: approved });
}

// Exact quote ceiling: if the required price increased, simulation/mint refuses.
const { request } = await publicClient.simulateContract({
  account, address, abi, functionName: 'mint',
  args: [phaseId, quantity, 0n, [], maxTotalCost, zeroAddress],
});
const hash = await walletClient.writeContract(request);
const receipt = await publicClient.waitForTransactionReceipt({ hash });
if (receipt.status !== 'success') throw new Error('Mint did not complete.');

Para uma fase com lista de acesso, obtenha a permissão e a prova Merkle da carteira do comprador pelo fluxo de provas que o KURV já tem e passe-as como o terceiro e o quarto argumentos da cunhagem. Nunca troque a prova por uma prova vazia em uma fase privada. Os limites por carteira, a oferta da fase, a pausa, as retenções de leilão e o custo total são aplicados pelo contrato; a simulação precisa dar certo antes do envio. Os leilões de preço decrescente e os leilões por peça usam os próprios módulos de venda e não são fases comuns de mint direto; use a página oficial até integrar e verificar a ABI e o fluxo de liquidação desse módulo.

O último argumento da cunhagem é um endereço de carteira de indicação, e não um texto de rastreamento. Use zeroAddress por padrão até integrar de propósito as condições de indicação da coleção implantada. Quem decide a divisão real das taxas é o contrato; acrescentar um código de link não cria uma comissão por si só. As revendas no mercado usam contratos de marketplace e ordens assinadas, e não a chamada de cunhagem primária mostrada aqui.

Para o esquema da resposta de uma coleção, veja APIs públicas. Para um widget pronto, use Coleções incorporadas. As permissões do contrato, as taxas e as condições da coleção continuam valendo; veja Taxas e Riscos e isenção de responsabilidade.