Skip to content

docs: replace inherited Frontier branding and disclosure policy - #135

Open
0xrlawrence wants to merge 1 commit into
orbinum:mainfrom
0xrlawrence:docs/orbinum-branding-and-disclosure
Open

docs: replace inherited Frontier branding and disclosure policy#135
0xrlawrence wants to merge 1 commit into
orbinum:mainfrom
0xrlawrence:docs/orbinum-branding-and-disclosure

Conversation

@0xrlawrence

Copy link
Copy Markdown

The docs site and the security policy were carried over from Frontier and still describe that project rather than this one. Everything here is documentation.

What this changes

SECURITY.md was Frontier's verbatim. It routed vulnerability reports to security@bitarray.dev and told low-severity reporters to "open an issue in the Frontier repo directly", so a report about the shielded pool would have gone to Frontier's maintainers rather than yours. Rewritten around security@orbinum.net, which CONTRIBUTING.md already names, with a scope section covering the node, orbinum/circuits, and the SDKs, plus a line routing genuine upstream Frontier issues back upstream. I also stated plainly that there is no bug bounty, since that is a question a reporter will otherwise ask.

docs/.vitepress/config.mts set title: "Frontier", base: /frontier, a GitHub social link to polkadot-evm/frontier, an API link to Frontier's pallet_evm rustdocs, and a Copyright © 2018-present, Frontier developers footer.

docs/index.md and docs/overview.md were Frontier's landing page and its explanation of Frontier's three EVM integration models (EVM-execution-only, post-block generation, pre-block feeding). None of that describes this repository. Replaced with an Orbinum overview built from the README, the pallet docs, and the Circom circuits: the public/private domains, the commitment and nullifier construction, what the transfer proof establishes, gasless submission, note recovery, and the crate layout.

CONTRIBUTING.md gave a fixed "estimated opening date" for external contributions that has now passed. Replaced with a pointer to Discussions so the section does not silently go stale again, and linked SECURITY.md from the vulnerability-reporting line.

Two things I could not decide for you

  • base: /frontier had to become something. I used /node on the assumption of GitHub Pages at orbinum.github.io/node, but if this site is deployed elsewhere the value should match that, and the API link needs the same treatment. Both are one-liners to adjust.
  • Given docs.orbinum.network exists, this VitePress site may be vestigial. If so, deleting docs/ is probably a better change than this one, and I am happy to redo it that way.

Cargo.toml still lists homepage = "https://orbinum.net" and contact@orbinum.net while the live site is orbinum.network. I left those alone rather than guess which is canonical.

Verification

Documentation only, no code or configuration outside docs/ touched. I was not able to build the workspace, so I have not run the VitePress build. The config change is a value swap on five existing keys, but the base path is worth a second look for the reason above.


Separately, I have emailed security@orbinum.net about a small number of higher-severity findings from the same review pass. Those are deliberately not in this PR, in any other PR, or in a public issue. Happy to hold them for as long as you need.

The docs site and the security policy were carried over from Frontier and
still describe that project rather than this one.

- SECURITY.md routed vulnerability reports to security@bitarray.dev and to
  "the Frontier repo", so a report about the shielded pool would have reached
  Frontier's maintainers rather than Orbinum's. Rewritten around
  security@orbinum.net, the address CONTRIBUTING.md already names, with a
  scope section covering the node, orbinum/circuits, and the SDKs, and a note
  routing genuine upstream Frontier issues back to Frontier.

- docs/.vitepress/config.mts set title "Frontier", base '/frontier', a GitHub
  link to polkadot-evm/frontier, an API link to Frontier's rustdocs, and a
  "Copyright Frontier developers" footer.

- docs/index.md and docs/overview.md were Frontier's landing page and its
  explanation of Frontier's three EVM integration models, neither of which
  applies here. Replaced with an Orbinum overview drawn from the repository
  README and the pallet documentation: the public/private domains, the
  commitment and nullifier construction, what the transfer proof establishes,
  gasless submission, note recovery, and the crate layout.

- CONTRIBUTING.md gave a fixed "estimated opening date" for external
  contributions that has now passed. Replaced with a pointer to Discussions so
  the section does not silently go stale again, and linked SECURITY.md from
  the vulnerability-reporting line.

Documentation only. No code or configuration outside docs/ is touched.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.

1 participant