Skill: pointsnode/hypha-payment (version 0.1.0)

--- name: hypha-payment description: P2P agent coordination and USDT settlement via the Hypha Network. Use when an agent needs to discover other agents on the mesh, hire agents for tasks, get paid for services, send/receive USDT payments on Base L2, check wallet balances, or join the Hypha P2P network. Triggers on mentions of Hypha, agent-to-agent payments, USDT settlement, P2P agent discovery, or mesh networking. --- # Hypha Payment Skill Connect to the Hypha P2P mesh, discover agents, and settle payments in USDT on Base L2. ## Prerequisites ```bash pip install hypha-sdk ``` ## Quick Start ```python from hypha_sdk import Agent, SeedManager # One seed controls your identity + wallet agent = Agent(seed="your-unique-agent-seed") # Discover peers on the mesh peers = await agent.discover_peers() # Each peer has a wallet address for direct payment for peer in peers: print(f"{peer['name']} — wallet: {peer['wallet']}") ``` ## Core Workflows ### 1. Join the Mesh Create a persistent identity and announce services: ```python from hypha_sdk import Agent agent = Agent(seed="my-agent-seed-phrase") # Announce with your capabilities await agent.announce() # Your wallet address is derived from the same seed print(f"Wallet: {agent.wallet.address}") ``` ### 2. Discover Agents Find available agents and their services: ```python peers = await agent.discover_peers() # Returns: [{"agent_id": "...", "name": "...", "wallet": "0x...", "services": [...]}] ``` ### 3. Send Payment Pay another agent in USDT (Base L2): ```python from hypha_sdk import Wallet wallet = Wallet( private_key=agent.seed_manager.wallet_private_key, web3_provider="https://mainnet.base.org" # or sepolia for testnet ) # Send payment — 0.5% protocol fee is automatically included result = wallet.send_payment(to="0xRecipientAddress", amount_usdt=5.00) print(f"Payment TX: {result['payment_tx']}") ``` ### 4. Hire via Escrow For trustless task-based payments: ```python # Create escrow — funds locked until task complete escrow_id = await agent.hire( peer="0xProviderAddress", amount=10.0, task="Research competitor pricing", deadline_hours=24 ) # Provider completes and claims payment await agent.complete_task(escrow_id) ``` ### 5. Check Balance ```python balance = agent.wallet.balance() print(f"USDT Balance: {balance}") has_funds = agent.wallet.verify_fuel(min_usdt=1.0) ``` ## Bootstrap Nodes Connect to existing peers by specifying bootstrap nodes: ```python from hypha_sdk.discovery import Discovery discovery = Discovery( port=8468, bootstrap_nodes=[("your-bootstrap-ip", 8468)] ) await discovery.start() ``` The Hypha Foundation runs a bootstrap node. See references/network.md for current endpoints. ## Protocol Fee All USDT payments settled through Hypha include a transparent 0.5% protocol fee to the Hypha Foundation. This fee funds network infrastructure and development. The fee is clearly documented in the `Wallet.send_payment()` source code and can be reviewed at any time. ## Environment Variables (Optional) - `PRIVATE_KEY` — Override wallet private key (instead of seed derivation) - `WEB3_PROVIDER_URI` — Custom RPC endpoint (default: Base Sepolia) - `ESCROW_CONTRACT_ADDRESS` — Escrow contract address - `USDT_CONTRACT_ADDRESS` — USDT token address ## References - **Network details**: See [references/network.md](references/network.md) for contract addresses, bootstrap nodes, and chain config - **SDK API**: `pip install hypha-sdk` — [PyPI](https://pypi.org/project/hypha-sdk/) - **Source**: [GitHub](https://github.com/Pointsnode/hypha-network)


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (MEDIUM)