Doma Testnet

Doma Testnet 自动化交互脚本 - 领水 + 桥接 + 多代币交易

📝 项目简介

Doma 是一个基于以太坊 Layer 2 的测试网络。本脚本实现了完整的测试网交互流程，包括水龙头领水、Sepolia 跨链桥接、多种代币的买卖交易等功能，帮助用户完成测试网任务并获得潜在的空投资格。

⚙️ 功能说明

1. 水龙头领水 💧

• 自动从 USDTEST 水龙头领取测试代币
• 可配置每次领取数量（默认 10 USDTEST）
• 支持多钱包批量领取
• 自动检查余额变化

2. 跨链桥接 🌉

• 从 Sepolia 测试网桥接 ETH 到 Doma Testnet
• 可配置桥接数量（默认 0.01 ETH）
• 自动估算 Gas 费用
• 显示 Sepolia 和 Doma 两端的交易链接
• 备注：需要在 Sepolia 测试网有足够的 ETH 余额

3. 多代币自动交易 💱

• 支持 6 种代币的自动交易：
• SOFTWAREAI
• LABUBURIP
• SEEYOUATKBW
• ILOVEPUMPKINSPICE
• DRINKMIZU
• ARTHURSFERRARI
• 自动授权 USDTEST 给 SwapRouter
• 自动购买代币（USDTEST → 代币）
• 可选自动卖出代币（代币 → USDTEST）
• 可配置每种代币的交易次数（默认 1 次）
• 显示交易详情和余额变化

4. 完整交互流程 ✨

• 第一步：领取 USDTEST 测试代币
• 第二步（可选）：从 Sepolia 桥接 ETH
• 第三步：自动购买所有代币
• 第四步（可选）：卖出已购买的代币
• 支持多轮循环执行（24 小时自动重复）

5. 安全机制 🛡️

• 自动检查余额是否充足
• 滑点保护（最小输出数量）
• Gas 费用自动估算
• 交易失败自动重试
• 详细的交易记录和浏览器链接

📋 注意事项

首次使用指南

1. 准备工作
   - 在「账号管理」页面添加 EVM 钱包私钥（支持批量导入）
   - 确保钱包在 Doma Testnet 有少量 ETH（用于 Gas 费）
   - 如需桥接功能，确保钱包在 Sepolia 有 ETH

2. 领取测试币
   - 首次使用建议先执行领水功能，获取 USDTEST
   - 在配置中设置 enable_faucet = true（默认开启）
   - 每次可领取 10 USDTEST（可在配置中调整）

3. 配置功能
   - enable_faucet：是否自动领水（建议开启）
   - enable_auto_swap_all_tokens：是否自动交易所有代币（建议开启）
   - enable_bridge：是否自动桥接（需要 Sepolia ETH，默认关闭）
   - enable_auto_sell：是否买入后立即卖出（可选，默认关闭）

4. 开始执行
   - 检查配置无误后，点击「开始执行」
   - 脚本会按顺序执行所有已启用的功能
   - 查看执行日志确认交易状态

配置建议

1. 新用户推荐配置
   - 开启领水功能（enable_faucet = true）
   - 开启自动交易（enable_auto_swap_all_tokens = true）
   - 关闭桥接功能（enable_bridge = false，需要时再开启）
   - 关闭自动卖出（enable_auto_sell = false）
   - 交易次数设为 1（swap_count = 1）

2. 进阶用户配置
   - 增加交易次数（swap_count = 2-5）
   - 开启自动卖出（enable_auto_sell = true）完成完整交互
   - 开启 24 小时自动执行，持续与测试网交互

3. Gas 费优化
   - 脚本已内置 Gas 费估算
   - 确保钱包有足够的 Doma ETH（每个钱包至少 0.01 ETH）
   - 如果 Gas 不足，脚本会自动跳过该钱包

4. 代理设置
   - RPC 节点较稳定，通常不需要代理
   - 如遇到 RPC 限流，可在「代理管理」中添加代理

常见问题

1. 领水失败？
   - 检查钱包在 Doma Testnet 是否有 ETH（用于 Gas）
   - 水龙头可能有冷却时间，等待一段时间后重试
   - 查看日志中的错误原因

2. 交易失败？
   - 检查 USDTEST 余额是否充足（需先领水）
   - 检查 Doma ETH 余额是否足够支付 Gas 费
   - 如果是滑点问题，可以降低 amount_out_min_buy 值

3. 桥接失败？
   - 确认 Sepolia 测试网有足够的 ETH
   - 桥接需要较长时间（1-5 分钟），请耐心等待
   - 可以在 Sepolia 和 Doma 浏览器查看交易状态

4. Gas 估算失败？
   - 脚本会使用默认 Gas Limit
   - 可以在配置中调整 default_gas_limit 参数
   - 如果持续失败，可能是 RPC 节点问题，尝试更换 RPC

5. 授权交易失败？
   - 授权是购买代币的必要步骤
   - 如果授权失败，后续购买会自动跳过
   - 重新运行脚本会自动重试授权

6. 如何获取 Sepolia ETH？
   - 可以使用 Sepolia 水龙头：https://sepoliafaucet.com/
   - 或使用其他水龙头服务
   - 也可以使用框架的「领水」功能（如果支持 Sepolia）

手动领水功能

本脚本支持独立的领水功能：

1. 在「领水」标签页选择本项目
2. 输入钱包地址列表（每行一个地址）
3. 点击「开始领水」
4. 脚本会自动为所有地址领取 USDTEST

注意：
- 领水功能需要钱包在 Doma Testnet 有少量 ETH（用于 Gas）
- 如果输入的是地址列表，领水功能会使用地址
- 如果需要认证（Privy SIWE），则需要使用私钥

特别说明

• 本脚本使用 Web3.py 与链上智能合约交互
• 私钥仅用于本地签名交易，不会上传到任何服务器
• 所有交易在链上公开可查
• 建议使用测试钱包，不要使用存放真实资产的钱包
• 交易 Hash 和浏览器链接会显示在日志中
• USDTEST 是测试代币，没有真实价值
• 建议开启 24 小时自动执行，持续与测试网交互
• 所有代币交易使用 Uniswap V3 风格的 SwapRouter02 合约

技术细节（可选阅读）

• 链 ID：97476（Doma Testnet）
• 浏览器：https://explorer-testnet.doma.xyz/
• 水龙头合约：支持 faucetMint 方法
• SwapRouter：Uniswap V3 风格的 exactInput 方法
• 桥接合约：支持 bridgeETHTo 方法
• 费率：3000（0.3%）

⚠️ 免责声明

本脚本仅供学习交流使用，使用本脚本产生的一切后果由使用者自行承担。