Mint na Twojej stronie

Użyj własnego konektora portfela EVM i publicznego ABI. Mint w KurvDrop to operacja ERC-20, a nie płatny mint w ETH. ETH pokrywa gas sieci. Darmowe fazy mintu mogą nadal pobierać opłatę serwisową kolekcji, więc korzystaj z wyceny, zamiast zakładać zerowy koszt.

Ten przykład obsługuje fazę publiczną bez modułu aukcji i ogranicza płatność do dokładnej wyceny. Korzysta z portfela przeglądarkowego dostarczonego przez odwiedzającego, nigdy z klucza prywatnego serwera. Zanim uruchomisz zapisy zgody i mintu, pokaż kupującemu sumę, koszt dodatkowego tokenu i sieć, a potem uzyskaj jego potwierdzenie.

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.');

W przypadku fazy z listą dostępu pobierz limit portfela kupującego i dowód Merkle z istniejącego przepływu dowodów KURV i przekaż je jako trzeci i czwarty argument mintu. Nigdy nie podstawiaj pustego dowodu w fazie prywatnej. Limity portfela, liczbę NFT w fazie, pauzę, blokady aukcyjne i łączny koszt egzekwuje kontrakt; symulacja musi się powieść przed wysłaniem. Aukcje ze spadającą ceną i aukcje pojedynczych NFT korzystają z własnych modułów sprzedaży i nie są zwykłymi fazami mint wywoływanymi bezpośrednio; używaj oficjalnej strony, dopóki nie zintegrujesz i nie zweryfikujesz ABI tego modułu oraz przepływu rozliczenia.

Ostatni argument mintu to adres portfela polecającego, a nie ciąg do śledzenia. Domyślnie używaj zeroAddress, dopóki świadomie nie zintegrujesz warunków poleceń wdrożonej kolekcji. O faktycznym podziale opłat decyduje kontrakt; samo dodanie kodu w linku nie tworzy prowizji. Odsprzedaże na marketplace korzystają z kontraktów marketplace i podpisanych zleceń, a nie z pokazanego tu wywołania mintu pierwotnego.

Schemat odpowiedzi kolekcji opisuje strona Publiczne API. Gotowy widżet znajdziesz na stronie Osadzanie kolekcji. Uprawnienia kontraktu, opłaty i warunki samej kolekcji nadal obowiązują; zobacz Opłaty i Ryzyka i zastrzeżenia.