Skip to content

commerce.md

Latest commit

 

History

History
111 lines (77 loc) · 2.91 KB

commerce.md

File metadata and controls

111 lines (77 loc) · 2.91 KB

Commerce

Agent commerce workflows with feeless Stealth transactions.

Why Stealth for Agent Commerce

Stealth's architecture is uniquely suited for autonomous agent transactions:

  1. Feeless — No fees to estimate, no gas limits, no cost overhead
  2. Fast — 5-second block times mean near-instant confirmations
  3. Simple — Direct send, no channels, no routing, no liquidity management
  4. Private — Stealth addresses hide recipient identity

Buyer Agent Workflow

# 1. Set up node (one-time)
skills/stealthd/scripts/install.sh
skills/stealthd/scripts/start-stealthd.sh
skills/stealthd/scripts/create-wallet.sh

# 2. Get funding address
skills/stealthd/scripts/stealthcli.sh getnewaddress

# 3. Fund wallet (send XST from exchange)

# 4. Send payment (feeless, confirms in ~5 seconds)
skills/stealthd/scripts/stealthcli.sh sendtoaddress <seller_address> 100.0

# 5. Get transaction proof
skills/stealthd/scripts/stealthcli.sh listtransactions "" 1

Seller Agent Workflow

# 1. Set up node (one-time)
skills/stealthd/scripts/install.sh
skills/stealthd/scripts/start-stealthd.sh
skills/stealthd/scripts/create-wallet.sh

# 2. Generate payment address (stealth for privacy)
skills/stealthd/scripts/stealthcli.sh getnewstealthaddress

# 3. Share address with buyers

# 4. Monitor payments
skills/stealthd/scripts/stealthcli.sh listtransactions "" 20

# 5. Verify specific payment
skills/stealthd/scripts/stealthcli.sh gettransaction <txid>

# 6. Deliver service/data after confirmation

Agent-to-Agent Loop

1. Buyer requests data from Seller
2. Seller provides stealth address + price
3. Buyer sends XST (feeless, ~5s confirmation)
4. Buyer provides txid as proof of payment
5. Seller verifies payment via gettransaction
6. Seller delivers data

Cost Management

Since Stealth transactions are feeless, cost management is about controlling the amount sent, not the transaction fee:

# Check balance before sending
skills/stealthd/scripts/stealthcli.sh getbalance

# Verify recipient address
skills/stealthd/scripts/stealthcli.sh validateaddress <address>

# Send exact amount needed
skills/stealthd/scripts/stealthcli.sh sendtoaddress <address> <exact_amount>

Wallet Locking

For security, unlock the wallet only when needed:

# Unlock for 60 seconds (just enough to send)
skills/stealthd/scripts/stealthcli.sh walletpassphrase "passphrase" 60

# Send payment
skills/stealthd/scripts/stealthcli.sh sendtoaddress <address> 100.0

# Lock immediately after
skills/stealthd/scripts/stealthcli.sh walletlock

StealthNode Commerce

Agents can also manage StealthNode validators for passive income:

# Check staker price
skills/stealthd/scripts/stealthcli.sh getstakerprice

# Purchase a staker (permanent bond)
skills/stealthd/scripts/stealthcli.sh purchasestaker <alias> ...

# Claim staking rewards
skills/stealthd/scripts/stealthcli.sh claimqposbalance <alias> <staker_id>