Skip to content

docs: readme and contracts#722

Merged
ctrlc03 merged 1 commit into
mainfrom
docs/crisp
Sep 12, 2025
Merged

docs: readme and contracts#722
ctrlc03 merged 1 commit into
mainfrom
docs/crisp

Conversation

@ctrlc03

@ctrlc03 ctrlc03 commented Sep 12, 2025

Copy link
Copy Markdown
Collaborator

Quick update of CRISP readme

related to #723

Summary by CodeRabbit

  • Documentation
    • Restructured CRISP development docs: renamed sections, clarified commands, noted web UI at http://localhost:3000, and stated RISC Zero tooling isn’t required for development.
    • Switched package manager guidance to PNPM with explicit Node/PNPM install steps.
    • Simplified web app setup to the project root; streamlined Ciphernodes and CLI guidance.
    • Marked RISC Zero contract deployment as optional for development.
    • Rebranded contracts README to CRISP terminology with clearer validator/proof descriptions.
    • Removed an outdated RISC Zero Ethereum deployment guide.

@vercel

vercel Bot commented Sep 12, 2025

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments
Project Deployment Preview Comments Updated (UTC)
crisp Skipped Skipped Sep 12, 2025 8:28am
enclave-docs Skipped Skipped Sep 12, 2025 8:28am

@coderabbitai

coderabbitai Bot commented Sep 12, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Documentation updates across CRISP example: restructured main README, revised contracts README to CRISP terminology, and removed the deployment guide file.

Changes

Cohort / File(s) Summary
CRISP Example Root Docs
examples/CRISP/Readme.md
Reorganized development sections; updated package manager to PNPM; clarified setup commands and environment start note; adjusted RISC Zero tooling notes; simplified ciphernodes and CLI guidance; added branch cleanup policy.
Contracts Docs
examples/CRISP/contracts/README.md
Reframed from Ethereum/RISC Zero example to CRISP program description; replaced ImageID/Elf references; outlined validate/verify roles, gating via Semaphore, ciphertext via Greco; removed tool/build specifics.
Deployment Guide Removal
examples/CRISP/deployment-guide.md
Deleted comprehensive RISC Zero Ethereum deployment guide; no replacement content added in this diff.

Sequence Diagram(s)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • auryn-macmillan
  • 0xjei
  • ryardley

Pre-merge checks (3 passed)

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title "docs: readme and contracts" is short and correctly signals documentation changes to README and contract docs present in the diff (CRISP README updates, contracts README changes, and removal of a deployment guide), so it relates to the main change. It is somewhat generic and does not mention CRISP specifically, but it still summarizes the primary intent.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

Poem

A rabbit taps keys with a whiskered grin,
Docs hop in line—tidy, clear, and thin.
Contracts renamed, the burrow’s lore,
Guides pruned back to the forest floor.
PNPM carrots in the dev field grow—
Onward to CRISP, where the bright bits glow! 🥕✨

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.

✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/crisp

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ctrlc03 ctrlc03 requested review from 0xjei and cedoor September 12, 2025 08:28
@ctrlc03 ctrlc03 self-assigned this Sep 12, 2025
@ctrlc03 ctrlc03 enabled auto-merge (squash) September 12, 2025 08:33
@ctrlc03 ctrlc03 added the documentation Improvements or additions to documentation label Sep 12, 2025

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (7)
examples/CRISP/contracts/README.md (1)

10-13: Clarify what exposes these functions (contract/program name) to avoid ambiguity.

If these map to specific Solidity functions or an interface, name it explicitly.

examples/CRISP/Readme.md (6)

27-28: Tighten wording and fix “prerequisites installation” phrasing.

-The two commands above will start everything you need to run the CRISP protocol. You can then interact with it using the web application at `http://localhost:3000`. Please ensure you follow the prerequisites installation for running the protocol locally.
+The commands above will start everything needed to run the CRISP protocol. You can then use the web app at `http://localhost:3000`. Please ensure you complete the prerequisite installation steps for running the protocol locally.

33-38: Consistency: fix RISC Zero note and pnpm casing.

-**RISC Zero toolchain** (not needed for development only)
+**RISC Zero toolchain** (not needed for local development)
@@
-**Pnpm** (as Node package manager)
+**pnpm** (Node package manager)

81-87: Heading and phrasing polish.

-## Setting Up the project
+## Setting up the project
@@
-1. Navigate to the root directory:
+1. Navigate to the project root:

95-105: Clarify terminal context and heading case.

Makes it obvious this runs in a separate terminal.

-## Setting Up the Web App
+## Setting up the web app
@@
-To set up the CRISP dApp in your local environment, follow these steps:
+To set up the CRISP dApp locally:
@@
-1. Navigate to the `client` directory:
+1. In a new terminal, navigate to the `client` directory:

166-171: Fix relative path and improve the “optional” note; standardize casing.

-### Step 3: Deploy the RISC Zero Contracts 
-
-> Please note that this step is optional for development only. You can run the program server in dev mode which does not use Risc0. 
-
-1. Navigate to the `CRISP/lib/risc0-ethereum` directory.
+### Step 3: Deploy the RISC Zero contracts
+
+> Optional for local development: the program server has a dev mode that does not use RISC Zero.
+
+1. Navigate to `examples/CRISP/lib/risc0-ethereum`:

Also applies to: 168-169, 170-171


254-261: Grammar and brevity for ciphernodes section.

-To run three ciphernodes, use the following command inside the CRISP directory:
+To run three ciphernodes, from the CRISP directory run:
@@
-This script will start the ciphernodes, add the ciphernodes to the registry on chain.
+This script starts the ciphernodes and registers them on-chain.
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7ccf6fa and 4cdd6c1.

📒 Files selected for processing (3)
  • examples/CRISP/Readme.md (5 hunks)
  • examples/CRISP/contracts/README.md (1 hunks)
  • examples/CRISP/deployment-guide.md (0 hunks)
💤 Files with no reviewable changes (1)
  • examples/CRISP/deployment-guide.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (8)
  • GitHub Check: build_sdk
  • GitHub Check: build_e3_support_dev
  • GitHub Check: integration_prebuild
  • GitHub Check: build_enclave_cli
  • GitHub Check: test_net
  • GitHub Check: build_e3_support_risc0
  • GitHub Check: test_contracts
  • GitHub Check: rust_unit

Comment thread examples/CRISP/contracts/README.md
Comment thread examples/CRISP/contracts/README.md
Comment thread examples/CRISP/Readme.md

@cedoor cedoor left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, some issues caught by CadeRabbit look legit tho, could be worth checking them.

@ctrlc03 ctrlc03 merged commit e3d9849 into main Sep 12, 2025
25 checks passed
@ctrlc03

ctrlc03 commented Sep 12, 2025

Copy link
Copy Markdown
Collaborator Author

LGTM, some issues caught by CadeRabbit look legit tho, could be worth checking them.

auto merge merged before I could commit those changes, ill add to the next PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants