e4c9dda0fd
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- 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
45 lines
2.0 KiB
Markdown
45 lines
2.0 KiB
Markdown
# 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](THIRDWEB_WALLETS_INTEGRATION.md) §3.1.
|
|
|
|
---
|
|
|
|
## Chains
|
|
|
|
- **138:** Hub (DeFi Oracle Meta Mainnet); RPC and Engine overrides: [THIRDWEB_ENGINE_CHAIN_OVERRIDES.md](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](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](ALLTRA_SPONSORSHIP_POLICY_MATRIX.md) — three-tier policy, method allowlist, anti-abuse caps.
|
|
- **Engine:** Add chain 651940 per [THIRDWEB_ENGINE_CHAIN_OVERRIDES.md](THIRDWEB_ENGINE_CHAIN_OVERRIDES.md) so paymaster and backend wallets work.
|
|
|
|
---
|
|
|
|
## Routing and activity feed
|
|
|
|
- **Routing registry:** [config/routing-registry.json](../../config/routing-registry.json); ALT for 138↔651940, CCIP for 138↔others. Helper: `getRouteFromRegistry()` in token-aggregation.
|
|
- **Activity feed:** [ACTIVITY_FEED_SPEC.md](ACTIVITY_FEED_SPEC.md) — `activity_events` table, ingestion, feed API.
|