npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@unruggable/gateways

v0.1.0

Published

<p align="center"> <img src="https://raw.githubusercontent.com/unruggable-labs/unruggable-gateways/main/unruggable-logo-black.png" style = "width:300px;" alt = "Unruggable Gateways" /> </p>

Downloads

300

Readme

Unruggable Gateways

This repository provides an end-to-end code solution for resolving data from rollup chains and verifying it against state posted to Layer 1 Ethereum.

Unruggable Gateways CI

Quickstart

Install our npm package:

$ npm i @unruggable/gateways

We have extensive documentation, with a slightly less quick Quickstart.

The examples page may be of particular interest.

We also have an examples repo that utilises our npm package to demonstrate both simple and complex use cases in a few clicks.

Architecture

The core components of a chain solution are:

  • Gateway: A HTTP server that handles responding to a virtual machine request by interfacing with the appropriate rollup to return proofs of the requested data stored on that chain.
  • Verifier: A Solidity smart contract (deployed on Layer 1) that verifies the proofs returned by the gateway and returns the proven data values.
  • Prover: A Solidity library (deployed on Layer 1) that handles the chain-specific proving process.

In addition to these core components, we have provided TypeScript implementations of the request builder (vm.ts) and the provers (listed below) to allow smart contract implementors to quickly iterate and test when building solutions.

Chain Support

There are currently implementations for the following chains:

Arbitrum
Base
Blast
Fraxtal
Linea
Optimism
Polygon PoS
Scroll
Taiko
ZKSync
Zora

If you are interested in building out a solution for another chain, please take a look at our our Contribution Guidelines and/or get in touch.

Setup

  1. foundryup
  2. forge install
  3. bun i
  4. create .env

Support

Running a Gateway

  • bun run serve <chain> [port]
    • Chain names: arb1 base blast fraxtal linea op polygon scroll taiko zksync zora
    • Default port: 8000

Testing

There is an extensive test suite available for testing individual components of the solution in an isolated manner.

Using blocksmith.js and Foundry we fork the chain in question (such that can interact with contracts deployed on a real network) and then deploy and test against an isolated unit (for example the chain specific verifier).

Commands available include:

Examples

A number of examples are provided as part of this repository. For more extensive step-wise example code, please see our documentation.

  • linea-ens
    • Replacement backend demo for https://names.linea.build/
    • bun serve lineaV1

Notes

Suggested VSCode Extensions

Forge Setup

# installed by forge in step (2)
# provided for reference
forge install foundry-rs/forge-std
forge install OpenZeppelin/[email protected]

# installed by script instead of the following command
# placed at standard remapping location
# see: https://github.com/ethereum-optimism/optimism/issues/10202
#forge install ethereum-optimism/optimism
bun build/import-op.ts

Contribution Guidelines

We welcome contributions to this codebase.

The premise behind the development of this software is to minimise duplication of effort and provide tooling that allows developers to interface with a simple, standardised API to read data from other chains.

Please take a look at our CONTRIBUTING.md file for a more in depth overview of our contribution process.

Release Process

Branching strategy

  • main is our stable release branch that reflects the latest release.
  • develop is our ongoing development branch. Feature branches are to merged down into this.
  • Feature Branches: Separate branches will be utilised for new feature development or bug fixes.

License

All files within this repository are licensed under the MIT License unless stated otherwise.