OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Smart Contracts

Libsubmarine

Libsubmarine is an open-source, work-in-progress Ethereum library that implements submarine sends through smart contracts and supporting off-chain components. Its flow covers a transaction commitment, a reveal carrying a Merkle-Patricia inclusion proof and an unlock call.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Libsubmarine — OpenViST project profile in Smart Contracts.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when designing or implementing an Ethereum dApp integration that needs submarine-send commitments, reveals and unlocks, and when reviewing the project’s test examples as interaction references.

Who it is for

  • Ethereum dApp developers integrating submarine sends into an existing application.
  • Developers building auction, DEX or ICO applications that need the documented commitment-and-reveal flow.

Documented uses

  • Add transaction commitment and reveal handling to an Ethereum application.
  • Use the library’s contract and off-chain components as a reference for submarine-send interactions.
  • Review the documented transaction sequence and application integration guidance before adapting a dApp.
Before you choose

Requirements & limits

The repository is publicly visible and described as open source.

  • The README documents a specific commitment, reveal and unlock sequence, including a Merkle-Patricia proof and RLP-encoded unlock transaction.
  • The repository includes Solidity contract tests, examples and off-chain components; the README recommends Solc and Python 3.6 or later for its test setup.
  • The project identifies itself as work in progress and says it has not undergone a formal independent security audit.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Run a LibSubmarine component test

Run one repository test file as a reference for user interaction with LibSubmarine.

Before you start

  • The repository is available locally.
  • Solc is installed.
  • Python 3.6 or later is recommended, and dependencies have been installed with pip3 install -r requirements.txt.

Steps

  1. Choose a test file under test/ named for the component to exercise.

  2. Run it with the command below, substituting the selected test-file name for whateverComponent.

    Documented command
    python3 test/test_whateverComponent.py

  3. Review the test as a reference for the modeled end-user interaction.

Expected outcome

The selected component test is invoked; the README says the tests model end-user interaction with LibSubmarine from start to finish.

Guide limitations

  • The README gives a placeholder test filename and does not identify specific test files or expected test results.
  • The project is work in progress and has not undergone an independent formal security audit.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
17 October 2026
Original website title
lorenzb/libsubmarine · Official homepage title · retained in its source language
How we review sourcesSuggest a correction