SuperAPI AI 工具集

greenfield

数据与分析

查看项目

更新于 10-30 07:58

技能介绍

用途 该技能用于让 Claude 帮助用户操作 BNB Greenfield(由 BNB Chain 构建的去中心化存储网络)。用户可以通过它完成存储桶与对象的创建、查询、下载、删除,以及支付账户和存储提供商相关的链上操作。

主要能力 技能提供一组 MCP 工具,按类别包括:存储操作(gnfd_create_bucket、gnfd_delete_bucket、gnfd_list_buckets、gnfd_get_bucket_info、gnfd_get_bucket_full_info、gnfd_create_file、gnfd_create_folder、gnfd_list_objects、gnfd_get_object_info、gnfd_download_object、gnfd_delete_object);账户操作(gnfd_get_account_balance、gnfd_get_all_sps);支付操作(gnfd_get_payment_accounts、gnfd_create_payment_account、gnfd_deposit_to_payment、gnfd_withdraw_from_payment、gnfd_get_payment_account_info)。

关键概念 Bucket 是存储对象的容器(类似文件夹),Object 是桶中的文件,Storage Provider(SP)是存储并提供数据的节点,Payment Account 是用于支付存储费用的账户。

使用方式 需安装 Greenfield SDK:npm install @bnb-chain/greenfield-js-sdk。通过 Client.create(GREENFIELD_RPC_URL, CHAIN_ID) 创建客户端后,可调用 bucket.createBucket、object.createObject、object.uploadObject、object.getObject、object.listObjects、payment.createPaymentAccount、payment.deposit、payment.withdraw、sp.getStorageProviders 等方法,并对交易进行签名和广播。资料中提供了创建桶、上传文件、下载文件、列出对象、支付账户操作及获取存储提供商列表的代码示例。

网络信息 Greenfield Mainnet:Chain ID 1017,RPC https://greenfield-chain.bnbchain.org;Greenfield Testnet:Chain ID 5600,RPC https://gnfd-testnet-fullnode-tendermint-us.bnbchain.org。

访问控制 可见性类型包括 VISIBILITY_TYPE_PUBLIC_READ(任何人可读)、VISIBILITY_TYPE_PRIVATE(仅所有者可访问)、VISIBILITY_TYPE_INHERIT(继承自桶)。可通过 updateObjectInfo 设置对象可见性。

适用场景 资料列出的用例包括网站托管、NFT 元数据存储和数据备份。

限制与注意事项 资料建议使用支付账户而非主钱包付款,监控配额与余额,为敏感数据设置合适可见性,对重要文件使用多个 SP 做冗余备份,并在操作前确认 SP 状态。存储费用取决于存储大小、读取配额和链上操作 gas。