Rome Protocol

Rome Protocol 跨链桥接脚本

Rome Protocol 是一个跨链桥接协议，连接 Solana 和 EVM 链，允许用户在两条链之间转移资产。本脚本支持自动化的存款和取款操作。

核心功能：
1. Deposit (存款) - 从 Solana 链存入 SOL，在 EVM 链上获得 RSOL
2. Withdraw (取款) - 从 EVM 链取回 RSOL，在 Solana 链上获得 SOL
3. 余额查询 - 查看 Solana 和 EVM 两条链的余额
4. 批量操作 - 支持多钱包批量执行
5. 双链支持 - 同时管理 Solana 和 EVM 两个账户

功能特性：
- 跨链资产转移
- 支持存款和取款两种模式
- 双链账户统一管理
- 实时余额查询
- 支持批量多笔交易
- 详细的交易日志
- Gas 参数可配置
- RPC 节点可更换

使用说明：

【平台介绍】
Rome Protocol：跨链桥接协议
- Solana 链：原生 SOL 代币
- EVM 链：RSOL 代币（Rome Solana 的映射代币）
- 桥接方式：托管式跨链桥
- 测试网：Rome Protocol testnet

【配置说明】
在 config.ini 中设置：

【Operation Settings（操作设置）】
- operation_type：操作类型
- deposit：存款模式，从 Solana 存入 SOL 获得 RSOL
- withdraw：取款模式，从 EVM 取回 RSOL 获得 SOL
- amount_per_transaction：每笔交易金额，建议 0.01-1.0
- transactions_per_wallet：每个钱包交易次数，建议 1-10

【Network Settings（网络设置）】
- solana_rpc_url：Solana RPC 节点地址
- 默认：https://node1-solana-api.testnet.romeprotocol.xyz/
- evm_rpc_url：EVM RPC 节点地址
- 默认：https://martius-i.testnet.romeprotocol.xyz/
- 如果 RPC 失效，可以更换其他节点

【Transaction Settings（交易设置）】
- compute_unit_price：Solana 计算单元价格（默认 1000）
- compute_unit_limit：Solana 计算单元限制（默认 200000）
- max_fee_per_gas_gwei：EVM Max Fee（默认 2 Gwei）
- max_priority_fee_per_gas_gwei：EVM Priority Fee（默认 1 Gwei）

【Advanced Settings（高级设置）】
- delay_min/max：钱包间延迟，在主 UI 中配置（默认 5-10 秒）

【账号格式说明】

重要：Rome Protocol 需要同时使用 Solana 和 EVM 两个账户

账号文件格式（每行一个账号）：

solana_private_key|evm_private_key

示例：

5JvHT...（Solana base58 私钥）|0x123abc...（EVM 十六进制私钥）

Solana 私钥格式：
- Base58 编码的私钥字符串
- 通常以数字或大写字母开头
- 长度约 88 个字符
- 示例：5JvHTYhzB4XvZKQWjWNd...

EVM 私钥格式：
- 十六进制字符串，可以带或不带 0x 前缀
- 长度 64 个十六进制字符（不含 0x）
- 示例：0x1234567890abcdef...

分隔符：
- 使用竖线 | 分隔两个私钥
- 不要有多余的空格

【功能详细说明】

1. Deposit (存款) 模式

存款模式会在 Solana 链上发送 SOL 到桥接合约，然后在 EVM 链上收到等量的 RSOL。

执行流程：
1. 检查 Solana 钱包 SOL 余额是否足够
2. 在 Solana 链上构建转账交易
3. 发送 SOL 到桥接地址：DDbjRkspygKHJ41TVBo3Poeu1XzHfnb3KM3PYZtb6TSL
4. 等待 Solana 交易确认
5. 桥接协议自动在 EVM 链上铸造等量 RSOL
6. 显示交易结果和余额变化

注意事项：
- 需要保留足够的 SOL 用于支付交易费（建议至少 0.01 SOL）
- Solana 交易费用约 0.000005 SOL（5000 lamports）
- 桥接通常需要几分钟时间
- 确保 EVM 地址正确，否则可能丢失资产

2. Withdraw (取款) 模式

取款模式会在 EVM 链上发送 RSOL 到桥接合约，然后在 Solana 链上收到等量的 SOL。

执行流程：
1. 检查 EVM 钱包 RSOL 余额是否足够
2. 在 EVM 链上构建智能合约调用
3. 调用桥接合约的 withdraw 函数
4. 传入 Solana 目标地址
5. 等待 EVM 交易确认
6. 桥接协议自动在 Solana 链上转账 SOL
7. 显示交易结果和余额变化

注意事项：
- 需要保留一些 RSOL 用于支付 EVM 链的 Gas 费
- EVM 交易 Gas 费约 0.0002 RSOL
- 桥接通常需要几分钟到十几分钟
- 确保 Solana 地址正确

3. 余额查询

脚本会自动查询并显示：
- Solana 链 SOL 余额
- EVM 链 RSOL 余额
- 初始余额和最终余额
- 余额变化（正数表示增加，负数表示减少）

4. 批量操作

支持两种批量模式：
- 多钱包批量：自动处理所有加载的账号对
- 单钱包多笔：每个钱包可以执行多笔交易

5. 双链账户管理

每个账号包含两个私钥：
- Solana 私钥：用于 Solana 链操作
- EVM 私钥：用于 EVM 链操作
- 两个地址可以是完全独立的
- 但建议使用关联地址以便管理

【使用步骤】

第一步：准备私钥

1. 准备 Solana 私钥
   - 从 Phantom、Solflare 等钱包导出
   - 格式为 Base58 编码
   - 确保钱包中有足够的 SOL

2. 准备 EVM 私钥
   - 从 MetaMask 等钱包导出
   - 格式为十六进制
   - 可以带或不带 0x 前缀

3. 组合为账号格式
   - 格式：solana_key|evm_key
   - 使用竖线分隔
   - 每行一个账号

第二步：配置参数

1. 选择操作类型（deposit 或 withdraw）
2. 设置每笔交易金额
3. 设置每个钱包交易次数
4. 必要时调整 Gas 参数
5. 检查 RPC 节点是否可用

第三步：执行脚本

1. 在 UI 中加载账号文件
2. 点击「开始执行」
3. 查看日志输出
4. 等待所有交易完成
5. 检查最终余额变化

【操作建议】

存款操作建议：
- 首次使用建议先测试小额（0.01-0.1 SOL）
- 确保 Solana 钱包至少保留 0.01 SOL 作为手续费
- 可以分多笔存入，降低风险
- 等待桥接完成后再进行下一笔

取款操作建议：
- 确认 EVM 钱包中有足够的 RSOL
- 确保有足够的 RSOL 支付 Gas 费
- 取款前确认 Solana 地址正确
- 可以部分取款，不必全部取回

交易设置建议：
- 测试网建议：0.01-0.1 per transaction
- Solana Gas 通常不需要调整
- EVM Gas 可能需要根据网络情况调整
- 每个钱包 1-3 笔交易即可
- 钱包间延迟 5-10 秒

安全建议：
- 不要在同一时间进行大量操作
- 定期检查两条链的余额
- 保存好所有交易记录
- 测试网代币无实际价值，可以大胆测试

【重要提示】

1. 双私钥要求
   - 必须提供 Solana 和 EVM 两个私钥
   - 格式必须正确，否则会加载失败
   - 建议使用关联地址以便管理
   - 私钥顺序不能颠倒

2. 网络要求
   - 需要同时连接 Solana 和 EVM 两个 RPC
   - 两个 RPC 都必须可用
   - 网络延迟会影响桥接速度
   - 建议使用稳定的网络连接

3. 余额要求
   - 存款：Solana 需要足够的 SOL + 手续费
   - 取款：EVM 需要足够的 RSOL + Gas 费
   - 建议两个钱包都保留一定储备

4. 桥接时间
   - Deposit 通常 2-5 分钟
   - Withdraw 通常 5-15 分钟
   - 网络拥堵时可能更长
   - 交易失败会自动回滚

5. 手续费说明
   - Solana 交易费：约 0.000005 SOL
   - EVM Gas 费：约 0.0002 RSOL
   - 桥接协议可能收取额外费用
   - 建议留出足够的手续费储备

6. 交易失败原因
   - Solana/EVM 余额不足
   - Gas 费不足
   - RPC 节点问题
   - 网络拥堵
   - 智能合约错误
   - 私钥格式错误

7. 风险提示
   - 这是测试网，代币无实际价值
   - 跨链桥接有合约风险
   - 建议先小额测试
   - 确保地址正确后再大额操作
   - 测试网可能随时重置

【常见问题】

Q: 为什么需要两个私钥？
A: Rome Protocol 是跨链桥接，需要在 Solana 和 EVM 两条链上操作，因此需要两个钱包的私钥。

Q: 两个地址必须关联吗？
A: 不必须，但建议使用关联地址以便管理。桥接协议会根据你提供的地址进行转账。

Q: 如何获取 Solana 私钥？
A: 从 Phantom、Solflare 等 Solana 钱包导出，格式为 Base58 编码字符串。

Q: 如何获取 EVM 私钥？
A: 从 MetaMask 等钱包导出，在账户详情中选择导出私钥。

Q: 桥接需要多长时间？
A: Deposit 通常 2-5 分钟，Withdraw 通常 5-15 分钟，取决于网络状况。

Q: 可以取消正在进行的桥接吗？
A: 不可以，交易一旦发送就无法取消。但如果失败会自动回滚。

Q: 为什么余额没有立即更新？
A: 跨链桥接需要时间，请等待几分钟后刷新余额。

Q: 如何获取测试网代币？
A: Solana 测试网可通过水龙头获取 SOL，EVM 测试网需要先从 Solana 桥接过去。

Q: RPC 节点失效怎么办？
A: 在 config.ini 中修改 solana_rpc_url 和 evm_rpc_url 为其他可用节点。

依赖库：
- web3：以太坊和兼容链交互
- solana：Solana 链交互
- base58：Solana 私钥编码
- asyncio：异步操作支持

官方信息：
- 平台：Rome Protocol
- 类型：跨链桥接协议
- 支持链：Solana、EVM (Rome testnet)
- 桥接合约：0x4200000000000000000000000000000000000016

适用场景：
- Solana 和 EVM 之间的资产转移
- 跨链桥接测试
- 批量跨链操作
- 多账号资产管理