GolemBase SDK

This is part of the Golem Base project, which is designed as a Layer2 Network deployed on Ethereum, acting as a gateway to various Layer 3 Database Chains (DB-Chains). For an overview of Golem Base, check out our Litepaper.

This SDK allows you to use GolemBase from Rust, it is available on crates.io, alng with its generated documentation. We provide an example application to showcase how you can use this SDK.

Getting started

For getting up and running quickly, we recommend the following two steps:

1. Start golembase-op-geth through its docker-compose ;
2. Install the demo CLI and create a user, or build the actual CLI as it's included in the golembase-op-geth repository.

When you create a user, it will generate a private key file called private.key and store it in the standard folder as per the XDG specification:

• ~/.config/golembase/ on Linux
• ~/Library/Application Support/golembase/ on macOS
• %LOCALAPPDATA%\golembase\ on Windows

You will also need to fund the account, you can do it with: golembase-demo-cli account fund 10

Overview

This SDK provides multiple layers for sending transactions:

• Use GolemBaseClient for high-level operations such as creating, updating, or deleting entities.
• Use Account for account-centric and lower-level transaction control.
• Advanced users can construct and submit raw Ethereum transactions directly using the types and helpers re-exported from Alloy.

Contributing

• Enter a reproducible Nix flakes devshell with nix develop or use direnv
• Install pre-commit git hook with pre-commit install

Thanks for helping improve the project!