Skip to content

docs: update docs [skip-line-limit]#1519

Merged
ctrlc03 merged 6 commits into
mainfrom
docs/update
Apr 16, 2026
Merged

docs: update docs [skip-line-limit]#1519
ctrlc03 merged 6 commits into
mainfrom
docs/update

Conversation

@ctrlc03

@ctrlc03 ctrlc03 commented Apr 14, 2026

Copy link
Copy Markdown
Collaborator

Summary by CodeRabbit

  • Documentation
    • Added comprehensive technical documentation covering committee selection, distributed key generation, zero-knowledge proofs, and commitment consistency mechanisms.
    • Expanded docs navigation with new "Technical Deep Dives" section for internal protocol details.
    • Updated SDK examples and guidance to use production-grade BFV parameter preset with parameter-to-contract mapping clarity.
    • Updated documentation branding and domain references across packages and examples.

@ctrlc03 ctrlc03 requested review from 0xjei and cedoor April 14, 2026 14:19
@vercel

vercel Bot commented Apr 14, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
enclave-docs Ready Ready Preview, Comment Apr 15, 2026 4:00pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
crisp Skipped Skipped Apr 15, 2026 4:00pm

Request Review

@coderabbitai

coderabbitai Bot commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Warning

Rate limit exceeded

@ctrlc03 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 57 minutes and 30 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 57 minutes and 30 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 2d55e7aa-382b-419c-84e9-f8ab89a83d2b

📥 Commits

Reviewing files that changed from the base of the PR and between 1dafbaa and f17b0b6.

📒 Files selected for processing (18)
  • README.md
  • docs/pages/_meta.json
  • docs/pages/ciphernode-operators/index.mdx
  • docs/pages/cryptography.mdx
  • docs/pages/internals/_meta.json
  • docs/pages/internals/commitment-consistency.mdx
  • docs/pages/internals/dkg.mdx
  • docs/pages/internals/sortition.mdx
  • docs/pages/sdk.mdx
  • examples/CRISP/Readme.md
  • examples/CRISP/client/src/pages/Landing/components/Hero.tsx
  • examples/CRISP/packages/crisp-zk-inputs/README.md
  • examples/CRISP/program/README.md
  • packages/enclave-config/README.md
  • packages/enclave-contracts/README.md
  • packages/enclave-mcp/README.md
  • packages/enclave-mcp/src/index.ts
  • packages/enclave-sdk/README.md
📝 Walkthrough

Walkthrough

This pull request adds comprehensive technical documentation for internal Interfold protocols (sortition, DKG, ZK proofs, and commitment consistency), updates SDK and package documentation with corrected BFV parameter preset examples, and migrates domain references from enclave.gg to theinterfold.com across documentation and example code.

Changes

Cohort / File(s) Summary
Internal Technical Documentation
docs/pages/internals/_meta.json, docs/pages/internals/sortition.mdx, docs/pages/internals/dkg.mdx, docs/pages/internals/zk-proofs.mdx, docs/pages/internals/commitment-consistency.mdx
New documentation section with detailed technical deep dives into sortition committee selection, DKG & threshold cryptography, ZK proof pipeline, and commitment consistency enforcement mechanisms.
Documentation Navigation & Structure
docs/pages/_meta.json, docs/pages/ciphernode-operators/index.mdx
Added "Internals" separator and navigation entry to docs structure; updated ciphernode operator guide links to use relative routes instead of full paths.
SDK & Configuration Documentation
docs/pages/sdk.mdx, packages/enclave-sdk/README.md
Updated BFV parameter preset examples from INSECURE_THRESHOLD_512 to SECURE_THRESHOLD_8192 with expanded guidance on preset-to-contract mapping and production usage warnings.
Domain Migration (enclave.gg → theinterfold.com)
examples/CRISP/Readme.md, examples/CRISP/client/src/pages/Landing/components/Hero.tsx, packages/enclave-mcp/README.md, packages/enclave-mcp/src/index.ts
Updated documentation links and base URL constant to point to theinterfold.com domain.
Package & Project README Enhancements
README.md, examples/CRISP/packages/crisp-zk-inputs/README.md, examples/CRISP/program/README.md, packages/enclave-config/README.md, packages/enclave-contracts/README.md, packages/enclave-mcp/README.md
Enhanced documentation with clearer descriptions, new sections (Architecture, Entry Points, Contract Overview, Key Interfaces), prerequisite clarifications, and usage examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested labels

documentation

Suggested reviewers

  • cedoor
  • 0xjei

Poem

🐰 Hops of documentation bright,
New internals sections in sight,
From enclave to interfold we bound,
With secure presets and proofs all around,
The docs now bloom with technical light!

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'docs: update docs' is vague and fails to convey the specific scope or nature of documentation changes made in this PR. Provide a more descriptive title that highlights the main documentation updates, such as 'docs: add internals section and update deployment/SDK docs' to clarify the primary changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/update

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.

@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: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
examples/CRISP/client/src/pages/Landing/components/Hero.tsx (1)

51-57: ⚠️ Potential issue | 🟠 Major

Use HTML anchor tag instead of Link for external URLs.

The Link component is designed for internal client-side routing. For external URLs like https://docs.theinterfold.com opened with target='_blank', use <a href> with rel='noopener noreferrer' to prevent tabnabbing vulnerabilities and follow React Router best practices.

Proposed fix
-            <Link
-              target='_blank'
-              to='https://docs.theinterfold.com'
-              className='inline-flex cursor-pointer items-center space-x-1 text-lime-600 duration-300 ease-in-out hover:underline hover:opacity-70'
-            >
+            <a
+              target='_blank'
+              rel='noopener noreferrer'
+              href='https://docs.theinterfold.com'
+              className='inline-flex cursor-pointer items-center space-x-1 text-lime-600 duration-300 ease-in-out hover:underline hover:opacity-70'
+            >
               <div>Learn more.</div>
-            </Link>
+            </a>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@examples/CRISP/client/src/pages/Landing/components/Hero.tsx` around lines 51
- 57, The external navigation is using the React Router Link component in
Hero.tsx (the Link element wrapping "Learn more.") which is for internal
routing; replace that Link with a plain anchor element (<a
href="https://docs.theinterfold.com">) keeping the same className,
target='_blank' and add rel='noopener noreferrer' to prevent tabnabbing and
follow best practices for external links.
🧹 Nitpick comments (1)
docs/pages/internals/sortition.mdx (1)

30-31: Optional locale consistency tweak: prefer “afterward” over “afterwards.”

This keeps wording aligned with American English style in docs.

Suggested edit
- proposed but publicly verifiable afterwards.
+ proposed but publicly verifiable afterward.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/pages/internals/sortition.mdx` around lines 30 - 31, The sentence
referencing `prevrandao` and `e3Id` uses “afterwards”; update that word to
“afterward” to match American English locale consistency in the docs—locate the
sentence mentioning `prevrandao` and `e3Id` (the description about RANDAO reveal
being unpredictable before the block is proposed but publicly verifiable
afterwards) and replace “afterwards” with “afterward” while preserving the rest
of the wording and punctuation.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/pages/internals/zk-proofs.mdx`:
- Around line 25-26: Update the docs map to use the canonical circuit name
"ShareComputation" instead of the two variant labels "SkShareComputation" and
"ESmShareComputation"; reflect that ProofType::C2aSkShareComputation and
ProofType::C2bESmShareComputation both map to CircuitName::ShareComputation and
note that SK vs ESm is resolved by orchestration/input type (see orchestration
in multithread.rs) so replace the two entries with a single ShareComputation
entry and a short note about SK/ESm distinction being handled upstream.

In `@examples/CRISP/packages/crisp-zk-inputs/README.md`:
- Around line 54-55: The README line incorrectly instructs importing order;
update the sentence referencing init() in the README to say "Call init() once
before calling any APIs from `@crisp-e3/zk-inputs`" (or similar) so it no longer
claims you must import before other imports; keep mention that init() fetches
the WASM in browsers and is a no-op in Node.js and ensure the symbol init() and
package name `@crisp-e3/zk-inputs` remain in the revised sentence.

---

Outside diff comments:
In `@examples/CRISP/client/src/pages/Landing/components/Hero.tsx`:
- Around line 51-57: The external navigation is using the React Router Link
component in Hero.tsx (the Link element wrapping "Learn more.") which is for
internal routing; replace that Link with a plain anchor element (<a
href="https://docs.theinterfold.com">) keeping the same className,
target='_blank' and add rel='noopener noreferrer' to prevent tabnabbing and
follow best practices for external links.

---

Nitpick comments:
In `@docs/pages/internals/sortition.mdx`:
- Around line 30-31: The sentence referencing `prevrandao` and `e3Id` uses
“afterwards”; update that word to “afterward” to match American English locale
consistency in the docs—locate the sentence mentioning `prevrandao` and `e3Id`
(the description about RANDAO reveal being unpredictable before the block is
proposed but publicly verifiable afterwards) and replace “afterwards” with
“afterward” while preserving the rest of the wording and punctuation.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a45c2e40-6394-4427-aea1-1ade598ffb54

📥 Commits

Reviewing files that changed from the base of the PR and between 6359bfd and 1dafbaa.

📒 Files selected for processing (18)
  • README.md
  • docs/pages/_meta.json
  • docs/pages/ciphernode-operators/index.mdx
  • docs/pages/internals/_meta.json
  • docs/pages/internals/commitment-consistency.mdx
  • docs/pages/internals/dkg.mdx
  • docs/pages/internals/sortition.mdx
  • docs/pages/internals/zk-proofs.mdx
  • docs/pages/sdk.mdx
  • examples/CRISP/Readme.md
  • examples/CRISP/client/src/pages/Landing/components/Hero.tsx
  • examples/CRISP/packages/crisp-zk-inputs/README.md
  • examples/CRISP/program/README.md
  • packages/enclave-config/README.md
  • packages/enclave-contracts/README.md
  • packages/enclave-mcp/README.md
  • packages/enclave-mcp/src/index.ts
  • packages/enclave-sdk/README.md

Comment thread docs/pages/internals/zk-proofs.mdx Outdated
Comment thread examples/CRISP/packages/crisp-zk-inputs/README.md Outdated
Comment thread docs/pages/internals/commitment-consistency.mdx Outdated
Comment thread docs/pages/internals/commitment-consistency.mdx Outdated
Comment thread docs/pages/internals/commitment-consistency.mdx Outdated
Comment thread docs/pages/internals/commitment-consistency.mdx Outdated
Comment thread docs/pages/internals/dkg.mdx Outdated
Comment thread docs/pages/internals/dkg.mdx Outdated
Comment thread docs/pages/internals/dkg.mdx Outdated
Comment thread docs/pages/internals/dkg.mdx Outdated
Comment thread docs/pages/internals/dkg.mdx Outdated
Comment thread docs/pages/internals/zk-proofs.mdx Outdated

@0xjei 0xjei 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.

utACK

@ctrlc03 ctrlc03 merged commit b147924 into main Apr 16, 2026
32 checks passed
@ctrlc03 ctrlc03 deleted the docs/update branch April 16, 2026 07:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants