# thirdweb

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/thirdweb

含 TypeScript SDK 的 Web3 开发平台；本档案聚焦 v5 合约状态读取与 v4 迁移排查。

官方入口：https://portal.thirdweb.com/typescript/v5
类别：开发与基础设施
网络：具体支持网络见官方文档
访问条件：SDK 初始化要 clientId 或服务器端 secretKey；只读合约调用独立于钱包签名。托管服务按账户权限使用。
费用：文档允许免费创建 Client ID；具体 RPC、存储与其他托管服务的配额/费用须按当前账户套餐，不能由 Client ID 免费推导。

## 用途
- 用完整 Solidity 签名读取状态
- 诊断 tokenURI 查询失败
- 核对 v4/v5 导入
- 区分 Client ID 与服务器 Secret Key

## 使用边界
- 具体教程针对 v5 的 thirdweb 包；v4 @thirdweb-dev/sdk/react API 不可混用。
- 当前读取示例为 Sepolia 配置，未取得各主网及各产品的支持矩阵，网络筛选暂留空。
- SDK、HTTP API、Wallets 和 Bridge 的权限、价格与范围不同，不能将一个接口能力套用到全部产品。
- 返回 tokenURI 仅说明该读取的返回值，不证明元数据可访问、NFT 所有权或已铸造成交。

## 操作教程
- [thirdweb v5 查不到 tokenURI：核对版本、签名和读取状态](https://lianxiaozhi.com/tools/guides/thirdweb-v5-token-uri-read)：从 v4/v5 混用、客户端初始化和 uint256 参数入手，确认读取到底得到 URI 还是遇到 RPC/合约错误。

## 相关知识

## 官方依据
- [thirdweb SDK v5：Client ID 与 Secret Key](https://portal.thirdweb.com/typescript/v5/client)
- [thirdweb：readContract 与 Solidity 签名](https://portal.thirdweb.com/references/typescript/latest/readContract)
- [thirdweb：从 v4 迁移到 v5](https://portal.thirdweb.com/typescript/v5/migrate)