Hyperfold AI

Wallet

Manage agent wallets for autonomous payment processing and fund allocation.

Overview

The hyperfold wallet command manages dedicated wallets for your agents. Wallets provide a controlled fund pool that agents draw from when processing transactions, enabling autonomous commerce while maintaining financial controls.

Creating Wallets

# Create a new wallet for an agent
$ hyperfold wallet create --agent=sales-bot-01

Creating wallet for agent sales-bot-01...
✓ Wallet created

WALLET DETAILS
  Wallet ID:         wal_xyz789
  Agent:             sales-bot-01
  Currency:          USD
  Balance:           $0.00
  Status:            active

# Create wallet with initial funding
$ hyperfold wallet create \
  --agent=premium-sales \
  --currency=USD \
  --initial-balance=5000 \
  --low-balance-alert=500

# Create multi-currency wallet
$ hyperfold wallet create \
  --agent=international-sales \
  --currencies=USD,EUR,GBP \
  --auto-convert=true

Wallet Types

TypeUse Case
OperatingStandard agent transactions (sales, refunds)
EscrowHold funds during negotiation or fulfillment
ReserveEmergency funds for dispute resolution
Multi-currencyInternational transactions with auto-conversion

Managing Wallets

# List all wallets
$ hyperfold wallet list

WALLETS

WALLET ID       AGENT              CURRENCY    BALANCE       STATUS
wal_xyz789      sales-bot-01       USD         $4,250.00     active
wal_abc123      premium-sales      USD         $12,500.00    active
wal_def456      fulfillment-01     USD         $890.00       low balance
wal_ghi789      intl-sales         EUR         €3,200.00     active

# Show detailed wallet info
$ hyperfold wallet show wal_xyz789

WALLET: wal_xyz789
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Agent:              sales-bot-01
Created:            2025-01-15T10:00:00Z
Status:             active

BALANCES
  Available:        $4,250.00
  Pending:          $350.00
  Reserved:         $0.00
  Total:            $4,600.00

LIMITS
  Daily Outflow:    $10,000.00 (used: $2,150.00)
  Monthly Outflow:  $250,000.00 (used: $67,500.00)

ALERTS
  Low Balance:      $500.00
  High Volume:      $5,000/hour

LAST 5 TRANSACTIONS
  -$125.00    refund         ord_123    2 min ago
  +$289.00    sale           ord_122    15 min ago
  +$156.00    sale           ord_121    1 hour ago
  -$45.00     refund         ord_118    3 hours ago
  +$412.00    sale           ord_117    4 hours ago

Funding Operations

# Fund a wallet
$ hyperfold wallet fund wal_xyz789 --amount=5000

Funding wallet...
✓ $5,000.00 added to wallet

Source:          Company Operating Account
New Balance:     $9,250.00
Transaction ID:  txn_fund_abc123

# Set up auto-replenishment
$ hyperfold wallet auto-fund \
  --wallet=wal_xyz789 \
  --threshold=1000 \
  --amount=5000 \
  --source=operating_account

Auto-replenishment configured:
  When balance drops below: $1,000.00
  Replenish amount:         $5,000.00
  Source:                   Company Operating Account

# Withdraw from wallet
$ hyperfold wallet withdraw wal_xyz789 \
  --amount=2000 \
  --destination=operating_account

✓ $2,000.00 withdrawn
New Balance: $7,250.00

Transactions

# View wallet transactions
$ hyperfold wallet transactions wal_xyz789

TRANSACTIONS: wal_xyz789
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

DATE                 TYPE        AMOUNT      REFERENCE       BALANCE
Dec 19, 14:30        sale        +$289.00    ord_122         $4,250.00
Dec 19, 14:15        refund      -$125.00    ord_123         $3,961.00
Dec 19, 13:45        sale        +$156.00    ord_121         $4,086.00
Dec 19, 11:00        refund      -$45.00     ord_118         $3,930.00
Dec 19, 10:15        sale        +$412.00    ord_117         $3,975.00
Dec 19, 09:00        fund        +$5,000.00  txn_fund_xyz    $3,563.00

# Filter transactions
$ hyperfold wallet transactions wal_xyz789 \
  --type=refund \
  --since=7d \
  --output=json

# Export for accounting
$ hyperfold wallet transactions wal_xyz789 \
  --since=2025-01-01 \
  --until=2025-01-31 \
  --format=csv > january-transactions.csv

Reconciliation

Regular reconciliation ensures wallet balances match payment provider records:

# Reconcile wallet with payment provider
$ hyperfold wallet reconcile wal_xyz789

Reconciling wallet wal_xyz789 with Stripe...

RECONCILIATION REPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Period:            Dec 1 - Dec 19, 2025
Transactions:      1,247

HYPERFOLD         STRIPE            STATUS
$187,450.00       $187,450.00       ✓ Matched

Charges:          $195,120.00       $195,120.00       ✓
Refunds:          -$7,670.00        -$7,670.00        ✓

No discrepancies found.

# Auto-reconcile on schedule
$ hyperfold wallet reconcile --schedule=daily --time=02:00

Daily reconciliation scheduled for 02:00 UTC
Results will be sent to: finance@company.com