@renaiss-protocol/client 包含供外部账户（EOA）使用的抽卡、市场和兑换客户端。不同版本自带各自的响应校验器。部署实际提供的接口见 HTTP 参考。
版本兼容性
0.1.0-beta.4 预期较早版本的目录响应结构。即使 HTTP 请求成功，卡包列表和市场列表方法也可能返回 INVALID_SCHEMA。如需读取当前卡包目录，请直接调用卡包列表接口。分档回购、按请求 ID 轮询、钱包收藏及包含当前 RIX 估值字段的兑换响应也请直接使用 HTTP。RIX 估值就是卡牌的预估公允市价（FMV）。
挂牌、出价、购买和接受买单时，请使用市场 HTTP 接口。0.1.0-beta.4 提交交易时会转发准备响应中的整个 payload。提交接口要求使用准备响应顶层的 tokenId，并会拒绝额外的 collectibleId 字段。
购买或结账后解析失败时，交易结果仍待确认。先查询原请求或订单的状态，再决定是否重新签名。
安装
使用 Node.js 24 或以上版本并锁定测试版版本号。使用下面的钱包适配器时还需安装viem。
客户端
将
baseUrl 设为 API 来源或后端代理前缀，省略 /v2，并显式传入对应的 network。只在后端保管 builderApiKey。浏览器可以调用自己的后端，由后端逐条授权并添加所需的请求头。
使用已有钱包
signInRedemptionWallet({ origin }) 开始配送会话。用户退出或切换钱包时调用 signOutRedemptionWallet()。
处理结果
code、status 和 detail，底层 HTTP 错误可能位于 error 中。列表方法返回按需加载的分页器。调用 .firstPage() 读取一页或使用 for await 迭代。通过 .from(nextCursor) 继续读取时应保留原筛选条件。
金额与标识符
例如，viem 的
parseUnits('10', 18) 返回 10 USDT 对应的最小单位数量。卡牌没有估值时，应保留 null。