在蓬勃发展的Web3世界中,ZORA正以其独特的“去中心化创作与分发协议”而备受瞩目，它不仅为艺术家和创作者提供了一个无需许可的平台，让任何人都能轻松铸造和销售NFT，更重要的是，它通过开放、强大的API接口，赋予了开发者无与伦比的灵活性，可以基于ZORA构建丰富的应用和体验，本文将为您全面解析ZORA币（及其原生代币$ZORA）的API接口调用，助您顺利迈入ZORA生态的开发大门。

初识ZORA API：不仅仅是代币，更是一个生态

在深入代码之前,我们首先要明确一点：ZORA的核心是一个协议，而$ZORA是其治理代币，ZORA API接口的功能远不止查询代币余额或转账那么简单，它涵盖了整个ZORA生态的核心功能，包括：

• NFT铸造与销售：创建新的NFT，并为其设定价格进行销售。
• NFT交易市场：查询在售NFT、购买NFT、完成所有权转移。
• 链上事件查询：追踪铸造、购买、出价等关键链上活动。
• 创作者收益管理：处理版税和创作者分成。
• 代币相关操作：查询代币信息、持有者、转账等。

这些API接口是ZORA协议与外部世界沟通的桥梁,是构建DApp、数据仪表板、分析工具等上层应用的基础。

准备工作：调用API前的必要配置

在开始调用API之前,您需要准备以下几样“武器”：

1. Web3钱包：如MetaMask，并确保其中存有ETH（用于支付Gas费）和$ZORA代币（如果需要）。
2. Node.js环境：您的开发环境需要安装Node.js。
3. 包管理器：如npm或yarn。
4. Web3库：推荐使用ethers.js或web3.js，它们是与以太坊区块链交互的强大工具，本文将以目前更现代的ethers.js为例进行讲解。
5. API端点：ZORA提供了多个RPC节点服务，您可以选择一个稳定可靠的节点提供商，如Alchemy或Infura，并获取其HTTP端点。

核心API接口调用实战

我们将通过几个常见的场景,来演示如何使用ethers.js与ZORA协议进行交互。

连接钱包并获取账户信息

这是所有操作的第一步,我们需要连接用户的钱包并获取其签名者。

import { ethers } from 'ethers';
// 1. 初始化Provider，连接到以太坊网络
const provider = new ethers.providers.JsonRpcProvider('YOUR_INFURA_OR_ALCHEMY_ENDPOINT');
// 2. 获取钱包连接（通常通过dApp的浏览器注入，如window.ethereum）
const signer = provider.getSigner(); // 假设用户已连接
// 3. 获取钱包地址
const address = await signer.getAddress();
console.log('钱包地址:', address);
// 4. 查询ETH余额
const ethBalance = await provider.getBalance(address);
console.log('ETH余额:', ethers.utils.formatEther(ethBalance));
// 5. 查询$ZORA代币余额（需要知道ZORA代币的合约地址）
const zoraTokenAddress = '0x...'; // ZORA代币合约地址
const zoraTokenContract = new ethers.Contract(zoraTokenAddress, ['function balanceOf(address) view returns (uint256)'], provider);
const zoraBalance = await zoraTokenContract.balanceOf(address);
console.log('$ZORA余额:', ethers.utils.formatUnits(zoraBalance, 18)); // 18是$ZORA的decimals

铸造一个NFT

铸造NFT是ZORA的核心功能之一,这通常需要调用ZORA核心合约的特定函数，并支付Gas费。

// 假设我们已经有了signer和provider
// ZORA核心合约地址（请查阅最新文档获取准确地址）
const zoraCoreAddress = '0x...'; 
// NFT的合约ABI（简化版，实际更复杂）
const nftAbi = [
    "function createToken(string memory tokenURI, uint256 salePrice) external payable returns (uint256)"
];
const nftContract = new ethers.Contract(zoraCoreAddress, nftAbi, signer);
// 准备参数
const tokenURI = 'https://myapi.com/nft-metadata.json'; // NFT的元数据链接
const salePrice = ethers.utils.parseEther('0.1'); // 销售价，0.1 ETH
// 发起交易
const tx = await nftContract.createToken(tokenURI, salePrice, {
    value: salePrice, // 需要支付ETH作为购买款
    gasLimit: 500000  // 设置合理的Gas限制
});
// 等待交易确认
const receipt = await tx.wait();
console.log('NFT铸造成功! 交易哈希:', receipt.transactionHash);
// 从receipt中可以解析出新铸造的NFT的Token ID

查询在售的NFT

如果您想构建一个市场前端,查询在售NFT是必不可少的。