防机器人保护最佳实践

https://yourproject.com/metadata/0.json
https://yourproject.com/metadata/1.json
https://yourproject.com/metadata/2.json

import fs from "fs";
import mime from "mime";
import { createGenericFile } from "@metaplex-foundation/umi";

const umi = // 导入或创建您的 umi 实例。

// 上传文件 - UMI 自动创建不可预测的交易 ID
async function uploadFiles(filePaths: string[]): Promise<string[]> {
  const files = filePaths.map((filePath) => {
    const file = fs.readFileSync(filePath);
    const mimeType = mime.getType(filePath);
    return createGenericFile(file, "file", {
      tags: mimeType ? [{ name: "content-type", value: mimeType }] : [],
    });
  });

  const uploadedUris = await umi.uploader.upload(files);

  // 记录每个上传的 URI 及其索引以便跟踪
  uploadedUris.forEach((uri, index) => {
    console.log(`已上传文件 #${index} -> ${uri}`);
  });

  return uploadedUris;
}

// 关键：存储所有返回的 URI - 您将需要它们进行揭示映射！
const uploadedUris = await uploadFiles(allFilePaths);

// 结果：必须存储的自动不可预测 URI
// uploadedUris[0] = "https://arweave.net/BrG44HdsEhzapvs8bEqzvkq4egwevS3fRE6kLuCyOdCd"
// uploadedUris[1] = "https://arweave.net/9jK3LpM7NqR5xY8vZ2BwC4tE6gH9sF1D3a7Q8eR2nM4K"
// uploadedUris[2] = "https://arweave.net/5tH8GpN3MqL7wV9xB2CeD4yR6kJ1sK3F8gQ7eP5nL9M2"
// ... 您所有文件的其余部分

// 安全存储这些 - 您无法重新生成它们！
// 这些 URI 来自通过 UMI 的底层服务（Irys/ArDrive Turbo）
fs.writeFileSync("./uploaded-uris.json", JSON.stringify(uploadedUris, null, 2));
await securelyStoreUris(uploadedUris);

{
  "name": "神秘资产",
  "description": "此资产将在铸造完成后揭示。每个资产都是独特的，很快将揭示其真实特征和稀有度！",
  "image": "https://yourproject.com/images/mystery-box.png",
  "attributes": [
    {
      "trait_type": "状态",
      "value": "未揭示"
    },
    {
      "trait_type": "集合",
      "value": "您的项目名称"
    }
  ]
}

https://yourproject.com/metadata/placeholder.json

// 在创建 Candy Machine 之前生成安全映射
function generateSecureMapping(totalSupply: number): number[] {
  // 创建索引数组 [0, 1, 2, ..., totalSupply-1]
  const indices = Array.from({ length: totalSupply }, (_, i) => i);

  // 使用密码学安全的洗牌（Fisher-Yates）
  for (let i = indices.length - 1; i > 0; i--) {
    const j = Math.floor(crypto.getRandomValues(new Uint32Array(1))[0] / (2**32) * (i + 1));
    [indices[i], indices[j]] = [indices[j], indices[i]];
  }

  return indices;
}

// 示例：对于 4000 NFT 集合
const secureMapping = generateSecureMapping(4000);
// 结果：[2847, 91, 3756, 128, 2904, 567, ...]
// 这意味着：
// - 铸造索引 0 将揭示为元数据索引 2847
// - 铸造索引 1 将揭示为元数据索引 91
// - 铸造索引 2 将揭示为元数据索引 3756
// 等等。

// 安全存储此映射 - 它是您的揭示密钥！
await storeMapping(secureMapping);

const guards = {
  thirdPartySigner: {
    signerKey: backendSignerWallet.publicKey,
  },
  botTax: {
    lamports: sol(0.01), // 失败尝试的税费
    lastInstruction: true,
  },
  solPayment: {
    lamports: sol(0.1), // 铸造价格
    destination: treasuryWallet.publicKey,
  },
};

// pages/api/mint.ts（Pages Router）或 app/api/mint/route.ts（App Router）
import type { NextApiRequest, NextApiResponse } from 'next';

export default async function handler(req: NextApiRequest, res: NextApiResponse) {
  if (req.method !== 'POST') {
    return res.status(405).json({ error: '方法不允许' });
  }

  try {
    // 1. 验证用户（速率限制、验证码等）
    const { userWallet } = req.body;

    // 2. 生成带有所需守卫的铸造交易。
    // 您可能需要从前端提供额外的守卫参数。
    const mintTransaction = await mintV1(umi, {
      candyMachine: candyMachine.publicKey,
      asset: generateSigner(umi),
      minter: createNoopSigner(userWallet),
      mintArgs: {
        thirdPartySigner: {
          signer: backendSigner,
        },
      },
    }).buildWithLatestBlockhash(umi);

    // 3. 使用后端签名者部分签名
    const signedTransaction = await backendSigner.signTransaction(mintTransaction);

    // 4. 返回交易供用户在前端签名
    res.json({
      transaction: base64.encode(signedTransaction.serialize()),
      asset: mintTransaction.asset.publicKey.toString(),
    });

  } catch (error) {
    res.status(500).json({ error: '铸造失败' });
  }
}