klasterio/node repository overview

⁠Klaster Node

Klaster Node abstracts away gas & blockchain interactions. It allows wallets to interact with different blockchains by paying for gas in any chain/token combination.

At the moment of writing, supported blockchain testnets are:

• Polygon Mumbai
• Arbitrum Sepolia

... and on mainnet:

• Optimism
• Base
• Arbitrum
• Polygon
• Scroll

Anyone can run a node & provide this trustless service to other wallets, dApps, rollups.

⁠GitHub

This image has been built from the source code available here⁠.

⁠Docker Setup

The simplest possible docker-compose.yml to correctly run this service is as follows:

version: '3.7'

services:
    node:
        image: klasterio/node:latest
        environment:
          - SINGLETON_ADDRESS=0xddec9abbf919896885dbe8db884da29d2fde9a68 # Klaster Singleton contract deployment
          - PRIVATE_KEY=<insert your private key here> # Load your private key from a secure environment
          - PORT=3000
        ports:
          - "3000:3000"

This configuration will spin up a node at port 3000 and expose the port to your network.

• SINGLETON_ADDRESS is the official Klaster Singleton deplyoment. At the time of writing, it's set to: 0xddec9abbf919896885dbe8db884da29d2fde9a68

• PRIVATE_KEY is your node operator wallet. Private key must be funded with native coins on all the supported Klaster networks in order to resolve transactions on these chains. Fee earned while resolving transactions are collected by the node.

⁠API Documentation

Public Node API documentation is provided here⁠.

Additional application properties can be defined via docker-compose environment variables in format:

• FEE_BENEFICIARY Custom wallet address where collected fees will be routed to.
• EXECUTION_DEADLINE Time for which the quote given by node is considered to be valid. (in milliseconds)
• MUMBAI_RPC Custom Mumbai RPC
• ARB_SEPOLIA_RPC Custom Arbitrum Sepolia RPC
• ARB_RPC Custom Arbitrum RPC
• OP_RPC Custom Optimism RPC
• BASE_RPC Custom Base RPC
• POLYGON_RPC Custom Polygon RPC
• SCROLL_RPC Custom Scroll RPC