Skip to content

Update Safe Harbor documentation for clarity and accuracy#356

Open
DicksonWu654 wants to merge 7 commits intosecurity-alliance:developfrom
DicksonWu654:safe-harbor-docs-update
Open

Update Safe Harbor documentation for clarity and accuracy#356
DicksonWu654 wants to merge 7 commits intosecurity-alliance:developfrom
DicksonWu654:safe-harbor-docs-update

Conversation

@DicksonWu654
Copy link
Collaborator

@DicksonWu654 DicksonWu654 commented Jan 31, 2026

Frameworks PR Checklist

Safe Harbor is now upgrading to V3, so I'm updating these docs to reflect the new structure. Additionally, some stats about Safe Harbor are out of date so just updating them to be up to date

  • If you are touching an existing piece of content, tag current contributors from the attribution list
  • If there is a steward for that framework, ask the steward to review it
  • If you're modifying the general outline, make sure to update it in the vocs.config.ts adding the dev: true parameter
  • If you need feedback for your content from the wider community, share the PR in our Discord
  • Review changes to ensure there are no typos, see instructions below

- Revised the on-chain adoption guide to reflect the creation of Agreement contracts via the AgreementFactory instead of AgreementV2 contracts.
- Updated references to the Safe Harbor Registry address and the method for registering agreements.
- Enhanced the overview section with updated asset protection statistics and clarified definitions regarding active exploits and whitehat agreements.
- Added details on CAIP-2 chain identifiers in the scope terms section.
- Improved language consistency and formatting across multiple documents, including the self-adoption guide and self-checklist.
- Replaced the outdated Safe Harbor Agreement link in the self-adoption guide with the updated URL for improved accuracy and accessibility.
- Ensured the language remains consistent with the overall documentation style.
@vercel
Copy link

vercel bot commented Jan 31, 2026

@DicksonWu654 is attempting to deploy a commit to the Security Alliance Team on Vercel.

A member of the Team first needs to authorize it.

@DicksonWu654 DicksonWu654 marked this pull request as ready for review January 31, 2026 22:30
@vercel
Copy link

vercel bot commented Feb 2, 2026

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

Project Deployment Actions Updated (UTC)
frameworks Ready Ready Preview, Comment Feb 5, 2026 0:55am

Request Review

@scode2277
Copy link
Collaborator

left a small indication for a link placeholder :))

- Updated the description to emphasize the legal protection provided to protocols and security researchers during DeFi exploits.
- Improved the overview section with a clear definition of Safe Harbor as an open-source framework.
- Enhanced image alt text for better accessibility and context.
- Revised the "How Safe Harbor Protects Your Protocol" section for clarity on pre-authorization processes.
- Updated the "How to Adopt Safe Harbor" section to reflect a more user-friendly onboarding process.
…ine content and enhance clarity. This change focuses on maintaining concise documentation while ensuring essential information remains accessible.
@scode2277
Copy link
Collaborator

Hey @DicksonWu654, please feature this guide for the frontmatter description. It has to fit max 160 chars otherwise it gets cut by the search engines

- Updated the description to enhance clarity and emphasize legal protections for protocols and researchers.
- Improved formatting of import statements and image tags for better readability.
- Revised sections for clearer definitions and streamlined content presentation.
- Enhanced accessibility by updating alt text for images and ensuring consistent terminology throughout the document.
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