Agent402/.env.example at main · MikeyPetrillo/Agent402 · GitHub

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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# Your Base USDC receiving address (an Ethereum-style 0x... address).
# Every payment lands here. Required unless FREE_MODE=true.
WALLET_ADDRESS=

# Primary payment network. The copy-paste default is TESTNET so a fresh clone
# never silently takes real USDC before you mean it to. Switch to "base" (real
# USDC on Base mainnet) only when you intend to accept live money.
NETWORK=base-sepolia
# NETWORK=base                # real USDC on Base mainnet

# Optional: accept USDC on MULTIPLE chains (the agent picks the chain it holds
# funds on). Comma-separated; the primary NETWORK is always included first.
# Default = NETWORK only. Facilitator routing in multi-chain mode: Base stays
# on CDP (keeps Bazaar marketplace discovery + fee-free settlement — set the
# CDP keys above!), PayAI settles the chains CDP doesn't (Solana, Polygon,
# Arbitrum). Without CDP keys everything falls back to PayAI and the Bazaar
# stops indexing this seller (a warning is logged at boot).
# PAYMENT_NETWORKS=base,solana,polygon,arbitrum

# REQUIRED when PAYMENT_NETWORKS includes "solana": the base58 Solana address
# that receives USDC on Solana. Without it the Solana payment option is
# silently omitted from every 402 (a warning is logged at boot) — buyers are
# never offered Solana and no Solana revenue is possible.
# IMPORTANT: the address must already have a USDC token account, or every
# buyer's payment fails on-chain simulation (InvalidAccountData) while your
# 402 looks healthy. One-time fix: send the address any amount of USDC on
# Solana before enabling. Boot checks this and warns (best-effort).
# SOLANA_WALLET_ADDRESS=

# Optional PayAI facilitator auth for multi-chain settlement. The free tier
# (10k settlements/month) needs no keys; get keys at merchant.payai.network.
# PAYAI_API_KEY_ID=
# PAYAI_API_KEY_SECRET=

# Recommended for mainnet: Coinbase Developer Platform API keys (free,
# portal.cdp.coinbase.com). Enables settlement on Base mainnet AND lists
# your endpoints in the x402 Bazaar so agents can discover them.
CDP_API_KEY_ID=
CDP_API_KEY_SECRET=

# Alternative to CDP keys: any x402 facilitator URL that supports your network.
# FACILITATOR_URL=

# Public URL of this deployment (used in docs/examples on the landing page).
# BASE_URL=https://your-app.up.railway.app

# Set to "true" to disable payments entirely (local demo only).
# FREE_MODE=false

# OpenAI-compatible LLM gateway (/v1/chat/completions + tiers): OpenRouter
# API key from openrouter.ai — the gateway spends this account's prepaid
# balance per call, AFTER the buyer's x402 payment settles. Unset = the
# three /v1 routes return 503.
# OPENROUTER_API_KEY=

# Proof-of-work tier (the "pay with compute" alternative for non-payers).
# POW_DIFFICULTY=20            # leading zero bits (8-28); higher = more CPU per free call
# POW_SECRET=                 # stable secret so challenges survive restarts (unset = a fresh random secret per process; set one in production)

# Similarity recall (/api/memory/remember + /recall). Defaults to a local
# lexical embedder (no key). Point these at any OpenAI-compatible /embeddings
# endpoint (OpenAI, Voyage, Together, DeepInfra, …) for true semantic recall.
# EMBEDDINGS_URL=https://api.openai.com/v1/embeddings
# EMBEDDINGS_MODEL=text-embedding-3-small
# EMBEDDINGS_API_KEY=