Fervent KAS

Fervent KAS DeFi 自动交互脚本

Fervent 是 Kasplex testnet 上的 DeFi 借贷协议，用户可以存入 KAS 代币获得 fKAS（生息代币），也可以赎回 fKAS 取回 KAS。本脚本支持自动化的存款和取款操作。

核心功能：
1. Supply (存款) - 存入 KAS 获得 fKAS
2. Withdraw (取款) - 赎回 fKAS 获得 KAS
3. 余额查询 - 查看 KAS 和 fKAS 余额
4. 兑换率查询 - 实时查看 fKAS/KAS 兑换率
5. 批量操作 - 支持多钱包批量执行
6. 智能检查 - 自动检查余额是否足够

功能特性：
- 自动化 DeFi 交互
- 支持存款和取款两种模式
- 智能合约直接交互
- 实时余额和兑换率查询
- 支持批量多笔交易
- 详细的交易日志
- Gas Price 可配置
- RPC 节点可更换

使用说明：

【平台介绍】
Fervent (Kasplex testnet)：DeFi 借贷协议
- 测试网：Kasplex testnet
- 智能合约：0x4BE1E85db381533b871AAEcb778Ed1E607821338
- 默认 RPC：https://rpc.kasplextest.xyz/
- 原生代币：KAS
- 生息代币：fKAS (8 位小数)

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

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

【Network Settings（网络设置）】
- rpc_url：RPC 节点地址（默认 https://rpc.kasplextest.xyz/）
- 如果默认 RPC 失效，可以更换其他节点

【Transaction Settings（交易设置）】
- gas_price_gwei：Gas Price，单位 Gwei（默认 2001）
- 如果交易失败或打包慢，可以适当提高

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

【功能详细说明】

1. Supply (存款) 模式

存款模式会将你的 KAS 代币存入 Fervent 协议，获得 fKAS 代币。fKAS 是生息代币，会随着时间增值。

执行流程：
1. 检查钱包 KAS 余额是否足够
2. 调用智能合约的 mint() 函数
3. 发送指定数量的 KAS
4. 接收相应数量的 fKAS
5. 显示交易结果和余额变化

注意事项：
- 需要保留足够的 KAS 用于支付 Gas 费（建议至少 0.1 KAS）
- 每笔交易会消耗约 300,000 Gas
- fKAS 会随着时间增值，兑换率会变化

2. Withdraw (取款) 模式

取款模式会赎回你的 fKAS 代币，取回对应的 KAS。

执行流程：
1. 查询当前 fKAS/KAS 兑换率
2. 计算需要赎回的 fKAS 数量
3. 检查钱包 fKAS 余额是否足够
4. 调用智能合约的 redeemUnderlying() 函数
5. 燃烧 fKAS，接收 KAS
6. 显示交易结果和余额变化

注意事项：
- 需要保留足够的 KAS 用于支付 Gas 费
- 每笔交易会消耗约 200,000 Gas
- 赎回时会按照当前兑换率计算
- fKAS 余额必须足够，否则交易会失败

3. 余额查询

脚本会自动查询并显示：
- KAS 余额（原生代币）
- fKAS 余额（生息代币）
- 初始余额和最终余额
- 余额变化（正数表示增加，负数表示减少）

4. 兑换率

fKAS 和 KAS 之间有一个动态兑换率：
- 初始时：1 fKAS ≈ 1 KAS
- 随着时间：1 fKAS 价值会增长
- 脚本会自动查询实时兑换率

5. 批量操作

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

【使用步骤】

第一步：准备工作
1. 确保钱包中有足够的 KAS 代币
2. 在 UI 中加载私钥
3. 检查 RPC 节点是否可用

第二步：配置参数
1. 选择操作类型（supply 或 withdraw）
2. 设置每笔交易金额
3. 设置每个钱包交易次数
4. 必要时调整 Gas Price

第三步：执行脚本
1. 点击「开始执行」
2. 查看日志输出
3. 等待所有交易完成
4. 检查最终余额变化

【操作建议】

存款操作建议：
- 首次使用建议先测试小额（0.01-0.1 KAS）
- 确保钱包至少保留 0.1 KAS 作为 Gas 费
- 可以分多笔存入，降低风险
- 存入后 fKAS 会开始计息

取款操作建议：
- 先查看当前兑换率
- 确认 fKAS 余额足够
- 取款前确保有足够的 KAS 支付 Gas
- 可以部分取款，不必全部赎回

交易设置建议：
- 测试网建议：0.01-0.1 KAS per transaction
- Gas Price 通常不需要调整
- 每个钱包 1-3 笔交易即可
- 钱包间延迟 5-10 秒

【重要提示】

1. 网络要求
   - 需要连接到 Kasplex testnet
   - RPC 节点必须可用
   - 网络延迟会影响交易速度

2. 余额要求
   - 存款：需要足够的 KAS + Gas 费
   - 取款：需要足够的 fKAS + Gas 费
   - 建议至少保留 0.1 KAS 作为 Gas 储备

3. Gas 费说明
   - Supply: 约 300,000 Gas
   - Withdraw: 约 200,000 Gas
   - Gas Price: 2001 Gwei (默认)
   - 单笔交易 Gas 费约 0.6 KAS

4. 交易失败原因
   - 余额不足
   - Gas Price 过低
   - RPC 节点问题
   - 网络拥堵
   - 智能合约错误

5. 风险提示
   - 这是测试网，代币无实际价值
   - 智能合约可能有未知风险
   - 建议先小额测试
   - 测试网代币可能会重置

【常见问题】

Q: 什么是 fKAS？
A: fKAS 是 Fervent 协议的生息代币，存入 KAS 后获得。随着时间推移，fKAS 相对于 KAS 的价值会增加。

Q: 为什么需要兑换率？
A: 因为 fKAS 会计息增值，所以 1 fKAS 的价值会大于 1 KAS。兑换率就是当前的价值比例。

Q: Supply 和 Withdraw 可以同时执行吗？
A: 不可以，每次运行只能选择一种模式。如果要执行两种操作，需要分别运行两次。

Q: 为什么交易失败？
A: 常见原因：1) KAS/fKAS 余额不足，2) Gas 费不足，3) RPC 节点问题，4) Gas Price 过低。

Q: 可以取出所有的 fKAS 吗？
A: 可以，但要确保有足够的 KAS 支付 Gas 费。建议分多次取出。

Q: 如何获取测试网 KAS？
A: 通过 Kasplex testnet 的水龙头获取测试代币。

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

Q: 为什么 Gas 费这么高？
A: 这是测试网的设置，Gas Price 较高是为了快速确认交易。

依赖库：
- web3：以太坊和兼容链交互
- asyncio：异步操作支持

官方信息：
- 平台：Fervent (Kasplex testnet)
- 类型：DeFi 借贷协议
- 网络：Kasplex testnet
- 智能合约：0x4BE1E85db381533b871AAEcb778Ed1E607821338

适用场景：
- Kasplex testnet DeFi 交互
- 测试网借贷协议测试
- 批量存取款操作
- DeFi 协议收益测试