Oasis September 2025 Engineering update

other workflows have correct triggers

Closes #522.

This PR:

• fixes wrong BIP-44 path serialization when using Ledger devices. Previously, the last two chunks weren't serialized so users weren't able to use indexes >0 for BIP-44 on Ledger.
• adds tests

This PR:

• Shows a "net.oasis.note" and "net.oasis.description" metadata of the offer:
  
  
• Populates the initial ROFL provider manifest with a single example offer having the new note and description fields prepopulated along with the price.
• Refactors anonymous Payment structs to NativePayment and EvmContractPayment.

closes #614

The rofl-app-backend uses oasis rofl build --validate-only to validate artifacts and captures errors from stderr. In this case, the specific (unhelpful) error shown is:

Error: compose file validation failed: parsing failed

After update:

Error: compose file validation failed: parsing: services must be a mapping

This approach keeps error handling consistent with other failures, since all errors are surfaced via stderr.

fix: https://github.com/oasisprotocol/docs/actions/runs/17373773257/job/49315384401?pr=1424

Fixes: #899

Fixes #875

Also moves NEXUS_FORCE_MARK_STALE_ACCOUNTS from env variable to a config parameter.

Closes #1143, also updates the docker images from Debian bookworm to trixie.

Fixes: #1157

Card headers update to the ui-library Typography component and adjusting the size of body font to 14px.

Fixes issues #2185 and #2195

Before:

After:

Converting the remaining MUI Grid components to Tailwind classes on:

• Rofl App Details page
• Validator Details page
• Paratime Card
• Consensus Account Details page

Implements #2139

Updating snapshot components from MUI to tailwind classes and uil Typography component. This includes: Consensus snapshot, ParaTimes snapshots, Token snapshot and Validator snapshot.

Waits for oasisprotocol/ui-library#49, oasisprotocol/ui-library#57

Used in:

• Consensus acc staked/debonding
  https://pr-2122.oasis-explorer.pages.dev/mainnet/consensus/address/oasis1qr3dyzj5aed7f2zq6rrrpzklzfl37t0tsvvffa9m
  vs
  https://explorer.oasis.io/mainnet/consensus/address/oasis1qr3dyzj5aed7f2zq6rrrpzklzfl37t0tsvvffa9m

• Card filters
  https://pr-2122.oasis-explorer.pages.dev/mainnet/sapphire/token
  vs
  https://explorer.oasis.io/mainnet/sapphire/token
  https://pr-2122.oasis-explorer.pages.dev/mainnet/consensus/proposal/5
  vs
  https://explorer.oasis.io/mainnet/consensus/proposal/5

• Duration selection in cards with charts
  https://pr-2122.oasis-explorer.pages.dev/mainnet/consensus
  vs
  https://explorer.oasis.io/mainnet/consensus

• Router tabs (most of details pages)
  https://pr-2122.oasis-explorer.pages.dev/mainnet/sapphire/token/0x39d22B78A7651A76Ffbde2aaAB5FD92666Aca520
  vs
  https://explorer.oasis.io/mainnet/sapphire/token/0x39d22B78A7651A76Ffbde2aaAB5FD92666Aca520

Replaced MUI components with shadcn components from ui library and tailwind styling to accomodate new design.

Before:

After:

Replace Grid and Box MUI with Tailwind classes for styling and layout of Layerpicker inside navigation. Partial implementation of #2139

There is a minor responsive layout misalignment caused by mismatch of MUI and Tailwind breakpoints between 768px - 900px, which should resolve itself with Issue #2157:

• switch to UI Lib pagination
• includes MUI Chip cleanup

Used in:

• block details nav
  https://pr-2187.oasis-explorer.pages.dev/mainnet/sapphire/block/10539598
  vs
  https://explorer.dev.oasis.io/mainnet/sapphire/block/10539583

• consensus acc staking card
  https://pr-2187.oasis-explorer.pages.dev/mainnet/consensus/address/oasis1qqnk4au603zs94k0d0n7c0hkx8t4p6r87s60axru
  vs
  https://explorer.dev.oasis.io/mainnet/consensus/address/oasis1qqnk4au603zs94k0d0n7c0hkx8t4p6r87s60axru

• lists
  https://pr-2187.oasis-explorer.pages.dev/mainnet/consensus/address
  vs
  https://explorer.dev.oasis.io/mainnet/consensus/address

Convert Learning Materials to new uil library and tailwind components and aligning with the new design. Partial implementation of #2139

Note - card heading and 'view all' button will be handled separately across all cards - Issue #2185.

Clean up minor issues introduced during the migration:

• restore #2168 fix removed in #2158
• remove unused Logotype prop. Color is now hardcoded https:// github.com/oasisprotocol/explorer/pull/2199/ files#diff-0e90edd6dbad7ce4c1b3d311669cd0ff373aa4c3874839105e1f7d6532bc7e21R29
• silence another dialog warning Warning: Missing Descriptionoraria-describedby={undefined} for {DialogContent}.
• remove unused MUI overrides. I forgot to clean up this stuff in prev PRs

Replace mono fonts in tables on dashboard pages.
Partial implementation of issue #2197

Before:

After:

Update remaining mono fonts across the site (excluding code snippets).

Issue: #2197

Example screenshots -

Before:

After:

Update social banner above footer to shadcn and tailwind from MUI.

Closes #2191

Used in

• layer picker (network and layer lists)
  https://pr-2194.oasis-explorer.pages.dev/mainnet/consensus
  vs https://explorer.dev.oasis.io/mainnet/consensus

Match MUI breakpoints to match values of Tailwind's default breakpoints and adjust size props on Grid components.

Fixes Issue #2157

Convert dashboard layout grids to tailwind.

Note - paraTime dashboard grid of 'Learning Materials' and 'Latest Blocks' is temporarily handled with flexbox tailwind classes and sx inline style, until MUI Card gets replaced.

Before:

After:

Convert header Grid and Box MUI elements to tailwind.

This is an alternate implementation of #2178, which keeps the border around the hover highlight, at the cost of losing one pixel around every address, and 1px of misalignment.

See screenshots at #2178.

Update mono fonts on ROFL app details page.

Before:

After:

Closes #1666
Waits for Nexus deploy

Reduce font size of table search input to 14px. Temporary adjustment until ui-library input gets implemented.

Fixes: 2200

Before:

After:

As part of the MUI → shadcn migration and block explorer redesign, update primary color #3333C4 → #0500E2 and switch default font Figtree → Inter. Issue: 2172

Before:

After:

Fixes Issue: #2217

Before:

After:

• clean up dev warnings <p> cannot appear as a descendant of
• align card label with what was introduced in SnapshotEpoch

In the layout picker, we are using a Drawer component, which is using Radix's Dialog under the hood.

On the browser console, there was a message:

DialogContent requires a DialogTitle
for the component to be accessible for screen reader users.

etc.

This change fixes that, by wrapping the already existing app logo with the required DrawerTitle tag.

Fixes Issue: #2218

Before:

After:

Introduced in #2155

dev/mobile view throws

chunk-KPD4VVXB.js?v=629ceb01:521 Warning: validateDOMNesting(...): <div> cannot appear as a descendant of <p>....

Paratime snapshot header grid classes adjustment.

Fixes #2193

Before:

After:

Fixes 2204

Updating terminology from 'ROFL Apps' to 'ROFL-Powered Apps' and updating 'ROFL name' in Metadata table.

Issue: #2186

Before:

After:

We are caching loaded token info. Cache is indexed by token address. However, we can now reference token using both their oasis and eth addresses.

This change makes sure we are normalizing all addresses to oasis addresses, so that we don't try to load the same info twice, using different representations of the same address.

This corner case is triggered when we are on a screen when both versions are on display, and we want to check for token names for both of them.

In these cases, up to this point, we were making some useless request to Nexus. This change gets rid of that.

This can be tested (for example) at http://localhost:1234/mainnet/sapphire/rofl/app/rofl1qpykfkl6ea78cyy67d35f7fmpk3pg36vashka4v9

After this change, there are 4 requests sent to nexus: /evm_tokens/...
Before the change, there used to be 5.

Broken since #2131

https://pr-2214.oasis-explorer.pages.dev/mainnet/sapphire/block
vs prod
https://explorer.oasis.io/mainnet/sapphire/block

Closes #2274.

Since the ethabi crate is no longer maintained and the new version of evm has a dependency incompatibility with it, we should switch to something else.

The ethabi crate recommends solabi as the replacement, so let's try that...

This PR changes the majority of ethabi uses into solabi, but a few have been left for @njelich to do while I'm on vacation :)
(Those are the evm_derive macros and erc20 precompiles [and tests related to them], as well as a few bits here and there that I probably missed.)

Fixes #2318

This pull request introduces the initial implementation of the Python client SDK for Oasis ROFL, including packaging, release automation, development tooling, and the core client code. The changes set up a modern, maintainable Python package with automated publishing and robust developer experience.

Core SDK Implementation:

• Added the main client class RoflClient and the KeyKind enum in src/oasis_rofl_client/rofl_client.py, providing async key generation methods and support for multiple key types.
• Established a clear package structure and public API via src/oasis_rofl_client/__init__.py and version handling in src/oasis_rofl_client/__about__.py. [1] [2]

Packaging and Release Automation:

• Added a comprehensive pyproject.toml for project metadata, dependencies, dev tooling, and build configuration, including Ruff and Hatch integration.
• Implemented a GitHub Actions workflow .github/workflows/release-rofl-client-py.yml for automated PyPI publishing on version tags.

Developer Experience and Documentation:

• Added a detailed README.md with installation, usage, API reference, error handling, and release information.
• Provided a Makefile for common development tasks (install, lint, format, test, build, clean, typecheck).
• Included a Pythonic .gitignore to exclude build artifacts, caches, and IDE files.
• Added an example script examples/basic_usage.py demonstrating key generation and usage patterns.

Fixes #2295

closes #2323

Replaced "ROFL app" terms with "app", "app running in ROFL", and "ROFL-Powered" for titles

Fixes #2305

Closes #2310.

The minimal image is 172MB in size, whereas the full image is 4GB, so this should be a very nice improvement (and it builds super-fast).

Fixes #2256

• uses path instead of working-directory for use artifact github actions

Initial Release

Needs tag for pypi publish workflow

rofl-client/py/v0.1.0

• fixed namespace stripping for correct version in workflow and hatch versioning

resolves #2311

There were some missing workdirs in the publish workflow.

• fix root for hatch, that hatch can see git tags
  (was before not seeing tags and falling back to 0.0.0)

(works now correctly on my fork)

Upgrading CLI to 15.5 and Core to 25.5.x for rofl-dev Docker image.

The marketplace diagram has way too many information. This PR simplifies it:

• Removes pricing
• Removes one ROFL node
• Removes ROFL provider address
• Removes the Scheduler box and simply changes the title to "ROFL node for Provider A"
• Adds "e.g." before ROFL addresses for consistency with https://docs.oasis.io/general/manage-tokens/#rose-and-the-paratimes
• Adds machine states (running app, stopped)
• Removes "ROFL app" terms

PREVIEW

Related: #2323, oasisprotocol/docs#1418

Stoarge -> Storage

BREAKING CHANGE

With #550 there were a couple of problems that revealed during usage. Even though it successfully wrapped EIP-6963 providers, the implementation did not work for WalletConnect and MetaMask "in-app" communication between mobile Chrome and mobile MetaMask for example.

This PR addresses the above issues and resolves them by changing the underlying API, which now wraps the connectors directly. By doing so, all the issues with previous implementation were successfully resolved.

Continuation of #620 (comment) thread.

Relates to #607 changes.

Built upon #607, due to library API changes.

This PR:

• Adds getRoflAppId() and ensureRoflAppId() subcalls to foundry's SapphireTest, so they can be used with forge test locally.
• Removes redundant specific subcall method wrappers since they cannot be accessible externally.
• Removes subcall methods, because they are never user externally (developers will use sapphire-contracts in solidity).
• Fixes a bug in Makefile if the dependencies are already satisfied

Closes #585

Preview URL: https://deploy-preview-616--oasisprotocol-sapphire-paratime.netlify.app/build/sapphire/develop/security#gas-padding

This PR updates soldeer contracts/ package naming and adds integrations package to workflow.

The new getRoflAppId() helper was merged a while ago, but it took a while to test it in production.

• looks like export const due to generic type didn't work

Built upon #607

Fixes: #786

Already indexed blocks will be fixed with the existing log fixer worker (added in #787)

Paratime Node
Paratime Client Node

Before:

After:

• Redirects are TODO

Partial fix for #1418

PREVIEW

closes #1439 & oasisprotocol/sapphire-paratime#627

this PR:

• Removes the Emerald tab and replaces them with Linux (Intel) | Windows. macOS, Linux (non-Intel) tabs for Sapphire localnet setup
• Adds info about macOS 26 Rosetta Docker issue

PREVIEW: https://deploy-preview-1462--oasisprotocol-docs.netlify.app/build/tools/localnet

Simplifies the Hyperlane CLI docs by removing Sapphire-specific instructions and switching to the standard CLI installation flow. Updates introduction and usage examples for clarity.

Merge once Sapphire with oasisprotocol/oasis-sdk#2215 is live.

Preview

Bumped on this when plugging in Ledger for the first time on a fresh Ubuntu installation.

Fix styling to show content of all doccards inside of tables.

Before:

After:

What was done:

1. Pass context explicitly.
2. Fix:
   • Panicking.
   • Deadlocking on the clean-up.
   • Triggering genesis checkpoint to early.
3. Minor refactors.

Follow-up:

I propose factoring out checkpointer and availability nudger (#6308) into separate workers. Could be one PR for each.
This will make diff sync part easier to reason about and thus optimize.

Fixes #6327

Example client side response with the update:

	addrss, err := rt.Accounts.Addresses(context.Background(), uint64(height), types.NativeDenomination)
	if err != nil {
		println("Failed to fetch addresses:", err.Error())
	}
	// prints: Failed to fetch addresses: Failed to write response: message too large

while before the query would just appear to be stuck on the client.

Closes #6319

remove redundant word in comment

Fixes: #6326