Rarible ile mint etme

Rarible, birkaç EVM ağı üzerinde NFT uygulamaları oluşturmak için SDK'lar ve API'ler sunan çok zincirli bir NFT protokolü ve pazaryeridir.

NFT basımı için Rarible Multichain SDK kendi veya paylaşılan koleksiyonlarınıza basım yapmanıza ve hemen satış emirleri oluşturmanıza olanak tanır.

Rarible SDK, IPFS yüklemesini işlemediği için, buradaki örneklerimiz Pinata bir IPFS barındırıcısı olarak kullanır. Bir JWT anahtarı elde etmek için bir Pinata hesabına ihtiyacınız olacak.

Ayrıca sizden şunlara sahip olmanız istenecek:

• Chiliz Chain üzerinde önceden dağıtılmış bir ERC-721 kontratı. Bir OpenZeppelin ERC-721 kontratı Chiliz Chain üzerine kendiniz dağıtmanız gerekir. Remix IDE bunu tarayıcı içinde yapmanızı sağlar. Kontratı bir blok gezgini kullanarak doğrulamayı unutmayın!

• Bir Rarible API anahtarı. Bir tane nasıl elde edeceğinizi öğrenmek için Getting Started bölümüne bakın:

Getting StartedRarible

Rarible SDK'yı kullanmak için birkaç kurulum yapmamız gerekiyor:

npm i @rarible/sdk @rarible/types ethers dotenv pinata

Şunu kullandığımızı fark edeceksiniz: ethers, bu da viem yerine bir alternatiftir; bunu diğer bölümlerde kullandık. Gerçekten de, Rarible, geliştiricilere Web3 cüzdanlarıyla çalışmak için ethers.js veya web3.js kullanmalarını önerir — ve web3.js Mart 2025'te kullanımdan kaldırıldı, geriye yalnızca ethers fiili tercih olarak kalıyor.

NFT koleksiyonu basma

İlk olarak, .env dosyanızı oluşturun:

# Chiliz RPC
RPC_URL=https://spicy-rpc.chiliz.com       # veya bir Mainnet RPC
PRIVATE_KEY=0xabc...                       # basıcının anahtarı (SADECE sunucu tarafında)

# Rarible
RARIBLE_API_KEY=your_rarible_api_key
COLLECTION_ADDRESS=0xYourCollectionOnChiliz
SUPPLY=1                                   # 1 = ERC-721, >1 = ERC-1155

# Pinata
PINATA_JWT=eyJhbGciOi...                   # panodan alınan Pinata JWT
PINATA_GATEWAY=your-subdomain.mypinata.cloud

# Medya / metadata girdileri
IMAGE_PATH=./art/image.png
NAME=My Chiliz NFT
DESCRIPTION=Rarible SDK aracılığıyla zincir üstünde basıldı

Tercih ettiğimiz iş akışı şudur:

1. Medyayı Pinata aracılığıyla IPFS'ye yükle

2. Metadata dosyasını oluştur ve yükle

3. Rarible SDK + zincir üstü basım

İlham alabileceğiniz tam örnek betik burada:

import 'dotenv/config'
import fs from 'fs'
import path from 'path'
import { Wallet, JsonRpcProvider } from 'ethers'
import { createRaribleSdk } from '@rarible/sdk'
import { toCollectionId, toUnionAddress } from '@rarible/types'
import { PinataSDK } from 'pinata'

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() {
  // Medyayı IPFS'ye yükle
  const pinata = new PinataSDK({
    pinataJwt: process.env.PINATA_JWT!,
  })

  const mediaPath = process.env.IMAGE_PATH!
  const mediaBlob = new Blob([fs.readFileSync(mediaPath)], { type: guessMime(mediaPath) })
  const mediaFile = new File([mediaBlob], path.basename(mediaPath), { type: guessMime(mediaPath) })

  const mediaUpload = await pinata.upload.public.file(mediaFile)
  const imageUri = `ipfs://${mediaUpload.cid}`
  // console.log('imageUri:', imageUri)

  // Metadata dosyasını oluştur ve yükle
  const metadata = {
    name: process.env.NAME!,
    description: process.env.DESCRIPTION!,
    image: imageUri,
    // animation_url: "ipfs://<cid>/video.mp4",
    // attributes: [{ trait_type: "Tier", value: "Gold" }],
  }
  const metaUpload = await pinata.upload.public.json(metadata)
  const metadataUri = `ipfs://${metaUpload.cid}`
  // console.log('metadataUri:', metadataUri)

  // Rarible zincir üstü basım
  const provider = new JsonRpcProvider(process.env.RPC_URL!)
  const wallet = new Wallet(process.env.PRIVATE_KEY!, provider)
  const sdk = createRaribleSdk(wallet, 'prod', { apiKey: process.env.RARIBLE_API_KEY! })

  // Union ID'leri "<BLOCKCHAIN>:<address>" biçimini kullanır — burada BLOCKCHAIN "CHILIZ"
  const collectionId = toCollectionId(`CHILIZ:${process.env.COLLECTION_ADDRESS}`)
  const creator = toUnionAddress(`CHILIZ:${wallet.address}`)

  const { transaction, itemId } = await sdk.nft.mint({
    collectionId,
    uri: metadataUri,
    supply: Number(process.env.SUPPLY || 1), // 721 için 1, 1155 için >1
  })

  const { hash } = await transaction.wait()
  console.log('Basılan öğe:', itemId, 'tx:', hash)
}

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

Bir NFT koleksiyonunu lazy mint etme

Lazy Minting, bir NFT'yi satışa koymadan önce basmanın peşin maliyetini ödemek istemeyenler için bir seçenektir. NFT'lerini satın alınmak üzere listeleyebilir, ardından yalnızca satın alındığında veya transfer edildiğinde basabilirler. Bu nedenle gas ücretleri basım sürecinin bir parçasıdır ve alıcı tarafından ödenir.

Kısacası, lazy minting, NFT'nin blok zincirine satın alma gerçekleşmeden önce değil, ancak biri NFT'yi satın aldığında eklenmesi demektir.

Düzgün tanımlanmış bir .env dosyasına ihtiyacınız olacak:

# Chiliz RPC / cüzdan
RPC_URL=https://spicy-rpc.chiliz.com
PRIVATE_KEY=0xabc...                         # oluşturucunun anahtarı (gizli tutun)

# Rarible
RARIBLE_API_KEY=your_rarible_api_key
COLLECTION_ADDRESS=0xYourCollectionOnChiliz   # ERC-721 veya ERC-1155

# Pinata
PINATA_JWT=eyJhbGciOi...                      # panodan alınan Pinata JWT
PINATA_GATEWAY=your-subdomain.mypinata.cloud  # isteğe bağlı (önizlemeler için)

# Medya / metadata
IMAGE_PATH=./art/image.png
NAME=My Chiliz NFT
DESCRIPTION=Rarible üzerinde lazy-minted (Chiliz)
SUPPLY=1                                      # 721 için 1; 1155 edisyonları için >1

Ve şimdi projenizi lazy mint etmek için örnek kod:

import 'dotenv/config'
import fs from 'fs'
import path from 'path'
import { Wallet, JsonRpcProvider } from 'ethers'
import { createRaribleSdk } from '@rarible/sdk'
import { toCollectionId, toUnionAddress } from '@rarible/types'
import { PinataSDK } from 'pinata'

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() {
  // Medyayı IPFS'ye yükle
  const pinata = new PinataSDK({
    pinataJwt: process.env.PINATA_JWT!,
  })

  const mediaPath = process.env.IMAGE_PATH!
  const mediaBlob = new Blob([fs.readFileSync(mediaPath)], { type: guessMime(mediaPath) })
  const mediaFile = new File([mediaBlob], path.basename(mediaPath), { type: guessMime(mediaPath) })
  const mediaUp = await pinata.upload.public.file(mediaFile)
  const imageUri = `ipfs://${mediaUp.cid}`

  const metadata = {
    name: process.env.NAME!,
    description: process.env.DESCRIPTION!,
    image: imageUri,
    // animation_url: "ipfs://<cid>/video.mp4",
    // attributes: [{ trait_type: "Tier", value: "Gold" }],
  }
  const metaUp = await pinata.upload.public.json(metadata)
  const metadataUri = `ipfs://${metaUp.cid}`

  // Rarible lazy mint
  const provider = new JsonRpcProvider(process.env.RPC_URL!)
  const wallet = new Wallet(process.env.PRIVATE_KEY!, provider)
  const sdk = createRaribleSdk(wallet, 'prod', { apiKey: process.env.RARIBLE_API_KEY! })
  const collectionId = toCollectionId(`CHILIZ:${process.env.COLLECTION_ADDRESS}`)
  const creator = toUnionAddress(`CHILIZ:${wallet.address}`)

  // Lazy mint'i hazırla ve gönder (zincir dışı öğe; alıcı satın alırken basar)
  const prepared = await sdk.nft.mint.prepare({ collectionId })
  const result = await prepared.submit({
    uri: metadataUri,
    supply: Number(process.env.SUPPLY || 1),     // 721 için 1; 1155 için >1
    lazyMint: true,                              // Evet, lütfen lazy olsun
    creators: [{ account: creator, value: 10000 }], // %100'ü cüzdanınıza gider
    royalties: [],                               // ör. %5 için [{ account: creator, value: 500 }]
  })

  // console.log('Lazy itemId:', result.itemId)
}

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