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.

Wallets work alongside Payment Delegation to provide comprehensive agent payment capabilities with spending controls.

Creating Wallets

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 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

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 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

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 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

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 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
Set up alerts for low balances to prevent failed transactions. Agents cannot process payments when wallet funds are insufficient.
Monitor wallet activity on the Billing Dashboard.