Starred Gists
Starred Gists订阅

GSoC 2026 Final Report: Make OrbOracle composable, and ship polished landing pages for Stability Nexus projects.

Contributor Piyush Choudhary (@Piyushbijarania)
Organization AOSSIE, Stability Nexus
Mentors Bruno Woltzenlogel Paleo, Sarthak Dengre, Yogesh Agrawal, M4dhav
Project page GSoC 2026 project page
Project repos OrbOracle-Solidity · OrbOracle-EVM-Frontend · Website · Gluon-LandingPage
Report version Final report, updated 31 October 2026.
Work record 1 June to 30 October 2026.

Introduction

OrbOracle is a decentralized, sustainable oracle protocol designed to provide continuous price feeds secured through exponentially weighted moving averages (EWMA), reporter-funded staking, and dynamic token incentives. Prior to this project, Orb was limited to standalone, single-asset primary price feeds. In modern decentralized finance (DeFi), protocols and automated systems frequently require synthetic asset valuation, cross-rate currency pricing (for example, deriving ETH/EUR by composing ETH/USD and EUR/USD), and price inversions without relying on centralized aggregation layers.

This Google Summer of Code project accomplished two major pillars for the Stability Nexus ecosystem:

  1. Architected and delivered the Composable Oracle Protocol: Developed and deployed production Solidity contracts (ComposedOracle, ComposedOracleFactory) enabling permissionless on-chain multiplication, division, and inversion across arbitrary base and composed price feeds normalized to 18 decimals (WAD), supported by synchronous historical extreme lookbacks (readValueInterval) and verified through comprehensive Foundry property-based fuzz test suites. Complementing the contracts, built an end-to-end Web3 interface allowing users to browse, create, simulate, and inspect composed feeds seamlessly.
  2. Polished and shipped production web infrastructure across Stability Nexus: Modernized, optimized, and deployed responsive web portals for the Stability Nexus ecosystem, including the flagship organization website (stability.nexus), the Gluon stablecoin landing page (gluon.stability.nexus), and the redesigned Orb Oracle decentralized application (orb-oracle.stability.nexus), integrating interactive protocol mechanics walkthroughs, dynamic charts, research libraries, automated SEO metadata, and OpenSSF Scorecard compliance.

Across the coding period, a total of 73 pull requests (70 merged, 3 open for post-GSoC review) were submitted across the Stability Nexus and AOSSIE repositories.

Goals of the Project

Status Goal Description & Key Deliverables
🟢 Composed Oracle Smart Contracts Implemented on-chain arithmetic composition (multiplication, division, inversion) standardized to 18 decimals (WAD = 1e18), adhering strictly to the IOracle interface. (PRs #5, #6, #7, #8, #9, #12, #15)
🟢 Permissionless Factory & Testnet Deployment Created ComposedOracleFactory for permissionless deployment with deterministic event emissions, metadata tracking, and deployed verified instances on Ethereum Sepolia testnet. (PRs #10, #18)
🟢 Historical Lookback Sampling (readValueInterval) Engineered synchronous lookback interval sampling over historical data across parent feeds to compute reliable upper and lower price bounds over user-specified timeframes. (PRs #9, #11)
🟢 Property-Based Fuzz Testing Built exhaustive Foundry property-based fuzz tests verifying scale invariance, deep chain nesting (up to 12 levels), division-by-zero reverts, and caller blacklist propagation. (PR #16)
🟢 Composed Oracle Web Interface & Creation Wizard Built a tabbed creation wizard, live composition preview, dynamic Chart.js multi-feed historical visualizer, lookback interval simulator, and deterministic transaction receipt log parser. (PRs #41, #43, #44, #45, #47, #60, #65)
🟢 Orb Oracle UI/UX Redesign & Production Readiness Redesigned Home, Deploy, Explorer, and Operate pages, added a global toast notification system, fixed UI race conditions, and configured SEO metadata, sitemaps, and robots directives. (PRs #59, #62, #63, #64)
🟢 Stability Nexus Main Website Upgrades Delivered the Research Library (12+ academic papers, custom YouTube seminar viewer with 22 videos), filterable software catalog with interactive details modals, events workshop redesign, brand asset kits, and OpenSSF Scorecard CI. (PRs #45, #46, #47, #51, #55, #56, #58, #59, #60, #64, #68, #70, #76)
🟢 Gluon Stablecoin Landing Page Shipped interactive protocol mechanics walkthrough (fission, fusion, beta transmutation), terms of use modal, AI agent readiness kits (/openapi.json, /api/info.json), mobile responsiveness, and SEO sitemaps. (PRs #5, #6, #9, #10, #12, #13, #15, #19)
🟢 Peer Review Audits & Code Quality Authored and merged 9 comprehensive peer review audits across Gluon-EVM and 8 AOSSIE-Org repositories, conducted peer review remediation, and resolved contract and UI edge cases. (PRs #20, #22, #24, #65, Gluon-EVM PR #71, AOSSIE PRs #407, #48, #756, #39, #59, #184, #9, #259)
🟡 Protocol Developer Fee & 2-Step Handover Added configurable developer fee deduction and safe two-step ownership handover logic to Oracle.sol. Ready and submitted for final review. (PR #19)

Summary of Achievements

  • Production Composable Oracle Protocol: Engineered arithmetic composition contracts that enable permissionless construction of synthetic feeds (e.g. ETH/EUR = ETH/USD / EUR/USD or inverse feeds USD/ETH = 1 / ETH/USD) with fixed-point math normalized to 18 decimals (1 WAD = 10^18).
  • Synchronous Historical Extremes: Delivered readValueInterval() on composed oracles, sampling overlapping historical price ranges between constituent parent feeds to return mathematically bounded minimum and maximum intervals for risk engines and lending liquidators.
  • Battle-Tested Security & Fuzzing: Authored comprehensive Foundry suites containing property-based fuzz tests verifying scale invariance, extreme value boundary bounds, deep recursive nesting (up to 12 levels), and blacklist propagation across randomized inputs.
  • Complete End-to-End Composed WebUI: Built a multi-step oracle creation wizard, dynamic Chart.js multi-series visualizer, lookback interval simulation panel, and robust transaction receipt log parsing via Viem that eliminated client-side redirect race conditions.
  • Full Ecosystem Surface Delivery: Elevated production web interfaces across Stability Nexus, including stability.nexus (Research Library, YouTube video viewer, filterable software directory), gluon.stability.nexus (interactive fission/fusion visualizer, terms modal, machine-readable API kits), and orb-oracle.stability.nexus (complete UI/UX overhaul, sitemaps, robots directives).
  • Cross-Repository Peer Review Audits: Authored and merged 9 comprehensive peer review audits across Gluon-EVM and 8 AOSSIE organization repositories, establishing code quality and architectural baselines across the ecosystem.

Stats

  • Pull requests: 73 total, 70 merged, 3 open, 0 closed
  • Lines changed across all PRs: +28,810 / -9,246
  • Repositories (16): StabilityNexus/OrbOracle-Solidity, StabilityNexus/OrbOracle-EVM-Frontend, StabilityNexus/Website, StabilityNexus/Gluon-LandingPage, StabilityNexus/Gluon-EVM, StabilityNexus/Info, StabilityNexus/StableViewpoints, AOSSIE-Org/Template-Repo-NextJS, AOSSIE-Org/Resonate-Website, AOSSIE-Org/SupportUsButton, AOSSIE-Org/Website, AOSSIE-Org/PictoPy-Website, AOSSIE-Org/Zplit-Website, AOSSIE-Org/Perspective, AOSSIE-Org/MoveYourBody-Website, AOSSIE-Org/SocialShareButton

Work Completed

1. Composable Oracle Protocol (OrbOracle-Solidity)

The core contribution to the smart contracts was implementing composability without breaking backwards compatibility with the existing IOracle interface:

  • Fixed-Point Scaling (WAD): Standardized all internal prices to 18 decimals:
    • Multiplication: $(valA \times valB) / 10^{18}$
    • Division: $(valA \times 10^{18}) / valB$ (reverting cleanly on zero division)
    • Inversion: $(10^{18} \times 10^{18}) / val$
  • Synchronous Extreme Lookback (readValueInterval): Engineered the calculation to sample historical snapshots across both parent feeds, deriving accurate min/max price bounds over any user-defined historical lookback window.
  • Permissionless Factory (ComposedOracleFactory): Provides single-transaction deployment of composed oracles, recording deployer metadata, emitting indexable events, and maintaining registry lists for on-chain enumeration.
  • Fuzz Testing: Added ComposedOracleFuzz.t.sol using Foundry to execute randomized property-based tests verifying deep recursive nesting (up to 12 compositions), blacklist reverts, and mathematical consistency against an independent reference model.
  • Protocol Fixes & Quality: Remediated the reporter reward denominator in Oracle.sol (PR #20), converted read methods to view functions (PR #6), updated SPDX identifiers to UNLICENSED (PR #21), and established AGENTS.md and MAINTAINERS.md guidelines (PR #13).

2. Composed Oracle Web Interface (OrbOracle-EVM-Frontend)

Built a complete Web3 experience for discovering, simulating, and deploying composed feeds:

  • Creation Wizard: Developed a tabbed deployment workflow supporting both Base and Composed oracles, featuring parent feed selectors, operation pickers (Multiplication / Division), inversion toggles, and live formula previews.
  • Historical Charting & Analytics: Integrated Chart.js to zip and plot synchronized historical snapshots from both parent feeds alongside the composed EWMA curve.
  • Lookback Simulation: Added an interactive interval tester to simulate readValueInterval(sampleSize) directly from the UI.
  • Reliable Event Log Parsing: Replaced brittle client-side timeouts in createOracle with deterministic waitForTransactionReceipt and Viem parseEventLogs, resolving redirect race conditions.
  • UI/UX Overhaul & SEO: Redesigned the Home, Deploy, Explorer, and Operate pages, added a unified global toast notification system, and shipped canonical SEO tags, sitemaps, and robots directives.

3. Stability Nexus Portal & Ecosystem Landing Pages

  • Main Website (StabilityNexus/Website):
    • Designed and deployed the Research Library showcasing 12+ academic research papers.
    • Built a custom YouTube playlist viewer for research seminar recordings (22 videos).
    • Redesigned the Software / Applications catalog with interactive details modals, per-chain deployment addresses, and filter categories.
    • Implemented the Events & Workshop page, updated branding asset kits, and configured OpenSSF Scorecard CI workflows.
  • Gluon Stablecoin Landing Page (StabilityNexus/Gluon-LandingPage):
    • Shipped the "Why Gluon" section and interactive protocol mechanics walkthrough (fission, fusion, and beta transmutation).
    • Integrated terms of use modal and full mobile/tablet responsiveness.
    • Created machine-readable AI agent readiness endpoints (/openapi.json, /api/info.json, robots.txt).

Pull Requests

Merged Pull Requests (Grouped by Feature Area)

Composable Oracle Smart Contracts (OrbOracle-Solidity)

Composed Oracle Web Interface (OrbOracle-EVM-Frontend)

Stability Nexus Main Website (StabilityNexus/Website)

Gluon Stablecoin Landing Page (StabilityNexus/Gluon-LandingPage)

Ecosystem & Cross-Repository Deliverables

AOSSIE Organization Peer Review Audits (8 Repositories)

Open Pull Requests (Work Continuing Beyond GSoC)

Repository PR Description Last GSoC Commit
StabilityNexus/OrbOracle-Solidity #19 Implement developer fee deduction on reporter rewards, configurable fee limits, and safe two-step ownership transfer. ceda9da (2026-10-22)
StabilityNexus/Website #78 Add public/sitemap.xml with canonical routes, configure robots.txt crawler directives, and set metadataBase. 1b67882 (2026-10-29)
StabilityNexus/Gluon-LandingPage #20 Add security-review and remediation skill configurations and publish formal automated audit reports. 8012e75 (2026-10-29)

How to Try It

1. Live Applications & Testnet Contracts

The deployed decentralized applications are live and connected to Ethereum Sepolia testnet:

Sepolia Testnet Contract Deployments:

2. Running Smart Contract Tests Locally (OrbOracle-Solidity)

Prerequisites: Foundry (forge, cast).

# Clone the repository
git clone https://github.com/StabilityNexus/OrbOracle-Solidity.git
cd OrbOracle-Solidity

# Install dependencies and build contracts
forge install
forge build

# Execute the complete test suite (unit tests and fuzz tests)
forge test -vv

# Run only the property-based fuzz tests
forge test --match-contract ComposedOracleFuzzTest -vv

3. Running the Orb Oracle Frontend Locally (OrbOracle-EVM-Frontend)

Prerequisites: Node.js (v18+), npm.

# Clone the repository
git clone https://github.com/StabilityNexus/OrbOracle-EVM-Frontend.git
cd OrbOracle-EVM-Frontend

# Install dependencies cleanly
npm ci

# Start the local development server
npm run dev

Navigate to http://localhost:3000 in your browser. Connect a Web3 wallet (e.g. MetaMask) set to Sepolia testnet to interact with existing oracles or create new composed feeds.

Future Work & Next Steps

  1. Multi-Chain Deployments: Deploy verified instances of OracleFactory and ComposedOracleFactory across our targeted networks: Ethereum, Polygon, Base, BSC, and Ethereum Classic.
  2. Deep Composition Tree Visualizer: Surface an interactive node-graph visualizer in the WebUI to help users inspect multi-tier composite price feeds (e.g., a composed oracle composed of two other composed oracles).
  3. Automated Reporter Keepers: Expand open-source keeper bots to automate value submissions and reward distributions across both base and composed feeds.

Challenges Faced

One of the biggest hurdles was taking the math from the research paper and turning it into working smart contracts. Formulas look simple on paper, but in Solidity you have to be very careful with decimals so numbers do not lose precision or divide by zero. Another tricky part was handling price history across two different oracles. Because each price feed updates at its own pace, calculating the historical minimum and maximum prices over the same lookback window without running into gas issues took a lot of careful thought and testing.

Learnings

I learned a lot throughout this summer, especially from code reviews with my mentors. They helped me spot code smells and taught me how to write cleaner, simpler code that is easy to read and maintain. I also learned a ton about UI and UX design - building web interfaces that feel simple and intuitive for normal users rather than confusing developer tools. Working on project assets also taught me what really goes into making a logo and building a brand identity, like vector precision, clear scaling, and contrast across dark and light themes.

My Experience

Working on this project for Google Summer of Code with Stability Nexus and AOSSIE has been a great experience. I got to build both the smart contracts and the websites around them, seeing everything come together from theoretical formulas to live apps on testnet.

A big thank you to my mentors - Bruno Woltzenlogel Paleo, Sarthak Dengre, Yogesh Agrawal, and M4dhav. Their patience, helpful reviews, and constant feedback helped me grow a lot as a developer. Seeing our work live on Sepolia and running on the project websites feels really rewarding, and I look forward to staying involved and helping deploy to more networks in the future.

Resources & References

参与讨论