SOVRx402

Operating status

Current public access, deployment evidence, commercial limits, and recovery controls.

Checking statusGateway health

Current public access

Acceptance on 2026-09-08: https://sovrx402.54-199-0-131.sslip.io/health returned HTTP 200, status ok, and paymentsPaused=false, with no pending requests or settlement recovery. This is a dated snapshot; the website's status indicator refreshes the live health endpoint.

The paid gateway is enabled within its existing bounded budget. Gateway access credentials and wallet signatures are still required. Public explorer reads do not charge a wallet and do not grant access to paid resource results.

bash
# Public read only: no key, payment signature, or mainnet transaction.
curl --max-time 10 -i https://sovrx402.54-199-0-131.sslip.io/health

What has been verified

AreaEvidence and limit
Historical mainnet lifecycleMAINNET_STATUS.md records registration, prepayment/scoring, credit, repayment, exit, and allowance cleanup using bounded project-owned funds.
Historical public HTTPS paymentThe 2026-09-06 acceptance artifact records one /alpha prepayment and immediate/restart replay rejection, with transaction receipts. It is not an ongoing public paid launch.
Current public gatewayThe 2026-09-08 mainline acceptance confirms operating health, retained access control, and recovery-free startup after cold restart.
New resource/result APIrobinhoodMainnet-mainline-acceptance-20260908.json records prepaid and credit delivery, exact request/transaction identity, repayment, exit, and free result retrieval after restart. Two RPC sources verify the 13 transactions and business events.
Default, destructive recovery, and upgrade failure pathsRepository local/fork tests cover these scenarios. They are not represented as destructive live mainnet exercises.
Security auditNo independent audit is asserted by this documentation. Tests and controlled acceptance do not remove owner, implementation, or operational risk.

Pricing and gas funding

The current bounded deployment retains a 1-base-unit call price and 20-base-unit refundable deposit. USDG has six decimals, so one unit is 0.000001 USDG. These unchanged micro-amounts are not a sustainable commercial-pricing or service-level commitment.

Prepaid calls require facilitator settlement gas and separate operator scoring gas. Credit calls require operator gas for each debt transaction. Users pay gas for their own approvals, registration, repayment, and exit. Payment receipts go to the configured payTo/treasury; they do not automatically replenish facilitator ETH.

MAINNET_STATUS.md and ops/README.md record the current bounded budget and operating controls. Earlier pricing proposals are archived and were not adopted. No automatic top-ups or unlimited recurring subsidy are authorized. Refundable deposits and residual wallet balances are not permission to exceed the existing limit.

Maintenance and recovery controls

X402_PAYMENTS_PAUSED=YES blocks new billing and reports maintenance. It does not, by itself, disable every startup recovery transaction. The documented maintenance runtime also uses SOVR_RPC_READ_ONLY=YES to block RPC writes and defer settlement-score recovery.

Preserve the original shared settlement journal, its credit-nonces file, the new requests store where used, and each role's existing gas budget. Reconcile pending transaction hashes and receipts before permitting writes. Never replace durable history with empty files to clear a health warning.

The circuit breakers are separate from service maintenance. Pause Registry and Ledger through their owner to stop their respective write paths while keeping repayment and debt-free withdrawal available. Resume requires reconciled state, usable emergency pause operations, explicit governance, and an authorized operating budget.

Documented mainnet contracts

The following addresses are recorded in MAINNET_STATUS.md for Robinhood chain ID 4663. The public health response matches the token and proxy addresses. Owner, implementation, pause flags, and account state should be read from the contracts for a current view; this table is not a transaction target for the local examples.

ContractAddress
Registry proxy0xE65C9245DBA9CA521CEc3ef38b640bAE05981400
CreditLedger proxy0xf2CB6BFBFADcD4FCE7D8727c7C20C9EA8E06E0d2
TimelockController0x1EEFDE0C9bdD24591548a86265f12d5148ebC527
USDG token0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168

Source records

  • README.md: active architecture, local commands, and the fixed example nature of /alpha.
  • packages/sdk/BaseAgent.ts, lifecycle.ts, types.ts, and package.json: current SDK behavior, types, and build entrypoints.
  • gateway/server-official-x402.ts, resource-gateway.ts, and resources.ts: HTTP routes, stored result behavior, and default handlers.
  • contracts/SOVRx402Registry.sol and contracts/CreditLedger.sol: credit formulas, debt state, permissions, and pause/recovery paths.
  • MAINNET_STATUS.md and deployments/robinhoodMainnet-final-https-acceptance-20260906.json: historical deployment and bounded payment evidence.
  • ROBINHOOD_MIGRATION.md, ops/README.md, and ops/ECONOMICS.md: operational procedures and funding limits. Historical budget figures or route descriptions must be checked against the latest status and current code.
Documentation
OverviewOverview

How the agent SDK, x402 gateway, and deposit-backed credit contracts fit together.

OverviewWhat SOVRx402 does

SOVRx402 adds registration, a refundable token deposit, a score, and an on-chain debt limit to an x402 payment gateway. A reg

OverviewComponents and responsibilities

BaseAgent SDK Signs resource requests and x402 authorizations; exposes registration, repayment, deposit withdrawal, and all

OverviewSupported environments

Local and mainnet share chain ID 4663. Verify the RPC endpoint and node identity as well as the chain ID. BaseAgent is a reta

OverviewAvailable resources

The default alpha handler returns a fixed example string. /alpha validates payment and credit behavior; it is not an external

OverviewAvailability and evidence

The gateway is operating. The 2026-09-08 acceptance records HTTP 200 with status ok and paymentsPaused=false. Paid APIs retai

Local quickstartLocal quickstart

Build the SDK from this checkout and connect a local agent without using mainnet funds.

Local quickstartPrerequisites

Run commands from the SOVRx402 repository root with Node.js, npm, and the repository dependencies already available. These in

Local quickstartPrepare local configuration

For a first setup, create .env.robinhood.local from the local example without replacing an existing file. Fill PRIVATE_KEY, F

Local quickstartStart the local services

Use separate terminals for the long-running node, facilitator, and gateway. Start a node only when its port is free; reuse an

Local quickstartConnect the built SDK

This Node example reads only .env.robinhood.local and performs setup and status reads. Place it at the repository root. It re

Local quickstartMake one local prepaid call

This optional fragment belongs inside main() after setup, using the same verified local agent. It sends local registration/ap