Skip to content

rhinestonewtf/rhinestone-nexus

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,516 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Rhinestone Nexus

Version 1.2.0

A modular smart account optimized for chain abstraction and multi-chain use with Rhinestone Intents.

This is a fork of Biconomy's Nexus, a modular smart account built off the foundational work of ERC-7579 and the ERC-7579 reference implementation. We extend our thanks to the Biconomy team in partnering with us to build the foundations of ERC-7579.

Overview

Rhinestone Nexus is an ERC-7579 compliant modular smart account designed for seamless cross-chain operations. Built on top of the battle-tested and heavily audited Biconomy Nexus, this fork is optimized to work seamlessly with Rhinestone's intent-based infrastructure.

Key Features

Chain Abstraction Ready

  • Multi-chain aware initialization with chain ID verification
  • EIP-712 TypedData signing for cross-chain initialize transactions
  • Designed for use with Rhinestone Intents for cross-chain execution

EIP-7702 Native Support

  • Full support for EIP-7702 accounts
  • PREP (Provably Rootless EIP-7702 Proxy) implementation for relay-friendly account initialization
  • Enables EOAs to delegate to smart account logic without deploying a proxy

Composable Execution

  • executeComposable() for multi-transaction orchestration
  • Supports complex execution flows for intent settlement
  • Integrated with the modular validator, executor, and hook system

Enhanced Module System

  • Pre-validation hooks for ERC-4337 and ERC-1271
  • Emergency hook uninstall mechanism with timelock protection

Deployments

Rhinestone Nexus is deployed on multiple chains. See the Rhinestone documentation for the latest deployment addresses.

Getting Started

Prerequisites

Installation

  1. Clone the repository:
git clone https://github.com/rhinestonewtf/nexus.git
cd nexus
  1. Install dependencies:
yarn install

Essential Scripts

Build and test using Foundry or Hardhat. Append :forge or :hardhat to target a specific environment.

Build Contracts

yarn build

Run Tests

yarn test

Gas Report

yarn test:gas

Coverage Report

yarn coverage

Generate Documentation

yarn docs

Lint Code

yarn lint

Auto-fix Linting Issues

yarn lint:fix

Generate Storage Layout

yarn check

Security

Audits

Auditor Date Report
CodeHawks-Cyfrin 09-2024 View Report
Spearbit 10/11-2024 View Report / ERC-7739 Add-on
Zenith 03-2025 View Report
Pashov 03-2025 View Report
ChainLight 07-2025 View Report

Reporting Vulnerabilities

To report security vulnerabilities, please email security@rhinestone.wtf or reach out via Telegram.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Connect with Rhinestone

Website Twitter GitHub Documentation

About

Rhinestone Nexus: ERC-7579 Modular Smart Account optimized for chain abstraction and multi-chain intents

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Solidity 83.5%
  • TypeScript 14.8%
  • Other 1.7%