用途:验证用户是否拥有 Seeker 设备。SGT 是每台 Seeker 一次性铸造的 Token-2022 NFT,持有它可证明拥有 Seeker,适合用于奖励门槛和“一设备一次领取”逻辑。
主要能力:验证分两半,缺一不可。一是用 Sign-in-with-Solana(SIWS)证明用户控制钱包,二是检查钱包持有的 Token-2022 mint 以证明持有 SGT。只做第二半,任何人都能提交真实 Seeker 持有者的公开地址通过验证;只做第一半则只能证明钱包控制权,无法说明设备归属。验证必须在服务端进行,客户端只负责收集签名,服务端验证并持有结果;客户端可被篡改,客户端的 hasSGT 布尔值没有价值。
使用方式:需自控后端能调用 Solana 主网 RPC,存储 nonce 与领取记录,并使用主网 RPC 端点;付费提供商更稳妥,因为检查会读取钱包持有的所有 Token-2022 账户,密钥只放服务端,绝不放入 EXPO_PUBLIC_* 变量。前提是已有可用的钱包连接,否则先用 solana-mobile-wallet 技能;测试需要实体 Seeker 设备,模拟器无法持有 SGT,需准备无需设备即可走的代码路径,例如开发环境服务端 allowlist。步骤:服务端签发完整 SIWS payload 并以 nonce 为键短 TTL 存储,nonce 必须服务端生成、一次性、短生命周期;客户端用 signIn 展开 payload 并加入 address,仅回传 address、nonce、signature、signedMessage 四个字段;服务端安装 @solana/kit @solana/wallet-standard-util,先做形态校验,再从 address 派生公钥并用 verifySignIn 验证签名,绝不用请求体里的公钥;接着安装 @solana-mobile/skr-genesis-token @solana/kit,用 getSeekerGenesisTokens 检查 SGT 并返回全部 mint 地址;最后原子消费 nonce、验证签名、针对同一地址查 SGT。防女巫:SGT 按设备唯一,应存 mint 地址而非钱包地址,用数据库 UNIQUE 约束保证一次领取,插入成功后再发放奖励。
限制:SGT 仅存在于主网;RPC 失败应映射为 503 而非空列表;插入与发放是两次独立写入,需处理第二次失败时的重试或幂等;本项目未提供具体收费与价格信息。