Repository guide · 0 diagrams

View source on GitHub ↗
Original documentation, preserved from the repository. Historical projections and scenario ambitions are not evidence of live performance. See the current readiness record for deployment requirements.

Omega operator playbook

Use the README for the quickstart. This playbook separates the local rehearsal, configured application stack and real deployment responsibilities. The demo does not register ENS names, publish IPFS files or instantiate production contracts by running its default command.

Run and verify a rehearsal

npm run demo:omega-business-3 -- --scope operator-review
node demo/LARGE-SCALE-OMEGA-BUSINESS-3/lib/verify.cjs /absolute/printed/run-directory
npm run demo:omega-business-3:ui -- --report /absolute/printed/run-directory

Use a new directory for each --out. Preserve report.json and all manifested files together, and archive the digest in a trusted audit system. The ledger describes synthetic jobs; onChainJobId remains null. Owner-report configuration snapshots and fixture test receipts are different evidence classes.

Review scope and economics before commissioning work. USDC business budgets have six decimals and are planning amounts; the optional contract fixture uses the original mock token with 18 decimals. A successful fixture result does not convert units, escrow real customer funds or earn a fee.

Existing owner diagnostics

After root npm ci, use --full to run the four retained owner utilities and the focused contract test. The default planning context is sepolia; local hardhat/localhost contexts may cause the owner parameter utility to bootstrap disposable fixtures. Review the actual phase log and report. Do not describe local bootstrap as a production read-only audit.

npm run demo:omega-business-3 -- --full --network sepolia --timeout-ms 300000
npm run owner:command-center -- --network sepolia --format human --no-mermaid
npm run owner:surface -- --network sepolia --format human

On a fresh checkout, --full --network sepolia stops at the parameter matrix because TaxPolicy and RewardEngine addresses are zero. The JSON matrix and phase log retain the exact errors. Supply reviewed actual deployment configuration before expecting the full workflow to pass; never insert invented addresses to make diagnostics green. Use the standalone local contract test in the README to rehearse mock settlement independently.

Reports expose configured pause, ownership, parameter and treasury information. Production authority must be verified against the actual chain, contract code and owner/governance accounts. A report alone does not prove that an operator can safely pause or upgrade a live deployment.

Launch the separately configured applications

Read the setup guides for Owner Console, Enterprise Portal and Validator UI. Install each app's locked dependencies and configure its actual RPC, chain, contract addresses and any indexer/backend before launching:

npm run demo:omega-business-3:ui -- --stack
App Default loopback URL Port override
Owner Console http://127.0.0.1:3000 OWNER_CONSOLE_PORT
Enterprise Portal http://127.0.0.1:3001 ENTERPRISE_PORTAL_PORT
Validator Desk http://127.0.0.1:3002 VALIDATOR_DASHBOARD_PORT

The supervisor requires Linux/macOS/WSL, checks HTTP readiness for up to 90 seconds, refuses occupied/duplicate ports, supplies Vite's real port flags with --strictPort, and prints a unique private log directory. Failure in one service stops all services. Ctrl+C terminates child process groups; logs remain for diagnosis. Readiness means HTTP response, not correct wallet/RPC/indexer configuration.

Use disposable accounts and a test network for rehearsals. The apps do not automatically preload Omega personas. Enter reviewed mission information manually from the scenario or create an appropriate specification through the portal. Connecting any arbitrary funded wallet is not a safe setup shortcut.

Preserve the original Solaris job flow

The original illustrative briefing remains:

For actionable work, use the narrower energy-balance task and its measurable criteria. The historical title is not a scientific claim. Verify the actual production asset/decimals; never paste the mock reward into a USDC field as a conversion.

The Enterprise Portal exports exact specification bytes for separate publication and URI verification. Attachments remain local unless separately published. Do not use the historical placeholder CIDs as evidence. Verify retrieval and exact content hash before approving a job transaction. Register and verify actual agents/validators; the scenario's ENS labels and .agent.agi.eth / .club.agi.eth identities are illustrative, not proof of registration.

The Validator Desk shows actual configured assignments, voting windows and disputes only when its contracts/indexer are operational. A named persona in a JSON file does not vote. The minimal SimpleJobRegistry fixture has no validator voting, burns or disputes and pays the full mock reward; never infer production behavior from its receipt.

Production commissioning

Keep a reviewable evidence record for each gate before real customer work:

  1. Deployment and money: exact chain ID, deployed code/addresses, actual settlement asset and decimals, governance/treasury ownership, gas/fee bounds, stake/tax prerequisites, pause/upgrade controls and independent contract/release review. Keep deployment/signing keys outside workers.
  2. Worker environment: installed OpenClaw/Work versions and permissions, dedicated OS/browser accounts, approved data rights, isolated tools/apps, enforced network/action boundaries, measured provider costs, spending limits and cancellation. The computer-work guide uses the existing adapter.
  3. Admission and recovery: exact reviewed task digest, unique job/deployment scope, durable shared journal, backed-up settlement state, duplicate prevention, restart and unknown-outcome reconciliation drills. Rehearsal capacity is not a global production queue reservation.
  4. Acceptance and disputes: independently registered reviewers, task-specific evaluators, real review availability, wrong-result/prompt-injection tests, actual app-state inspection, evidence publication and content integrity, dispute/finality behavior and a separate settlement signer. Require evidence beyond model completion or a green fixture check.
  5. Operations and scale: representative task reliability/load tests, bounded queue admission, observed end-to-end costs, monitoring and incident escalation, retention/deletion policy, rollback/stop drills, and customer-authorized rollout. Record what has passed and what remains unresolved.

These are deployment gates, not claims established by this demo's CI. Use the repository RUNBOOK, OperatorRunbook and release workflow for the wider protocol.

Mainnet preparation and explicit execution

npm run demo:omega-business-3:mainnet

By default this prints an inert preparation plan: no RPC, environment overwrite, wallet access or deployment. The original deployment capability remains as an explicit advanced route:

npm run demo:omega-business-3:mainnet -- \
  --execute \
  --config /absolute/reviewed-deployer.json \
  --config-sha256 REVIEWED_64_HEX_DIGEST \
  --env /absolute/protected-operator.env \
  --ticket /absolute/new-mainnet-change-ticket.md

Do not run that example until your independent release review authorizes actual deployment. The config must explicitly name mainnet, nonzero governance and treasury addresses, and a fresh absolute addressbook output path. Compute and review its SHA-256 locally; the wrapper requires a matching digest. The operator env file must already exist and the ticket path must be new. Set MAINNET_RPC_URL in the protected process environment; the wrapper checks eth_chainId = 1 using a bounded HTTPS request before opening an interactive terminal workflow.

The wrapper runs the existing deployment checklist, rechecks the config digest, and invokes the existing interactive one-click wizard without --yes or automatic Compose. The wizard updates the explicit operator env file after deployment using actual address output; review and back up that file in advance. Its existing deployment engine controls transactions and defaults: the wrapper does not independently audit that engine or guarantee a spending cap. A successful deployment produces an owner change ticket for review. An abort, failure, timeout or uncertain receipt requires reconciliation before a retry; never assume a partially completed deployment did nothing.

No production deployment, real provider dispatch, live payment or verified market-size claim is made by this update.

The optional deployment wrapper supplies the reviewed configuration through a private, read-only snapshot for the entire interactive wizard and its deployment child. Editing the original file while confirmation is pending does not change those bytes. The snapshot is removed when the wizard returns, including on failure. The deployment signer remains responsible for the separate operator environment and transaction confirmation.

This route requires the configured governance address to equal the account derived from MAINNET_PRIVATE_KEY; it validates that match before contacting RPC or launching deployment. Multisig and timelock governance require a separately reviewed initialization and ownership-transfer procedure. Do not replace governance with an arbitrary signer just to pass preflight.

The mainnet deployment child atomically reserves the fresh addressbook path before its first transaction and writes through the held file descriptor. An existing or competing output is rejected. A failed deployment retains its reservation, possibly empty, alongside any produced addressbook in the private per-run evidence directory named by the error; an empty file is not a successful addressbook. Reconcile the chain and receipts before any retry. Never remove another run's output to make a retry pass.

The change ticket and addressbook must resolve to distinct paths, including through existing directory symlinks. Tickets are generated in a private staging directory and published exclusively; a competing file is never overwritten. If publication fails, the error identifies the retained staging file for recovery.

The reviewed JSON config and writable operator env must also be distinct files. Preflight rejects identical paths, canonical symlink aliases and hard links, because the wizard updates the env after deployment.

The selected deployer config is validated before any deployment transaction, separately from the repository deployment checklist. Percentages use whole values from 0 to 100 (never fractional ratios), and the slashing distribution must total at most 100. Token amounts use unsigned decimal strings for exact precision; job stake must fit the contract's uint96 units. Durations must resolve to safe whole seconds: use integer seconds or explicit units such as 1d or 1h 30m. Secure-default duration fields require positive integer seconds; pauseOnLaunch is a JSON boolean. Invalid values are rejected rather than rounded or ignored.

The wizard holds the addressbook reservation through secure-default application and environment generation. Both consumers read the same private, read-only snapshot of the produced bytes; neither reopens the public output or the shared docs path. The public file's identity and contents are rechecked between phases. A replacement or modification stops the workflow, retains public evidence for reconciliation, and removes the private snapshot when the workflow returns. Secure defaults receive the reviewed config using the actual supported ONECLICK_CONFIG option.

Every one-click child writes its addressbook directly into a unique private evidence directory using ONECLICK_ADDRESSES_OUTPUT; the source is created exclusively and read only by that run. Concurrent deployments cannot exchange addresses through the historical shared docs file. The private source is removed after all consumers succeed and retained on failure for reconciliation. Direct legacy deploy.ts calls without an explicit output still support docs/deployment-addresses.json.

Computer-work handoffs must fit the real adapter's 32,000-character input-text limit, including the complete instructions, source hash, dashboard URL and embedded input. The row-count ceiling alone does not guarantee a dispatchable task. Oversized handoffs are rejected with an instruction to reduce rows or split the work into separate orders; source data is never silently truncated.

← Back to Large-Scale Omega Business