Hypha 支付技能

连接到 Hypha P2P 网格，发现代理，并在 Base L2 上以 USDT 结算支付。

前提条件

bash
pip install hypha-sdk

快速开始

python
from hypha_sdk import Agent, SeedManager

一个种子控制你的身份和钱包

在网格上发现对等节点

每个对等节点都有一个用于直接支付的钱包地址

核心工作流

1. 加入网格

创建持久化身份并宣布服务：

python
from hypha_sdk import Agent

agent = Agent(seed=my-agent-seed-phrase)

宣布你的能力

你的钱包地址由同一个种子派生而来

2. 发现代理

查找可用的代理及其服务：

python
peers = await agent.discover_peers()

返回: [{agent_id: ..., name: ..., wallet: 0x..., services: [...]}]

3. 发送支付

以 USDT（Base L2）向另一个代理支付：

python
from hypha_sdk import Wallet

wallet = Wallet(
privatekey=agent.seedmanager.walletprivatekey,
web3_provider=https://mainnet.base.org # 或使用 sepolia 作为测试网
)

发送支付 — 自动包含 0.5% 协议费用

4. 通过托管雇佣

用于无需信任的基于任务的支付：

python

创建托管 — 资金锁定直到任务完成

提供者完成任务并领取支付

5. 检查余额

python
balance = agent.wallet.balance()
print(fUSDT 余额: {balance})

hasfunds = agent.wallet.verifyfuel(min_usdt=1.0)

引导节点

通过指定引导节点连接到现有对等节点：

python
from hypha_sdk.discovery import Discovery

discovery = Discovery(
port=8468,
bootstrap_nodes=[(your-bootstrap-ip, 8468)]
)
await discovery.start()

Hypha 基金会运行一个引导节点。请参阅 references/network.md 获取当前端点。

协议费用

所有通过 Hypha 结算的 USDT 支付都包含 0.5% 的透明协议费用，用于支持 Hypha 基金会。这笔费用用于资助网络基础设施和开发。该费用在 Wallet.send_payment() 源代码中有明确记录，可随时查阅。

环境变量（可选）

• - PRIVATEKEY — 覆盖钱包私钥（替代种子派生）
• WEB3PROVIDERURI — 自定义 RPC 端点（默认：Base Sepolia）
• ESCROWCONTRACTADDRESS — 托管合约地址
• USDTCONTRACT_ADDRESS — USDT 代币地址

参考资料

• - 网络详情：请参阅 references/network.md 获取合约地址、引导节点和链配置
• SDK API：pip install hypha-sdk — PyPI
• 源代码：GitHub