Feature/cyber docs#32
Conversation
WalkthroughDeletes generated VitePress dependency/cache artifacts, updates site navigation and homepage link, and adds or updates many documentation pages across governance, products, tokens, SDK, and options guides (content, structure, and styling changes). Changes
Sequence Diagram(s)sequenceDiagram
autonumber
participant User
participant VitePress
participant Config as "src/.vitepress/config.mts"
participant Docs as "Markdown files"
Note right of VitePress #f7f9fc: Build/runtime loads config and content
User->>VitePress: Request page
VitePress->>Config: Load navigation & sidebar
Config-->>VitePress: Nav & sidebar data
VitePress->>Docs: Resolve requested markdown
Docs-->>VitePress: Rendered HTML
VitePress-->>User: Serve rendered page
sequenceDiagram
autonumber
participant Trader
participant OPX
participant OMLP
participant xLABS
Note right of OPX #eef7f0: Fee & revenue flow (documented in Fees/xLABS)
Trader->>OPX: Open/Close option
OPX->>OMLP: Source liquidity / borrow
OPX->>xLABS: Allocate fees for buyback
xLABS-->>Market: Buyback executed → Burn
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~40 minutes Possibly related PRs
Pre-merge checks and finishing touches❌ Failed checks (1 inconclusive)
✅ Passed checks (2 passed)
✨ Finishing touches🧪 Generate unit tests
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. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 0
🧹 Nitpick comments (19)
src/governance/governance.md (1)
1-1: Bare-bones stub: add at least a short overview or a TODOThe file only contains a top-level heading. Readers following the new sidebar link will land on a blank page, which feels unfinished.
Add a brief paragraph (or a clear “Coming soon” notice) outlining the scope of the future governance docs so navigation does not dead-end.src/products/fees.md (1)
1-1: Provide minimal content or placeholderSame issue as with
governance.md: a single heading with no context. Either flesh it out with a one-sentence summary of the fee model or include an explicit TODO so contributors know what remains.src/.vitepress/config.mts (3)
41-59: Links to non-existent pages will 404 despiteignoreDeadLinks
/products/apiand/products/osvare marked “Under Development” but still resolve to routes.
Until the docs exist, consider:- { text: 'API (Under Development)', link: '/products/api' }, - { text: 'OSV (Under Development)', link: '/products/osv' } + // TODO: add pages once available + { text: 'API (Under Development)', link: '#' }, + { text: 'OSV (Under Development)', link: '#' }This prevents broken links in production while keeping the sidebar placeholders.
78-82: Consistent casing: “DeFi” not “Defi”All other docs use “DeFi”. Update for consistency:
- { text: '4) - TradFi vs Defi', link: '/options-for-starters/tradfi-vs-defi' }, + { text: '4) - TradFi vs DeFi', link: '/options-for-starters/tradfi-vs-defi' },
97-103: Minor formatting – missing indentation & brace alignment hampers readabilityWhile syntactically valid, the closing
]and}in this block are mis-aligned, making the object harder to scan. Consider realigning:- { text: 'How We Make Decisions', link: '/governance/governance' }, - ] - }, + { text: 'How We Make Decisions', link: '/governance/governance' }, + ] + },src/products/xlabs.md (2)
3-5: Grammar & clarity tweaksA few small wording issues:
- “its how users earn” → “it’s how users earn”
- Missing comma before “while simultaneously”
- “its total supply” → “its total supply”
-Introducing **xLABS**, our staking product that functions like buyback program - but with a twist! xLABS was designed to increase in price while simultaneously managing its total supply to prevent inflation. Best of all, its how users earn passive income via revenue sharing from staking in Epicentral Labs! +Introducing **xLABS**, our staking product that functions like a buyback program — but with a twist! xLABS is designed to increase in price, while simultaneously managing its total supply to prevent inflation. Best of all, it’s how users earn passive income via revenue sharing when staking with Epicentral Labs!
26-31: Consider adding a short numeric exampleThe summary is clear but an illustrative calculation (e.g., “Stake 1 000 LABS → receive 1 000 xLABS; if OPX buys back 100 xLABS, supply drops X %, price moves Y %”) would help readers grasp the mechanics faster.
src/products/opx.md (2)
11-16: Polish wording for professional toneA few informal or awkward phrases detract from clarity:
- “knowledgewise” → simply drop; “high barrier to entry.”
- “Its all the information” → “It’s all the information”
-Options-trading can be complicated enough creating a high barrier of entry knowledgewise. Our goal with OPX was to ensure that the UI is user-friendly so that even the first-time options traders can understand. +Options trading is complicated and often has a high barrier to entry. Our goal with OPX was to build a user-friendly UI that even first-time options traders can understand. @@ -On the trading page you will see values, strike prices, expiration dates and option “greeks” articulately displayed before you; Its all the information you could need without being overwhelmed. +On the trading page you will see values, strike prices, expiration dates, and option “Greeks” clearly displayed; it’s all the information you need without being overwhelmed.
17-19: Internal link should omit.mdfor consistencyElsewhere you omit extensions (e.g.,
/governance/governance). Stick to one style; VitePress will resolve correctly without “.md”.-OPX generates revenue fees when users open and close their positions - please visit the [Fees](/products/fees.md) page for more details on how fees are calculated. +OPX generates revenue fees when users open and close their positions — see the [Fees](/products/fees) page for details on how fees are calculated.src/option-standard-sdk/opm.md (2)
6-6: Trim wordiness in BSM rationale sentenceThe phrase “used globally on a daily basis” is verbose. Consider a tighter variant such as:
“We use the BSM because it is a proven, widely-adopted formula for TradFi derivative pricing.”
18-21: Resolve grammar issues in capital-efficiency bulletTwo small glitches:
- “expand maximize” – pick one verb.
- “…win-win scenarios for trader” – missing article.
Example fix:
- Traders can expand maximize their capital efficiency + Traders can maximise their capital efficiency @@ - > Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader + > Mitigates risk by encouraging capital efficiency through spreads, creating potential win-win scenarios for the tradersrc/products/omlp.md (4)
2-4: Spelling & concision touch-ups
- “in order to” → “to”
- “futher” → “further”
- ...borrow funds from liquidity providers in order to cover... + ...borrow funds from liquidity providers to cover... @@ - ...guide for futher details... + ...guide for further details...
15-17: Grammar tightening for OMLP description
- “OMLPs disrupts” → “OMLP disrupts”
- Replace “have the ability to” with “can”.
- OMLPs disrupts traditional markets completely... + OMLP disrupts traditional markets completely... @@ - Now traders have the ability to enter options contracts + Now traders can enter options contracts
33-35: Fix typos: “systen” and “unqiue”- ...two-tiered priority systen... + ...two-tiered priority system... @@ - The yield earned from SAP1 is unqiue because... + The yield earned from SAP1 is unique because...
6-6: Heading punctuation flagged by markdownlint
## Option Contract Structure: "Calls" vs "Puts"ends with a colon after “Structure”. Removing the trailing colon silences MD026.src/options-for-starters/tradfi-vs-defi.md (4)
3-3: Clarify opening sentenceCurrent wording is awkward: “can be offered permissionlessly on-chain access”.
Suggested rewrite:
- Now options trading and options pricing can be offered permissionlessly on-chain access. + Options trading and pricing can now be offered permissionlessly on-chain.
10-10: Remove double space and simplify wording- DeFi options revolutionizes this concept with the utilization of smart contracts. + DeFi options revolutionise this concept through smart-contract utilisation.
25-25: Correct “postions” typo- ...Instead, all postions must be "cash covered"... + ...Instead, all positions must be "cash covered"...
53-53: Fix “philosphy” typo- ...to drive this philosphy! + ...to drive this philosophy!
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
⛔ Files ignored due to path filters (5)
.vitepress/cache/deps/chunk-XYSSNQS4.js.mapis excluded by!**/*.map.vitepress/cache/deps/vitepress___@vue_devtools-api.js.mapis excluded by!**/*.map.vitepress/cache/deps/vitepress___@vueuse_core.js.mapis excluded by!**/*.map.vitepress/cache/deps/vue.js.mapis excluded by!**/*.mapsrc/public/trader_vs_trader.pngis excluded by!**/*.png
📒 Files selected for processing (11)
.vitepress/cache/deps/_metadata.json(0 hunks).vitepress/cache/deps/package.json(0 hunks).vitepress/cache/deps/vue.js(0 hunks)src/.vitepress/config.mts(3 hunks)src/governance/governance.md(1 hunks)src/option-standard-sdk/opm.md(1 hunks)src/options-for-starters/tradfi-vs-defi.md(1 hunks)src/products/fees.md(1 hunks)src/products/omlp.md(1 hunks)src/products/opx.md(1 hunks)src/products/xlabs.md(1 hunks)
💤 Files with no reviewable changes (3)
- .vitepress/cache/deps/package.json
- .vitepress/cache/deps/_metadata.json
- .vitepress/cache/deps/vue.js
🧰 Additional context used
🪛 LanguageTool
src/option-standard-sdk/opm.md
[style] ~6-~6: ‘on a daily basis’ might be wordy. Consider a shorter alternative.
Context: ... reliable formula that is used globally on a daily basis for TradFi derivative pricing. ## Con...
(EN_WORDINESS_PREMIUM_ON_A_DAILY_BASIS)
src/products/omlp.md
[style] ~2-~2: Consider a more concise word here.
Context: ...o borrow funds from liquidity providers in order to cover their positions. Before diving ...
(IN_ORDER_TO_PREMIUM)
[grammar] ~4-~4: Ensure spelling is correct
Context: ...ters"](/options-for-starters) guide for futher details on options markets basics. ## ...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
[style] ~17-~17: The phrase ‘have the ability to’ might be wordy. Consider using “can”.
Context: ...ntract structure was born. Now traders have the ability to enter options contracts by themselves a...
(HAS_THE_ABILITY_TO)
[grammar] ~33-~33: Ensure spelling is correct
Context: ...t. We crafted this two-tiered priority systen to incentivize Total Value Locked ([TvL...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
[style] ~44-~44: ‘Prior to’ might be wordy. Consider a shorter alternative.
Context: ... Expanding option markets: The Summary Prior to OMLP, lenders were never able parti...
(EN_WORDINESS_PREMIUM_PRIOR_TO)
src/options-for-starters/tradfi-vs-defi.md
[grammar] ~25-~25: Ensure spelling is correct
Context: ..., and baked in, stop-loss. Instead, all postions must be "cash covered" - aka collateral...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
[grammar] ~53-~53: Ensure spelling is correct
Context: ...-entry as low as possible to drive this philosphy! Please note that none of the informat...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
🪛 markdownlint-cli2 (0.17.2)
src/products/omlp.md
1-1: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
8-8: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3
(MD001, heading-increment)
8-8: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
13-13: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
19-19: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
TheLazySol
left a comment
TheLazySol
left a comment
There was a problem hiding this comment.
Please review changes @CyberStaker
There was a problem hiding this comment.
Images in this doc will be updated at a later time.
There was a problem hiding this comment.
Actionable comments posted: 0
♻️ Duplicate comments (1)
src/option-standard-sdk/opm.md (1)
3-3: Acronym still present – align with prior feedback
(BSM)is still in the sentence even though the earlier review explicitly asked to remove the parenthetical.
🧹 Nitpick comments (7)
src/option-standard-sdk/opm.md (4)
6-6: Trim wordiness (“on a daily basis”)
The phrase is redundant; the meaning is clear without it.-We use the Black-Scholes Model because it is a proven and reliable formula that is used globally on a daily basis in traditional finance derivatives pricing. +We use the Black-Scholes Model because it is a proven and widely used formula in traditional-finance derivatives pricing.
14-14: Heading has trailing punctuation and mixed casing
Remove the colon at the end and consider lowercase “i.e.” to follow style guides.-### Fractionalized Options for Buyers and Sellers - I.e. : +### Fractionalized options for buyers and sellers (i.e.)
18-18: Grammar – duplicate verbs
expand maximize→ one verb (or add a conjunction).-- Traders can expand maximize their capital efficiency +- Traders can maximize their capital efficiency
21-21: Add missing article
“for trader” → “for the trader” (or “for traders”).-> Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader +> Mitigating risk by encouraging capital efficiency via spreads to create possible win-win scenarios for traderssrc/options-for-starters/tradfi-vs-defi-options.md (3)
10-10: Subject-verb agreement & extra space
“options revolutionizes” → “options revolutionize”; also remove the double space before “utilization”.-DeFi options revolutionizes this concept with the utilization of smart contracts. +DeFi options revolutionize this concept with the utilization of smart contracts.
25-25: Spelling: “postions” → “positions”-... Instead, all postions must be "cash covered" - aka collateralized. +... Instead, all positions must be "cash covered" – aka collateralized.
53-53: Spelling: “philosphy” → “philosophy”-... to drive this philosphy! +... to drive this philosophy!
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (4)
src/.vitepress/config.mts(3 hunks)src/introduction/about-epicentral-labs.md(1 hunks)src/option-standard-sdk/opm.md(1 hunks)src/options-for-starters/tradfi-vs-defi-options.md(1 hunks)
✅ Files skipped from review due to trivial changes (1)
- src/introduction/about-epicentral-labs.md
🚧 Files skipped from review as they are similar to previous changes (1)
- src/.vitepress/config.mts
🧰 Additional context used
🪛 LanguageTool
src/option-standard-sdk/opm.md
[style] ~6-~6: ‘on a daily basis’ might be wordy. Consider a shorter alternative.
Context: ... reliable formula that is used globally on a daily basis in traditional finance derivatives pric...
(EN_WORDINESS_PREMIUM_ON_A_DAILY_BASIS)
src/options-for-starters/tradfi-vs-defi-options.md
[grammar] ~25-~25: Ensure spelling is correct
Context: ..., and baked in, stop-loss. Instead, all postions must be "cash covered" - aka collateral...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
[grammar] ~53-~53: Ensure spelling is correct
Context: ...-entry as low as possible to drive this philosphy! Please note that none of the informati...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
🪛 markdownlint-cli2 (0.17.2)
src/option-standard-sdk/opm.md
14-14: Trailing punctuation in heading
Punctuation: ' :'
(MD026, no-trailing-punctuation)
20-20: Blank line inside blockquote
(MD028, no-blanks-blockquote)
There was a problem hiding this comment.
Actionable comments posted: 0
♻️ Duplicate comments (1)
src/products/omlp.md (1)
1-1: Heading still uses “Lending” instead of the agreed “Liquidity”Prior feedback requested the acronym to expand to Option Margin Liquidity Pool.
-# Option Margin Lending Pool (OMLP) +# Option Margin Liquidity Pool (OMLP)
🧹 Nitpick comments (6)
src/products/xlabs.md (2)
1-1: Drop the trailing colon in the main headingAvoid punctuation at the end of headings (MD026).
-# xLABS – Revshare re-configured: +# xLABS – Revshare re-configured
8-19: Normalize heading levels and remove surplus colonsH3 bumps directly after H1 violate MD001, and the colons are unnecessary. Moving to H2 also improves hierarchy.
-### 1. The Staking: +## 1. Staking … -### 2. The Buying: +## 2. Buying … -### 3. The Burning: +## 3. Burningsrc/option-standard-sdk/opm.md (2)
6-6: Trim wordiness“on a daily basis” is verbose.
-We use the Black-Scholes Model because it is a proven and reliable formula that is used globally on a daily basis in traditional finance derivatives pricing. +We use the Black-Scholes Model because it is a proven, globally-used formula for traditional-finance derivatives pricing.
14-14: Shorten and tidy section titleRemove the “I.e.” qualifier and trailing colon; it reads cleaner and avoids MD026.
-### Fractionalized Options for Buyers and Sellers - I.e. : +### Fractionalized Options for Buyers and Sellerssrc/products/omlp.md (2)
4-4: Fix typo “futher” → “further”-["Options - For Starters"](/options-for-starters) guide for futher details on options markets basics. +["Options – For Starters"](/options-for-starters) guide for further details on options-market basics.
33-33: Correct typo “systen” → “system”-...two-tiered priority systen to incentivize... +...two-tiered priority system to incentivize...
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (3)
src/option-standard-sdk/opm.md(1 hunks)src/products/omlp.md(1 hunks)src/products/xlabs.md(1 hunks)
🧰 Additional context used
🪛 LanguageTool
src/option-standard-sdk/opm.md
[style] ~6-~6: ‘on a daily basis’ might be wordy. Consider a shorter alternative.
Context: ... reliable formula that is used globally on a daily basis in traditional finance derivatives pric...
(EN_WORDINESS_PREMIUM_ON_A_DAILY_BASIS)
src/products/omlp.md
[style] ~2-~2: Consider a more concise word here.
Context: ...o borrow funds from liquidity providers in order to cover their positions. Before diving ...
(IN_ORDER_TO_PREMIUM)
[grammar] ~4-~4: Ensure spelling is correct
Context: ...ters"](/options-for-starters) guide for futher details on options markets basics. ## ...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
[style] ~17-~17: The phrase ‘have the ability to’ might be wordy. Consider using “can”.
Context: ...ntract structure was born. Now traders have the ability to enter options contracts by themselves a...
(HAS_THE_ABILITY_TO)
[grammar] ~33-~33: Ensure spelling is correct
Context: ...t. We crafted this two-tiered priority systen to incentivize Total Value Locked ([TvL...
(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)
[style] ~44-~44: ‘Prior to’ might be wordy. Consider a shorter alternative.
Context: ... Expanding option markets: The Summary Prior to the Option Margin Lending Pool, **lende...
(EN_WORDINESS_PREMIUM_PRIOR_TO)
🪛 markdownlint-cli2 (0.17.2)
src/option-standard-sdk/opm.md
1-1: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
8-8: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3
(MD001, heading-increment)
8-8: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
13-13: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
19-19: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
src/products/omlp.md
20-20: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/products/xlabs.md
1-1: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
8-8: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3
(MD001, heading-increment)
8-8: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
13-13: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
19-19: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
There was a problem hiding this comment.
Actionable comments posted: 5
♻️ Duplicate comments (5)
src/option-standard-sdk/opm.md (1)
15-16: Replace Google search URLs with authoritative references + tighten copyLink directly to reliable sources and avoid “aka”. Also hyphenate “cash‑covered.”
-### No ["Naked"](https://www.google.com/search?q=what+is+a+naked+option%3F...) positions -> All sellers must be ["cash covered"](https://www.google.com/search?q=what+is+a+cash+covered+option%3F...), aka *"collateralized"* +### No [“naked” positions](https://www.investopedia.com/terms/n/nakedoption.asp) +> All sellers must be [“cash‑covered”](https://www.investopedia.com/terms/c/cashcoveredoption.asp) (*collateralized*).src/products/degen-mode.md (2)
25-27: Fix seller “Position Sentiment” links to short-option anchorsChange long-call/long-put anchors to short-put/short-call for seller guidance.
-| [**Position Sentiment**](/options-for-starters/calls-and-puts#long-call-option-bullish) | Sell a <span style="color: #64acff">**Put**</span> if you are [**Bullish**](/options-for-starters/calls-and-puts#long-call-option-bullish) :ox::chart_with_upwards_trend: -- or -- Sell a <span style="color: #64acff">**Call**</span> if you are [**Bearish**](/options-for-starters/calls-and-puts#long-put-option-bearish) :bear: :chart_with_downwards_trend: | +| [**Position Sentiment**](/options-for-starters/calls-and-puts#short-put-option-bullish) | Sell a <span style="color: #64acff">**Put**</span> if you are [**Bullish**](/options-for-starters/calls-and-puts#short-put-option-bullish) :ox::chart_with_upwards_trend: -- or -- Sell a <span style="color: #64acff">**Call**</span> if you are [**Bearish**](/options-for-starters/calls-and-puts#short-call-option-bearish) :bear: :chart_with_downwards_trend: |
3-3: Emoji shortcodes won’t render without markdown-it-emojiEither enable markdown-it-emoji in VitePress or replace shortcodes with Unicode. Also applies to later headings.
Run to verify config:
#!/bin/bash rg -n -i 'markdown-it-emoji|emoji' .vitepress package.jsonAlso applies to: 5-5, 15-15, 25-25, 29-29, 40-40
src/tokens/xlabs.md (2)
17-24: Normalize sub‑section headings; drop trailing colons (MD001/MD026).Same as the earlier review—use H2 and remove “:”.
Apply:
-### 1. The Staking: +## 1. Staking ... -### 2. The Buying: +## 2. Buying ... -### 3. The Burning: +## 3. Burning
19-24: Remove price‑effect guarantees and promotional tone.Phrases like “creates consistent buy pressure that naturally increases the value” read as guarantees. Rephrase to neutral, risk‑aware language.
Apply:
-All while xLABS are minted by users staking, OPX is working hard in the background by utilizing **80%** of fees generated to purchase xLABS ***directly*** from the market. This creates a consistent *"buy"* pressure that naturally increases the value of xLABS for holders. +While xLABS are minted by users staking, OPX allocates **80%** of fees to purchase xLABS ***directly*** from the market. This introduces persistent buy‑side demand; price outcomes are not guaranteed. ... -- Burning xLABS also **provides** liquidity into the buy-side market directly +- Burning xLABS also **contributes** to buy‑side liquidity.
🧹 Nitpick comments (15)
src/option-standard-sdk/opm.md (4)
18-18: Fix markdownlint MD026: remove trailing punctuation in headingDrop the colon at the end of the H3.
-### Fractionalized Options for Buyers and Sellers: +### Fractionalized Options for Buyers and Sellers
1-1: Avoid inline HTML styling in headings (theme/a11y consistency)Inline color styling can break in dark mode and across themes. Prefer plain Markdown.
-# Options Pricing Model (<span style="color: #64acff">**OPM**</span>) +# Options Pricing Model (OPM)
3-3: Tighten intro sentenceMinor readability tweak; avoid “integrated within … - it is”.
-The “Option Pricing Model” is our options price calculator that is integrated within the `option_program` - it is a critical component that validates option pricing on-chain. +The “Option Pricing Model” is our on-chain options price calculator, integrated into the `option_program`, and is a critical component that validates option pricing.
27-27: Heading style: prefer “Summary”-## The Summary +## Summarysrc/products/degen-mode.md (5)
29-29: Resolve MD026 and clarify headingAvoid trailing punctuation and shortcode. Prefer a clear heading.
-## Options Contract Multiplier:100:: +## Options Contract Multiplier (100x)
33-38: Fix typo and present examples as a list“Thanks to to” → “Thanks to”. Replace nested blockquotes with a simple list.
-Thanks to to DeFi, Buyers & Sellers will be able to determine whatever size they want for their position through [fractionalization.](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers) -> For example: ->> selecting a quantity of 1 = 100x of the underlying asset ->> Selecting a quantity of 0.5 = 50x of the underlying asset ->> ->> Selecting a quantity of 0.25 = 25x of the underlying asset +Thanks to DeFi, Buyers & Sellers can choose any position size via [fractionalization](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers). + +Examples: +- Quantity 1.00 → 100× of the underlying +- Quantity 0.50 → 50× of the underlying +- Quantity 0.25 → 25× of the underlying
16-16: Clean up punctuation in questionsRemove “?.“ and “??.” → single “?”.
-... the strike price?. +... the strike price?-... the strike price??. +... the strike price?Also applies to: 26-26
7-7: Consistency: “Degen Mode” capitalizationUse consistent casing (“Degen Mode”) throughout.
31-31: Instrument nuance: 100x multiplier may varyIf non-equity/crypto options differ, add a note that 100x is typical but may vary by instrument/venue.
src/tokens/xlabs.md (3)
12-15: Fix typos and tighten wording.“yied” → “yield”; “opprotunity” → “opportunity”; “peacemealing” → “piecemealing”.
Apply:
-Price volatility of the [LABS](/tokens/labs) governance token should be reduced since holders are incentivized to stake to realize revshare yied. This in turn concentrates price action and trading to xLABS. +Price volatility of the [LABS](/tokens/labs) governance token may be reduced as holders are incentivized to stake to realize revshare yield. This in turn concentrates trading in xLABS. ... -As a bonus, users now have the opprotunity to transfer xLABS to other holders/wallets, ensuring control of their governance power while peacemealing their yields as they please - similar to [US STRIPS.](https://www.treasurydirect.gov/marketable-securities/strips/) +As a bonus, users now have the opportunity to transfer xLABS to other holders/wallets, maintaining governance control while piecemealing their yields as they please — similar to [US STRIPS.](https://www.treasurydirect.gov/marketable-securities/strips/)
18-18: Product name consistency.Use the canonical page name “Staking Lab”.
-Everything starts when users stake their LABS into our **Staking Labs** platform. +Everything starts when users stake their LABS into our **Staking Lab** platform.
32-36: Clarify revshare statement and avoid definitive “increases value”.Minor copy hardening.
-> Revshare fees are paid to stakers proportional to the distribution of xLABS a user owns compared to all xLABS held by other stakers. +> Revshare fees are paid to stakers in proportion to their share of total xLABS held by stakers. ... -> OPX's role increases xLABS value by providing market demand while also reducing the total supply - thus performing a buyback function. The entire system was created to be balanced, automatic, and inflation-regulating. +> OPX’s purchases provide market demand while burns reduce circulating supply — together performing a buyback‑like function. The system aims to be balanced, automatic, and inflation‑regulating.src/products/omlp.md (3)
21-23: Fix MD028: blank line inside blockquote.Remove the empty line between consecutive “> …” lines.
-> Trader A vs Trader B - -> Trader A vs SAP +> Trader A vs Trader B +> Trader A vs SAP
27-37: Typos/grammar and readability nits.Maximize (not maximizes), system, TVL, unique; tighten phrasing.
-Single-party trading helps maximizes **capital** and **time** efficiencies by removing their dependencies on other individuals. +Single‑party trading helps maximize **capital** and **time** efficiency by removing dependencies on other individuals. ... -... two-tiered priority systen ... +... two‑tiered priority system ... ... -Total Value Locked ([TvL](...)) +Total Value Locked (TVL) ... -The yield earned from SAP1 is unqiue because it is completely resistant to [impermanent loss (IL).](...) +The yield earned from SAP1 is unique and is not subject to typical AMM impermanent loss (IL).
43-44: Subject‑verb agreement and clarity.-SAP2 integrated pools are sourced from proven Solana liquidity powerhouses like [Kamino](...) and [Orca](...). SAP2 ensure there is always funding with OPX, making it a true 24/7 options market! +SAP2‑integrated pools are sourced from Solana liquidity venues like [Kamino](...) and [Orca](...). SAP2 ensures there is always funding within OPX, enabling a 24/7 options market.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
⛔ Files ignored due to path filters (1)
src/public/opx_logo_gif.gifis excluded by!**/*.gif
📒 Files selected for processing (7)
src/.vitepress/config.mts(2 hunks)src/option-standard-sdk/opm.md(1 hunks)src/products/degen-mode.md(1 hunks)src/products/omlp.md(1 hunks)src/products/opx.md(1 hunks)src/products/staking-lab.md(1 hunks)src/tokens/xlabs.md(1 hunks)
✅ Files skipped from review due to trivial changes (1)
- src/products/staking-lab.md
🚧 Files skipped from review as they are similar to previous changes (2)
- src/.vitepress/config.mts
- src/products/opx.md
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
src/products/degen-mode.md
29-29: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
40-40: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
src/products/omlp.md
22-22: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/option-standard-sdk/opm.md
18-18: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
24-24: Blank line inside blockquote
(MD028, no-blanks-blockquote)
🪛 Gitleaks (8.27.2)
src/tokens/xlabs.md
[high] 3-3: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.
(generic-api-key)
🔇 Additional comments (7)
src/option-standard-sdk/opm.md (5)
5-5: Grammar: “based on,” not “based off”[ suggest_nitpick_refactor ]
-OPM is carefully calculated by being heavily based off the [Black-Scholes Model](https://www.investopedia.com/terms/b/blackscholes.asp). +OPM is carefully calculated and heavily based on the [Black‑Scholes Model](https://www.investopedia.com/terms/b/blackscholes.asp).
10-10: Capitalize “Black‑Scholes” and drop ellipsis[ suggest_nitpick_refactor ]
-However, using the black-scholes model within the DeFi environment does come with its own challenges... +However, using the Black‑Scholes Model within the DeFi environment comes with its own challenges.
12-13: Consistency: capitalize “Model” and tighten phrasing[ suggest_nitpick_refactor ]
-## Conforming the Black-Scholes Model -To adapt the Black-Scholes model to the Solana DeFi ecosystem, the original formula was refactored to include changes such as: +## Conforming the Black‑Scholes Model +To adapt the Black‑Scholes Model to the Solana DeFi ecosystem, the original formula was adjusted to include rules such as:
29-29: Fix grammar and clarity[ suggest_nitpick_refactor ]
-The crypto space is a very competitive space with many gifted developers. While We cannot be reveal too much about how OPM calculates, we aim to express the basis and legitimacy of how it functions. +Crypto is highly competitive with many gifted developers. While we cannot reveal proprietary details of OPM, our goal here is to explain its basis and legitimacy.
1-30: Verify markdownlint passes (MD026/MD028)Automated run failed: repo root .markdownlint.jsonc not found (ENOENT). Add .markdownlint.jsonc to the repo root or run without --config:
npx -y markdownlint-cli2 "src/option-standard-sdk/opm.md"
Re-run and paste the output so MD026/MD028 can be confirmed.
src/products/degen-mode.md (2)
15-15: Verify inline HTML styles rendersrc/products/degen-mode.md contains inline … occurrences at lines 3, 15–17, 25–27, 41–42; repository scan returned ".vitepress: No such file or directory". Confirm the site generator does not sanitize inline styles — if it does, replace these with CSS classes or update the markdown renderer config.
31-31: Fix typo and replace Google search link with internal anchorFile: src/products/degen-mode.md (line 31). Change “Multiplers” → “Multipliers” and replace the Google search URL with an internal link to the Contract Multiplier section; verify that the anchor #contract-multiplier exists in src/options-for-starters/intro.md — if it doesn't, add the anchor or update the link.
-It is important to remember that [Options Contract Multiplers](https://www.google.com/search?q=What+is+an+options+contract+multiplier%3F...) exist - traditionally meaning each value must be multiplied 100x. +It is important to remember that Options Contract Multipliers exist — traditionally meaning each value is multiplied by 100x. +See: [Contract Multiplier](/options-for-starters/intro#contract-multiplier).
| - Traders can expand maximize their capital efficiency | ||
| > Granting traders the freedom to distribute their funds across multiple contracts instead of having to stick with one - thus increasing the odds in their favor | ||
|
|
||
| > Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader | ||
|
|
There was a problem hiding this comment.
🛠️ Refactor suggestion
Resolve MD028 (blank line inside blockquote) and clarify bullets
Remove the blank line inside the blockquote and convert explanations to nested bullets; tighten grammar.
-- Traders can expand maximize their capital efficiency
-> Granting traders the freedom to distribute their funds across multiple contracts instead of having to stick with one - thus increasing the odds in their favor
-
-> Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader
+- Traders can maximize capital efficiency:
+ - Distribute funds across multiple contracts instead of concentrating in one, improving win probabilities.
+ - Use spreads to mitigate risk and create more balanced payoff profiles.📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| - Traders can expand maximize their capital efficiency | |
| > Granting traders the freedom to distribute their funds across multiple contracts instead of having to stick with one - thus increasing the odds in their favor | |
| > Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader | |
| - Traders can maximize capital efficiency: | |
| - Distribute funds across multiple contracts instead of concentrating in one, improving win probabilities. | |
| - Use spreads to mitigate risk and create more balanced payoff profiles. |
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
24-24: Blank line inside blockquote
(MD028, no-blanks-blockquote)
🤖 Prompt for AI Agents
In src/option-standard-sdk/opm.md around lines 22 to 26, there's a blank line
inside a blockquote and unstructured explanatory text; remove the blank line so
the blockquote is contiguous, convert the two explanatory sentences into nested
bullet points under the main bullet, and tighten grammar (e.g., "Traders can
maximize capital efficiency" and "Grant traders the freedom to allocate funds
across multiple contracts, increasing odds" and "Encourage use of spreads to
mitigate risk and improve capital efficiency") so the content becomes a single
blockquote with a main statement followed by two concise nested bullets.
| # Option Margin Liquidity Pool (<span style="color: #64acff">**OMLP**</span>) | ||
| Our OMLPs are single-asset pools (SAPs) that allow users (like market makers/short sellers) to borrow funds from liquidity providers to cover their positions. | ||
|
|
||
| Before diving into the OMLP we must first understand how options contracts are structured within the options market. | ||
|
|
||
| Please visit the ["Options - For Starters"](/options-for-starters) guide for more details on options-markets basics. | ||
|
|
||
| ## Option Contract Structure: "Calls" vs "Puts" | ||
|
|
||
| Traditionally, options contracts are structured by requiring **two** parties to trade. One party is positioned as the buyer; the other is positioned as the seller. | ||
|
|
||
| > Trader A vs Trader B | ||
|
|
||
|
|
||
|  | ||
|
|
||
| OMLP introduces a whole other *dimension* to the options contract structure -**single-party** options trading! | ||
|
|
||
| Now buyers can enter options contracts by themselves using third-party liquidity providers as the counterparty. The buyer creates their own contract by determining expiration dates and strike prices: | ||
|
|
||
| > Trader A vs Trader B | ||
|
|
||
| > Trader A vs SAP | ||
|
|
||
|  | ||
|
|
||
| Single-party trading helps maximizes **capital** and **time** efficiencies by removing their dependencies on other individuals. | ||
|
|
||
| OMLP is designed as a two-tiered SAP system that prioritizes liquidity from our in-house liquidity provider pools first - named "SAP1". Once the funds from SAP1 are 100% utilized by traders, funds are then tapped from external liquidity providers - named SAP2. | ||
|
|
||
| ## Lending: SAP1 | ||
| SAP1 funds are provided to the pool via OPX directly from liquidity providers whom earn yield from [fees](/products/fees) generated by borrowing traders. The fees earned come in the form of the pool's asset type. | ||
| > For example, if the borrower is borrowing from a SOL pool, then the LPers will be paid in SOL, etc. | ||
|
|
||
| Our primary goal in designing SAP1 was to create a way in which users who do not want to trade directly can still participate within the options market. We crafted this two-tiered priority systen to incentivize Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&oq=what+does+total+value+locked+mean%3F&gs_lcrp=EgZjaHJvbWUyBggAEEUYOTIHCAEQABiABDINCAIQABiGAxiABBiKBTINCAMQABiGAxiABBiKBTINCAQQABiGAxiABBiKBTIHCAUQABjvBTIHCAYQABjvBTIKCAcQABiiBBiJBdIBCDg4NTVqMGo3qAIAsAIA&sourceid=chrome&ie=UTF-8)) and protocol growth. | ||
|
|
||
| But wait, that is not all! The yield earned from SAP1 is unqiue because it is completely resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&sca_esv=d6b7cd5f9271c9c7&ei=2pRFaNucOPaDwbkP_cb1uAM&ved=0ahUKEwjb8eXU--GNAxX2QTABHX1jHTcQ4dUDCBA&uact=5&oq=what+is+impermanent+loss%3F&gs_lp=Egxnd3Mtd2l6LXNlcnAiGXdoYXQgaXMgaW1wZXJtYW5lbnQgbG9zcz8yBRAAGIAEMgUQABiABDIFEAAYgAQyBhAAGBYYHjIGEAAYFhgeMgYQABgWGB4yBhAAGBYYHjIGEAAYFhgeMgYQABgWGB4yBhAAGBYYHkiiR1DnC1jhQ3AEeAGQAQCYAXCgAZsSqgEEMjUuM7gBA8gBAPgBAZgCIKACkRSoAgrCAgoQABiwAxjWBBhHwgILEAAYgAQYkQIYigXCAgsQABiABBixAxiDAcICCBAAGIAEGLEDwgIOEC4YgAQYsQMY0QMYxwHCAhEQLhiABBixAxjRAxiDARjHAcICCxAuGIAEGLEDGIMBwgIKEC4YgAQYQxiKBcICCxAuGIAEGMcBGK8BwgIIEC4YgAQYsQPCAg4QLhiABBjHARiOBRivAcICBRAuGIAEwgIUEAAYgAQY4wQYtAIY6QQY6gLYAQHCAhAQABgDGLQCGOoCGI8B2AEBwgIKEAAYgAQYQxiKBcICEBAuGIAEGNEDGEMYxwEYigXCAg4QABiABBixAxiDARiKBcICDhAuGIAEGLEDGIMBGIoFwgIHEAAYgAQYCsICChAAGIAEGEYY-QHCAiQQABiABBhGGPkBGJcFGIwFGN0EGEYY-QEY9AMY9QMY9gPYAQLCAggQABiABBiiBMICCxAAGIAEGIYDGIoFmAMM8QU-OcVzw-q9HIgGAZAGCLoGBAgBGAe6BgYIAhABGBOSBwQyNi42oAfQ9gGyBwQyMi42uAfzE8IHCDItMjQuNy4xyAfdAQ&sclient=gws-wiz-serp) The IL resistance is a byproduct of SAP1 that cannot be enjoyed via typical DeFi liquidity pools! | ||
|
|
||
| Once 100% utilization is reached from SAP1 (aka all funds are being borrowed), liquidity is then sourced from SAP2. | ||
|
|
||
| ## Lending: SAP2 | ||
|
|
||
| SAP2 integrated pools are sourced from proven Solana liquidity powerhouses like [Kamino](https://app.kamino.finance/liquidity?filter=all&sort=tvl) and [Orca](https://www.orca.so/). SAP2 ensure there is always funding with OPX, making it a true 24/7 options market! | ||
|
|
||
| ## Token Eligibility | ||
| Epicentral Labs DAO members determine which tokens can be borrowed to cover positions from the SAPs. | ||
|
|
||
| Please visit the **"token eligibility"** section within the [OPX](/products/opx) page for more details. | ||
|
|
||
| ## The Summary | ||
|
|
||
| Before the Option Margin Liquidity Pool, **retail lenders** were never able to participate in options contracts - only traders could participate. | ||
|
|
||
| For the first time, multiple users can now participate within an options contract as either a buyer, a seller, or as a *lender* - this concept revolutionizes the options market completely! No newline at end of file |
There was a problem hiding this comment.
💡 Verification agent
🧩 Analysis chain
Consistency sweep: OMLP naming, assets, and cross‑refs.
- Ensure “Option Margin Liquidity Pool (OMLP)” is used consistently repo‑wide.
- Verify images exist under /public and are optimized or remove them.
- Confirm /options-for-starters and /products/opx routes exist.
Run:
🏁 Script executed:
#!/bin/bash
# Naming consistency
rg -nP 'Options? Margin (Lending|Liquidity) Pool|OMLP' -C1
# Image presence
fd -a 'trader_vs_trader.png|sap-transparent-background.png' public/
# Check referenced routes exist (by filenames)
fd -a 'options-for-starters.md' src/ || true
fd -a 'opx.md' src/ || trueLength of output: 1862
Fix missing assets and broken cross‑refs; OMLP naming is consistent.
- Naming: "OMLP" is used consistently in src/products/omlp.md, src/products/opx.md, and src/tokens/labs.md — no rename required.
- Assets: src/products/omlp.md references /trader_vs_trader.png and /sap-transparent-background.png, but those files were not found under public/ — add optimized images to public/ or update/remove the image links.
- Cross‑refs: the "/options-for-starters" link in src/products/omlp.md has no matching src/options-for-starters.md — add the page or correct the link.
- Confirmed: src/products/opx.md exists and its OMLP reference is valid.
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
22-22: Blank line inside blockquote
(MD028, no-blanks-blockquote)
🤖 Prompt for AI Agents
In src/products/omlp.md lines 1-54, the review flags missing image assets and a
broken cross‑reference: add the referenced images (trader_vs_trader.png and
sap-transparent-background.png) into the public/ directory (optimized for web
and with correct paths), or update/remove the image links to point to existing
assets; also create src/options-for-starters.md with the referenced content or
update the /options-for-starters link to the correct existing file path; keep
the OMLP naming as-is and verify the updated links render correctly.
| Our primary goal in designing SAP1 was to create a way in which users who do not want to trade directly can still participate within the options market. We crafted this two-tiered priority systen to incentivize Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&oq=what+does+total+value+locked+mean%3F&gs_lcrp=EgZjaHJvbWUyBggAEEUYOTIHCAEQABiABDINCAIQABiGAxiABBiKBTINCAMQABiGAxiABBiKBTINCAQQABiGAxiABBiKBTIHCAUQABjvBTIHCAYQABjvBTIKCAcQABiiBBiJBdIBCDg4NTVqMGo3qAIAsAIA&sourceid=chrome&ie=UTF-8)) and protocol growth. | ||
|
|
||
| But wait, that is not all! The yield earned from SAP1 is unqiue because it is completely resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&sca_esv=d6b7cd5f9271c9c7&ei=2pRFaNucOPaDwbkP_cb1uAM&ved=0ahUKEwjb8eXU--GNAxX2QTABHX1jHTcQ4dUDCBA&uact=5&oq=what+is+impermanent+loss%3F&gs_lp=Egxnd3Mtd2l6LXNlcnAiGXdoYXQgaXMgaW1wZXJtYW5lbnQgbG9zcz8yBRAAGIAEMgUQABiABDIFEAAYgAQyBhAAGBYYHjIGEAAYFhgeMgYQABgWGB4yBhAAGBYYHjIGEAAYFhgeMgYQABgWGB4yBhAAGBYYHkiiR1DnC1jhQ3AEeAGQAQCYAXCgAZsSqgEEMjUuM7gBA8gBAPgBAZgCIKACkRSoAgrCAgoQABiwAxjWBBhHwgILEAAYgAQYkQIYigXCAgsQABiABBixAxiDAcICCBAAGIAEGLEDwgIOEC4YgAQYsQMY0QMYxwHCAhEQLhiABBixAxjRAxiDARjHAcICCxAuGIAEGLEDGIMBwgIKEC4YgAQYQxiKBcICCxAuGIAEGMcBGK8BwgIIEC4YgAQYsQPCAg4QLhiABBjHARiOBRivAcICBRAuGIAEwgIUEAAYgAQY4wQYtAIY6QQY6gLYAQHCAhAQABgDGLQCGOoCGI8B2AEBwgIKEAAYgAQYQxiKBcICEBAuGIAEGNEDGEMYxwEYigXCAg4QABiABBixAxiDARiKBcICDhAuGIAEGLEDGIMBGIoFwgIHEAAYgAQYCsICChAAGIAEGEYY-QHCAiQQABiABBhGGPkBGJcFGIwFGN0EGEYY-QEY9AMY9QMY9gPYAQLCAggQABiABBiiBMICCxAAGIAEGIYDGIoFmAMM8QU-OcVzw-q9HIgGAZAGCLoGBAgBGAe6BgYIAhABGBOSBwQyNi42oAfQ9gGyBwQyMi42uAfzE8IHCDItMjQuNy4xyAfdAQ&sclient=gws-wiz-serp) The IL resistance is a byproduct of SAP1 that cannot be enjoyed via typical DeFi liquidity pools! |
There was a problem hiding this comment.
🛠️ Refactor suggestion
Avoid raw Google search links in docs.
Replace search URLs with internal references or a concise definition; external search links are brittle.
-... Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&...)) ...
+... Total Value Locked (TVL) ...
-
-... resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&...)
+... not subject to typical impermanent loss (IL).📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| Our primary goal in designing SAP1 was to create a way in which users who do not want to trade directly can still participate within the options market. We crafted this two-tiered priority systen to incentivize Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&oq=what+does+total+value+locked+mean%3F&gs_lcrp=EgZjaHJvbWUyBggAEEUYOTIHCAEQABiABDINCAIQABiGAxiABBiKBTINCAMQABiGAxiABBiKBTINCAQQABiGAxiABBiKBTIHCAUQABjvBTIHCAYQABjvBTIKCAcQABiiBBiJBdIBCDg4NTVqMGo3qAIAsAIA&sourceid=chrome&ie=UTF-8)) and protocol growth. | |
| But wait, that is not all! The yield earned from SAP1 is unqiue because it is completely resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&sca_esv=d6b7cd5f9271c9c7&ei=2pRFaNucOPaDwbkP_cb1uAM&ved=0ahUKEwjb8eXU--GNAxX2QTABHX1jHTcQ4dUDCBA&uact=5&oq=what+is+impermanent+loss%3F&gs_lp=Egxnd3Mtd2l6LXNlcnAiGXdoYXQgaXMgaW1wZXJtYW5lbnQgbG9zcz8yBRAAGIAEMgUQABiABDIFEAAYgAQyBhAAGBYYHjIGEAAYFhgeMgYQABgWGB4yBhAAGBYYHjIGEAAYFhgeMgYQABgWGB4yBhAAGBYYHkiiR1DnC1jhQ3AEeAGQAQCYAXCgAZsSqgEEMjUuM7gBA8gBAPgBAZgCIKACkRSoAgrCAgoQABiwAxjWBBhHwgILEAAYgAQYkQIYigXCAgsQABiABBixAxiDAcICCBAAGIAEGLEDwgIOEC4YgAQYsQMY0QMYxwHCAhEQLhiABBixAxjRAxiDARjHAcICCxAuGIAEGLEDGIMBwgIKEC4YgAQYQxiKBcICCxAuGIAEGMcBGK8BwgIIEC4YgAQYsQPCAg4QLhiABBjHARiOBRivAcICBRAuGIAEwgIUEAAYgAQY4wQYtAIY6QQY6gLYAQHCAhAQABgDGLQCGOoCGI8B2AEBwgIKEAAYgAQYQxiKBcICEBAuGIAEGNEDGEMYxwEYigXCAg4QABiABBixAxiDARiKBcICDhAuGIAEGLEDGIMBGIoFwgIHEAAYgAQYCsICChAAGIAEGEYY-QHCAiQQABiABBhGGPkBGJcFGIwFGN0EGEYY-QEY9AMY9QMY9gPYAQLCAggQABiABBiiBMICCxAAGIAEGIYDGIoFmAMM8QU-OcVzw-q9HIgGAZAGCLoGBAgBGAe6BgYIAhABGBOSBwQyNi42oAfQ9gGyBwQyMi42uAfzE8IHCDItMjQuNy4xyAfdAQ&sclient=gws-wiz-serp) The IL resistance is a byproduct of SAP1 that cannot be enjoyed via typical DeFi liquidity pools! | |
| Our primary goal in designing SAP1 was to create a way in which users who do not want to trade directly can still participate within the options market. We crafted this two-tiered priority systen to incentivize Total Value Locked (TVL) and protocol growth. | |
| But wait, that is not all! The yield earned from SAP1 is unqiue because it is not subject to typical impermanent loss (IL). The IL resistance is a byproduct of SAP1 that cannot be enjoyed via typical DeFi liquidity pools! |
🤖 Prompt for AI Agents
In src/products/omlp.md around lines 35 to 37, the paragraph includes raw Google
search URLs for "Total Value Locked" and "impermanent loss" which are brittle
and inappropriate for docs; replace those external search links with either (a)
internal documentation links if we have existing glossary or product pages for
TVL and impermanent loss, or (b) a concise inline definition (e.g., "Total Value
Locked (TVL) — the total assets locked in a protocol" and "impermanent loss (IL)
— unrealized loss from price divergence in liquidity pools") and remove the
Google URLs; ensure link markup, wording and punctuation are updated to read
naturally and point to our internal resources if available.
| @@ -0,0 +1,47 @@ | |||
| # <span style="color: #64acff">**xLABS**</span>: Revshare re-configured | |||
|
|
|||
| ## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT | |||
There was a problem hiding this comment.
💡 Verification agent
❓ Verification inconclusive
Avoid hardcoding token address in prose; link to explorer to prevent false “secret” flags (Gitleaks).
Gitleaks flagged this line. Prefer an explorer link header to avoid false positives and future churn.
Apply:
-## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT
+## Token address
+Explore: https://solscan.io/token/xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiTReplace hardcoded token address with an explorer link (avoids Gitleaks false positives)
Gitleaks flagged the literal token address; use an explorer URL instead to prevent false "secret" flags and future churn.
File: src/tokens/xlabs.md — line 3
-## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT
+## Token address
+Explore: https://solscan.io/token/xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| ## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT | |
| ## Token address | |
| Explore: https://solscan.io/token/xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT |
🧰 Tools
🪛 Gitleaks (8.27.2)
[high] 3-3: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.
(generic-api-key)
🤖 Prompt for AI Agents
In src/tokens/xlabs.md around line 3, replace the hardcoded token address string
with a link to a blockchain explorer (e.g. an Etherscan/appropriate-chain URL
pointing to the token contract) so the file contains a URL instead of the raw
address; update the markdown to present the explorer link (with the address
embedded) and remove the literal address to avoid Gitleaks false positives.
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (5)
src/products/omlp.md (2)
35-37: Replace raw Google search links with internal/authoritative references.Use internal glossary or concise definitions; avoid brittle search URLs. This was raised before.
-... priority system to incentivize Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&...)) ... +... priority system to incentivize Total Value Locked (TVL) ... -... resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&...) +... not subject to typical impermanent loss (IL).
6-6: Fix broken internal link to the starter guide.The path should target the folder index (intro.md) to resolve in VitePress.
-Please visit the ["Options - For Starters"](/options-for-starters) guide for more details on options-markets basics. +Please visit the ["Options - For Starters"](/options-for-starters/intro) guide for more details on options basics.src/option-standard-sdk/opm.md (2)
15-16: Replace Google-search URLs with authoritative links.Directly reference Investopedia (or internal glossary). This was flagged before.
-### No ["Naked"](https://www.google.com/search?q=what+is+a+naked+option%3F&...) positions -> All sellers must be ["cash-covered"](https://www.google.com/search?q=what+is+a+cash+covered+option%3F&...), aka *"collateralized"* +### No [“naked” positions](https://www.investopedia.com/terms/n/nakedoption.asp) +> All sellers must be [“cash‑covered”](https://www.investopedia.com/terms/c/cashcoveredoption.asp) — collateralized.
18-26: Fix MD026 (trailing punctuation), remove blank-line-in-quote, and clarify bullets.Tighten language and convert explanatory quotes to nested bullets to satisfy markdownlint.
-### Fractionalized Options for Buyers and Sellers: +### Fractionalized Options for Buyers and Sellers -- Traders are no longer obligated to trade 100x of the underlying share per trade -> The financial barrier of entry for any given contract is lowered - -- Traders can expand maximize their capital efficiency -> Granting traders the freedom to distribute their funds across multiple contracts instead of having to stick with one - thus increasing the odds in their favor - -> Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader +- Traders are no longer obligated to trade 100× of the underlying per contract. + - Lowers the barrier to entry for any given contract. +- Traders can maximize capital efficiency: + - Distribute funds across multiple contracts instead of concentrating in one, improving odds. + - Use spreads to mitigate risk and create more balanced payoff profiles.src/options-for-starters/intro.md (1)
95-102: Fix Intrinsic/Extrinsic Value definitions (currently incorrect).Use option-specific definitions tied to strike/spot and premium.
-| <span style="color: #64acff">**Extrinsic Value (EV)**</span> | Extrinsic value is the portion of an option's premium that exceeds its intrinsic value, reflecting factors such as time until expiration and market volatility. | -| <span style="color: #64acff">**Intrinsic Value (IV)**</span> | Intrinsic value is the real value of an asset based on fundamental factors, as opposed to the price assigned by the market. | +| <span style="color: #64acff">**Intrinsic Value (IV)**</span> | The value if exercised now: for a call, max(0, spot − strike); for a put, max(0, strike − spot). | +| <span style="color: #64acff">**Extrinsic Value (EV)**</span> | The portion of premium above IV (premium − IV), reflecting time to expiration, interest rates, and implied volatility. |
🧹 Nitpick comments (11)
src/products/omlp.md (2)
12-14: Fix MD028 (blank line inside blockquote).Keep blockquotes contiguous or convert to a list. Remove the blank line within the quoted blocks.
-> Trader A vs Trader B - - +> Trader A vs Trader B +-> Trader A vs Trader B - -> Trader A vs SAP +> Trader A vs Trader B +> Trader A vs SAPAlso applies to: 21-24
27-37: Tighten grammar and fix typos (systen→system, unqiue→unique, ensures).Also improve clarity and style.
-Single-party trading helps maximizes **capital** and **time** efficiencies by removing their dependencies on other individuals. +Single-party trading helps maximize capital and time efficiency by removing dependencies on other individuals. -OMLP is designed as a two-tiered SAP system that prioritizes liquidity from our in-house liquidity provider pools first - named "SAP1". Once the funds from SAP1 are 100% utilized by traders, funds are then tapped from external liquidity providers - named SAP2. +OMLP is a two-tiered SAP system that prioritizes in‑house liquidity pools first ("SAP1"). Once SAP1 is 100% utilized, liquidity is sourced from external providers ("SAP2"). -SAP1 funds are provided to the pool via OPX directly from liquidity providers whom earn yield from [fees](/products/fees) generated by borrowing traders. The fees earned come in the form of the pool's asset type. +SAP1 funds come via OPX directly from liquidity providers who earn yield from [fees](/products/fees) paid by borrowing traders. Fees are paid in the pool’s asset. -Our primary goal in designing SAP1 was to create a way in which users who do not want to trade directly can still participate within the options market. We crafted this two-tiered priority systen to incentivize Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&...)) and protocol growth. +Our goal with SAP1 is to let users who don’t want to trade directly still participate in the options market. This two‑tier priority system incentivizes Total Value Locked (TVL) and protocol growth. -But wait, that is not all! The yield earned from SAP1 is unqiue because it is completely resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&...) +Additionally, SAP1 yield is unique in that it is not subject to typical impermanent loss (IL). -SAP2 integrated pools are sourced from proven Solana liquidity powerhouses like [Kamino](https://app.kamino.finance/liquidity?filter=all&sort=tvl) and [Orca](https://www.orca.so/). SAP2 ensure there is always funding with OPX, making it a true 24/7 options market! +SAP2 integrated pools are sourced from proven Solana liquidity providers like [Kamino](https://app.kamino.finance/liquidity?filter=all&sort=tvl) and [Orca](https://www.orca.so/). SAP2 ensures there is always funding with OPX, making it a true 24/7 options market!Also applies to: 43-43
src/options-for-starters/intro.md (4)
29-31: Tighten spread sentence and hyphenation.-Options can also be used to create complex positions that involve buying and/or selling multiple contract - "legs" - at the same time thus creating a [Spread](/options-for-starters/spreads) position. +Options can also create complex positions by buying and/or selling multiple contracts—“legs”—at the same time, forming a [spread](/options-for-starters/spreads).
60-60: Fix typo: “postions” → “positions”.-Instead, all postions must be "cash covered" - aka collateralized. +Instead, all positions must be "cash covered"—aka collateralized.
84-84: Fix spelling and tone.-... drive this philosphy! +... drive this philosophy.
104-106: Smooth the “Solana Ecosystem” note (run-on sentence).-This course primarily focuses on the **Solana Ecosystem**. Which means all examples and discussions will be covered surrounding cryptocurrency/tokens on Solana. +This course primarily focuses on the **Solana ecosystem**, so examples and discussions center on Solana-native cryptocurrencies/tokens.src/option-standard-sdk/opm.md (3)
5-5: Simplify phrasing and preposition (“based on,” not “based off”).-OPM is carefully calculated by being heavily based off the [Black-Scholes Model](https://www.investopedia.com/terms/b/blackscholes.asp). +OPM is heavily based on the [Black‑Scholes Model](https://www.investopedia.com/terms/b/blackscholes.asp).
10-13: Capitalize “Black‑Scholes” consistently.-However, using the black-scholes model within the DeFi environment does come with its own challenges... +However, using the Black‑Scholes model within the DeFi environment comes with its own challenges... -## Conforming the Black-Scholes Model +## Conforming the Black‑Scholes Model -To adapt the Black-Scholes model to the Solana DeFi ecosystem, the original formula was refactored to include changes such as: +To adapt the Black‑Scholes model to the Solana DeFi ecosystem, the original formula was refactored to include changes such as:
29-30: Fix grammar and clarity in the summary paragraph.-The crypto space is a very competitive space with many gifted developers. While We cannot be reveal too much about how OPM calculates, we aim to express the basis and legitimacy of how it functions. +The crypto space is highly competitive with many gifted developers. While we cannot disclose proprietary details of the OPM, this document explains its basis and legitimacy.src/.vitepress/config.mts (2)
23-37: Avoid sorting nav by text — it reorders “Home”.The alphabetical sort can move “Home” away from the first position. Keep explicit order.
- ].sort((a, b) => a.text.localeCompare(b.text)), + ],
75-92: Be cautious sorting “Products” — groups may jump unexpectedly.Alphabetical sorting can reorder the OPX group vs. standalone items, which may not match IA/UX intent. Prefer explicit order.
- ].sort((a, b) => a.text.localeCompare(b.text)) + ] // keep explicit order for IA/UX
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (6)
src/.vitepress/config.mts(2 hunks)src/governance/contributor-bonus.md(1 hunks)src/option-standard-sdk/opm.md(1 hunks)src/options-for-starters/intro.md(2 hunks)src/products/omlp.md(1 hunks)src/products/staking-lab.md(1 hunks)
✅ Files skipped from review due to trivial changes (1)
- src/products/staking-lab.md
🚧 Files skipped from review as they are similar to previous changes (1)
- src/governance/contributor-bonus.md
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
src/option-standard-sdk/opm.md
18-18: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
24-24: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/products/omlp.md
22-22: Blank line inside blockquote
(MD028, no-blanks-blockquote)
🔇 Additional comments (2)
src/option-standard-sdk/opm.md (1)
21-21: Use “barrier to entry” idiomatically.
[raise_nitpick_refactor]-The financial barrier of entry for any given contract is lowered +The financial barrier to entry for any given contract is loweredsrc/.vitepress/config.mts (1)
24-36: All sidebar/nav links resolved — verification passed. The provided script was run and every listed route returned OK.
|  | ||
|
|
There was a problem hiding this comment.
💡 Verification agent
🧩 Analysis chain
Resolve missing image assets or update paths; add alt text.
Both /trader_vs_trader.png and /sap-transparent-background.png must exist under public/ (served from /). Add the files or update/remove the images; also provide descriptive alt text for accessibility. Script below verifies presence.
Also applies to: 25-26
🏁 Script executed:
#!/bin/bash
# Verify referenced images exist in /public
fd -a 'trader_vs_trader.png' public/
fd -a 'sap-transparent-background.png' public/Length of output: 0
🏁 Script executed:
#!/bin/bash
echo "== ls public =="
if [ -d public ]; then ls -la public || true; else echo "public/ not found"; fi
echo
echo "== find image files =="
find . -type f \( -iname 'trader_vs_trader.png' -o -iname 'sap-transparent-background.png' \) -print || true
echo
echo "== rg search for references =="
if command -v rg >/dev/null 2>&1; then rg -n --hidden -S 'trader_vs_trader\.png|sap-transparent-background\.png' || true; else echo "rg not installed"; fi
echo
echo "== show src/products/omlp.md (first 200 lines) =="
if [ -f src/products/omlp.md ]; then sed -n '1,200p' src/products/omlp.md || true; else echo "src/products/omlp.md not found"; fiLength of output: 5235
Resolve missing image assets or update paths; add alt text.
- src/products/omlp.md references /trader_vs_trader.png and /sap-transparent-background.png (lines 15–16, 25–26) but the files are located at src/public/trader_vs_trader.png and src/public/sap-transparent-background.png; public/ (root) does not contain them.
- Action: either move the two images into public/ (public/trader_vs_trader.png, public/sap-transparent-background.png) so they are served from /, or update the Markdown to point to the correct build path used by your site (e.g., ../public/trader_vs_trader.png from src/products/omlp.md or the site’s canonical asset path).
- Add descriptive alt text for both images (examples: "Diagram: Trader A vs Trader B" and "Diagram: Trader A vs SAP (single-party)").
- Edit targets: src/products/omlp.md (lines 15–16, 25–26); existing image files: src/public/trader_vs_trader.png, src/public/sap-transparent-background.png.
🤖 Prompt for AI Agents
In src/products/omlp.md around lines 15–16 and 25–26, the markdown references
/trader_vs_trader.png and /sap-transparent-background.png but the actual files
live at src/public/trader_vs_trader.png and
src/public/sap-transparent-background.png; either move those two images into the
repo root public/ directory (public/trader_vs_trader.png and
public/sap-transparent-background.png) so the current / paths work, or update
the image links in src/products/omlp.md to the correct build-relative paths (for
example ../public/trader_vs_trader.png and
../public/sap-transparent-background.png or your site’s canonical asset path);
also add descriptive alt text for both images (suggestions: "Diagram: Trader A
vs Trader B" and "Diagram: Trader A vs SAP (single-party)") and commit edits to
src/products/omlp.md and the image file locations as applicable.
There was a problem hiding this comment.
Actionable comments posted: 3
♻️ Duplicate comments (13)
src/option-standard-sdk/opm.md (2)
15-16: Replace Google-search URLs with authoritative referencesLink directly to definitions; search URLs are brittle.
-### No ["Naked"](...google... ) positions -> All sellers must be ["cash-covered"](...google...), aka *"collateralized"* +### No [“naked” positions](https://www.investopedia.com/terms/n/nakedoption.asp) +> All sellers must be [“cash-covered”](https://www.investopedia.com/terms/c/cashcoveredoption.asp), i.e., collateralized
22-26: Fix blank line inside blockquote and tighten grammarMake the blockquote contiguous and convert explanations to nested bullets; also fix “expand maximize”.
-- Traders can expand maximize their capital efficiency -> Granting traders the freedom to distribute their funds across multiple contracts instead of having to stick with one - thus increasing the odds in their favor - -> Mitigating risk by encouraging capital efficiency via use of spreads to create possible win-win scenarios for trader +- Traders can maximize capital efficiency: + - Allocate funds across multiple contracts instead of concentrating in one, improving odds. + - Use spreads to mitigate risk and create more balanced payoff profiles.src/products/omlp.md (1)
35-37: Remove Google-search links; tighten text; fix typos-... incentivize Total Value Locked ([TvL](https://www.google.com/search?q=what+does+total+value+locked+mean%3F&...)) and protocol growth. - -But wait, that is not all! The yield earned from SAP1 is unqiue because it is completely resistant to [impermanent loss (IL).](https://www.google.com/search?q=what+is+impermanent+loss%3F&...) The IL resistance is a byproduct of SAP1 that cannot be enjoyed via typical DeFi liquidity pools! +... incentivize Total Value Locked (TVL) and protocol growth. + +Additionally, SAP1 yield is not subject to typical impermanent loss (IL) seen in AMM LP positions.src/tokens/xlabs.md (2)
3-4: Replace raw token address with explorer link (avoid Gitleaks false positives)-## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT +## Token address +Explore: https://solscan.io/token/xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT
17-24: Normalize heading levels and remove trailing colonsFixes MD001/MD026 and improves consistency.
-### 1. The Staking: +## 1. Staking @@ -### 2. The Buying: +## 2. Buying @@ -### 3. The Burning: +## 3. Burningsrc/options-for-starters/intro.md (1)
95-102: Correct Intrinsic/Extrinsic definitions; tighten glossaryThese entries are inaccurate/misleading.
-| <span style="color: #4a85ff">**Extrinsic Value (EV)**</span> | Extrinsic value is the portion of an option's premium that exceeds its intrinsic value, reflecting factors such as time until expiration and market volatility. | -| <span style="color: #4a85ff">**Intrinsic Value (IV)**</span> | Intrinsic value is the real value of an asset based on fundamental factors, as opposed to the price assigned by the market. | +| <span style="color: #4a85ff">**Intrinsic Value (IV)**</span> | Value if exercised now: for a call, max(0, spot − strike); for a put, max(0, strike − spot). | +| <span style="color: #4a85ff">**Extrinsic Value (EV)**</span> | Premium above IV, driven by time to expiration, interest rates, and (implied) volatility. | @@ -| <span style="color: #4a85ff">**Options**</span> | Financial derivatives of an underlying asset or token. They represent an agreement between a buyer and a seller for a potential future transaction at a predetermined price, known as the strike price. | +| <span style="color: #4a85ff">**Options**</span> | Contracts granting the right (not obligation) to buy (call) or sell (put) the underlying at the strike price on/before expiration, for a premium. | @@ -| <span style="color: #4a85ff">**Strike Price**</span> | The price at which the buyer can purchase (call option) or sell (put option) the underlying asset if the option is exercised. | +| <span style="color: #4a85ff">**Strike Price**</span> | The price at which the underlying can be bought (call) or sold (put) if the option is exercised. | @@ -| <span style="color: #4a85ff">**Volatility**</span> | Volatility is a measurement of how varied the returns of a given security or market index are over time. It is often measured from either the standard deviation or variance between those returns. In most cases, the higher the volatility, the riskier the security. | +| <span style="color: #4a85ff">**Volatility**</span> | A measure of how much the underlying’s price varies over time; options reference both historical and implied volatility. |src/options-for-starters/calls-and-puts.md (4)
14-23: Fix Long Option definition (put = right to sell) and typos; remove .htmlAlso resolve MD028 inside blockquotes.
-A **"Long Option"** gives the Option Buyer the right, *but not the obligation*, to buy the underlying token at a set price, known as a [**Strike Price**](/options-for-starters/intro.html#terminology), within a specific time period. +A **“Long Option”** gives the buyer the right, but not the obligation, to buy (call) or sell (put) the underlying at the [strike price](/options-for-starters/intro#terminology) within a specific time period. @@ -> For example, you don't have to stay and watch the whole movie if you dont like it. You can exit the theatre *whenever* you wanted to. +> For example, you don’t have to stay for the whole movie if you don’t like it. You can exit the theatre whenever you want. @@ ->> Heres another scenario: let's say you bought the **last** movie ticket for a specific viewing. You could **sell** the ticket to someone else for profit *if* you wanted to. Option contracts work the same way where traders can sell their positions to realize their profits/losses. +>> Here’s another scenario: if you bought the last ticket, you could sell it to someone else for a profit. Options work similarly: traders can sell positions to realize gains/losses.
60-63: Correct seller obligation wording (deliver vs purchase)Match obligation to option type.
-Regardless of the price of the token, sellers are OBLIGATED to purchase the underlying token at a specified price **if/when** their Option position is assigned, or expires. +Regardless of price, sellers are obligated to honor the contract at the strike: deliver the asset for a call, or buy it for a put, if assigned or at in‑the‑money expiry.
76-79: Fix instrument mix‑up in Short Call PnL textMentions “put” in a short call section.
-> The **PNL Chart** above provides a generalized sense of a short **call** option. As the value of the token increases, the value of the put option decreases. +> The PnL chart above illustrates a short call: as the token price increases, the call option’s value increases (bad for the seller); as the token price decreases, the call’s value falls (good for the seller).
88-90: Fix Short Put value/price relationshipOption value decreases as underlying rises.
-> The **PNL Chart** above provides a generalized sense of a short **put** option As the value of the token increases, the value of the put option also increases. +> The PnL chart above illustrates a short put: as the token price increases, the put option’s value decreases — this decay benefits the seller.src/products/degen-mode.md (3)
3-5: Emoji shortcodes won’t render without markdown-it-emojiEither enable markdown-it-emoji in VitePress or replace shortcodes with Unicode.
25-25: Seller “Position Sentiment” links point to long-option anchorsUse short-put (bullish) and short-call (bearish) anchors.
-| [**Position Sentiment**](/options-for-starters/calls-and-puts#long-call-option-bullish) | Sell a <span style="color: #4a85ff">**Put**</span> if you are [**Bullish**](/options-for-starters/calls-and-puts#long-call-option-bullish) :ox::chart_with_upwards_trend: -- or -- Sell a <span style="color: #4a85ff">**Call**</span> if you are [**Bearish**](/options-for-starters/calls-and-puts#long-put-option-bearish) :bear: :chart_with_downwards_trend: | +| [**Position Sentiment**](/options-for-starters/calls-and-puts#short-put-option-bullish) | Sell a <span style="color: #4a85ff">**Put**</span> if you are [**Bullish**](/options-for-starters/calls-and-puts#short-put-option-bullish) :ox::chart_with_upwards_trend: -- or -- Sell a <span style="color: #4a85ff">**Call**</span> if you are [**Bearish**](/options-for-starters/calls-and-puts#short-call-option-bearish) :bear: :chart_with_downwards_trend: |
40-42: Fix bearish guidance and trailing punctuation in headingCorrect the bearish line (Put, not Call) and remove trailing punctuation to satisfy MD026.
-## Options Tips for Degens :thinking::thought_balloon:: +## Options Tips for Degens - Buying a <span style="color: #4a85ff">**Call**</span> / Selling a <span style="color: #4a85ff">**Put**</span> = Bullish on Price :ox::chart_with_upwards_trend: -- Buying a <span style="color: #4a85ff">**Call**</span> / Selling a <span style="color: #4a85ff">**Call**</span> = Bearish on Price :bear: :chart_with_downwards_trend: +- Buying a <span style="color: #4a85ff">**Put**</span> / Selling a <span style="color: #4a85ff">**Call**</span> = Bearish on Price :bear: :chart_with_downwards_trend:
🧹 Nitpick comments (32)
src/option-standard-sdk/opm.md (4)
18-18: Remove trailing punctuation in headingColon violates MD026.
-### Fractionalized Options for Buyers and Sellers: +### Fractionalized Options for Buyers and Sellers
12-13: Prefer “Adapting” over “Conforming”; simplify phrasingClearer heading and sentence.
-## Conforming the Black-Scholes Model -To adapt the Black-Scholes model to the Solana DeFi ecosystem, the original formula was refactored to include changes such as: +## Adapting the Black-Scholes model +To fit the Solana DeFi ecosystem, we make pragmatic adjustments to the original model, including:
5-5: Wording nit: “based off” → “based on”Micro style improvement.
-OPM is carefully calculated by being heavily based off the [Black-Scholes Model](https://www.investopedia.com/terms/b/blackscholes.asp). +OPM is carefully calculated and is heavily based on the [Black-Scholes model](https://www.investopedia.com/terms/b/blackscholes.asp).
29-30: Fix grammar and tighten founder quote lead‑in-The crypto space is a very competitive space with many gifted developers. While We cannot be reveal too much about how OPM calculates, we aim to express the basis and legitimacy of how it functions. +Crypto is highly competitive. While we cannot reveal details of OPM’s calculations, our goal is to explain its basis and legitimacy.src/products/fees.md (3)
8-11: Resolve MD028 and make blockquote contiguousRemove the blank line inside the blockquote.
- 10% of revenue generated by OPX will be sent to the multisig: -> 5% will be used for Operational Overhead Costs - -> 5% will be paid to the core team as royalties for protocol development and labor +> 5% will be used for operational overhead costs +> 5% will be paid to the core team as royalties for protocol development and labor
36-38: Fix MD028 and grammar (“of Operational Overhead Costs”)-> 80% of revenue generated by MISC fees will be used to buyback & burn xLABS - -> 20% of revenue generated by MISC fees will be sent to the multisig of Operational Overhead Costs +> 80% of revenue generated by misc fees will be used to buy back and burn xLABS +> 20% of revenue generated by misc fees will be sent to the multisig for operational overhead costs
5-5: Use extensionless internal link (VitePress best practice)Keeps dev/prod routing consistent.
-- 80% of revenue generated by OPX will be used to buy-back & burn [xLABS](/tokens/xlabs.md) +- 80% of revenue generated by OPX will be used to buy back and burn [xLABS](/tokens/xlabs)src/products/omlp.md (3)
6-6: Fix internal link to the starter guideLikely route is the intro page.
-Please visit the ["Options - For Starters"](/options-for-starters) guide for more details on options-markets basics. +Please visit the ["Options - For Starters"](/options-for-starters/intro) guide for options‑market basics.
27-37: Spelling/grammar fixes (“maximizes”, “system”, “unique”)-Single-party trading helps maximizes **capital** and **time** efficiencies by removing their dependencies on other individuals. +Single‑party trading helps maximize capital and time efficiency by removing dependencies on other individuals. @@ -... priority systen ... +... priority system ... @@ -The yield earned from SAP1 is unqiue ... +The yield earned from SAP1 is unique ...
43-44: Subject‑verb agreement (“ensure” → “ensures”) and clarity-SAP2 integrated pools are sourced from proven Solana liquidity powerhouses like [Kamino](...) and [Orca](...). SAP2 ensure there is always funding with OPX, making it a true 24/7 options market! +SAP2 pools are sourced from providers like [Kamino](...) and [Orca](...). SAP2 ensures continuous funding for OPX, making it a true 24/7 options market.src/tokens/xlabs.md (1)
9-11: Fix MD028 (blank line inside blockquote)Keep blockquotes contiguous.
-> "The way I see 'LABS' vs 'xLABS' is like seeing a fruiting tree. LABS is the tree while xLABS is the fruit the ripens on the tree. The tree is the foundation, but the fruit is the end product. Just like you would not cut down the tree to harvest the fruit, LABS should not be sold to realize the revshare" - Cyber Staker, Core Team - +> "The way I see 'LABS' vs 'xLABS' is like seeing a fruiting tree. LABS is the tree while xLABS is the fruit that ripens on the tree. The tree is the foundation, but the fruit is the end product. Just like you would not cut down the tree to harvest the fruit, LABS should not be sold to realize the revshare." — Cyber Staker, Core Team @@ -> OPX's role increases xLABS value by providing market demand while also reducing the total supply - thus performing a buyback function. The entire system was created to be balanced, automatic, and inflation-regulating. +> OPX’s purchases provide demand while burns reduce supply, functioning like a buyback. The system is designed to be balanced, automated, and supply‑regulated.Also applies to: 36-36
src/option-standard-sdk/introduction.md (3)
23-23: Fix internal link to Epicentral Labs pageLikely route is under introduction.
-Introducing the **Solana Options Standard (SOS)** our open-source [Solana Program(s)](https://solana.com/docs/core/programs) **SDK** created by [**Epicentral Labs.**](/epicentral-labs/about) +Introducing the **Solana Options Standard (SOS)** — our open‑source [Solana programs](https://solana.com/docs/core/programs) SDK created by [Epicentral Labs](/introduction/about-epicentral-labs).
31-33: Fix typos: “incrediblly”, “simutaneously”-Thanks to Solana's incrediblly fast transaction speed, inexpensive transaction costs, and proof-of-history (PoH) transaction validation, option contracts can be created and validated at extremely fast speeds. +Thanks to Solana's incredibly fast transaction speed, inexpensive transaction costs, and proof‑of‑history (PoH) validation, option contracts can be created and validated quickly. @@ -This eliminates unfair low-latency advantages like in the New York Stock Exchange while simutaneously promoting safety for all who participate. +This reduces low‑latency advantages seen on traditional venues while simultaneously promoting fairness for all participants.
51-53: Fix typo: “standerdized” → “standardized”-The Solana Options Standard will help fix most of the above issues by implementing standerdized solutions for developers to use within their projects or platforms. +The Solana Options Standard addresses these issues by providing standardized solutions developers can use in their projects and platforms.src/options-for-starters/the-greeks.md (3)
13-14: Capitalization and clarity“Greeks” is a proper term; streamline sentence.
-An Option's price does not only change based on how traders interact with it, but also with market conditions. The composition or structure of an Option relies heavily on greeks: +An option’s price changes with trader behavior and market conditions. The composition of an option relies on the Greeks:
17-20: Subject‑verb agreement-> Higher deltas indicates the option's price closely follows the token's price movements. +> Higher delta indicates the option’s price more closely follows the token’s price movements.
35-38: Minor wording cleanups (Vega/Rho)Concise and parallel phrasing.
- Measures the sensitivity of the option's price relative to the changes within the underlying token's volatility. + Measures the option’s price sensitivity to changes in the underlying token’s volatility. @@ - Indicates how much the option's price changes in response to a 1% change in interest rates. + Indicates how much the option’s price changes for a 1% change in interest rates.Also applies to: 41-42
src/options-for-starters/intro.md (2)
84-86: Fix capitalization and spelling (“DeFi”, “philosophy”)-In short, TradFi and Defi have similarities in the overall foundation of options trading, but with nuanced exceptions. And while they both carry their risks, they both serve rewarding purpose for traders and capital markets. In fact, many financial institutions watch options markets as strong indicators of trading sentiment for any given underlying asset. Options trading *should* be utilized more frequently and we intend to bring the barrier-of-entry as low as possible to drive this philosphy! +In short, TradFi and DeFi share foundational similarities with nuanced differences. While both carry risk, both serve useful purposes for traders and capital markets. Many institutions watch options markets as indicators of sentiment. Options trading should be more accessible, and we aim to lower the barrier to drive this philosophy.
54-54: Optional: add note on impermanent loss mitigation (per prior request)We can add a brief sentence in “How are Options Used?” or “TradFi vs DeFi” noting that options can be structured to mitigate IL for LPs via hedges.
Say the word and I’ll propose exact wording and placement.
src/options-for-starters/calls-and-puts.md (2)
14-14: Use extensionless internal linksVitePress best practice; avoid .html.
-[**Strike Price**](/options-for-starters/intro.html#terminology) +[**Strike Price**](/options-for-starters/intro#terminology) @@ -[**expiration date**](/options-for-starters/intro.html#terminology) +[**expiration date**](/options-for-starters/intro#terminology) @@ -[**Assignment**](/options-for-starters/intro.html#terminology) +[**Assignment**](/options-for-starters/intro#terminology) @@ -[Short Call](/options-for-starters/calls-and-puts.html#short-call-option-bearish) +[Short Call](/options-for-starters/calls-and-puts#short-call-option-bearish)Also applies to: 18-18, 62-62, 72-72, 84-84
21-21: Fix MD028: remove blank lines inside blockquotesKeep each blockquote contiguous.
Example:
-> For example, you don’t have to stay... - ->> Here’s another scenario... +> For example, you don’t have to stay... +>> Here’s another scenario...Apply similarly to other flagged locations.
Also applies to: 31-31, 45-45, 77-77, 89-89
src/products/degen-mode.md (3)
15-18: Fix punctuation and clarity in Buyer table rows
- Remove extra “.” after question mark.
- Prefer “expires” (lowercase) and drop “by”.
-| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price that you will compare your Position Sentiment to: Will the price be going <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price?. | -| [**Expiration Date**](/options-for-starters/intro#terminology) | Select the date your option contract <span style="color: #4a85ff">**Expires**</span> by. The contract is over after this date | +| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price you will compare your position to: will price go <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price? | +| [**Expiration Date**](/options-for-starters/intro#terminology) | Select the date your option contract <span style="color: #4a85ff">**expires**</span>. The contract ends after this date. |
26-26: Double punctuationRemove the extra “?” and final “.”.
-| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price that you will compare your Position Sentiment to: Will the price be going <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price??. | +| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price you will compare your position to: will price go <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price? |
33-38: Typos and consistency in examples
- “Thanks to to” → “Thanks to”.
- Start each example with “Selecting”.
-Thanks to to DeFi, Buyers & Sellers will be able to determine whatever size they want for their position through [fractionalization.](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers) +Thanks to DeFi, buyers and sellers can choose any position size via [fractionalization](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers). > For example: ->> selecting a quantity of 1 = 100x of the underlying asset +>> Selecting a quantity of 1 = 100× of the underlying asset >> Selecting a quantity of 0.5 = 50x of the underlying asset >> >> Selecting a quantity of 0.25 = 25x of the underlying assetsrc/products/opx.md (8)
1-3: Improve image alt textUse descriptive alt text for accessibility.
-<img src="/opx_logo_gif.gif" alt="opx_logo_gif"> +<img src="/opx_logo_gif.gif" alt="OPX animated logo">
5-5: Grammar: remove possessive apostrophe“P&L’s” → “P&L”.
-OPX is our Decentralized Options Exchange protocol and flagship product. Users engage with OPX to enter into, and exit from, option positions - realizing their P&L's. +OPX is our Decentralized Options Exchange protocol and flagship product. Users engage with OPX to enter into and exit from option positions—realizing their P&L.
13-14: Clarity and toneSimplify wording; avoid “knowledgewise”.
-Options-trading can be complicated enough creating a high barrier of entry knowledgewise. Our goal with OPX is to ensure that the UI is user-friendly, so that even the first-time options traders can understand. +Options trading can be complex and create a high barrier to entry. Our goal with OPX is a user-friendly UI that even first‑time options traders can understand.
19-21: Grammar: “It’s”, flow, and comma usageFix “Its” → “It’s” and streamline sentence.
-On our default trading page you will see values, strike prices, expiration dates and option [“Greeks”](/options-for-starters/the-greeks) articulately displayed before you; Its all the information you could need without being overwhelmed while being fully aware of your position. +On the default trading page you’ll see values, strike prices, expiration dates, and option [Greeks](/options-for-starters/the-greeks) clearly displayed. It’s all the information you need without being overwhelming, while keeping you fully aware of your position.
21-27: Consistency with Degen Mode examplesMatch capitalization and “×” symbol.
->> selecting a quantity of 1 = 100x of the underlying asset +>> Selecting a quantity of 1 = 100× of the underlying asset >> Selecting a quantity of 0.5 = 50x of the underlying asset >> >> Selecting a quantity of 0.25 = 25x of the underlying asset
32-35: Typo: “wil” → “will”Minor spelling fix.
-Sellers wil navigate through the 3x pages to create their contracts - as seen below: +Sellers will navigate through the 3 pages to create their contracts—as seen below:
52-52: Typo: “creatin” → “creating”-- **Cost Breakdown Panel:** This panel will reflect the cost of creatin an options contract for sellers summarizing the: +- **Cost Breakdown Panel:** This panel reflects the cost of creating an options contract for sellers, summarizing:
70-70: Internal link: drop .md for consistencyVitePress resolves without extension; future‑proofing.
-Please visit the [Fees](/products/fees.md) page for more details. +Please visit the [Fees](/products/fees) page for more details.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (11)
src/option-standard-sdk/introduction.md(1 hunks)src/option-standard-sdk/opm.md(1 hunks)src/options-for-starters/calls-and-puts.md(1 hunks)src/options-for-starters/intro.md(2 hunks)src/options-for-starters/the-greeks.md(1 hunks)src/products/degen-mode.md(1 hunks)src/products/fees.md(1 hunks)src/products/omlp.md(1 hunks)src/products/opx.md(1 hunks)src/tokens/labs.md(1 hunks)src/tokens/xlabs.md(1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
- src/tokens/labs.md
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
src/products/fees.md
9-9: Blank line inside blockquote
(MD028, no-blanks-blockquote)
37-37: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/options-for-starters/calls-and-puts.md
21-21: Blank line inside blockquote
(MD028, no-blanks-blockquote)
31-31: Blank line inside blockquote
(MD028, no-blanks-blockquote)
45-45: Blank line inside blockquote
(MD028, no-blanks-blockquote)
77-77: Blank line inside blockquote
(MD028, no-blanks-blockquote)
89-89: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/option-standard-sdk/opm.md
18-18: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
24-24: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/products/degen-mode.md
29-29: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
40-40: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
src/products/omlp.md
22-22: Blank line inside blockquote
(MD028, no-blanks-blockquote)
src/tokens/xlabs.md
9-9: Blank line inside blockquote
(MD028, no-blanks-blockquote)
37-37: Blank line inside blockquote
(MD028, no-blanks-blockquote)
🔇 Additional comments (5)
src/option-standard-sdk/opm.md (1)
10-10: Capitalize “Black-Scholes” consistentlyMinor correctness/consistency fix.
[raise_nitpick_refactor]
-However, using the black-scholes model within the DeFi environment does come with its own challenges... +However, using the Black-Scholes model within the DeFi environment comes with its own challenges...src/products/fees.md (1)
14-24: Clarify fee percentages to avoid ambiguityConfirm that “0.10%” and “0.075%” are fractional percentages (0.0010 and 0.00075), not 10%/7.5%.
If correct, consider rewriting as “0.10% (one‑tenth of one percent)” and “0.075% (0.00075)” for clarity.
src/options-for-starters/intro.md (1)
35-36: Internal links look good; keep extensionless pathsNoting this aligns with VitePress routing.
src/options-for-starters/calls-and-puts.md (1)
28-28: Verify presence of image assets under public/Automated check returned no output; cannot confirm these exist in public/: Long_Call.png, Long_Put.png, Short_Call.png, Short_Put.png, OptionGreeks.png. Affected: src/options-for-starters/calls-and-puts.md (lines 28, 42, 74, 86). Prevent broken images.
src/products/omlp.md (1)
15-16: Verify referenced images exist under public/ and add descriptive alt textAutomated search returned no matches — confirm these assets exist in public/ and update alt text.
File: src/products/omlp.md — lines 15–16 (also 25–26)
- + @@ - +
| Although being a seller is more risky than being a buyer, they are motivated to write contracts because they are paid by the buyer per hour. As time to expiration draws closer, so does the amount earned per hour - like a complicated game of ["chicken"](https://www.collinsdictionary.com/us/dictionary/english/play-chicken#:~:text=Definition%20of%20'play%20chicken'&text=1.,before%20actual%20conflict%20or%20collision) | ||
|
|
||
| > If the buyer chooses to walk away from the option contract, then the seller earns the **full** premium. | ||
|
|
There was a problem hiding this comment.
Fix payout mechanics: sellers aren’t “paid per hour”
Premium is received upfront; profit accrues as time decay reduces option value.
-Although being a seller is more risky than being a buyer, they are motivated to write contracts because they are paid by the buyer per hour. As time to expiration draws closer, so does the amount earned per hour - like a complicated game of ["chicken"](...)
+Although selling carries more risk than buying, writers receive the premium upfront. Profit is realized if the option’s value decays (time decay) or expires worthless — a bit like a game of “chicken” with time.📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| Although being a seller is more risky than being a buyer, they are motivated to write contracts because they are paid by the buyer per hour. As time to expiration draws closer, so does the amount earned per hour - like a complicated game of ["chicken"](https://www.collinsdictionary.com/us/dictionary/english/play-chicken#:~:text=Definition%20of%20'play%20chicken'&text=1.,before%20actual%20conflict%20or%20collision) | |
| > If the buyer chooses to walk away from the option contract, then the seller earns the **full** premium. | |
| Although selling carries more risk than buying, writers receive the premium upfront. Profit is realized if the option’s value decays (time decay) or expires worthless — a bit like a game of “chicken” with time. | |
| > If the buyer chooses to walk away from the option contract, then the seller earns the **full** premium. |
🤖 Prompt for AI Agents
In src/options-for-starters/calls-and-puts.md around lines 64 to 67, the text
incorrectly states sellers are "paid per hour" and implies a per-hour increasing
payment; rephrase to explain that the option premium is received upfront, the
seller's profit accrues as the option experiences time decay (theta) and loses
value, and clarify that if the buyer lets the option expire worthless the seller
keeps the full premium; replace the "paid per hour" and "amount earned per hour"
wording with a brief accurate description of premium upfront and time decay
mechanics.
| ## Options Contract Multiplier:100:: | ||
|
|
||
| It is important to remember that [Options Contract Multiplers](https://www.google.com/search?q=What+is+an+options+contract+multiplier%3F&sca_esv=33dcfe7d0c1ffd3e&rlz=1C1UEAD_enUS1166US1166&ei=5MvFaPePI9STwbkP-tCbuAQ&ved=0ahUKEwj3kaKTwtaPAxXUSTABHXroBkcQ4dUDCBE&uact=5&oq=What+is+an+options+contract+multiplier%3F&gs_lp=Egxnd3Mtd2l6LXNlcnAiJ1doYXQgaXMgYW4gb3B0aW9ucyBjb250cmFjdCBtdWx0aXBsaWVyPzIFECEYoAEyBRAhGKABMgUQIRigATIFECEYoAEyBRAhGKABMgUQIRirAkjHP1AAWOc9cAB4AZABAJgBe6AB2RqqAQQzMS44uAEDyAEA-AEBmAInoAK2G8ICCxAAGIAEGJECGIoFwgIKEAAYgAQYQxiKBcICDhAuGIAEGLEDGNEDGMcBwgILEAAYgAQYsQMYgwHCAggQABiABBixA8ICERAuGIAEGLEDGNEDGIMBGMcBwgIEEAAYA8ICDhAAGIAEGLEDGIMBGIoFwgIOEC4YgAQYsQMYgwEYigXCAgUQABiABMICBhAAGBYYHsICCBAAGBYYChgemAMAkgcEMzEuOKAHleoBsgcEMzEuOLgHthvCBwY2LjI5LjTIB0o&sclient=gws-wiz-serp) exist - traditionally meaning each value must be multiplied 100x. |
There was a problem hiding this comment.
Heading format and external link
- Fix MD026 (trailing punctuation) and odd “:100::”.
- Avoid Google SERP links; link internally to Terminology instead.
-## Options Contract Multiplier:100::
-
-It is important to remember that [Options Contract Multiplers](https://www.google.com/search?q=What+is+an+options+contract+multiplier%3F&...) exist - traditionally meaning each value must be multiplied 100x.
+## Options Contract Multiplier (100×)
+
+It’s important to remember that options contract multipliers exist—standard equity options represent 100 units of the underlying (100×). See [Terminology](/options-for-starters/intro#terminology) for details.📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| ## Options Contract Multiplier:100:: | |
| It is important to remember that [Options Contract Multiplers](https://www.google.com/search?q=What+is+an+options+contract+multiplier%3F&sca_esv=33dcfe7d0c1ffd3e&rlz=1C1UEAD_enUS1166US1166&ei=5MvFaPePI9STwbkP-tCbuAQ&ved=0ahUKEwj3kaKTwtaPAxXUSTABHXroBkcQ4dUDCBE&uact=5&oq=What+is+an+options+contract+multiplier%3F&gs_lp=Egxnd3Mtd2l6LXNlcnAiJ1doYXQgaXMgYW4gb3B0aW9ucyBjb250cmFjdCBtdWx0aXBsaWVyPzIFECEYoAEyBRAhGKABMgUQIRigATIFECEYoAEyBRAhGKABMgUQIRirAkjHP1AAWOc9cAB4AZABAJgBe6AB2RqqAQQzMS44uAEDyAEA-AEBmAInoAK2G8ICCxAAGIAEGJECGIoFwgIKEAAYgAQYQxiKBcICDhAuGIAEGLEDGNEDGMcBwgILEAAYgAQYsQMYgwHCAggQABiABBixA8ICERAuGIAEGLEDGNEDGIMBGMcBwgIEEAAYA8ICDhAAGIAEGLEDGIMBGIoFwgIOEC4YgAQYsQMYgwEYigXCAgUQABiABMICBhAAGBYYHsICCBAAGBYYChgemAMAkgcEMzEuOKAHleoBsgcEMzEuOLgHthvCBwY2LjI5LjTIB0o&sclient=gws-wiz-serp) exist - traditionally meaning each value must be multiplied 100x. | |
| ## Options Contract Multiplier (100×) | |
| It’s important to remember that options contract multipliers exist—standard equity options represent 100 units of the underlying (100×). See [Terminology](/options-for-starters/intro#terminology) for details. |
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
29-29: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
🤖 Prompt for AI Agents
In src/products/degen-mode.md around lines 29 to 31, the heading contains stray
“:100::” and trailing punctuation triggering MD026 and the paragraph links to a
Google search; remove the extraneous “:100::” so the heading is a normal heading
like “Options Contract Multiplier” with no trailing punctuation, simplify the
sentence to mention that multipliers are traditionally 100x (e.g., “Options
contract multipliers traditionally multiply values by 100.”), and replace the
external Google SERP link with an internal link to the Terminology page (use
your repo’s Terminology doc path, e.g., ../terminology.md or
/docs/terminology.md).
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (4)
src/products/degen-mode.md (4)
3-5: Emoji shortcodes won’t render without markdown-it-emojiEither enable markdown-it-emoji in VitePress config or replace shortcodes with Unicode.
Minimal Unicode replacement example:
-:rotating_light::speaking_head:<span style="color: #4a85ff">**CALLING ALL DEGENS**</span>:speaking_head::rotating_light: +:rotating_light::speaking_head:<span style="color: #4a85ff">**CALLING ALL DEGENS**</span>:speaking_head::rotating_light: +<!-- If plugin not enabled, replace with: --> +🚨🗣️<span style="color: #4a85ff"><b>CALLING ALL DEGENS</b></span>🗣️🚨Verify config or shortcode presence:
#!/bin/bash rg -n -i 'markdown-it-emoji|emoji' .vitepress package.json rg -n ':[a-z_]+:' src/products/degen-mode.mdAlso applies to: 15-15, 25-25, 40-40
25-26: Seller “Position Sentiment” should link to short-option anchors; fix double punctuationUpdate anchors to short put/short call and remove “??.”.
-| [**Position Sentiment**](/options-for-starters/calls-and-puts#long-call-option-bullish) | Sell a **Put** if you are <span style="color: #4a85ff">**Bullish**</span> :ox: :chart_with_upwards_trend: -- or -- Sell a **Call** if you are <span style="color: #4a85ff">**Bearish**</span> :bear: :chart_with_downwards_trend: | +| [**Position Sentiment**](/options-for-starters/calls-and-puts#short-put-option-bullish) | Sell a **Put** if you are <span style="color: #4a85ff">**Bullish**</span> :ox: :chart_with_upwards_trend: -- or -- Sell a **Call** if you are <span style="color: #4a85ff">**Bearish**</span> :bear: :chart_with_downwards_trend: | -| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price that you will compare your Position Sentiment to: Will the price be going <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price??. | +| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price that you will compare your Position Sentiment to: Will the price be going <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price? |
29-31: Heading punctuation (MD026), typo, and Google SERP linkFix trailing punctuation, spell “Multipliers,” and link internally to Terminology.
-## Options Contract Multiplier:100:: - -It is important to remember that [Options Contract Multiplers](https://www.google.com/search?q=What+is+an+options+contract+multiplier%3F&...) exist - traditionally meaning each value must be multiplied 100x. +## Options Contract Multiplier (100×) + +It’s important to remember that options contract multipliers exist—standard equity options represent 100 units of the underlying (100×). See [Terminology](/options-for-starters/intro#terminology) for details.
40-42: Fix MD026 and correct bearish guidanceRemove trailing punctuation in the heading and use “Buying a Put / Selling a Call” for bearish.
-## Options Tips for Degens :thinking::thought_balloon:: +## Options Tips for Degens :thinking::thought_balloon: - Buying a <span style="color: #4a85ff">**Call**</span> / Selling a <span style="color: #4a85ff">**Put**</span> = Bullish on Price :ox::chart_with_upwards_trend: -- Buying a <span style="color: #4a85ff">**Call**</span> / Selling a <span style="color: #4a85ff">**Call**</span> = Bearish on Price :bear: :chart_with_downwards_trend: +- Buying a <span style="color: #4a85ff">**Put**</span> / Selling a <span style="color: #4a85ff">**Call**</span> = Bearish on Price :bear: :chart_with_downwards_trend:
🧹 Nitpick comments (11)
src/products/degen-mode.md (3)
16-16: Fix stray “?.” punctuationEnd the sentence with either “?” or “.”, not both.
-| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price that you will compare your Position Sentiment to: Will the price be going <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price?. | +| [**Strike Price**](/options-for-starters/intro#terminology) | Select the base price that you will compare your Position Sentiment to: Will the price be going <span style="color: #4a85ff">**above**</span> or <span style="color: #4a85ff">**below**</span> the strike price? |
33-38: Grammar cleanups and consistent casing in examplesRemove duplicate “to,” use consistent “Selecting,” and drop the empty quote line.
-Thanks to to DeFi, Buyers & Sellers will be able to determine whatever size they want for their position through [fractionalization.](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers) +Thanks to DeFi, Buyers & Sellers can choose any position size through [fractionalization.](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers) > For example: ->> selecting a quantity of 1 = 100x of the underlying asset ->> Selecting a quantity of 0.5 = 50x of the underlying asset ->> ->> Selecting a quantity of 0.25 = 25x of the underlying asset +>> Selecting a quantity of 1 = 100× of the underlying asset +>> Selecting a quantity of 0.5 = 50× of the underlying asset +>> Selecting a quantity of 0.25 = 25× of the underlying asset
50-52: Minor copy edit for clarityTighten disclaimer wording.
-None of the information you will read is to be interpreted as financial advice! Kindly do your own research (DYOR) because Options can be risky and do not guarantee financial gains. +Nothing here is financial advice. Do your own research (DYOR). Options are risky and do not guarantee profits.src/option-standard-sdk/introduction.md (8)
5-5: Grammar: possessive and articleUse “an investor’s portfolio.”
-Just like the [Stock Market](https://www.investopedia.com/terms/s/stockmarket.asp), Option Contracts can provide exceptional diversity to an investors portfolio, or day-to-day positions, within the crypto space as well. +Just like the [stock market](https://www.investopedia.com/terms/s/stockmarket.asp), option contracts can provide exceptional diversity to an investor’s portfolio or day-to-day positions within crypto as well.
13-16: Wording: “barrier to entry”Use the standard phrasing and tighten sentences.
-Those individual investors and financial institutions are limited by various rules set by different exchanges, clearing firms, and government regulators - which is about as centralized as it gets. -While the centralized approach promotes safety and fairness from larger financial institutions, it does create a barrier-of-entry for smaller companies/individuals with less capital and whom cannot meet the criteria to participate. +Those investors and institutions are constrained by rules set by exchanges, clearing firms, and regulators—a centralized model. +While centralization can promote safety and fairness, it also creates a barrier to entry for smaller companies and individuals with less capital who cannot meet participation criteria.
31-33: Spelling fixes: “incredibly,” “simultaneously”Also minor style touch.
-Thanks to Solana's incrediblly fast transaction speed, inexpensive transaction costs, and proof-of-history (PoH) transaction validation, option contracts can be created and validated at extremely fast speeds. -This eliminates unfair low-latency advantages like in the New York Stock Exchange while simutaneously promoting safety for all who participate. +Thanks to Solana’s incredibly fast transaction speed, low transaction costs, and proof-of-history (PoH) validation, option contracts can be created and validated quickly. +This reduces unfair low-latency advantages seen on traditional venues while simultaneously promoting safety for all participants.
35-35: PunctuationEnd the sentence with a period.
-Please visit [Solana](https://solana.com/) for more details +Please visit [Solana](https://solana.com/) for more details.
39-42: Avoid absolute, time-sensitive claimsReplace “There are no protocols” with “Few protocols,” which will age better.
-There are no protocols, or platforms, that provide options as a service/function given its natural complexities. Simply put, options have not received the spotlight they deserve. +Few protocols or platforms provide options as a service/function due to their complexity. Simply put, options have not received the spotlight they deserve.
45-47: Minor capitalization and clarityUse sentence case for “option,” and clarify “order books.”
->- They are **difficult** to calculate correctly, consistently, and fairly. ->- They rely on **centralized** exchange orderbooks to calculate Option properties. ->- They require developers with **extensive** quantitative finance and programming knowledge to create. +>- They are **difficult** to calculate correctly, consistently, and fairly. +>- They rely on **centralized** exchange order books to calculate option properties. +>- They require developers with **extensive** quantitative finance and programming knowledge to create.
51-51: Spelling: “standardized”Fix typo.
-The Solana Options Standard will help fix most of the above issues by implementing standerdized solutions for developers to use within their projects or platforms. +The Solana Options Standard will help address most of the above issues by implementing standardized solutions for developers to use within their projects or platforms.
53-53: Tone polishTrim exclamatory marketing tone slightly.
-The purpose of **SOS-SDK** is to create an efficient and hassle-free way to create Option Contracts (and even Option Chains) on Solana. This standard will finally bring the most important financial derivatives into the spotlight - like it deserves! +The purpose of **SOS-SDK** is to provide an efficient, hassle-free way to create option contracts (and option chains) on Solana. This standard helps bring key financial derivatives into the spotlight.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
src/option-standard-sdk/introduction.md(1 hunks)src/products/degen-mode.md(1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
src/products/degen-mode.md
29-29: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
40-40: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
There was a problem hiding this comment.
Actionable comments posted: 0
♻️ Duplicate comments (1)
src/option-standard-sdk/introduction.md (1)
23-23: Broken internal link; wording cleanup (“Solana programs”)Update to the new About page path introduced in this PR and simplify wording.
-Introducing the **Solana Options Standard (SOS)** our open-source [Solana Program(s)](https://solana.com/docs/core/programs) **SDK** created by [**Epicentral Labs.**](/epicentral-labs/about) +Introducing the **Solana Options Standard (SOS)**—our open‑source [Solana programs](https://solana.com/docs/core/programs) SDK created by [**Epicentral Labs**](/introduction/about-epicentral-labs).Verify target exists:
#!/bin/bash fd -a 'about-epicentral-labs.md' src || true rg -n '^#\s*About Epicentral Labs' -n src/introduction/about-epicentral-labs.md || true
🧹 Nitpick comments (6)
src/option-standard-sdk/introduction.md (6)
13-15: Fix “barrier-of-entry” and “whom”Use standard phrasing and correct pronoun.
-While the centralized approach promotes safety and fairness from larger financial institutions, it does create a barrier-of-entry for smaller companies/individuals with less capital and whom cannot meet the criteria to participate. +While the centralized approach promotes safety and fairness from larger financial institutions, it creates a barrier to entry for smaller companies/individuals with less capital and who cannot meet the criteria to participate.
19-19: Minor tone/grammarPrefer “while” and standard phrasing.
-> Is it possible to promote **safety** and **fairness** whilst also lowering the barrier-of-entry for retail traders and smaller businesses? +> Is it possible to promote **safety** and **fairness** while also lowering the barrier to entry for retail traders and smaller businesses?
25-27: Consistency and run‑on sentenceLowercase “option contract(s)” for consistency and split the compound sentence.
-The SOS-SDK standardizes **Option Contract** creation on the Solana network, making it easier than ever to generate, calculate, and integrate Options on-chain. +The SOS‑SDK standardizes option contract creation on Solana, making it easier to generate, calculate, and integrate options on‑chain. -Our SDK consists of different libraries, modules, and pre-made mathematical derivative functions that allow developers to build option contracts within their protocols on Solana; and since it is open-source, they can even tweak it to implement bespoke options contracts tailored to their needs! +Our SDK provides libraries, modules, and pre‑made derivative functions that allow developers to build option contracts within their Solana protocols. Since it is open source, they can tweak it to implement bespoke options tailored to their needs.
31-35: Typos and clarityFix misspellings; tighten phrasing; end sentence with a period.
-Thanks to Solana's incrediblly fast transaction speed, inexpensive transaction costs, and proof-of-history (PoH) transaction validation, option contracts can be created and validated at extremely fast speeds. +Thanks to Solana's incredibly fast throughput, low transaction costs, and proof‑of‑history (PoH) validation, option contracts can be created and validated quickly. -This eliminates unfair low-latency advantages like in the New York Stock Exchange while simutaneously promoting safety for all who participate. +This reduces unfair low‑latency advantages like those on the New York Stock Exchange while simultaneously promoting safety for all participants. -Please visit [Solana](https://solana.com/) for more details +Please visit [Solana](https://solana.com/) for more details.
51-51: Spelling“standerdized” → “standardized”.
-The Solana Options Standard will help fix most of the above issues by implementing standerdized solutions for developers to use within their projects or platforms. +The Solana Options Standard will help fix most of the above issues by implementing standardized solutions for developers to use within their projects or platforms.
53-53: Tone and capitalizationLowercase common nouns; remove exclamation for neutral doc tone.
-The purpose of **SOS-SDK** is to create an efficient and hassle-free way to create Option Contracts (and even Option Chains) on Solana. This standard will finally bring the most important financial derivatives into the spotlight - like it deserves! +The purpose of **SOS‑SDK** is to provide an efficient, hassle‑free way to create option contracts (and even option chains) on Solana. This standard will help bring key financial derivatives into the spotlight.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
src/option-standard-sdk/introduction.md(1 hunks)src/tokens/labs.md(1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
- src/tokens/labs.md
🔇 Additional comments (2)
src/option-standard-sdk/introduction.md (2)
43-47: Clear, scannable reasons — looks goodConcise list of why options are overlooked reads well.
5-7: Grammar/clarity fixes — target page verifiedTighten language and fix possession; remove unnecessary quotes in link text. Internal target exists at src/options-for-starters/intro.md.
-Just like the [Stock Market](https://www.investopedia.com/terms/s/stockmarket.asp), Option Contracts can provide exceptional diversity to an investors portfolio, or day-to-day positions, within the crypto space as well. +Just like the [stock market](https://www.investopedia.com/terms/s/stockmarket.asp), option contracts can diversify an investor's portfolio or day‑to‑day positions in crypto. -Please visit the ["Options - For Starters"](/options-for-starters/intro) page for more details. +Please visit the [Options – For Starters](/options-for-starters/intro) page for more details.
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (2)
src/products/degen-mode.md (1)
1-1: Emoji shortcodes won’t render without markdown-it-emoji; enable it or replace with Unicode.If keeping shortcodes like 🚨/😎, enable the plugin in VitePress config or replace with actual emoji characters.
#!/bin/bash # Verify emoji plugin enabled and where shortcodes are used rg -n -i 'markdown-it-emoji|emoji' src/.vitepress/config.mts package.json rg -n ':[a-z_]+:' src/products/degen-mode.mdAlso applies to: 7-7, 38-38
src/tokens/xlabs.md (1)
3-4: Replace raw token address with explorer link (avoids Gitleaks false positives).-## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT +## Token address +Explore: https://solscan.io/token/xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT
🧹 Nitpick comments (12)
src/products/api.md (3)
5-5: Fix minor grammar (“everyday” → “every day”).-Analysts use derivative trading data everyday to gauge market sentiment by examining the behavior of investors, which can signal broader shifts in the market. +Analysts use derivative trading data every day to gauge market sentiment by examining the behavior of investors, which can signal broader shifts in the market.
1-1: Avoid inline color styling in headings (better theme/dark‑mode compatibility).-# Epicentral Labs <span style="color: #4a85ff">**API**</span> Endpoint +# Epicentral Labs API Endpoint
27-33: Tighten copy; end bullets with periods; small wording nits.-Including, but not limited to: -- **Historical and live data:** Access end-of-day prices, open interest, and volume data for in-depth analysis and strategy backtesting -- **Market sentiment metrics:** Leverage insights from volatility, put/call ratios, and other indicators to gauge the overall market mood -- **And more!** +Our services include: +- **Historical and live data:** Access end‑of‑day prices, open interest, and volume for analysis and backtesting. +- **Market sentiment metrics:** Leverage volatility, put/call ratios, and other indicators to gauge overall market mood. +- **And more.**src/products/degen-mode.md (2)
27-35: Fix heading (MD026), spelling, and avoid Google SERP link.-## Options Contract Multiplier:100:: - -It is important to remember that [Options Contract Multiplers](https://www.google.com/search?q=What+is+an+options+contract+multiplier%3F&...) exist - traditionally meaning each value must be multiplied 100x. -Thanks to to DeFi, Buyers & Sellers will be able to determine whatever size they want for their position through [fractionalization.](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers) +## Options Contract Multiplier (100×) + +It’s important to remember that options contract multipliers exist—standard equity options represent 100 units of the underlying (100×). +Thanks to DeFi, buyers and sellers can choose any position size via [fractionalization](/option-standard-sdk/opm#fractionalized-options-for-buyers-and-sellers).
38-41: Correct bearish guidance and remove trailing punctuation (MD026).-## Options Tips for Degens :thinking::thought_balloon:: +## Options Tips for Degens - Buying a <span style="color: #4a85ff">**Call**</span> / Selling a <span style="color: #4a85ff">**Put**</span> = Bullish on Price :ox::chart_with_upwards_trend: -- Buying a <span style="color: #4a85ff">**Call**</span> / Selling a <span style="color: #4a85ff">**Call**</span> = Bearish on Price :bear: :chart_with_downwards_trend: +- Buying a <span style="color: #4a85ff">**Put**</span> / Selling a <span style="color: #4a85ff">**Call**</span> = Bearish on Price :bear: :chart_with_downwards_trend:src/tokens/xlabs.md (1)
12-15: Fix typos and soften price/promise language.-Price volatility of the [LABS](/tokens/labs) governance token should be reduced since holders are incentivized to stake to realize revshare yied. This in turn concentrates price action and trading to xLABS. +Price volatility of the [LABS](/tokens/labs) governance token may be reduced as holders stake to realize revshare yield, which could shift trading activity toward xLABS. @@ -As a bonus, users now have the opprotunity to transfer xLABS to other holders/wallets, ensuring control of their governance power while peacemealing their yields as they please - similar to [US STRIPS.](https://www.treasurydirect.gov/marketable-securities/strips/) +As a bonus, users can transfer xLABS to other wallets, maintaining governance control while realizing yield piecemeal — similar to [US STRIPS](https://www.treasurydirect.gov/marketable-securities/strips/). @@ -> OPX's role increases xLABS value by providing market demand while also reducing the total supply - thus performing a buyback function. The entire system was created to be balanced, automatic, and inflation-regulating. +> OPX’s purchases provide demand while burns reduce supply, functioning like a buyback. The system is designed to be balanced, automated, and supply‑regulated — not a guarantee of returns.Also applies to: 24-27
src/products/staking-lab.md (4)
3-3: Copy edits (typos, clarity).-The Staking LAB was created with the user in-mind while also being balanced, automatic, and inflation-regulating. Our intent is to to incentivize users to stake with us by ensuring they take part in the protocol's revsharing system. +The Staking Lab was created with the user in mind while also being balanced, automatic, and supply‑regulated. Our intent is to incentivize users to stake with us by ensuring they take part in the protocol’s revsharing system.
5-5: Remove trailing colon in heading (MD026).-## How it works: +## How it works
9-9: Verb form of “buy back.”-Simultaneously, OPX utilizes 80% of fees to buyback xLABS over the open-market thus driving market demand while also reducing the total supply. +Simultaneously, OPX utilizes 80% of fees to buy back xLABS on the open market, driving demand while also reducing total supply.
18-20: Soften value‑increase claim.-While xLABS are created from staking, OPX uses 80% of the fees it generates to ***buyback*** xLABS from the market. -> This creates a consistent *"buy"* pressure that naturally increases the value of xLABS for holders. +While xLABS are created from staking, OPX uses 80% of the fees it generates to ***buy back*** xLABS from the market. +> This creates ongoing buy pressure that may support xLABS price for holders.src/.vitepress/config.mts (2)
4-10: Enable git timestamps for “Last Updated”.VitePress requires the top‑level flag to read git timestamps.
export default defineConfig({ + lastUpdated: true, ignoreDeadLinks: true,
1-1: Enable emoji shortcode rendering site‑wide.In src/.vitepress/config.mts import and enable markdown-it-emoji in the VitePress markdown config, and add it to package.json devDependencies.
-import { defineConfig } from 'vitepress' +import { defineConfig } from 'vitepress' +import emoji from 'markdown-it-emoji' @@ export default defineConfig({ + markdown: { + config: (md) => { + md.use(emoji) + } + },+"markdown-it-emoji": "^3.0.0"
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (5)
src/.vitepress/config.mts(2 hunks)src/products/api.md(1 hunks)src/products/degen-mode.md(1 hunks)src/products/staking-lab.md(1 hunks)src/tokens/xlabs.md(1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
src/products/degen-mode.md
27-27: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
38-38: Trailing punctuation in heading
Punctuation: '::'
(MD026, no-trailing-punctuation)
🪛 Gitleaks (8.27.2)
src/tokens/xlabs.md
[high] 3-3: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.
(generic-api-key)
🔇 Additional comments (2)
src/.vitepress/config.mts (1)
91-91: Confirm “Under Development” label for Staking Lab.The page exists and reads complete; if it’s public‑ready, consider dropping “(Under Development)” for consistency with other live pages.
src/products/degen-mode.md (1)
14-16: Fix anchors and punctuation in tables (buyer/seller).Update the Position Sentiment link to /options-for-starters/calls-and-puts.html#short-put-option-bullish (anchor exists) and correct punctuation/grammar in the Strike Price and Expiration Date table rows (remove duplicate/questionable punctuation; use a single sentence-ending mark).
File: src/products/degen-mode.md — lines 14–16, 23–25
| nav: [ | ||
| { text: 'Home', link: '/' }, | ||
| { | ||
| text: 'Solana Options Standard SDK', | ||
| text: 'Guides', | ||
| items: [ | ||
| { text: 'Introduction', link: '/option-standard-sdk/introduction' } | ||
| { text: 'Options - For Starters', link: '/options-for-starters/intro' } | ||
| ] | ||
| }, | ||
| { | ||
| text: 'Guides', | ||
| { | ||
| text: 'Solana Options Standard SDK', | ||
| items: [ | ||
| { text: 'Options - For Starters', link: '/options-for-starters/intro' } | ||
| { text: 'Introduction', link: '/option-standard-sdk/introduction' } | ||
| ] | ||
| } | ||
| ], | ||
|
|
||
| ].sort((a, b) => a.text.localeCompare(b.text)), |
There was a problem hiding this comment.
🛠️ Refactor suggestion
Don’t sort top‑nav; keep Home pinned first.
- nav: [
+ nav: [
{ text: 'Home', link: '/' },
{
text: 'Guides',
items: [
{ text: 'Options - For Starters', link: '/options-for-starters/intro' }
]
},
{
text: 'Solana Options Standard SDK',
items: [
{ text: 'Introduction', link: '/option-standard-sdk/introduction' }
]
}
- ].sort((a, b) => a.text.localeCompare(b.text)),
+ ],📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| nav: [ | |
| { text: 'Home', link: '/' }, | |
| { | |
| text: 'Solana Options Standard SDK', | |
| text: 'Guides', | |
| items: [ | |
| { text: 'Introduction', link: '/option-standard-sdk/introduction' } | |
| { text: 'Options - For Starters', link: '/options-for-starters/intro' } | |
| ] | |
| }, | |
| { | |
| text: 'Guides', | |
| { | |
| text: 'Solana Options Standard SDK', | |
| items: [ | |
| { text: 'Options - For Starters', link: '/options-for-starters/intro' } | |
| { text: 'Introduction', link: '/option-standard-sdk/introduction' } | |
| ] | |
| } | |
| ], | |
| ].sort((a, b) => a.text.localeCompare(b.text)), | |
| nav: [ | |
| { text: 'Home', link: '/' }, | |
| { | |
| text: 'Guides', | |
| items: [ | |
| { text: 'Options - For Starters', link: '/options-for-starters/intro' } | |
| ] | |
| }, | |
| { | |
| text: 'Solana Options Standard SDK', | |
| items: [ | |
| { text: 'Introduction', link: '/option-standard-sdk/introduction' } | |
| ] | |
| } | |
| ], |
🤖 Prompt for AI Agents
In src/.vitepress/config.mts around lines 23 to 37, the top navigation array is
being globally sorted which moves the Home item; keep Home pinned first by
removing the global .sort or by constructing the nav so Home remains at index 0
and only the remaining items are sorted — e.g. extract navRest =
nav.slice(1).sort(...), then set nav = [nav[0], ...navRest]; ensure the final
exported nav preserves Home as the first entry.
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (5)
src/tokens/xlabs.md (3)
12-12: Fix typos and soften claims (avoid promises).Address “yied/opprotunity/peacemealing” and remove implied guarantees.
-Price volatility of the [LABS](/tokens/labs) governance token should be reduced since holders are incentivized to stake to realize revshare yied. This in turn concentrates price action and trading to xLABS. +Price volatility of [LABS](/tokens/labs) may be reduced as holders stake to realize revshare yield, which could shift trading activity toward xLABS. @@ -As a bonus, users now have the opprotunity to transfer xLABS to other holders/wallets, ensuring control of their governance power while peacemealing their yields as they please - similar to [US STRIPS.](https://www.treasurydirect.gov/marketable-securities/strips/) +As a bonus, users can transfer xLABS to other wallets, separating governance from revshare and allowing piecemeal realization of yield — similar to [US STRIPS](https://www.treasurydirect.gov/marketable-securities/strips/).Also applies to: 14-14
3-3: Replace raw token address with explorer link (prevents Gitleaks false positives).Same as previously raised; switch to a link and remove the literal address string.
-## Token Address: xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT +## Token address +Explore: https://solscan.io/token/xLABSWsaKtCdzdqCqZrHyj6WxxKSQRPB9o2LXLwHfiT
29-29: Tone down prescriptive wording in founder quote (compliance).Replace the quote to avoid implying guaranteed returns or giving financial advice.
File: src/tokens/xlabs.md — line 29
-> “xLABS is designed to be minted *and* **sold.**” TheLazySol, founder +> “xLABS is designed to be minted; holders may choose whether to sell.” — TheLazySol, foundersrc/.vitepress/config.mts (2)
37-37: Don’t globally sort top‑nav; keep Home pinned first.Same ask as earlier: remove the
.sortso “Home” remains first.- ].sort((a, b) => a.text.localeCompare(b.text)), + ],
76-93: Avoid sorting Products; preserve curated order or use weights.Global sorting can shuffle important groupings (e.g., OPX). Prefer explicit order or weight keys.
- ].sort((a, b) => a.text.localeCompare(b.text)) + ]If you want partial sorting, add
weightfields and sort by weight then text, leaving grouped items intact.
🧹 Nitpick comments (8)
src/products/staking-lab.md (2)
3-3: Fix grammar and tighten wording (typos, clarity).Correct minor issues and standardize “revshare” wording.
-The Staking LAB was created with the user in-mind. Our intent is to to incentivize users to stake with us by ensuring they take part in the protocol's revsharing system. +The Staking Lab was created with the user in mind. Our intent is to incentivize users to stake with us by ensuring they participate in the protocol’s revenue‑sharing (revshare) system.
5-5: Remove trailing punctuation in headings (MD026).Drop the colons to satisfy markdownlint and keep style consistent.
-## How it works: +## How it works -### 1. Staking: +### 1. Staking -### 2. Buying: +### 2. Buying -### 3. Burning: +### 3. BurningAlso applies to: 13-13, 17-17, 21-21
src/tokens/xlabs.md (1)
1-1: Avoid HTML styling in headings for a11y/theming compatibility.Use plain Markdown; theme will handle color/weight.
-# <span style="color: #4a85ff">**xLABS**</span>: Revshare re-configured +# xLABS: Revshare reconfiguredsrc/.vitepress/config.mts (1)
32-35: Unify naming: use “SOS‑SDK” consistently.Sidebar uses “SOS-SDK” while top nav says “Solana Options Standard SDK”.
- text: 'Solana Options Standard SDK', + text: 'SOS-SDK',src/option-standard-sdk/introduction.md (4)
5-5: Minor grammar/case polish.-Just like the [Stock Market](https://www.investopedia.com/terms/s/stockmarket.asp), Option Contracts can provide exceptional diversity to an investors portfolio, or day-to-day positions, within the crypto space as well. +Just like the [stock market](https://www.investopedia.com/terms/s/stockmarket.asp), option contracts can provide exceptional diversity to an investor’s portfolio, or day‑to‑day positions, within the crypto space as well.
23-23: Punctuation inside the link text.Move the period outside the link and drop the trailing dot from the anchor text.
-Introducing the **Solana Options Standard (SOS)** our open-source [Solana Program(s)](https://solana.com/docs/core/programs) **SDK** created by [**Epicentral Labs.**](/introduction/about-epicentral-labs) +Introducing the **Solana Options Standard (SOS)**—our open‑source [Solana programs](https://solana.com/docs/core/programs) **SDK** created by [**Epicentral Labs**](/introduction/about-epicentral-labs).
31-35: Fix typos and soften absolute claims.Correct spelling and avoid “eliminates” claims; prefer “mitigates”.
-Thanks to Solana's incrediblly fast transaction speed, inexpensive transaction costs, and proof-of-history (PoH) transaction validation, option contracts can be created and validated at extremely fast speeds. -This eliminates unfair low-latency advantages like in the New York Stock Exchange while simutaneously promoting safety for all who participate. -Please visit [Solana](https://solana.com/) for more details +Thanks to Solana’s incredibly fast throughput, low transaction costs, and proof‑of‑history (PoH), option contracts can be created and validated quickly. +This mitigates low‑latency advantages seen on centralized venues and promotes a more level playing field for participants. +Please visit [Solana](https://solana.com/) for more details.
51-51: Typo + clarity.-The Solana Options Standard will help fix most of the above issues by implementing standerdized solutions for developers to use within their projects or platforms. +The Solana Options Standard addresses many of the above issues by implementing standardized solutions developers can integrate into their projects and platforms.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (4)
src/.vitepress/config.mts(2 hunks)src/option-standard-sdk/introduction.md(1 hunks)src/products/staking-lab.md(1 hunks)src/tokens/xlabs.md(1 hunks)
🧰 Additional context used
🪛 Gitleaks (8.27.2)
src/tokens/xlabs.md
[high] 3-3: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.
(generic-api-key)
🪛 markdownlint-cli2 (0.17.2)
src/products/staking-lab.md
5-5: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
13-13: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
17-17: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
21-21: Trailing punctuation in heading
Punctuation: ':'
(MD026, no-trailing-punctuation)
🔇 Additional comments (2)
src/products/staking-lab.md (1)
15-15: Spell/wording nit + accuracy check on “fixed rate predetermined by the DAO”.Change “pre-determined” → “predetermined”, and link/verify the parameter in Governance docs.
-> xLABS are instantly minted to the user’s wallet at a fixed rate pre-determined by the DAO. +> xLABS are instantly minted to the user’s wallet at a fixed rate predetermined by the DAO.Please confirm this rate and add a reference to the relevant governance page (e.g., /governance/governance or /governance/operations), or adjust wording if the rate can change by vote.
src/.vitepress/config.mts (1)
111-115: Confirm correct icon key for Twitter/X in your VitePress version.Some versions expect
icon: 'x'instead of'twitter'.If needed, change:
- { icon: 'twitter', link: 'https://x.com/EpicentralLabs' }, + { icon: 'x', link: 'https://x.com/EpicentralLabs' },
|
|
||
| Revshare fees are allocated to stakers proportionally, based on their individual xLABS holdings relative to the total supply of staked xLABS. | ||
|
|
||
| Simultaneously, OPX utilizes 80% of fees to buyback xLABS over the open-market thus driving market demand while also reducing the total supply. |
There was a problem hiding this comment.
Soften price/return implications; fix “buyback” usage and phrasing.
Avoid implying guaranteed price effects; use “buy back” (verb) and clarify burn effects.
-Simultaneously, OPX utilizes 80% of fees to buyback xLABS over the open-market thus driving market demand while also reducing the total supply.
+At the same time, OPX allocates 80% of fees to buy back xLABS on the open market, supporting demand and reducing circulating supply.
-While xLABS are created from staking, OPX uses 80% of the fees it generates to ***buyback*** xLABS from the market.
-> This creates a consistent *"buy"* pressure that naturally increases the value of xLABS for holders.
+While xLABS are created from staking, OPX uses 80% of the fees it generates to ***buy back*** xLABS on the market.
+> This creates ongoing buy pressure that may support xLABS price.
-> This is a ***crucial*** step in two regards:
-> - Burning **combats** inflation by reducing xLABS circulating supply
-> - Burning xLABS also **provides** liquidity into the buy-side market directly
+> This is a crucial step:
+> - Burning reduces xLABS circulating supply.Also applies to: 18-20, 22-26
🤖 Prompt for AI Agents
In src/products/staking-lab.md around line 9 (and also apply the same changes to
lines 18-20 and 22-26), replace the definitive language that implies guaranteed
price or return effects and change the noun "buyback" to the verb phrase "buy
back"; rephrase to say OPX uses 80% of fees to buy back xLABS on the open
market, which may support demand, and clarify whether purchased tokens are
burned or otherwise taken out of circulation (e.g., "and a portion of those
tokens are burned, which reduces circulating supply") so the phrasing is
conditional (e.g., "may contribute to upward pressure" / "can help support
market demand") rather than asserting guaranteed price increases.
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (4)
src/introduction/about-epicentral-labs.md (4)
10-13: Tighten style; add clarity and disclaimers for trading education.
- Prefer “barrier to entry” over “barrier-of-entry”.
- Consider adding a short “This is not financial advice; crypto involves risk” disclaimer in this section.
Apply this diff:
- Bringing Options markets and options trading to the Solana network with a focus on decentralization. Our goal is to create a legacy by driving decentralization and influencing other DAOs. We also plan to expand option market capabilities across the ecosystem by making our SDK **open-source** for other protocols to use. + Bringing options markets and options trading to the Solana network with a focus on decentralization. Our goal is to drive decentralization and positively influence other DAOs. We also plan to expand option market capabilities across the ecosystem by making our SDK **open source** for other protocols to use. - Current market opportunities allow traders to profit by either trading at spot price or with leverage via perp trading. While this is a great start for DeFi trading, it's missing many factors that would benefit users. Key factors like *risk management, capital efficiency, and strategic diversification* are all left out of the current trading experience and create barriers-of-entry for beginner users. + Current market opportunities allow traders to participate at spot or with leverage via perps. While this is a start for DeFi trading, important factors like *risk management, capital efficiency, and strategic diversification* are often missing for beginners, creating barriers to entry. - Our goal is to lower the barrier-of-entry by making trading more accessible, and understandable, for all - regardless of experience. + Our goal is to lower the barrier to entry by making trading more accessible and understandable for all users, regardless of experience. + + > Note: The information provided is for educational purposes only and does not constitute financial, investment, or legal advice. Crypto assets are volatile and carry risk.Also applies to: 16-21
23-31: Soften absolute claims; fix list formatting (markdownlint).
- “100% democratic” is absolute and may be inaccurate; soften to “community-governed”.
- Replace blockquotes with a list to satisfy MD027/MD028 and improve scannability.
Apply this diff:
- We are 100% democratic and are governed by proposals brought forth by our community members. Voting power is determined by the amount of [LABS](/tokens/labs) a user owns. This structure incentivizes alignment and commitment from community members while also filtering out the opinions from non-members. Members of our community determine key decisions like: -> Deciding which assets will be eligible for trading on the protocol - -> Proposing new features and improvements for the protocol - -> Voting on protocol governance parameters and criteria on **how** the DAO functions + We are community‑governed via proposals brought forth by members. Voting power is determined by the amount of [LABS](/tokens/labs) a user owns. This structure incentivizes alignment and long‑term commitment. Members help decide: + - Which assets are eligible for trading on the protocol + - New features and improvements for the protocol + - Governance parameters and criteria for how the DAO functions
38-41: Minor wording nit.“Return … back” is redundant; tighten sentence.
Apply this diff:
- At our core, we want to return financial power back to users from financial institutions. + At our core, we want to return financial power to users from financial institutions.
50-58: Convert blockquote roles to a list; fix terminology.
- Replace blockquotes with a list (fixes MD028).
- “open-source codes” → “open‑source code”.
- Market makers don’t “establish expiration dates”; suggest “quote options and provide liquidity across strikes and expirations.”
Apply this diff:
- > **Traders:** Users who trade underlying assets via purchasing/selling/exercising options contracts - - > **Lenders and Liquidity Providers:** Users who wish not to trade but be involved by providing liquidity and capital for traders to use at a pre-determined rate - - > **Market Makers:** Users who wish to profit by establishing expiration dates and price futures of underlying assets - - > **Protocol Developers:** Users who utilize our open-source codes to further expand functionality within the Solana network + - **Traders:** Trade underlying assets via purchasing/selling/exercising options contracts. + - **Lenders and Liquidity Providers:** Provide liquidity/capital for traders to use at pre‑determined terms. + - **Market Makers:** Quote options and provide liquidity across strikes and expirations. + - **Protocol Developers:** Utilize our open‑source code to expand functionality within the Solana network.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
src/introduction/about-epicentral-labs.md(1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.18.1)
src/introduction/about-epicentral-labs.md
24-24: Multiple spaces after blockquote symbol
(MD027, no-multiple-space-blockquote)
25-25: Blank line inside blockquote
(MD028, no-blanks-blockquote)
27-27: Blank line inside blockquote
(MD028, no-blanks-blockquote)
53-53: Blank line inside blockquote
(MD028, no-blanks-blockquote)
55-55: Blank line inside blockquote
(MD028, no-blanks-blockquote)
57-57: Blank line inside blockquote
(MD028, no-blanks-blockquote)
🔇 Additional comments (5)
src/introduction/about-epicentral-labs.md (5)
5-5: Capitalization of Solana looks good.Past feedback on capitalizing “Solana” appears addressed here.
23-31: Address markdownlint warnings (MD027/MD028).The blockquote formatting triggers MD027/MD028. The proposed list conversions above will resolve these.
Also applies to: 50-58
32-35: Internal links verified — no broken nav detected.Pages found: src/products/fees.md, src/tokens/xlabs.md, src/tokens/labs.md, src/governance/governance.md (checked lines 20–21 and 32–35).
44-47: Verify legal entity details and add jurisdiction + transparency link
- Confirm "Epicentral Labs DAO, LLC", formation date "July 6, 2024", and add the state of formation (jurisdiction) before publishing — src/introduction/about-epicentral-labs.md (lines 44–47).
- No transparency/governance/legal page found in the repo; add a public entity disclosure/governance page and link it from this doc.
20-21: Verify route exists & use title-caseConfirm that "/options-for-starters/intro" exists with the exact slug/casing and update the href if it does not. Change the link text to title-case and remove the hyphen: "Options for Starters guide".
File: src/introduction/about-epicentral-labs.md (lines 20–21)
| --- | ||
| ### RevSharing | ||
| Revenuse sharing yields will be distributed via our Revenue Sharing Token (RST) [xLABS.](/tokens/xlabs) Our [fees structure](/products/fees) is designed with the DAO, and LABS stakers, in mind. This is our way of thanking the community and incentivizing alignment within the DAO. | ||
|
|
There was a problem hiding this comment.
Fix typos; avoid “revshare” guarantees; add compliance language.
- Spelling: “RevSharing” → “Revenue Sharing”, “Revenuse” → “Revenue”, “fees structure” → “fee structure”.
- Avoid implying guaranteed yields; clarify variability and governance control.
- Keep token naming consistent: “xLABS” without trailing punctuation inside the link text.
Apply this diff:
----
-### RevSharing
-Revenuse sharing yields will be distributed via our Revenue Sharing Token (RST) [xLABS.](/tokens/xlabs) Our [fees structure](/products/fees) is designed with the DAO, and LABS stakers, in mind. This is our way of thanking the community and incentivizing alignment within the DAO.
+### Revenue Sharing
+Revenue from protocol operations may be allocated to participants via the [xLABS](/tokens/xlabs) token as determined by DAO governance. Distributions, if any, are not guaranteed and may vary over time. Our [fee structure](/products/fees) is designed with the DAO and LABS stakers in mind to align incentives.
+> Disclaimer: Nothing herein constitutes an offer to sell or a solicitation to buy any asset. Availability may be restricted by jurisdiction. See the xLABS and LABS token pages for details and risks.📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| --- | |
| ### RevSharing | |
| Revenuse sharing yields will be distributed via our Revenue Sharing Token (RST) [xLABS.](/tokens/xlabs) Our [fees structure](/products/fees) is designed with the DAO, and LABS stakers, in mind. This is our way of thanking the community and incentivizing alignment within the DAO. | |
| --- | |
| ### Revenue Sharing | |
| Revenue from protocol operations may be allocated to participants via the [xLABS](/tokens/xlabs) token as determined by DAO governance. Distributions, if any, are not guaranteed and may vary over time. Our [fee structure](/products/fees) is designed with the DAO and LABS stakers in mind to align incentives. | |
| > Disclaimer: Nothing herein constitutes an offer to sell or a solicitation to buy any asset. Availability may be restricted by jurisdiction. See the xLABS and LABS token pages for details and risks. |
🤖 Prompt for AI Agents
In src/introduction/about-epicentral-labs.md around lines 32 to 35, fix typos
and wording: change the heading "RevSharing" to "Revenue Sharing", correct
"Revenuse" to "Revenue", and "fees structure" to "fee structure"; update the
sentence to remove any implication of guaranteed yields by stating that revenue
distributions vary and are subject to DAO governance and policy; add brief
compliance-safe language such as “distributions are variable, not guaranteed,
and subject to applicable laws and DAO governance”; and ensure the token link
text reads "xLABS" (no trailing punctuation inside the link).
2 participants
Summary by CodeRabbit
New Features
Documentation
Chores