> For the complete documentation index, see [llms.txt](https://help.bananatool.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bananatool.org/tools/mint-evm.md).
# EVM 铭文铸造教程
EVM 铭文铸造教程：使用 BananaTool 在 BSC 等 EVM 公链发送铭文数据，支持文本或十六进制、Gas 设置、发送金额与单钱包重复铭刻。
BananaTool EVM 铭文铸造工具用于通过当前连接的钱包发送铭文数据，并集中设置 Gas Price、Gas Limit、每笔发送金额和重复铭刻次数。页面支持文本模式与十六进制模式，适合 BSC 等 EVM 公链上的协议铭刻、测试调用和批量重复提交。
本文以官网当前页面的 BSC 网络为例，介绍铭文数据填写、Gas 选项、发送参数、接收地址和执行明细。不同铭文协议对 `data:` 内容、接收地址和金额有自己的要求，请以协议官方文档和 [BananaTool EVM 铭文铸造](https://www.bananatool.org/mint-evm) 页面实时字段为准。
{% hint style="danger" %}
铭文交易会真实消耗钱包中的原生币并写入区块链。提交前必须确认数据格式、目标协议、接收地址、发送金额和交易次数；链上交易通常无法撤回。只使用专用测试钱包，不要在网页中暴露助记词或高价值钱包私钥。
{% endhint %}
## 一、EVM 铭文是什么
EVM 铭文通常把一段协议数据写入交易 calldata，并由目标 EVM 网络的节点记录。页面会根据你填写的铭文数据构造交易，按设置的次数逐笔广播，最终在「执行明细」中展示成功、失败和交易 Hash。
铭文数据本身不等于代币余额或合约状态。某些协议（例如 BRC-20 风格的 EVM 铭文）会要求固定的 JSON 字段；格式错误时，交易即使上链也可能不会被协议索引器识别。
## 二、使用前准备
开始前准备：
* 确认目标 EVM 公链、原生币和铭文协议，例如 BSC 与 BNB。
* 准备已安装并解锁的浏览器钱包，钱包网络必须与页面当前公链一致。
* 从协议官方文档取得铭文格式、字段大小限制、接收地址规则和推荐 Gas。
* 为发送金额、Gas 和重复次数预留足够原生币；不要把余额全部用于铭刻。
* 先在测试网或用极小金额验证一笔，确认数据能被目标索引器识别。
## 三、打开页面并连接钱包
1. 打开 [BananaTool EVM 铭文铸造](https://www.bananatool.org/mint-evm)。
2. 在页面顶部确认「当前公链」和原生币。官网页面示例显示 `BSC` 与 `BNB`。
3. 点击「连接钱包」，在钱包扩展中确认连接的账户和网络。
4. 检查页面显示的钱包地址、BNB 余额和推荐 Gas Price。余额或推荐 Gas 显示为 `-` 时，先刷新钱包信息或检查 RPC、网络连接。
EVM 铭文铸造初始页面
{% hint style="warning" %}
连接钱包只用于读取地址和请求交易签名。任何要求你提供助记词、钱包密码或导出私钥的页面都不是正常的连接流程；请确认域名为 `www.bananatool.org`。
{% endhint %}
## 四、填写铭文数据
页面的「铭文数据」区域提供两种输入模式。
### 文本模式
文本模式适合直接粘贴协议要求的 `data:` URI 或普通文本。官网当前示例为：
```
data:, {"p":"bsc-20","op":"mint","tick":"BNBS","amt":"1000"}
```
实际使用时请按照协议文档替换协议标识、操作类型、代币符号和数量。不要擅自添加空格、换行或未定义字段；JSON 的大小写和引号都可能影响索引器解析。页面右侧会显示「数据大小」，提交前确认没有被截断。
### 十六进制模式
十六进制模式用于输入已经编码好的 calldata，通常以 `0x` 开头。切换模式后，页面会显示类似 `0x646174613a...` 的输入框。请确认十六进制字符只包含 `0-9`、`a-f` 或 `A-F`，长度为偶数，并且解码结果与协议要求的数据完全一致。
十六进制模式：输入已编码的铭文数据
切换文本和十六进制模式后，重新检查数据内容与大小。不要把交易 Hash、合约地址或私钥误粘贴到铭文数据框。
## 五、设置铭刻参数
在「铭刻参数」区域按实际需求设置以下选项。
### 1. 等待交易确认
开启后，工具会在广播一笔交易后等待确认，再请求下一笔签名。它更适合需要严格顺序的协议或新手测试；关闭后可能更快，但多笔交易同时处于 pending 状态时，更容易遇到 nonce、Gas 或网络拥堵问题。
### 2. Gas Price
页面支持「固定」「自动」「随机」三种模式：
* **固定**：手动指定 Gas Price，适合有明确网络费率要求的场景。
* **自动**：根据当前网络和推荐值估算，适合常规操作。
* **随机**：在页面允许范围内生成不同费率。使用前确认协议没有对 Gas Price 设定上限或下限。
### 3. Gas Limit
同样支持固定、自动和随机。自动模式会在估算值基础上预留页面提示的余量（当前页面标注为 20%）。固定值过低会导致交易因 out of gas 失败，过高则会增加钱包需要预留的余额；随机模式只应在你了解协议和网络行为后使用。
## 六、设置发送金额和重复次数
### 发送数量（BNB）
页面提供以下金额模式：
* **全部金额**：发送当前可用余额，必须确保仍留有 Gas。
* **随机金额**：每笔使用随机金额，先确认协议允许附带原生币。
* **随机百分比**：按余额比例计算每笔发送金额。
* **固定金额**：每笔发送输入框中的固定 BNB 数量。
* **保留固定**：发送后为钱包保留指定数量的原生币。
金额模式影响每笔交易的 `value`，不等同于铭文数据里的代币数量。协议要求零金额调用时，应按协议说明设置，不要仅凭页面默认值判断。
### 单钱包铭刻次数
此字段表示当前连接钱包重复执行铭刻的次数。次数越多，Gas 总成本、等待时间和失败概率越高。建议先设置为 `1` 完成单笔验证，再根据协议规则和预算增加；不要用高重复次数测试未经验证的数据。
## 七、接收地址或合约地址
默认开启「转给自己」，页面会把交易发送给当前连接钱包。若协议要求发送给特定地址或合约：
1. 关闭「转给自己」开关。
2. 在「接收地址或合约地址」输入目标 EVM 地址。
3. 核对地址的网络、大小写和合约用途；确认该地址确实是协议要求的接收方。
不要把代币合约地址、个人收款地址和铭文协议合约地址混为一谈。交易目标填错时，铭文可能无法被识别，已支付的 Gas 也不会自动退回。
## 八、执行铭刻并查看结果
完成所有设置后，滚动到页面底部并再次核对摘要：
1. 当前公链与钱包地址。
2. 铭文数据模式、完整内容和数据大小。
3. Gas Price、Gas Limit 和等待确认开关。
4. 发送金额模式、单钱包铭刻次数和接收地址。
5. 预计需要签名的交易数量和钱包剩余余额。
确认无误后点击「开始铭刻」并在钱包弹窗逐笔确认。页面的「执行明细」会显示任务数、成功数、失败数以及每笔交易的 Hash。
铭刻参数与执行明细
复制每笔 Hash 到目标网络区块浏览器，核对 `to` 地址、`value`、calldata、区块确认数和实际 Gas。再到协议官方索引器或浏览器页面确认铭文是否被正确解析；“交易成功”不一定代表协议业务成功。
## 九、失败和 Pending 处理
### 交易 Pending
先复制 Hash 查询交易状态，确认是否仍在待打包、已成功或已失败。检查钱包 nonce、Gas Price、网络拥堵和 RPC 状态，不要在状态不明时重复点击开始铭刻。
### 交易失败或 out of gas
检查 Gas Limit、余额、接收地址和数据格式。自动 Gas Limit 通常会预留余量；若协议调用复杂，可先用一笔小额交易估算，再调整固定值。只重试区块浏览器明确失败的交易。
### 交易成功但没有显示铭文
检查 calldata 是否符合协议规范、目标地址是否正确、数据大小是否超限，以及索引器是否支持当前网络。等待索引器同步后再判断，不要仅依据钱包活动列表下结论。
## 十、安全核对清单
* 页面域名是官方 `www.bananatool.org`，网络和钱包账户已确认。
* 铭文协议格式来自官方文档，文本或十六进制数据已独立解码核验。
* 接收地址或合约地址经过两次人工复核。
* 已为每笔 Gas 和重复次数预留足够原生币，没有把主钱包用于批量测试。
* 已用单笔、小额交易验证，确认交易能被目标索引器识别。
* 已保存交易 Hash、区块高度、Gas 和失败记录。
* 没有在网页、截图、客服或代码仓库中暴露助记词、私钥或钱包密码。
## 常见问题
### 文本模式和十六进制模式有什么区别？
文本模式输入可读的 `data:` 内容，工具负责按页面规则处理；十六进制模式输入已编码的 `0x` 数据。两者最终都进入交易 calldata，必须保证编码结果符合协议要求。
### 为什么数据大小很重要？
数据越大，交易 calldata 和 Gas 成本通常越高。部分网络或协议还会设置大小限制，超过限制可能导致交易失败或索引器忽略。
### Gas Price 选自动还是固定？
常规操作优先使用自动并观察推荐值；协议或网络有明确费率要求时再使用固定。固定值过低会长时间 pending，过高会增加成本。
### 可以一次铭刻很多次吗？
可以通过「单钱包铭刻次数」设置重复次数，但每次都是独立交易，会分别消耗 Gas。先用 1 次验证数据，再按预算逐步增加。
### 交易成功为什么协议页面没有记录？
链上成功只说明交易被区块确认，不能保证协议解析成功。请检查 calldata、目标地址、协议字段和索引器同步状态。
## 相关教程
* [多钱包批量铭刻教程](https://www.bananatool.org/mint-evm-batch)
* [批量检查钱包余额教程](/tools/batch-check-balance.md)
* [批量转账（一转多）教程](/tools/multisend.md)
* [BananaTool 工具导航](/gong-ju-dao-hang.md)