thirdweb ile mintleme

thirdweb çoklu blok zinciri ağlarında merkeziyetsiz uygulamalar geliştirmek için araçlar ve altyapı sunan bir platformdur. SDK'lar, API'ler ve önceden oluşturulmuş bileşenlerle blok zinciri entegrasyonunu basitleştirir.

NFT basma durumunda, thirdweb denetlenmiş sözleşmeleri ve geniş SDK'larıyla birlikte kullanıma hazır bir kontrol paneli ve IPFS yükleme sunar.

Tek bir NFT'yi manuel olarak basma

Sadece tek bir görsel yükleyip basmak istiyorsanız, thirdweb tıklamayla dağıtım arayüzü sunar.

Önce, Web3 cüzdanınızı sahip olarak kullanarak bir thirdweb hesabı oluşturun. Bu size thirdweb kontrol panelinize erişim sağlar.

Oradan iki yol arasında seçim yapabilirsiniz:

• Kullanın TokenERC721 sayfası ve onun "Deploy Now" düğmesi.

• Veya kontrol panelinin "Create Token" arayüzünü kullanın.

Her birini bu sayfada hızlıca inceleyelim. The thirdweb Developer Portal ihtiyacınız olursa size daha fazla bilgi verecektir.

TokenERC721 sayfasını kullanma

1. şuraya gidin: TokenERC721 sayfa. Bu, bir NFT Koleksiyonu oluşturmak için onların sözleşmesine dayanır.

2. Sözleşme dağıtım sayfasına erişmek için "Deploy Now" tıklayın.

1. "Contract metadata" bölümünü doldurun:

   1. NFT koleksiyonunuzu temsil etmesini istediğiniz görseli (veya sadece basmak istediğiniz görseli) yükleyin.

   2. Koleksiyonunuza benzersiz bir ad ve bir sembol/ticker verin.

   3. Bir açıklama verin.

2. thirdweb, "Primary Sales" ve "Royalties" için alıcı adreslerini otomatik doldurur; Web3 adreslerinin gerçekten sizin cüzdanınıza ait olduğundan emin olun.

3. "Deploy Options" içinde Chiliz Chain'i seçin (ya da sadece testse Chiliz Spicy Testnet'i) ve "Deploy Now" tuşuna tıklayın:

1. thirdweb sözleşmeyi dağıtmaya başlayacak ve Web3 cüzdanınızdan bir onay modalı tetikleyecektir. Dağıtımı bitirmek için onaylayın.

2. İşlem tamamlandığında "View Contract" butonuna tıklayın. thirdweb kontrol panelinizde sözleşmenin sayfasına yönlendirileceksiniz; burada bir kontrol listesi/ilerleme çubuğu göreceksiniz:

3. Kontrol listesinden görüldüğü gibi, şimdilik yaptığınız tek şey bir sözleşme dağıtmak; NFT'yi gerçekten basmanız hâlâ gerekiyor. Sol sütunda, yeni bir sayfa açmak için "NFTs" menü öğesine tıklayın; şimdilik bu sayfa boştur:

4. "Mint" düğmesine tıklayın; bir yan panel açılacak ve NFT'nizin her özniteliği için alanlar gösterecektir. Burada NFT'nizin metadata'sını oluşturursunuz:

5. Çeşitli alanları doldurun. "Artist_name" veya "Type_of_work" gibi NFT koleksiyonunuza özgü alanlar oluşturabilirsiniz ve gelişmiş seçenekleri keşfedebilirsiniz; ancak bu test için minimumda tutabilirsiniz: isim, medya dosyası, açıklama.

6. Yan panelin altındaki "Mint NFT" düğmesine tıklayın ve cüzdanınızdan işlemi onaylayın.

7. thirdweb daha sonra "NFTs" sayfasını gösterecek; NFT'niz artık görünür olacak ve NFT sözleşmenize bağlı olacaktır.

TAMAM! NFT'nizi bastınız!

Gerçekten Chiliz Chain'de olduğunu kontrol etmek için Chiliscan (veya eğer Spicy Testnet kullanıyorsanız onun Testnet versiyonu ) açın ve NFT'nin hash'ini arama alanına yapıştırın. Bu, sözleşmenizin zincirde olduğunu hemen doğrulamalı ve "Inventory" sekmesi NFT'nizi sizin (veya en azından cüzdanınızın ID'si) olarak listelemelidir.

NFT'nizi Chiliz Chain Mainnet'te bastıysanız, hesabınızda Rarible veya OKXgibi pazar yerlerinde görünmesini görmelisiniz ve oradan satışa başlayabilirsiniz!

"Create Token" düğmesini kullanma

Aslında bu, yukarıdakinden daha doğrudan bir yoldur ve thirdweb'e yeni eklenmiş bir özelliktir.

1. thirdweb kontrol panelinizde herhangi bir proje klasöründen, sol kenar çubuğunda "Tokens" seçeneğine tıklayın:

2. Açılan "Tokens" sayfasında sağ taraftaki "Create Token" düğmesine tıklayın. Bir modal pencere açılır ve 2 seçenek gösterir; "Create NFT Collection" seçeneğini seçin.

3. Bu sizi adım adım bir sürüme götürecektir: TokenERC721 dağıtım sayfasının (aslında bir ERC-721 Drop sözleşmesi dağıtacaktır). Bu sözleşme için gerekli tüm alanları doldurun, sonra "Next" düğmesine basın.

4. Sonraki ekran NFT'nin kendisi hakkındadır: görseli yükleyin ve görseli tanımlayan alanları doldurun, sonra "Next" düğmesine basın.

5. thirdweb şimdi başlatmak üzere olduğunuz NFT koleksiyonunun bir özetini gösterir. Her şeyin doğru olduğunu kontrol edin ve ardından "Launch NFT Collection" düğmesine tıklayın.

6. thirdweb, sözleşmeyi dağıtma, NFT'yi basma ve koşulları ayarlama işlerini tek seferde üstlenir. Web3 cüzdanınız üzerinden üç işlemi onaylamanız gerekecek.

7. Bu işlem tamamlandığında "View NFT" düğmesine tıklayın; thirdweb kontrol panelinize geri yönlendirileceksiniz ve bu sözleşmeye özel sayfa — ve ona bağlı NFT'ler — gösterilecektir.

Oradan, gerçekten zincirde olduğunu bir blok gezgini aracılığıyla kontrol edebilir veya NFT'nizi bir pazar yeri üzerinden satmaya başlayabilirsiniz.

Tek bir NFT'yi programatik olarak basma

İşte thirdweb v5 SDKkullanan bir kod örneği, bu örnek medya dosyasını IPFS'e yükler, metadata.json dosyasını oluşturur, sonra onu da IPFS'e yükler.

Bunun için şunlara ihtiyacınız olacak:

• Chiliz Chain üzerinde zaten dağıtılmış bir ERC-721 sözleşmesi. Bu durumda bunu thirdweb kullanarak yapmalısınız, başka bir araçla değil.

• thirdweb tarafından dağıttığınız ERC-721 sözleşmesine bağlı bir thirdweb API anahtarı. Bunu akıllı sözleşmenin proje sayfasında "Client ID" adı altında bulabilirsiniz.

• Yerel bir thirdweb SDK kurulumu. Bunu kullanarak yapabilirsiniz: npm:

npm install thirdweb dotenv

Buradaki dotenv parametresi bir .env dosyası oluşturur; bu özel değerleri saklamak için gereklidir:

THIRDWEB_SECRET_KEY=YOUR_TW_SECRET_KEY # thirdweb proje sayfanızdan.
PRIVATE_KEY=0xabc...                   # İşlemi gönderecek Web3 cüzdanı.
CONTRACT_ADDRESS=0xYour721Address      # Dağıttığınız TokenERC721 sözleşmeniz.
CHAIN_ID=88882                         # 88888=Mainnet, 88882=Spicy
IMAGE_PATH=./art/image.png             # Medya dosyanızın yerel yolu.
NAME=My Chiliz NFT
DESCRIPTION=Minted on Chiliz Chain

Asla PRIVATE_KEY veya THIRDWEB_SECRET_KEY istemci tarafı kodunda açığa çıkarmayın! Bu dosyayı güvenli bir sunucu/CI üzerinde tutun ve herkese açık bir depoya yüklemeyin

Şimdi her şey hazır olduğuna göre, bu betikten ilham alabilirsiniz; bu betik şunları yapacaktır:

1. Medya dosyasını IPFS'e yükleyecek

2. oluşturacak ve yükleyecek metadata.json dosyasını

3. Sözleşmenin mintTo metodunu kullanarak NFT'yi basacak.

4. Ortaya çıkan tokenId ve tokenUrl gibi bilgileri size gösterecek.

Bu sadece bir örnek koddur; kendi proje kodunuza uyarlamanız gerekecek!

import 'dotenv/config';
import fs from 'fs';
import path from 'path';

import { createThirdwebClient, getContract, sendTransaction, waitForReceipt, parseEventLogs } from "thirdweb";
import { defineChain } from "thirdweb/chains";
import { privateKeyToAccount } from "thirdweb/wallets";
import { mintTo, transferEvent, getNFT } from "thirdweb/extensions/erc721";
import { upload } from "thirdweb/storage";

function guessMime(p: string) {
  const ext = path.extname(p).toLowerCase();
  if (ext === ".png") return "image/png";
  if (ext === ".jpg" || ext === ".jpeg") return "image/jpeg";
  if (ext === ".webp") return "image/webp";
  if (ext === ".gif") return "image/gif";
  if (ext === ".mp4") return "video/mp4";
  if (ext === ".webm") return "video/webm";
  return "application/octet-stream";
}

async function main() {
  const client = createThirdwebClient({ secretKey: process.env.THIRDWEB_SECRET_KEY! });
  const chain = defineChain(Number(process.env.CHAIN_ID)); // 88888 veya 88882
  const account = privateKeyToAccount({ client, privateKey: process.env.PRIVATE_KEY! });

  const contract = getContract({
    client,
    chain,
    address: process.env.CONTRACT_ADDRESS as `0x${string}`,
  });

  // Medya dosyasını IPFS'e yükle
  const filePath = process.env.IMAGE_PATH!;
  const buffer = fs.readFileSync(filePath);
  const file = new File([buffer], path.basename(filePath), { type: guessMime(filePath) });

  const [imageUri] = await upload({ client, files: [file] }); // ipfs://... döner 
  // console.log("imageUri:", imageUri);

  // IPFS imageUri'ye referans veren metadata.json oluştur ve yükle
  const metadata = {
    name: process.env.NAME!,
    description: process.env.DESCRIPTION!,
    image: imageUri
  };
  const metaBlob = new Blob([JSON.stringify(metadata, null, 2)], { type: "application/json" });
  const metaFile = new File([metaBlob], "metadata.json", { type: "application/json" });

  const [metadataUri] = await upload({ client, files: [metaFile] });
  // console.log("metadataUri:", metadataUri);

  // metadata URI kullanılarak mintTo işlemi hazırla ve gönder
  // mintTo, tokenURI olarak doğrudan kullanılacak bir string kabul eder.
  const tx = mintTo({
    contract,
    to: account.address,
    nft: metadataUri, // TokenURI
  });

  const { transactionHash } = await sendTransaction({ transaction: tx, account });
  //console.log("tx:", transactionHash);

  const receipt = await waitForReceipt({ client, chain, transactionHash });

  // TokenId'yi göstermek için Transfer olayını ayrıştır
  const events = parseEventLogs({ logs: receipt.logs, events: [transferEvent()] });
  const minted = events.find(e => e.eventName === "Transfer" && e.args.from === "0x0000000000000000000000000000000000000000");
  const tokenId = minted ? (minted.args.tokenId as bigint) : undefined;
  //console.log("tokenId:", tokenId?.toString() ?? "(not found)");

  if (tokenId !== undefined) {
    const nft = await getNFT({ contract, tokenId });
    //console.log("tokenURI (read back):", nft.tokenURI);
  }
}

main().catch((err) => (console.error(err), process.exit(1)));

İlham almanız gereken önemli kısımlar şunlardır:

• upload dosyaları (ve JSON'u) IPFS'e depolar ve ipfs://… URI'leri döndürür.

• mintTo doğrudan kullanılmak üzere bir string (kabul eder) tokenURI.

• Standart ERC-721 Transfer olayını ayrıştırarak basılanı okuyoruz tokenId.

Programatik olarak bir NFT koleksiyonu basma

Bir NFT koleksiyonu basmak, tek bir NFT basmaktan çok farklı değildir. En belirgin fark, sizin .env dosyanızın tüm görselleri içeren klasöre IMAGE_DIRişaret etmesi, tek bir görsele işaret eden IMAGE_PATH.

THIRDWEB_SECRET_KEY=YOUR_TW_SECRET_KEY # thirdweb proje sayfanızdan.
PRIVATE_KEY=0xabc...                   # İşlemi gönderecek Web3 cüzdanı.
CONTRACT_ADDRESS=0xYour721Address      # Dağıttığınız TokenERC721 sözleşmeniz.
CHAIN_ID=88882                         # 88888=Mainnet, 88882=Spicy
yerine
IMAGE_PATH=./art                       # Medya dosyalarınızın yerel yolu.
DESCRIPTION=Minted on Chiliz Chain

NAME_PREFIX=My Chiliz NFT # Bu şuna dönüşecek: "My Chiliz NFT <n>"

import 'dotenv/config';
import fs from 'fs';
import path from 'path';

import { createThirdwebClient, getContract, sendTransaction, waitForReceipt, parseEventLogs } from "thirdweb";
import { defineChain } from "thirdweb/chains";
import { privateKeyToAccount } from "thirdweb/wallets";
import { mintTo, transferEvent, getNFT } from "thirdweb/extensions/erc721";
import { upload } from "thirdweb/storage";

function guessMime(p: string) {
  const ext = path.extname(p).toLowerCase();
  if (ext === ".png") return "image/png";
  if (ext === ".jpg" || ext === ".jpeg") return "image/jpeg";
  if (ext === ".webp") return "image/webp";
  if (ext === ".gif") return "image/gif";
  if (ext === ".mp4") return "video/mp4";
  if (ext === ".webm") return "video/webm";
  return "application/octet-stream";
}

Burada sunduğumuz örnek kod bu durumu dikkate alır:
// Tüm dosyaları toplamanın bir yolu
  function listMediaFiles(dir: string) {
  const allow = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif", ".mp4", ".webm", ".svg"]);
    return fs
    .readdirSync(dir)
    .filter((f) => allow.has(path.extname(f).toLowerCase()))
}

async function main() {
  const client = createThirdwebClient({ secretKey: process.env.THIRDWEB_SECRET_KEY! });
  const chain = defineChain(Number(process.env.CHAIN_ID)); // 88888 veya 88882
  const account = privateKeyToAccount({ client, privateKey: process.env.PRIVATE_KEY! }); 

  const contract = getContract({
    client,
    chain,
    address: process.env.CONTRACT_ADDRESS as `0x${string}`,
  });

  .map((f) => path.join(dir, f));
  // Bir klasördeki medya dosyalarını IPFS'e yükle
  const dirPath = process.env.IMAGES_DIR!;
  const filePaths = listMediaFiles(dirPath);
    if (!filePaths.length) {
  }

  throw new Error(`No media files found in ${dirPath}`);
    const fileObjs = filePaths.map((p) => {
    const buffer = fs.readFileSync(p);
  });

  return new File([buffer], path.basename(p), { type: guessMime(p) });
  const imageUris = await upload({ client, files: fileObjs }); // ["ipfs://...", ...] döner

  //console.log("Uploaded images to IPFS:", imageUris.length, "files");
  // Her imageUri'ye referans veren metadata.json oluştur ve yükle
  // NAME ve DESCRIPTION çevresel değişkenlerini kullanır; isimler "<NAME> #<index>" olur
  const namePrefix = process.env.NAME!;

  const description = process.env.DESCRIPTION!;
  // metadata JSON'ları için bir File dizisi oluştur
    const metadata = {
      const metaFiles = imageUris.map((imageUri, i) => {
      name: `${namePrefix} #${i + 1}`,
      image: imageUri
    };
    const metaBlob = new Blob([JSON.stringify(metadata, null, 2)], { type: "application/json" });
    description,
  });

  return new File([metaBlob], `metadata-${i + 1}.json`, { type: "application/json" });
  const metadataUris = await upload({ client, files: metaFiles }); // ["ipfs://.../metadata-1.json", ...]

  //console.log("Uploaded metadata files to IPFS:", metadataUris.length);
  // metadata URI'lerini kullanarak mintTo işlemlerini hazırla ve gönder (sıralı)

  const ZERO = "0x0000000000000000000000000000000000000000";
    for (let i = 0; i < metadataUris.length; i++) {

    const tx = mintTo({
      contract,
      to: account.address,
      nft: metadataUri, // TokenURI
    });

    const { transactionHash } = await sendTransaction({ transaction: tx, account });
    const metadataUri = metadataUris[i];

    const receipt = await waitForReceipt({ client, chain, transactionHash });

    console.log(`[${i + 1}/${metadataUris.length}] tx:`, transactionHash);
    const events = parseEventLogs({ logs: receipt.logs, events: [transferEvent()] });
    // Bu mint için tokenId'yi almak üzere Transfer olayını ayrıştır
      const minted = events.find(
    );
    const tokenId = minted ? (minted.args.tokenId as bigint) : undefined;

    (e) => e.eventName === "Transfer" && typeof e.args.from === "string" && e.args.from.toLowerCase() === ZERO
    if (tokenId !== undefined) {
      const nft = await getNFT({ contract, tokenId });
      // console.log(`[${i + 1}/${metadataUris.length}] tokenId:`, tokenId?.toString() ?? "(not found)");
    }
  }
}

main().catch((err) => (console.error(err), process.exit(1)));

// console.log(`[${i + 1}/${metadataUris.length}] tokenURI (read back):`, nft.tokenURI);

• Detaylı değişiklikler şunlardır: IMAGES_DIR IMAGE_PATH.

• ile değiştirildi Eklenen listMediaFiles

• birden çok girdiyi toplamak için. upload Görüntüler ve metadata için toplu işlemler (sıralamayı korur).

• Her mintTo metadataUri üzerinde döngü , her birolayı kendi Transfer için ayrıştırma. tokenId.

• İsimler otomatik numaralandırılır: NAME #1, NAME #2, … mevcut NAME/DESCRIPTION.

Yine, lütfen bunu kendi kodunuz için bir ilham kaynağı olarak kullanın, aynen kopyalamayın!

Not: Lazy minting yapmak isterseniz, thirdweb'ün ERC-721 sözleşmesi şuna sahip lazyMint metodu.