Live x402 SMS rails for agents

AgentComms

Disposable numbers, premium durable US-only lines, and SMS checks priced for autonomous workflows.

Generate burner verification numbers or provision premium durable Telnyx-backed US lines, then check incoming messages through x402. Agents pay per action, remember their assigned provider + number, and reuse the same message route until the job is done. Premium send/receive is landing over the next 72 hours.

View API Health Download Agent Skill
$ GET /api/agentcomms/countries
✓ choose countryCode

$ POST /api/agentcomms/premium/lines
{ "provider": "telnyx", "phoneNumber": "+18575550123" }
→ save provider + phoneNumber in memory

$ GET /api/agentcomms/inbox
?provider=telnyx&phoneNumber=%2B18575550123
✓ inbound SMS persisted

// PRICING

USDC on Base via x402. DARKSOL holder benefits require at least 10,000,000 DARKSOL on Base.

NUMBER
$1.00Generate/get a temporary Zyla virtual phone number. Worldwide access where upstream inventory supports the country.
10M HOLDER
$0.50Number creation discount for 10M+ DARKSOL wallets.
PREMIUM SEARCH
$0.05Search Telnyx durable US lines before provisioning.
PREMIUM LINE
$10.00Provision a durable Telnyx US line for 3 months. Renewal required before expiry, plus pass-through rental/usage.
SMS CHECK
$0.01Check messages for a saved provider + phoneNumber.
10M HOLDER
FREEMessage checks are free for eligible holders.

// AGENT WORKFLOW

Important: agents must remember provider + number. New number every poll is wasteful and brittle.

01 - Discover

Call /api/agentcomms/countries and choose a countryCode. Right now: US only.

02 - Create

Call /api/agentcomms/numbers for disposable Zyla or /api/agentcomms/premium/search then /premium/lines for Telnyx durable lines.

03 - Remember

Persist provider, countryCode, phoneNumber, smsPhoneNumberParam when present, purpose, and createdAt in agent memory/state.

04 - Poll

Call /api/agentcomms/messages or /api/agentcomms/inbox with the same provider/number. Use backoff. Don't tight-loop.

Use policy: AgentComms is for legitimate agent communication and verification workflows. No spam, harassment, fraud, or bypass abuse. SMS contents are sensitive; callers should avoid durable logs.

// API SHAPE

Structured for agents, x402 clients, and Bankr-style workflows.

GET /api/agentcomms/countries
// returns available countries/country codes
POST /api/agentcomms/numbers
{
  "countryCode": "1",
  "agentWallet": "0x..."
}
GET /api/agentcomms/premium/search
/api/agentcomms/premium/search?provider=telnyx&countryCode=US&areaCode=857
POST /api/agentcomms/premium/lines
{`r`n  "provider": "telnyx",`r`n  "phoneNumber": "+18575550123"`r`n}`r`n`r`n# Returns expiresAt + renewalRequired. Lines last 3 months unless renewed.`r`n`r`n# Bankr x402 $10 premium line wrapper`r`nhttps://x402.bankr.bot/0x8f9fa2bfd50079c1767d63effbfe642216bfcb01/agentcomms-premium-lines
GET /api/agentcomms/inbox
/api/agentcomms/inbox?provider=telnyx&phoneNumber=%2B18575550123
POST /api/agentcomms/send
{
  "provider": "telnyx",
  "from": "+18575550123",
  "to": "+14155550123",
  "text": "hello from darksol"
}
GET /api/agentcomms/messages
/api/agentcomms/messages?countryCode=1&phoneNumber=578329806

/api/agentcomms/messages?provider=telnyx&phoneNumber=%2B18575550123

# Bankr x402 wrapper
https://x402.bankr.bot/0x8f9fa2bfd50079c1767d63effbfe642216bfcb01/agentcomms-messages?countryCode=1&phoneNumber=578329806
Holder proof headers
x-darksol-wallet: 0x...
x-darksol-signature: signature over DARKSOL holder proof message