{"id":174096,"date":"2026-06-03T08:24:43","date_gmt":"2026-06-03T08:24:43","guid":{"rendered":"https:\/\/mycryptomania.com\/?p=174096"},"modified":"2026-06-03T08:24:43","modified_gmt":"2026-06-03T08:24:43","slug":"guide-to-deploying-a-trustless-eliza-agent-with-oasis-rofl","status":"publish","type":"post","link":"https:\/\/mycryptomania.com\/?p=174096","title":{"rendered":"Guide To Deploying A Trustless Eliza Agent With Oasis ROFL"},"content":{"rendered":"

Oasis introduced the framework for runtime off-chain logic (ROFL) to help build and run apps off-chain while ensuring privacy and maintaining trust with on-chain verifiability. For most people, this explainer video<\/a> would be enough. But for developers and dApp builders, who want to try things out themselves, a deeper dive is worth\u00a0it.<\/p>\n

In this tutorial, I will demonstrate how to build and deploy a trustless Eliza agent with Oasis\u00a0ROFL.<\/p>\n

Objective<\/h3>\n

The objective is to have a working Eliza agent running inside a ROFL Trusted Execution Environment (TEE). I will also show how to get it registered and validated as a trustless agent in the ERC-8004<\/a> registry. The agent\u2019s code will be fully auditable, and anyone can verify the authenticity of the origin of the deployed instance, which is immutable and tamper-proof.<\/p>\n

Prerequisites<\/h3>\n

Refer to the prerequisite section in the ROFL quickstart tutorial<\/a> for setup details.
So, right now, we need these to get\u00a0started.<\/p>\n

Docker<\/strong> (or Podman) with credentials. It can be on docker.io, ghcr.io, or any other public OCI registry.Oasis CLI<\/strong> and at least 120 TEST<\/strong> tokens in your wallet. Since we are building in the testnet environment, you can get these tokens for free from the official\u00a0faucet<\/a>.Node.js 22+<\/strong>. It is for Eliza and helper\u00a0scripts.OpenAI API\u00a0key<\/strong>RPC URL<\/strong>. It is to access the ERC-8004 registry (e.g.\u00a0Infura).Pinata JWT<\/strong>. It is to store agent information in\u00a0IPFS.At least 2 GiB of memory<\/strong> and 10 GB of\u00a0storage<\/strong>.<\/p>\n

Eliza Agent\u00a0Creation<\/h3>\n

The first step is to initialize a project using the ElizaOS CLI. Next, prepare it for\u00a0ROFL.<\/p>\n

# Install bun and ElizaOS CLI
bun –version || curl -fsSL https:\/\/bun.sh\/install | bash
bun install -g @elizaos\/cli<\/p>\n

# Create and configure the agent
elizaos create -t project rofl-eliza
# 1) Select Pqlite database
# 2) Select the OpenAI model and enter your OpenAI key<\/p>\n

# Test the agent locally
cd rofl-eliza
elizaos start
# Visiting http:\/\/localhost:3000 with your browser should open Eliza UI<\/p>\n

Containerize<\/h3>\n

In this step, you will need to containerize both the app and the ERC-8004 wrapper.
You will notice that the Eliza agent startup wizard has already generated:<\/p>\n

Dockerfile<\/strong>\u200a\u2014\u200athis packs your agent into a container.docker-compose.yaml<\/strong>\u200a\u2014\u200athis automatically configures, connects, and manages the interdependent postgres<\/strong> and elizaos<\/strong> containers.<\/p>\n

The next step is to make some changes to docker-compose.yaml<\/strong>.<\/p>\n

In the PostgreSQL section, you need to replace relative image: ankane\/pgvector:latest<\/strong> with image: docker.io\/ankane\/pgvector:latest<\/strong>.You need to name the elizaos<\/strong> image with a corresponding absolute path, e.g. image: docker.io\/YOUR_USERNAME\/elizaos:latest<\/strong>.You need to register the Eliza agent as a trustless agent in the ERC-8004 registry using the rofl-8004<\/strong><\/a> snippet. Ensure that the environment variables are mapped as\u00a0is.<\/p>\n

docker-compose.yaml<\/strong><\/p>\n

rofl-8004:
image: ghcr.io\/oasisprotocol\/rofl-8004@sha256:f57373103814a0ca4c0a03608284451221b026e695b0b8ce9ca3d4153819a349
platform: linux\/amd64
environment:
– RPC_URL=${RPC_URL}
– PINATA_JWT=${PINATA_JWT}
volumes:
– \/run\/rofl-appd.sock:\/run\/rofl-appd.sock<\/p>\n

The validation flow looks something like\u00a0this:<\/p>\n

Once you have edited docker-compose.yaml<\/strong>, it is time to build and\u00a0push.<\/p>\n

docker compose build
docker compose push<\/p>\n

If you are looking for full verifiability, you need to pin the digest by appending image:\u00a0\u2026<\/strong>@sha256<\/strong><\/a>:\u2026<\/strong> to all images in docker-compose.yaml<\/strong>.<\/p>\n

Init &\u00a0Create<\/h3>\n

Once all previous steps are complete, you will find that the agent is running in a container within a TEE. In this setup, ROFL handles the startup attestation of the container and the secrets in the form of environment variables. As a result, the TEE is completely transparent to the Eliza agent\u00a0app.<\/p>\n

oasis rofl init
oasis rofl create –network testnet<\/p>\n

You can check out on-chain activity and app details in the Oasis Explorer<\/a>.<\/p>\n

Build ROFL\u00a0bundle<\/h3>\n

This is where the memory and storage prerequisites come in handy.
First, you need to update the resources section.<\/p>\n

rofl.yaml<\/strong><\/p>\n

resources:
memory: 2048
cpus: 1
storage:
kind: disk-persistent
size: 10000<\/p>\n

Now, you can build the ROFL bundle by invoking this\u00a0command.<\/p>\n

oasis rofl build<\/p>\n

Secrets<\/h3>\n

In this step, we take care of encryption. It involves:<\/p>\n

End-to-end encrypting of OPENAI_API_KEY<\/strong> and storing it on-chain.Providing the RPC_URL<\/strong> and PINATA_JWT<\/strong> values for ERC-8004 registration.echo -n “<your-openai-key-here>” | oasis rofl secret set OPENAI_API_KEY –
echo -n “https:\/\/sepolia.infura.io\/v3\/<YOUR_KEY>” | oasis rofl secret set RPC_URL –
echo -n “<your-pinata-key-here>” | oasis rofl secret set PINATA_JWT –<\/p>\n

Then comes the important step of storing the secrets as well as the previously built enclave identities on-chain.<\/p>\n

oasis rofl update<\/p>\n

Deploy<\/h3>\n

This completes the building of the Eliza agent. Now, we need to deploy it to an ROFL provider.<\/p>\n

oasis rofl deploy<\/p>\n

The Oasis-maintained provider is selected on Testnet, which rents a node for 1 hour by default. You can extend the rental period for more hours, say for 6 hours, by invoking oasis rofl machine top-up\u200a\u2014\u200aterm hour\u200a\u2014\u200aterm-count 6<\/strong>\u00a0command<\/a>.<\/p>\n

Test<\/h3>\n

You have successfully built and deployed your very own Eliza agent. You can test if it is running properly with this CLI\u00a0check.<\/p>\n

# Show machine details (state, proxy URLs, expiration).
oasis rofl machine show<\/p>\n

A successful agent boot means the Proxy:<\/strong> section will show the URL where the agent is accessible. So, for example, if it\u00a0shows:<\/p>\n

Proxy:
Domain: m1058.opf-testnet-rofl-25.rofl.app
Ports from compose file:
3000 (elizaos): https:\/\/p3000.m1058.opf-testnet-rofl-25.rofl.app<\/p>\n

In this case, the app would be accessible at https:\/\/p3000.m1058.opf-testnet-rofl-25.rofl.app<\/strong><\/a>.<\/p>\n

ERC-8004 Registration and Validation<\/h3>\n

This is not an automatic step and needs to be completed to get this Eliza agent registered and validated as a trustless agent in the ERC-8004 registry. When you are running the agent for the first time, the rofl-8004<\/strong> service will derive the Ethereum address for registering it. To go ahead, you will need to fund that account with some ETH to pay for the gas\u00a0fees.<\/p>\n

Use this command to fetch your app\u00a0logs.<\/p>\n

oasis rofl machine logs<\/p>\n

The Please top it up<\/strong> line will show the derived address. After funding it, your agent is registered and validated, and ready to\u00a0go.<\/p>\n

Please note<\/strong>: All logs here are accessible to the app admin, as they are stored unencrypted on the ROFL node<\/strong>. So, remember not to put any private information here.<\/p>\n

Demo<\/h3>\n

This guide shows how you can build your own agent, but if you need to check out a full-fledged demo of how it looks and works, there is an example in the official Oasis repository.
Trustless Agent\u00a0Demo<\/strong><\/a><\/p>\n

For a quick chat with the Oasis engineering team for help with specific issues, you can drop your comments in the dev-central channel<\/strong> in the official\u00a0Discord<\/a>.<\/p>\n

Originally published at <\/em>https:\/\/dev.to<\/em><\/a> on May 28,\u00a02026.<\/em><\/p>\n

Guide To Deploying A Trustless Eliza Agent With Oasis ROFL<\/a> was originally published in Coinmonks<\/a> on Medium, where people are continuing the conversation by highlighting and responding to this story.<\/p>","protected":false},"excerpt":{"rendered":"

Oasis introduced the framework for runtime off-chain logic (ROFL) to help build and run apps off-chain while ensuring privacy and maintaining trust with on-chain verifiability. For most people, this explainer video would be enough. But for developers and dApp builders, who want to try things out themselves, a deeper dive is worth\u00a0it. In this tutorial, […]<\/p>\n","protected":false},"author":0,"featured_media":174097,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-174096","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-interesting"],"_links":{"self":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/posts\/174096"}],"collection":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=174096"}],"version-history":[{"count":0,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/posts\/174096\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/media\/174097"}],"wp:attachment":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=174096"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=174096"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=174096"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}