SuperAPI AI 工具集

sumsub-resolve-currency

安全与审计

查看项目

更新于 10-15 21:05

技能介绍

用途:解析并校验 Sumsub 交易中期望的货币字段,包括 info.currencyCode、info.currencyType、info.cryptoParams.cryptoChain,以及 info.amountInDefaultCurrency 与 info.defaultCurrencyCode。

主要能力:法币侧是 ISO 4217 代码的成员测试;加密侧需把(符号、链、可选合约地址)解析为唯一资产。接口为 GET /resources/kyt/currency?type=crypto 与 ?type=fiat,省略 type 返回法币列表。加密条目含 currencyCode、cryptoChain、contractAddress、chainId、name、coinmarketcapId、coingeckoId。链列表需从加密目录的 cryptoChain 去重推导,无公开接口;无汇率接口。

使用方式:认证用 App Token + secret,仅限沙箱令牌(除非 SUMSUB_ALLOW_PROD=1),环境变量为 SUMSUB_APP_TOKEN、SUMSUB_SECRET_KEY、可选 SUMSUB_BASE。脚本:${CLAUDE_SKILL_DIR}/scripts/get_currencies.sh crypto(或 fiat)获取目录并缓存;${CLAUDE_SKILL_DIR}/scripts/resolve_currency.py 传入目录与查询进行解析。链名会先大写、去空格并映射固定别名表(如 ETHEREUM、BSC、TRC20、MATIC、POLYGON、BEP20、TRON、SOLANA、AVAX_C 等),表外字符串原样使用。

关键规则:符号不等于资产,同一符号可能对应多条链上资产;空 cryptoChain 表示该链原生币。匹配到多行时服务器记录 Multiple currencies found 并返回空,不选默认值。amountInDefaultCurrency 影响 Travel Rule 与未托管钱包阈值判断,且在交易创建时冻结。

适用场景:创建交易前确定要发送的货币字段、排查货币未识别问题、处理 Travel Rule 交换中的资产词汇覆盖。

限制:仅沙箱令牌;无公开链列表与汇率接口;别名表未通过接口暴露;部分资产缺少 Travel Rule 协议映射,可能导致 notEnoughCounterpartyData。