Codex 插件【Alchemy】：访问链上数据

Alchemy 插件就像一个面向区块链的数据查询助手。它可以让 Codex 直接访问链上数据，查询钱包资产、代币价格、交易记录、NFT、区块、智能合约和网络状态，减少手动查阅区块浏览器或编写底层 RPC 请求的工作。

Alchemy 通过模型上下文协议（Model Context Protocol，MCP）连接 AI 编程工具，覆盖 Ethereum、Base、Polygon、Arbitrum、Optimism、Solana、Starknet 等多种网络。

一、Alchemy 能做什么

图 1：Alchemy 查询和分析链上数据的基本流程

1、查询钱包资产

用户可以提供钱包地址或 ENS 名称，让插件查询其持有的原生代币、ERC-20 代币和 NFT。

例如，可以查看某个地址在不同网络上的代币余额、资产分布和 NFT 列表，为钱包应用、资产看板和用户画像提供数据。Alchemy 的 Portfolio API 支持查询可替代代币、NFT 和交易信息。

2、查询交易与转账记录

Alchemy 可以根据钱包地址、合约地址或交易哈希查询历史活动。

查询结果可以包含发送方、接收方、区块高度、时间、资产类型、数量和交易状态。Transfers API 还能统一检索外部交易、内部转账以及代币转移，避免逐个扫描历史区块。

3、查询代币与 NFT 数据

插件可以查询代币余额、价格和合约信息，也可以获取 NFT 的名称、图片、属性、集合信息和持有者数据。

Alchemy 的 NFT API 支持 ERC-721 和 ERC-1155，可以按钱包、合约地址和 Token ID 查询 NFT 及其元数据。

4、读取区块与智能合约

通过节点 API，Codex 可以读取区块、交易、事件日志、合约代码和链上状态，也可以调用智能合约的只读方法。

在开发去中心化应用时，这些数据可用于验证合约行为、排查交易失败、分析事件记录和生成测试数据。Alchemy 的 Node API 基于标准 JSON-RPC，并支持查询区块、日志和状态。

5、模拟和分析交易

在真正提交交易前，可以先模拟合约调用，检查执行结果、状态变化、Gas 使用情况和可能出现的错误。

Alchemy MCP 还提供交易追踪、合约模拟、账户抽象和智能钱包等工具，适合辅助调试 Web3 应用。

二、怎样把任务说清楚

使用 Alchemy 时，应说明网络、查询对象、数据范围和输出形式。

至少应提供以下信息：

1、区块链网络：Ethereum、Base、Polygon、Solana 或其他网络。

2、查询对象：钱包地址、ENS、交易哈希、合约地址或 Token ID。

3、数据类型：余额、交易、NFT、价格、事件日志或合约状态。

4、时间范围：最新状态、指定区块或一段历史记录。

5、输出方式：摘要、表格、JSON、异常分析或代码示例。

可以使用下面的模板：

请使用 Alchemy 插件查询并分析链上数据。

区块链网络：[网络名称]

查询对象：[钱包 / 交易 / 合约 / 代币]

地址或哈希：[具体内容]

数据范围：[余额、交易、NFT、日志等]

时间范围：[最新 / 区块范围 / 日期范围]

输出要求：[表格、摘要、JSON 或分析报告]

完成后请说明：数据来源网络、查询结果、关键字段、异常情况和需要进一步验证的内容。

三、场景示例

示例 1：查看钱包资产

查询指定地址在 Ethereum 和 Base 上的代币余额、NFT 和最近交易，并按资产类型整理。

示例 2：分析交易失败

根据交易哈希查询交易状态、调用路径、事件日志和失败原因，并指出可能出错的合约步骤。

示例 3：追踪代币转移

查询某个 ERC-20 合约最近的转账记录，列出发送地址、接收地址、数量和区块时间。

示例 4：检查 NFT 持仓

查询指定钱包持有的 NFT，按集合分类，并提取名称、Token ID 和元数据。

示例 5：辅助开发链上应用

读取目标合约的状态和事件记录，生成调用代码，并使用模拟结果检查参数和返回值。

四、使用时要注意

1、明确网络与地址

相同地址可能出现在多个网络中。查询时应明确主网、测试网和具体区块链，避免混淆结果。

2、区分余额与价格

链上余额来自区块链状态，价格通常来自额外的数据服务。价格可能存在更新时间和流动性差异，不宜直接视为成交价格。

3、处理分页与数据范围

活跃地址可能包含大量交易和资产。应设置时间、区块或数量限制，并正确处理分页结果。

4、保护密钥和签名权限

查询公开数据通常不需要钱包私钥。不要在提示词、代码或日志中暴露助记词、私钥和长期有效的 API 密钥。

5、核对高风险操作

交易模拟不等于交易一定成功。提交转账、授权或合约调用前，仍应核对网络、地址、金额、Gas、授权范围和合约安全性。

小结

Alchemy 插件可以让 Codex 查询钱包、交易、代币、NFT、区块和智能合约数据，并辅助交易模拟与故障分析。明确网络、地址、数据范围和输出格式，是获得可靠结果的关键。

“点赞有美意，赞赏是鼓励”