Skip to content

Using Our Command-Line Shell Tool

We also offer a simple-to-use tool you can run right from the command line shell (such as bash or sh). Our CLI tool can create a wallet create entities, and update and delete the entities.

To get started, you need to make sure you have the Go tools installed. To install them, visit the Go installation page).

Next, you need to clone our golem-base-op-geth repo:

git clone https://github.com/Golem-Base/golembase-op-geth.git

Then move into the cloned folder's cmd/golembase folder:

cd golembase-op-geth/cmd/golembase

Next, build the tool by typing:

go build .

Give it a few moments to build. Make sure it exists:

ls
and you should see the executable file called golembase listed.

Creating a Wallet

Create a wallet by typing:

./golembase account create

Note: This will create a private.key file and install it in a standard config directory; the tool will show you where in its output:

Private key generated and saved to /home/<username>/.config/golembase/private.key
Address: 0x1cdE196136e2418605d526978dF2837d1fF09D21

Copy the address it created to your clipboard, including the 0x part, as you'll need that next.

Adding Funds

Now open your browser and go to this link, which is the faucet for Kaolin:

https://kaolin.holesky.golem-base.io/faucet/

Paste your account Address in and click Request Funds. After a moment, your account will have a couple Eth available in our testnet.

Creating an Entity

Now you can create an entity. Note, however, that you need to specify the URL of the testnet, as by default this tool connects to a locally-running instance.

To create an entity, type the following:

./golembase entity create --data 'Hello, Golem World!' --node-url https://rpc.kaolin.holesky.golem-base.io

You can learn more by visiting the CLI tool's README here: https://github.com/Golem-Base/golembase-op-geth/tree/main/cmd/golembase

  • Wish to learn more?

    Golem Base introduces a novel architectural model for decentralized data infrastructure — designed to be modular, Ethereum-native, and accessible across both Web2 and Web3.

    For a complete overview:
    Read the Litepaper (PDF)

    It covers:

    • The structure and role of DB-Chains
    • How Golem Base aligns with Ethereum Layer 2/3 philosophy
    • Potential real-world use cases

    Golem Base Origins

    Golem Base was born from a need inside Golem Network — and grew into its own thing. Built by an independent team committed to the idea that data autonomy should be the norm, not the exception. Read more

  • Join the Community

    Stay connected and get help as you explore Golem Base.

    • Discord — Chat with the team and other developers in real time.
    • GitHub — Ask questions, share feedback, or explore new ideas.
    • Twitter (X) — Follow us for announcements, updates, and ecosystem highlights.
    • Blog — Read technical deep dives, tutorials, and project news.


      Need Help?