Skip to content
This repository was archived by the owner on Sep 14, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ OrbitMem is a sovereign data layer for AI agents — encrypted P2P vaults, multi
- `@orbitmem/sdk` — Core SDK with six composable layers (identity, encryption, data, transport, discovery, persistence) plus a client facade
- `@orbitmem/relay` — Hono HTTP server with ERC-8128 auth + session token middleware, vault/discovery/snapshot routes
- `@orbitmem/contracts` — Foundry/Solidity smart contracts implementing ERC-8004 for Data — on-chain data discovery & reputation
- `@orbitmem/cli` — CLI tool (`bun run cli`) — vault management, data discovery, identity, snapshots
- `orbitmem` — CLI tool (`npx orbitmem`) — vault management, data discovery, identity, snapshots
- `@orbitmem/web` — React dashboard (Vite + TanStack Router + wagmi + Tailwind) deployed via Cloudflare Workers
- `examples/memo` — Example app demonstrating OrbitMem usage

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,7 @@ await client.rateData(datasets[0].dataId, 95);
| `@orbitmem/sdk` | Core SDK — identity, encryption, vault, transport, discovery, persistence, client |
| `@orbitmem/relay` | Hono relay server — vault, discovery, snapshots, plan tiers, ERC-8128 auth |
| `@orbitmem/contracts` | Solidity contracts — DataRegistry (ERC-721), FeedbackRegistry (reputation) |
| `@orbitmem/cli` | CLI tool (`npx orbitmem`) — vault management, data discovery, identity, snapshots |
| `orbitmem` | CLI tool (`npx orbitmem`) — vault management, data discovery, identity, snapshots |
| `@orbitmem/web` | React dashboard — data explorer, vault manager, trust graph, wallet connection |

## Tech Stack
Expand Down
691 changes: 324 additions & 367 deletions bun.lock

Large diffs are not rendered by default.

73 changes: 41 additions & 32 deletions docs/submissions/202603_PL_Genesis/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

Built on OrbitDB with AES/Lit Protocol encryption, ERC-8128 wallet auth, and ERC-8004 for data discovery and reputation.

[📝 Submission](https://pl-genesis-frontiers-of-collaboration-hackathon.devspot.app/projects/1101) | [▶️ Video](https://youtube.com) | [🎬 Slides](https://raw.githack.com/oboroxyz/orbitmem/main/docs/submissions/202603_PL_Genesis/slides.html)
[📝 Submission](https://pl-genesis-frontiers-of-collaboration-hackathon.devspot.app/projects/1101) | [▶️ Video](https://youtube.com/xxx) | [🎬 Slides](https://raw.githack.com/oboroxyz/orbitmem/main/docs/submissions/202603_PL_Genesis/slides.html)

---

Expand Down Expand Up @@ -45,14 +45,14 @@ IPFS is great as decentralized storage — but it falls short as a modern, devel
└─────────────────────────────────────────────────────────┘
```

| Layer | Technology | Role |
| :--- | :--- | :--- |
| **Interface** | SDK + CLI (Skills) | One-call lifecycle for users and AI agents |
| **Identity** | OWS + Porto Passkeys + EVM + Solana | OWS wallet for CLI/SDK, biometric-first auth for browser |
| **Encryption** | Lit Protocol + AES-256-GCM | Reputation-gated access control, per-path encryption |
| **Discovery & Trust** | ERC-8004 (ERC-721 + Reputation) | On-chain data discovery & quality scoring |
| **Data Vault** | OrbitDB Nested | Local-first P2P storage with hierarchical JSON paths |
| **Persistence** | Storacha (Filecoin/IPFS) | Immutable archival snapshots, disaster recovery |
| Layer | Technology | Role |
| :-------------------- | :---------------------------------- | :------------------------------------------------------- |
| **Interface** | SDK + CLI (Skills) | One-call lifecycle for users and AI agents |
| **Identity** | OWS + Porto Passkeys + EVM + Solana | OWS wallet for CLI/SDK, biometric-first auth for browser |
| **Encryption** | Lit Protocol + AES-256-GCM | Reputation-gated access control, per-path encryption |
| **Discovery & Trust** | ERC-8004 (ERC-721 + Reputation) | On-chain data discovery & quality scoring |
| **Data Vault** | OrbitDB Nested | Local-first P2P storage with hierarchical JSON paths |
| **Persistence** | Storacha (Filecoin/IPFS) | Immutable archival snapshots, disaster recovery |

---

Expand All @@ -68,19 +68,27 @@ P2P data vaults with per-path visibility control. The same data tree can have di

```typescript
// Public — any agent reads freely
await vault.put('travel/dietary', 'vegan', { visibility: 'public' });
await vault.put("travel/dietary", "vegan", { visibility: "public" });

// Shared — only agents with reputation ≥ 80 can decrypt (Lit Protocol)
await vault.put('travel/budget', { min: 3000, max: 5000 }, {
visibility: 'shared',
engine: 'lit',
accessConditions: [reputationCondition({ minScore: 80 })],
});
await vault.put(
"travel/budget",
{ min: 3000, max: 5000 },
{
visibility: "shared",
engine: "lit",
accessConditions: [reputationCondition({ minScore: 80 })],
},
);

// Private — owner only, AES encrypted
await vault.put('travel/passport', { number: 'XX123' }, {
visibility: 'private',
});
await vault.put(
"travel/passport",
{ number: "XX123" },
{
visibility: "private",
},
);
```

### Wallet Auth
Expand Down Expand Up @@ -113,7 +121,7 @@ High-quality data attracts more agent consumption → more feedback → higher s

## Example apps using OrbitMem

### 1. Decentralized Memo App - [Live Demo (IPFS)](https://ipfs.io/ipfs/bafybeiewn6m4l37cbcriwt7qh45sbue7r4thhiimnwnfiqxahba33i6k54/) | [Source Code](../../examples/memo/)
### 1. Decentralized Memo App - [Live Demo (IPFS)](https://ipfs.io/ipfs/bafybeig3h3rymklg2agcjp7jg2wwtsfcu2qox545fmgbclqttsazyfname/) | [Source Code](../../examples/memo/)

A fully decentralized note-taking app — no server, no platform, no lock-in.

Expand All @@ -139,7 +147,7 @@ AI agents produce and consume data autonomously — research results, curated da

1. **Agent publishes data** — an agent stores output in an OrbitMem vault and registers it on-chain via `npx orbitmem register`, minting an ERC-721 NFT with schema tags (`research`, `market-analysis`, `2026-Q1`)
2. **Other agents discover** — `npx orbitmem discover --schema research --min-score 70` finds entries by tag and reputation score
3. **Agents rate data** — consuming agents call `giveFeedback()` to score accuracy, freshness, completeness — building the producer's on-chain reputation
3. **Agents rate data** — consuming agents call `npx orbitmem rate <dataId> <score> --tag accurate` to score accuracy, freshness, completeness — building the producer's on-chain reputation
4. **Agents pay for data** — priced vault entries require MPP payment via HTTP 402 before access is granted

---
Expand Down Expand Up @@ -190,12 +198,12 @@ OrbitMem uses Filecoin (via Storacha) for verifiable archival storage and IPFS/O

OrbitMem addresses **4 of 7** Filecoin challenge ideas:

| Challenge Idea | OrbitMem Implementation |
| :--- | :--- |
| **Onchain Agent Registry** | `DataRegistry` (ERC-721) — `register(dataURI)` mints on-chain pointers to off-chain data |
| Challenge Idea | OrbitMem Implementation |
| :--------------------------------------- | :--------------------------------------------------------------------------------------------- |
| **Onchain Agent Registry** | `DataRegistry` (ERC-721) — `register(dataURI)` mints on-chain pointers to off-chain data |
| **Agent Reputation & Portable Identity** | `FeedbackRegistry` — registry-agnostic reputation with per-tag scoring, bidirectional feedback |
| **Agent-Generated Data Marketplace** | Client lifecycle: discover → evaluate → consume → rate |
| **Agent Storage SDK** | `@orbitmem/sdk` + `@orbitmem/cli` — encrypted vault, Storacha persistence, `--json` output |
| **Agent-Generated Data Marketplace** | Client lifecycle: discover → evaluate → consume → rate |
| **Agent Storage SDK** | `@orbitmem/sdk` + `@orbitmem/cli` — encrypted vault, Storacha persistence, `--json` output |

**Storacha integration:** encrypted vault snapshots archived to Filecoin via `@storacha/client` — immutable backups, CID-based retrieval, verifiable storage deals. No plaintext exposure (encryption before upload).

Expand Down Expand Up @@ -238,6 +246,7 @@ ERC-8004 is OrbitMem's core on-chain primitive. `DataRegistry` mints ERC-721 NFT

- **`npx orbitmem register`** — register data on-chain, minting a receipt NFT
- **`npx orbitmem discover`** — search by schema, tags, and minimum quality scores
- **`npx orbitmem rate`** — rate data quality on-chain with per-tag scoring
- **Interface** — `discoverData` → `getDataScore` → `rateData` lifecycle, all scored on-chain

### 9. Funding the Commons
Expand All @@ -248,13 +257,13 @@ ERC-8004 is OrbitMem's core on-chain primitive. `DataRegistry` mints ERC-721 NFT

## What We've Built

| Package | Description |
| :--- | :--- |
| **`@orbitmem/sdk`** | Composable SDK — identity, encryption, vault, transport, discovery, persistence + client |
| **`@orbitmem/contracts`** | `ERC-8004` Solidity contracts — DataRegistry (ERC-721) + FeedbackRegistry (reputation) on Base Sepolia |
| **`@orbitmem/relay`** | Hono HTTP relay with `ERC-8128` auth + MPP payment middleware, vault/data/snapshot routes |
| **`@orbitmem/web`** | React dashboard — vault explorer, data registry, metrics, wallet integration (Cloudflare Workers) |
| **`@orbitmem/cli`** | CLI for users and agents — `npx orbitmem init/vault/register/discover/snapshot` + `vault price` for pay-per-read pricing. `--json` output. Includes Claude Code skill for natural language operation |
| Package | Description |
| :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`@orbitmem/sdk`** | Composable SDK — identity, encryption, vault, transport, discovery, persistence + client |
| **`@orbitmem/contracts`** | `ERC-8004` Solidity contracts — DataRegistry (ERC-721) + FeedbackRegistry (reputation) on Base Sepolia |
| **`@orbitmem/relay`** | Hono HTTP relay with `ERC-8128` auth + MPP payment middleware, vault/data/snapshot routes |
| **`@orbitmem/web`** | React dashboard — vault explorer, data registry, metrics, wallet integration (Cloudflare Workers) |
| **`@orbitmem/cli`** | CLI for users and agents — `npx orbitmem init/vault/register/discover/snapshot` + `vault price` for pay-per-read pricing. `--json` output. Includes Claude Code skill for natural language operation |

---

Expand Down
36 changes: 19 additions & 17 deletions docs/submissions/202603_PL_Genesis/script.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,42 +6,44 @@ Hi, I'm building OrbitMem — a decentralized data layer for the agentic web, de

## Slide 2: Problem (~30s)

IPFS is great as decentralized storage — but it falls short as a modern, developer-friendly database.
IPFS is great as decentralized storage — but it's no modern usable database.

No encryption — data is stored in the open. No authentication — anyone with a CID can access it. And no discovery — you can't search for data, and there's no quality signal.
- _No encryption_ — data is stored in the open.
- _No authentication_ — anyone know a CID can access it. - _No discovery_ — you can't search for data, and there's no quality signal.

So I'm building OrbitMem to fill these gaps.

## Slide 3: Architecture (~30s)

OrbitMem is built on OrbitDB — a local-first P2P database built on IPFS and libp2p.
OrbitMem is built on top of OrbitDB — a local-first P2P database built on libp2p.

On top of that, authentication uses Passkeys, EVM, and Solana wallets with ERC-8128 signed HTTP — no OAuth, no API keys. Encryption combines Lit Protocol for token-gated access with AES-256-GCM for per-record encryption. And discovery & trust is powered by ERC-8004. It was originally designed for agent reputation, but we applied it to data — on-chain scoring where every data entry is rated by humans and agents.

Snapshots are archived to Filecoin via Storacha for long-term persistence.
- Auth uses Passkeys and wallets via ERC-8128(eighty-one twenty-eight) signed HTTP — no token or API keys.
- Encryption pairs Lit Protocol with AES.
- Discovery runs on ERC-8004(eighty-oh-four) — on-chain scoring where data entries are rated by humans and agents. we applied this to data not only agent.
- Persistence is handled by P2P replication across relays — no single point of failure. And snapshots are archived to Filecoin via Storacha.

## Slide 4: Key Features

## Slide 5: Demo — Decentralized Memo (~40s)

To show how OrbitMem works as a decentralized database via SDK, here's a memo app. No server, no platform, no lock-in.

Connect with a Passkey(Porto) or EVM wallet. Write memos in Markdown with live preview.
OrbitMem works as a decentralized database via SDK, here's a demo memo app deployed on IPFS.

Each memo has per-path visibility control. Public memos are shareable and can be registered on-chain. Private memos are AES-256-GCM encrypted — the relay server and IPFS nodes only receive already-encrypted data, so only the owner can decrypt it.
--- _DEMO_1_ ---

And you can snapshot your vault to Filecoin via Storacha for long-term backup.
- Auth with wallet or passkey(porto)
- Public memos are shareable.
- Private memos are AES encrypted — the relay server and IPFS nodes only receive already-encrypted data, so only the owner can decrypt it.

## Slide 6: Demo — Agent Data Trust (~40s)

OrbitMem is also designed for agent use cases. We provide a CLI and agent skills so AI agents can publish, discover, and rate data autonomously. You can integrate it into your own agents — whether it's OpenClaw, WorkFlow, or any autonomous system.
OrbitMem is also designed for agents. We provide a CLI and Skills so agents can publish, discover, and rate data autonomously.

Agent A stores research data and registers it on-chain — minting an ERC-721 receipt. Agent B discovers it by searching with schema and quality filters, then rates it with a score and tags like "accurate."
--- _DEMO_2_ ---

This creates a virtuous cycle — higher quality, higher visibility. Reputation-gated access via Lit Protocol means the best data producers earn more trust and reach.
You can integrate it into your own agents — whether it's OpenClaw, WorkFlow, or any agents.

## Slide 7: Closing + QR (~15s)
Quality drives visibility. We also integrated Machine Payments Protocol by Tempo/Stpipe, so data can be bought and sold based on reputation. This drives a healthy data ecosystem.

That's OrbitMem — encrypted vaults, on-chain discovery, and verifiable data trust. All open source.
## Slide 7: Closing + QR (~15s)

Scan the QR codes to check it out. Thanks.
That's it. Thanks.
Loading