OMP Memory Protocol

---

name: omp-memory

description: OpenClaw Memory Protocol (OMP) — store and retrieve encrypted files on BSC blockchain with PoW mining rewards. Use when user wants to store files on-chain, retrieve stored files, check MMP token balance, manage storage rent, or interact with the OMP protocol on BSC mainnet.

---

# OMP Memory Protocol

On-chain encrypted file storage on BSC. Files are split into 256KB chunks, Merkle-hashed, and stored with rent-based expiry. Miners earn MMP tokens for hosting data.

Setup (first time)

# 1. Install dependencies
cd ~/.omp-client && npm install

# 2. Create encrypted wallet
node bin/cli.js init
# → saves wallet to ~/.omp/wallet.json

# 3. Check MMP balance / get top-up info
node bin/cli.js topup

Key Commands

Store a file

node bin/cli.js save <file> [--rent <blocks>]
# --rent default: 201600 (~7 days). 0 = free tier (≤10KB, permanent)
# Returns: merkleRoot (save this — needed to retrieve the file)

Retrieve a file

node bin/cli.js load <merkleRoot> <outFile>

Check status

node bin/cli.js status              # network overview
node bin/cli.js status <merkleRoot> # specific tree info

Grant/revoke access

node bin/cli.js grant <merkleRoot> <address>
node bin/cli.js revoke <merkleRoot> <address>

Renew rent

node bin/cli.js renew <merkleRoot> [--blocks <n>]

Contract Addresses (BSC Mainnet)

| Contract | Address |

|----------|---------|

| MemoryProtocol Proxy | `0x3BD7945d18FE6B68D273109902616BF17eb40F44` |

| MMPToken | `0x30b8Bf35679E024331C813Be4bDfDB784E8E9a1E` |

Environment Variables (.env)

PROTOCOL_ADDRESS=0x3BD7945d18FE6B68D273109902616BF17eb40F44
MMP_TOKEN_ADDRESS=0x30b8Bf35679E024331C813Be4bDfDB784E8E9a1E
BSC_RPC=https://bsc-dataseed.binance.org/
WALLET_PASSWORD=<your-password>

Install Script

Run `scripts/install.sh` to auto-install the CLI from the OMP repo.

Notes