Operate ClawCommit

Overview

Execute ClawCommit protocol operations with the repository's canonical commands and deterministic hash model. Load only the reference file needed for the requested workflow.

Start

1. •Confirm environment and dependencies.

• •node -v (18+ expected)
• •npm install

1. •Prepare environment for networked actions.

• •cp .env.example .env
• •Set BSC_RPC_URL, DEPLOYER_PRIVATE_KEY, and BSCSCAN_API_KEY when needed.

1. •Run baseline checks before deployment or mainnet transactions.

• •npx hardhat compile
• •npm test

1. •Select and load the matching reference.

• •Core commit/reveal/replay/deploy: references/core-workflow.md
• •Merkle batch flow: references/batch-workflow.md
• •MCP/SDK/GitHub Action integration: references/integrations-workflow.md
• •OpenClaw workflow: skills/openclaw-native/references/workflow.md

Operating Rules

• •Preserve the V2 hash model exactly: keccak256(abi.encode(prompt, output, modelVersion, nonce)).
• •Reuse identical payload fields and nonce between commit and reveal.
• •Default to bsc only when the user requests mainnet or does not override network.
• •Save proof outputs in deployment-proof/ and batch outputs in artifacts/batches/.
• •Capture and report contract address, commit/batch IDs, transaction hashes, and verification results.
• •Confirm intent before running any state-changing mainnet command.

Fast Paths

• •One-shot deploy plus proof artifacts: npx hardhat run scripts/deployAndProve.ts --network bsc
• •Local batch walkthrough: npm run batch:demo:local
• •Standalone replay check: npx ts-node scripts/replay.ts --tx <REVEAL_TX_HASH>

Bundled Scripts

• •scripts/preflight.sh Run install, compile, and tests in one command before onchain work.

bash <skill-dir>/scripts/preflight.sh --repo <repo-path> [--skip-install]

• •scripts/decision_cycle.sh Run commit -> reveal -> replay as one flow and emit a machine-readable summary.

bash <skill-dir>/scripts/decision_cycle.sh \
  --repo <repo-path> \
  --contract <CONTRACT_ADDRESS> \
  --prompt "<PROMPT>" \
  --output "<OUTPUT>" \
  --model-version "<MODEL_VERSION>" \
  --network bsc \
  --json-out deployment-proof/decision-cycle-summary.json

Supports explicit mainnet opt-in for both commit and reveal:

• •

  --allow-mainnet-writes true

• •

  scripts/batch_local_cycle.sh Run build -> recomputeRoot -> generateProof -> replayBatch --local and optionally write summary JSON.

bash <skill-dir>/scripts/batch_local_cycle.sh \
  --repo <repo-path> \
  --in data/decisions-batch-001.ndjson \
  --out artifacts/batches/batch-001.manifest.json \
  --model-version clawcommit-v2.0 \
  --leaf-index 1 \
  --json-out artifacts/batches/batch-001.local-cycle.json

References

• •references/core-workflow.md
• •references/batch-workflow.md
• •references/integrations-workflow.md