跳到正文
← 使用教程

Crossmint signer 显示 pending?按链核对签名者、恢复方法和付费方

链小知 · 进阶 · 核验 · 依官方文档整理

审核已有 wallet details 或 SDK 结果,分开日常签名者与恢复方法,检查导出按钮缺失及 Solana 费用条件。

开始前准备

  • 准备本人公开地址、目标链、staging/production 标识及已有脱敏 wallet details 或 signer 结果;可由应用支持提供,勿粘贴 API key 或 JWT。
  • 官方读取接口需要 wallets.read 权限;本教程可审核已有结果,公开地址不是匿名调用认证接口的许可。
  • 检查对象是 Crossmint Wallets;Checkout、onramp、身份验证和项目成员管理的权限不能代替钱包 signer 权限。

1. 先对齐环境、链与钱包

记录已有结果来自 staging.crossmint.com 还是 www.crossmint.com,以及 Base Sepolia 等测试链还是主网。两环境的项目、密钥和钱包独立,不按同一个邮箱认定地址相同。

用完整 wallet address 和 chain 定位这份记录;不匹配或只有测试环境结果时,不能解释生产账户的权限或余额。环境总览的赞助描述留待具体产品费页核对。

检查结果:环境、链和地址形成同一组查询对象,没有跨环境合并结果。

2. 读 signer 字段与状态

SDK wallet.signers() 的结果查看 type、locator、status;REST wallet details 在 config.delegatedSigners。把 success、pending、awaiting-approval、failed 分开记录,pending 或等待恢复批准不能记成已激活。

EVM 列表只返回当前钱包链的批准项,其他链另查。服务端 getWallet 处于 read-only 时 wallet.signer 可为 undefined,但读取 signers 仍可用;这不自动证明没有注册 signer。

检查结果:逐项记录类型、唯一定位符和状态,并明确该结果只覆盖所选链。

3. 另查恢复方法及控制方

读取 SDK wallet.recoveryMethods 或 REST config.recoveryMethods,避免从 signers 列表推断恢复方式为空。记录 email、phone、passkey、server、external wallet 或 KMS 的方法及谁能使用。

恢复方法可授权增删 signer,也可能发送交易;因此本人持有 device signer 并不排除组织通过自己的恢复方法操作。将具体可执行权限写清楚,不根据登录名称单独认定托管或非托管。

检查结果:日常 signer 与恢复方法分成两张明确记录,未看见完整恢复配置时标待核。

4. 排查导出按钮为何没出现

ExportPrivateKeyButton 针对 email/phone signer;客户端 key 需 wallets.export,钱包已创建且可访问。passkey、external-wallet 等类型按设计不走该私钥导出入口,组件可能不渲染。

核对应用的 signer 类型、导出 scope 与钱包加载状态,不为出现按钮改 signer 或重复注册。已有 wallets.signer.exported 事件只会在每个钱包首次导出时发送,不含密钥;缺第二次事件不能证明第二次导出失败。

检查结果:按钮缺失被归入类型、权限、加载或未知原因;没有把一次 webhook 当完整恢复验收。

5. 按 Solana 产品检查费用与失败

目标是 Solana smart wallet 时,在应用提供的项目设置记录中核对 Wallets → Settings 的 Fee Payer:You 使用项目 credits 并计入项目账单,Executing Wallet 由执行钱包付款,可有 SOL/USDC 选项。

具体费页说明 staging 默认赞助、新 production 默认 Executing Wallet,生产项目赞助需开通;每用户 spending limits 属 private access。这些条件不适用于所有链。费用不足、未开通或 signer 状态失败时,保留错误和待办,勿将环境总览的赞助表述当本次免费保证。

检查结果:报告 signer 当前阶段、恢复控制方、导出资格和目标产品付费方;费用与权限失败单独列出。

怎样确认完成

  • 保存同环境、同链、同地址的 signer 及恢复记录,区分所有状态。
  • 导出资格与 Solana Fee Payer 有具体配置依据或明确待核;不扩大成所有链覆盖。
  • 本文核验为文档,没有认证接口查询、signer 变更、导出或交易回执。

常见错误与边界

  • 多恢复方法存在不等于每次操作都要所有方法共同确认。
  • EVM 链过滤、SDK/REST 字段差异和 read-only wallet 都可能造成误读。
  • 项目付费的赞助不是基础设施或网络总成本为零。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据