★ FEATURED ARTICLE 【免费下载链接】internet-court-skillThe trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.项目地址https://gitcode.com/gh_mirrors/in/internet-court-skill点击查看免费下载Greenfield 是 BNB Chain 生态的去中心化存储与数据基础设施bnbchain-mcp通过一组gnfd_*前缀的 MCP 工具让 Agent 能够直接管理 Greenfield 存储桶Bucket、对象/文件夹Object/Folder与支付账户Payment Account。本文以仓库中的 Greenfield 工具参考文档 为主体结合bnbchain-mcpSkill 的完整配置、凭证规则与安全实践系统讲解每类工具的调用参数、读写权限边界和实操要点。读完本文你将能够通过 MCP 服务器完成从创建存储桶、上传下载文件、到开通支付账户并结算存储费用的完整 Greenfield 操作链路。Greenfield 工具在 agentic commerce 中的定位在 Internet Court 这个Agent 对 Agent 商业信任层中bnbchain-mcp属于六层技术栈的第一层——发现、身份与声誉Discovery, identity reputation承担链上操作区块、交易、合约、ERC-8004 代理注册与 Greenfield 去中心化存储两大职责见 README.md 中的分层表。Greenfield 工具的价值在于Agent 之间交换的元数据、证据文件、内容寻址数据需要一个公开、可验证、链上关联的存储载体而 Greenfield 正是 BNB Chain 提供的这一层基础设施。在仓库中bnbchain-mcp是 BNB Chain 官方技能源仓库bnb-chain/bnbchain-skills的 vendored 副本由skills-lock.json锁定版本对应提交为4f6557b7f776c2ac6748027baadf18d44db67da7以 MIT 协议发布参见 skills-lock.json。所有 Greenfield 工具统一以gnfd_为前缀与 EVM 工具get_*、transfer_*、ERC-8004 工具register_erc8004_agent等并列构成完整的 bnbchain-mcp SKILL 工具集。网络与凭证一切调用的前提network 参数testnet 与 mainnetGreenfield 工具运行在testnet或mainnet上通过network参数指定取值含义testnet测试网默认值适合开发与演练mainnet主网涉及真实资产需谨慎写入类操作Write必须显式确认网络。这与整个 bnbchain-mcp 的通用规则一致读操作区块、余额、合约读的network可选且默认bsc但任何状态变更操作都没有默认网络必须由用户显式指定详见 SKILL.md。若用户未指定网络Agent 必须先询问而非默认主网——误执行主网写操作可能造成不可逆的资金损失。Greenfield 工具同样遵循该纪律。PRIVATE_KEY写入的钥匙读操作列出、查询信息、下载通常不需要私钥写入操作创建/删除 Bucket、上传/删除对象、创建文件夹、支付账户相关的资金操作必须在 MCP 服务器环境变量中设置PRIVATE_KEY或在支持的地方通过privateKey参数传入私钥只能放在 MCP 服务器env中严禁出现在聊天记录、日志或输出中。MCP 服务器的最小配置stdio 模式如下见 SKILL.md{ mcpServers: { bnbchain-mcp: { command: npx, args: [-y, bnb-chain/mcplatest], env: { PRIVATE_KEY: } } } }留空PRIVATE_KEY即只读模式写入需求出现后再填入并重启 MCP 客户端。若使用 SSE 模式在args中加入--sse本地开发服务器则改用url: http://localhost:3001/sse并保持相同env。工具命名差异提示原文档特别提示部分工具在实现中可能采用不同命名典型如文件上传工具。应以 MCP 服务器实际暴露的工具名为准下面表格与 BNB Chain MCP README 及常见用法保持一致。调用前可用get_supported_networks或 MCP 工具列表确认当前版本的确切参数名。Buckets存储的顶层容器Bucket 是 Greenfield 中按地址归属的顶层存储容器类似于 S3 的 Bucket。相关工具如下工具说明参数gnfd_list_buckets列出某地址拥有的 Bucketnetwork、address可选、privateKey可选用于默认账户gnfd_get_bucket_info获取 Bucket 详情network、bucketNamegnfd_get_bucket_full_info获取 Bucket 信息及配额用量network、bucketName、privateKeygnfd_create_bucket写入创建 Bucketnetwork、privateKey、bucketNamegnfd_delete_bucket写入删除 Bucketnetwork、privateKey、bucketName关键细节bucketName在可选时可省略默认值为created-by-bnbchain-mcp创建和删除 Bucket 是典型的写操作必须提供privateKey或环境变量PRIVATE_KEY且明确指定networkgnfd_get_bucket_full_info与gnfd_get_bucket_info的区别在于前者附带配额quota用量信息这要求privateKey以读取当前账户的计费状态。Objects and folders数据的内容载体工具说明参数gnfd_list_objects列出 Bucket 中的对象network、bucketNamegnfd_get_object_info获取对象详情network、bucketName、objectNamegnfd_upload_object/gnfd_create_file写入上传文件到 Bucketnetwork、privateKey、filePath文件的绝对路径、bucketNamegnfd_download_object下载对象到本地磁盘network、bucketName、objectName、targetPath可选、privateKeygnfd_delete_object写入删除对象network、privateKey、bucketName、objectNamegnfd_create_folder写入在 Bucket 中创建文件夹network、privateKey、bucketName、folderName可选实战要点上传工具的双命名如果服务器暴露的是gnfd_create_file而非gnfd_upload_object则使用filePath参数指向要上传文件的绝对路径——这正是 SKILL.md 工具分类表中Greenfield 工具可能命名不同提示的具体体现gnfd_download_object的targetPath可选省略时由服务器决定落盘位置它是少数带privateKey参数的非写入工具用于获取受限对象的访问权限gnfd_create_folder的folderName可选未指定时由实现生成默认文件夹名。Account and payment存储费用的支付基础设施Greenfield 采用支付账户Payment Account机制为存储计费一个主账户可以派生多个支付账户来隔离不同业务的存储开销工具说明参数gnfd_get_account_balance查询 Greenfield 账户余额network、按实现选择address或privateKeygnfd_get_payment_accounts列出某地址的支付账户network、address可选、privateKeygnfd_get_payment_account_info查询支付账户详情network、账户标识符见实现说明gnfd_create_payment写入创建支付账户network、privateKeygnfd_get_payment_balance查询支付账户余额network、账户标识符gnfd_deposit_to_payment写入向支付账户充值network、to支付账户地址、amount字符串单位为 BNB、privateKeygnfd_withdraw_from_payment写入从支付账户提现network、from、amount、privateKeygnfd_disable_refund写入不可逆禁用支付账户退款network、address、privateKey如暴露要点解析amount一律以字符串形式传入单位为 BNB例如0.5与 EVM 转账工具transfer_native_token的amount风格一致gnfd_disable_refund是唯一标注 IRREVERSIBLE不可逆的操作——一旦禁用退款即永久生效调用前务必二次确认账户标识符类参数gnfd_get_payment_account_info、gnfd_get_payment_balance的确切格式依赖实现版本建议先用gnfd_get_payment_accounts拿到账户地址后再查询并用get_supported_networks或 MCP 工具列表核对参数名。与 EVM / ERC-8004 工具的组合用法Greenfield 工具并非孤立存在。在bnbchain-mcp的完整工具谱系中见 SKILL.md查询链上事实用get_native_balance检查 BNB 余额用get_transaction_receipt追踪 Greenfield 写入交易的确认状态代理身份绑定用 register_erc8004_agent 注册链上 Agent 身份其agentURI元数据name、description、image、services 如 MCP endpoint完全可以直接托管在 Greenfield Bucket 中形成链上身份 去中心化存储的组合网络确认写操作前先用get_chain_info或get_supported_networks见 EVM 工具参考确认当前环境再决定 testnet 还是 mainnet。安全与最佳实践综合 SKILL.md 的安全准则与 Greenfield 工具特性建议遵循以下规范写操作先确认再调用对gnfd_create_bucket、gnfd_delete_bucket、上传/删除对象、gnfd_deposit_to_payment、gnfd_withdraw_from_payment等所有写入调用前确认bucketName、objectName、金额与网络避免误删或误充值网络必须显式写入工具没有默认网络用户未指定时必须询问不得默认主网建议用 testnet这类口头提示不能替代显式网络确认私钥只进 envPRIVATE_KEY仅存在于 MCP 服务器环境变量绝不写入聊天记录、日志或输出文件不可逆操作格外谨慎gnfd_disable_refund永久生效使用前务必向用户说明后果并取得明确确认版本差异兜底不同版本的 bnbchain-mcp 可能对上传工具、账户标识符参数命名有差异先通过get_supported_networks或 MCP 工具列表核实参数名再组织调用。小结Greenfield 工具参考文档覆盖了三类操作Bucket 生命周期管理、对象/文件夹的内容读写、以及支付账户的存储计费体系。结合bnbchain-mcpSKILL 的网络与私钥纪律Agent 可以在安全边界内完成创建存储桶 → 上传对象 → 开通支付账户并充值的完整闭环为链上身份元数据、证据文件与交易数据提供去中心化的存储底座。更完整的 EVM、ERC-8004 与提示词工具可继续查阅 EVM 工具参考、ERC-8004 工具参考 与 Prompts 参考。赞分享【免费下载链接】internet-court-skillThe trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.项目地址https://gitcode.com/gh_mirrors/in/internet-court-skill点击查看免费下载相关推荐BNB Chain MCP 接入实战EVM 链上查询与交易、ERC-8004 Agent 注册、Greenfield 存储一站式指南BNB Chain MCP 接入实战EVM 链上查询与交易、ERC 8004 Agent 注册、Greenfield 存储一站式指南 导读 本指南围绕 IntRook Ceph 对象存储桶通知Object Bucket Notifications完全指南CephBucketTopic 与 CephBucketNotification 实战Rook Ceph 对象存储桶通知Object Bucket Notifications完全指南CephBucketTopic 与 CephBucketN云原生存储容器编排运维Encore.ts 对象存储Object Storage完全指南Bucket 操作、权限引用与签名 URLEncore.ts 对象存储Object Storage完全指南Bucket 操作、权限引用与签名 URL 对象存储Object Storage是后端后端开发工具云原生微服务上一篇FRESCO API开发指南如何将视频翻译功能集成到你的应用中下一篇Clerk深度解析从文件解析到依赖图构建的完整工作流程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
