Files

Deploy to Phoenix / deploy (push) Has been cancelled

Details

chore: update submodule references and documentation

- Marked submodules ai-mcp-pmm-controller, explorer-monorepo, and smom-dbis-138 as dirty to reflect recent changes.
- Updated documentation to clarify operator script usage, including dotenv loading and task execution instructions.
- Enhanced the README and various index files to provide clearer navigation and task completion guidance.

Made-with: Cursor

2026-03-04 02:03:08 -08:00

2.0 KiB

Raw Blame History

Alltra + x402 Operator Guide

Purpose: Short operator reference for Alltra (651940) and x402: server wallet usage, chain config, and where to look for runbooks.

Server wallet usage

Use the server wallet (e.g. SERVER_WALLET_ADDRESS in x402-api) only for:
- Contract admin (roles, pausing, upgrades)
- Allowlist/signature minting
- Indexer repair jobs
- Operational controls (key rotation, emergency)
Do not use it in user flows; keep keys in KMS/HSM/custody.
Full policy: THIRDWEB_WALLETS_INTEGRATION.md §3.1.

Chains

138: Hub (DeFi Oracle Meta Mainnet); RPC and Engine overrides: THIRDWEB_ENGINE_CHAIN_OVERRIDES.md.
651940: Alltra (ALL Mainnet); sponsorship and x402 USDC on this chain.

x402 (Alltra-native)

Env: X402_USE_ALLTRA=true, SERVER_WALLET_ADDRESS, optional CHAIN_651940_RPC_URL. When Alltra is used, local verification does not require THIRDWEB_SECRET_KEY.
Spec: X402_ALLTRA_ENDPOINT_SPEC.md — 402 challenge, PAYMENT-SIGNATURE, local verification on 651940 USDC.
API: x402-api returns 402 + PAYMENT-REQUIRED when unpaid; accepts PAYMENT-SIGNATURE with txHash and verifies settlement on 651940.

Sponsorship (paymaster on 651940)

Policy: ALLTRA_SPONSORSHIP_POLICY_MATRIX.md — three-tier policy, method allowlist, anti-abuse caps.
Engine: Add chain 651940 per THIRDWEB_ENGINE_CHAIN_OVERRIDES.md so paymaster and backend wallets work.

Routing and activity feed

Routing registry: config/routing-registry.json; ALT for 138↔651940, CCIP for 138↔others. Helper: getRouteFromRegistry() in token-aggregation.
Activity feed: ACTIVITY_FEED_SPEC.md — activity_events table, ingestion, feed API.

2.0 KiB Raw Blame History