docs: add obol-stack technical specification bundle#297
Open
docs: add obol-stack technical specification bundle#297
Conversation
…ures Two issue specifications for carving PR #288 into focused PRs: 1. reth-erc8004-indexer Helm chart - Standalone chart with 3-tier discovery fallback - Reth indexer → BaseScan (native ERC-8004 metadata) → 8004scan - Go DiscoveryClient interface with FallbackClient 2. Autoresearch infrastructure Helm chart - Round-based reward engine with OPOW influence calculation - Anti-monopoly parity formula penalizing concentrated workers - Commit-reveal Merkle proof verification - Escrow settlement via x402 Commerce Payments Protocol (5x-audited Base contracts, zero custom Solidity) - x402-rs implications and contribution path 9 Gherkin feature files (40+ scenarios): - escrow_round_lifecycle.feature (fixed: receiver is per-PaymentInfo, uses RewardDistributor contract as single receiver) - opow_influence_calculation_with_anti_monopoly_parity.feature (fixed: penalty values verified against TIG opow.rs math, added single-challenge and phase-in scenarios) - commit_reveal_work_verification.feature - reward_pool_distribution_across_roles.feature - multi_tier_worker_discovery_with_fallback.feature - end_to_end_autoresearch_round.feature - erc8004_identity_lifecycle.feature (NEW: registration, transfer, deactivation, schema validation during active rounds) - leaderboard_api.feature (NEW: REST API, historical rounds, cumulative earnings) - round_state_continuity.feature (NEW: fund rollover, atomic transitions, worker state reset, on-chain auditability) Cross-reference analysis: - escrow_contract_cross_reference.md (AuthCaptureEscrow contract audit) - FEATURE_REVIEW.md (comprehensive gap analysis vs ERC-8004/x402)
Platform wallet is payer, operator, AND receiver. Escrow is used for verifiable commitment (workers see locked pool on-chain before working), not for routing. After capture() returns USDC to platform wallet, standard ERC20 transfers distribute to workers/innovators. Zero custom Solidity. Zero new deployments. Zero new audits. Only AuthCaptureEscrow (5x audited) + USDC.transfer().
Install backend-service-spec-bundler skill and generate comprehensive spec bundle covering all 9 core subsystems: stack lifecycle, LLM routing, network/RPC gateway, sell-side monetization, buy-side payments, OpenClaw & skills, tunnel management, ERC-8004 identity, standalone inference. - SPEC.md: 1452-line technical specification with Mermaid diagrams - ARCHITECTURE.md: C4 diagrams, module decomposition, data flows - BEHAVIORS_AND_EXPECTATIONS.md: 28 desired, 6 undesired, 7 edge cases - CONTRIBUTING.md: 9 non-negotiable developer rules - 7 BDD feature files (126 Gherkin scenarios) - 6 ADRs (k3d, LiteLLM, x402, pre-signed buyer, Gateway API, ERC-8004)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
backend-service-spec-bundlerskill for structured spec generationSpec Bundle (docs/specs/)
Issue Specs (docs/issues/)
issue-autoresearch-helm-chart.md— reward engine, commit-reveal verification, escrow settlementissue-reth-erc8004-indexer-helm-chart.md— 3-tier discovery fallback, Helm chart structureSkill Installation
backend-service-spec-bundlerinstalled at.agents/skills/with symlink in.claude/skills/— reusable for future spec generation.Test plan