{"service":"darksol-agentcomms","name":"DARKSOL AgentComms","status":"scaffolded","description":"x402-gated worldwide-access disposable phone numbers plus US-only premium durable lines for autonomous agents. Disposable SMS checks are live; premium durable line messaging is rolling out over the next 72 hours.","baseUrl":"https://acp.darksol.net/agentcomms","api":"https://acp.darksol.net/api/agentcomms","webhooks":{"telnyxInboundSms":"https://acp.darksol.net/api/agentcomms/telnyx/webhook","auth":"no shared secret configured yet","durableStorage":false,"storage":{"backend":"memory_ephemeral","durable":false},"storageNote":"Inbound SMS inbox is using ephemeral memory fallback until KV/Upstash env vars are configured."},"pricing":{"disposableNumber":{"provider":"zyla","coverage":"worldwide-access where upstream inventory is available","standard":"$1.00 USDC","darksolHolder":"$0.50 USDC","retention":"temporary/provider-dependent"},"premiumSearch":{"provider":"telnyx","standard":"$0.05 USDC","darksolHolder":"free"},"premiumLine":{"provider":"telnyx","standard":"$10.00 USDC setup + pass-through provider rental","darksolHolder":"$10.00 USDC setup + pass-through provider rental","term":"3 months; renewal required before expiry"},"messages":{"disposable":"$0.01 USDC","premium":"$0.02 USDC","darksolHolder":"free where enabled"},"holderMinimum":"10000000 DARKSOL on Base"},"providers":{"zyla":{"tier":"disposable","enabled":true,"durable":false},"telnyx":{"tier":"premium","enabled":true,"durable":true,"note":"Requires TELNYX_API_KEY and optional TELNYX_MESSAGING_PROFILE_ID."},"twilio":{"tier":"premium","enabled":false,"durable":true,"status":"adapter placeholder/fallback"}},"disposableCoverage":"worldwide-access via Zyla country inventory; call /countries for available country codes","premiumSupportedCountries":["US"],"currentLimitations":["Disposable Zyla tier has worldwide access where upstream inventory is available.","Disposable tier is intended for short-lived 15-20 minute verification workflows.","Premium durable lines are $10 USDC setup, US-only, designed for persistent agent identity, and last 3 months unless renewed.","Premium inbound/verification messaging is being completed over the next 72 hours; outbound is limited preview only until 10DLC/Toll-Free verification is enabled.","Telnyx paid account limitations currently include no 10DLC, no Toll-Free verification, no hosted messaging, 5 concurrent outbound calls, 10 outbound calls/hour, and 100 outbound calls/day.","Voice/calls are not public yet."],"holderAccess":{"token":"0x00cb1fbca324d51325a7264d54072bc073c28ba3","chain":"base","requiredBalance":"10000000","proof":"Sign the DARKSOL holder proof message, then send x-darksol-wallet + x-darksol-signature headers.","proofMessageTemplate":"DARKSOL Oracle free access\nWallet: 0x0000000000000000000000000000000000000000\nChain: Base (8453)\nPurpose: prove token-holder access without payment"},"endpoints":{"health":"GET /api/agentcomms/health","countries":"GET /api/agentcomms/countries","numbers":"POST /api/agentcomms/numbers { countryCode }","premiumSearch":"GET /api/agentcomms/premium-search?provider=telnyx&countryCode=US&areaCode=857","premiumProvision":"POST /api/agentcomms/premium-lines { provider:\"telnyx\", phoneNumber:\"+1...\" } — $10 setup, 3-month term, renewal required","premiumProvisionBankr":"https://x402.bankr.bot/0x8f9fa2bfd50079c1767d63effbfe642216bfcb01/agentcomms-premium-lines","messages":"GET /api/agentcomms/messages?countryCode=<id>&phoneNumber=<number>","inbox":"GET /api/agentcomms/inbox?provider=telnyx&phoneNumber=%2B1...&limit=20","send":"POST /api/agentcomms/send { provider:\"telnyx\", from:\"+1...\", to:\"+1...\", text:\"...\" } — limited preview; no marketing/blast traffic until 10DLC/Toll-Free verification is enabled","lines":"GET /api/agentcomms/lines","telnyxWebhook":"POST /api/agentcomms/telnyx/webhook","skill":"GET /api/agentcomms/download-skill"},"agentInstructions":["Call /countries first if you do not know the countryCode.","Use provider=zyla for worldwide-access disposable verification numbers; these can expire quickly and availability depends on upstream country inventory.","Use premium-search then premium-lines with provider=telnyx for durable US agent phone lines. Persist expiresAt; lines last 3 months unless renewed.","After any number endpoint returns a phoneNumber, persist provider + countryCode + phoneNumber in your own memory/state.","Reuse the saved provider + countryCode + phoneNumber when calling /messages or /inbox.","Do not create a new number for the same workflow unless the previous number failed, expired, or the user explicitly requested a new premium line.","Do not tight-loop message checks; use reasonable backoff."]}