Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
coodos merged 12 commits into from
Feb 10, 2026
Merged

Feat/dev sandbox and eid sdk #797

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
02af17b
feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)
coodos Feb 10, 2026
b4f9ff1
feat(wallet-sdk): implement provisioning flow with CryptoAdapter
coodos Feb 10, 2026
8c147ed
feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…
coodos Feb 10, 2026
08ff736
feat(wallet-sdk): add syncPublicKeyToEvault and signPayload
coodos Feb 10, 2026
f3c2b1b
test(wallet-sdk): add test double and tests for provision, auth, sync…
coodos Feb 10, 2026
7f3f6b6
feat(dev-sandbox): add app scaffold and Web Crypto adapter
coodos Feb 10, 2026
61c1446
feat(dev-sandbox): wire provision and auth UI to SDK
coodos Feb 10, 2026
72225df
feat(dev-sandbox): add sync key and sign payload UI, README
coodos Feb 10, 2026
f637299
feat: base working dev sandbox
coodos Feb 10, 2026
3ba6d62
feat: restyle sandbox
coodos Feb 10, 2026
345174a
feat: docker setup
coodos Feb 10, 2026
b9ffeba
chore: delete junk files
coodos Feb 10, 2026
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
33 changes: 33 additions & 0 deletions .github/workflows/tests-wallet-sdk.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
push:
branches: [main]
paths:
- 'packages/wallet-sdk/**'
pull_request:
branches: [main]
paths:
- 'packages/wallet-sdk/**'

jobs:
test:
runs-on: ubuntu-latest

steps:
- name: Checkout code
uses: actions/checkout@v3

- name: Set up Node.js 22
uses: actions/setup-node@v4
with:
node-version: 22

- name: Install pnpm
run: npm install -g pnpm

- name: Install dependencies
run: pnpm install

- name: Run tests
run: pnpm -F=wallet-sdk test
21 changes: 0 additions & 21 deletions Dockerfile.dev
View file
Open in desktop

This file was deleted.

89 changes: 89 additions & 0 deletions QUICKSTART.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.

# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.

```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).
23 changes: 6 additions & 17 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.
- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```
11 changes: 0 additions & 11 deletions control-panel.compose.yml
View file
Open in desktop

This file was deleted.

Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
Feat/dev sandbox and eid sdk#797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

coodos
merged 12 commits into

from

Feb 10, 2026
 Merged


Feat/dev sandbox and eid sdk
#797
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


12 commits


Select commit
Hold shift + click to select a range
02af17b

feat(wallet-sdk): add package and CryptoAdapter interface (BYOC)


coodos Feb 10, 2026
b4f9ff1

feat(wallet-sdk): implement provisioning flow with CryptoAdapter


coodos Feb 10, 2026
8c147ed

feat(wallet-sdk): implement auth flow (parse w3ds auth, sign session,…


coodos Feb 10, 2026
08ff736

feat(wallet-sdk): add syncPublicKeyToEvault and signPayload


coodos Feb 10, 2026
f3c2b1b

test(wallet-sdk): add test double and tests for provision, auth, sync…


coodos Feb 10, 2026
7f3f6b6

feat(dev-sandbox): add app scaffold and Web Crypto adapter


coodos Feb 10, 2026
61c1446

feat(dev-sandbox): wire provision and auth UI to SDK


coodos Feb 10, 2026
72225df

feat(dev-sandbox): add sync key and sign payload UI, README


coodos Feb 10, 2026
f637299

feat: base working dev sandbox


coodos Feb 10, 2026
3ba6d62

feat: restyle sandbox


coodos Feb 10, 2026
345174a

feat: docker setup


coodos Feb 10, 2026
b9ffeba

chore: delete junk files


coodos Feb 10, 2026

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


33 changes: 33 additions & 0 deletions
.github/workflows/tests-wallet-sdk.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
name: Tests [wallet-sdk]

on:
 push:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'
 pull_request:
 branches: [main]
 paths:
 - 'packages/wallet-sdk/**'

jobs:
 test:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout code
 uses: actions/checkout@v3

 - name: Set up Node.js 22
 uses: actions/setup-node@v4
 with:
 node-version: 22

 - name: Install pnpm
 run: npm install -g pnpm

 - name: Install dependencies
 run: pnpm install

 - name: Run tests
 run: pnpm -F=wallet-sdk test

21 changes: 0 additions & 21 deletions
Dockerfile.dev

View file


Open in desktop


This file was deleted.


89 changes: 89 additions & 0 deletions
QUICKSTART.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
# Quick start: registry + evault-core + dev-sandbox

Run Postgres and Neo4j in Docker, then start the core services and dev-sandbox with one script.

## Prerequisites

- **Docker** (for Postgres and Neo4j)
- **Node.js 18+** and **pnpm**
- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)

## Environment

Create or edit `.env` in the repo root. Minimum for this stack:

```bash
# Postgres (used by registry)
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry

# Neo4j (used by evault-core)
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password
Comment thread
coodos marked this conversation as resolved.


# So the sandbox and evault-core can talk to registry/provisioner
PUBLIC_REGISTRY_URL=http://localhost:4321
PUBLIC_PROVISIONER_URL=http://localhost:3001
REGISTRY_SHARED_SECRET=dev-secret-change-me
PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
```

## One-command start

From the repo root:

```bash
pnpm install
pnpm dev:core
```

Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`

This will:

1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
2. Wait for Postgres to be ready
3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel

Stop with `Ctrl+C`. To stop only the databases: `pnpm docker:core:down`.

## Ports

| Service | Port(s) | Notes |
|----------------|---------|--------------------------|
| Postgres | 5432 | |
| Neo4j HTTP | 7474 | |
| Neo4j Bolt | 7687 | |
| Registry | 4321 | |
| evault-core | 3001, 4000 | Provisioning + GraphQL |
| **Dev sandbox**| **8080**| W3DS dev sandbox UI |

Open **http://localhost:8080** for the dev sandbox (provision, w3ds flows, sign).

## Optional: databases only

To run only Postgres and Neo4j (e.g. you run the app services yourself):

```bash
pnpm docker:core
```

Or: `docker compose -f docker-compose.databases.yml up -d`. Stop with `pnpm docker:core:down`.

## Troubleshooting

**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
Comment thread
coodos marked this conversation as resolved.


```bash
docker compose -f docker-compose.databases.yml down
docker volume rm metastate_neo4j_data 2>/dev/null || true
docker compose -f docker-compose.databases.yml up -d
pnpm dev:core
```

Otherwise ensure `.env` has `NEO4J_URI=bolt://127.0.0.1:7687` and matching `NEO4J_USER` / `NEO4J_PASSWORD`.

---

For full Docker setups and all platform services, see the main [README](README.md).

23 changes: 6 additions & 17 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -2,6 +2,8 @@

**[Documentation](https://docs.w3ds.metastate.foundation)** — Getting started with W3DS and the MetaState prototype.

**Quick start (registry + evault-core + dev-sandbox):** see **[QUICKSTART.md](QUICKSTART.md)** — one script to run Postgres + Neo4j in Docker and the core services locally. Dev sandbox runs at **http://localhost:8080**.

## Docker Development Environment

### Port Assignments
Expand All@@ -26,7 +28,7 @@
- **1111** - Pictique API

#### Frontend Services
- **8080** - Blabsy Frontend
- **8080** - Dev sandbox (W3DS) / Blabsy Frontend
Comment thread
coderabbitai[bot] marked this conversation as resolved.

- **5173** - Pictique Frontend
- **3004** - Group Charter Manager Frontend
- **3005** - eVoting Frontend
Expand All@@ -52,22 +54,9 @@ Runs all services (core + all APIs + all frontends)

### Usage

Start all services:
```bash
pnpm dev:docker:all
```
**Local dev (recommended):** `pnpm dev:core` — see [QUICKSTART.md](QUICKSTART.md). Runs Postgres + Neo4j in Docker, then registry, evault-core, and dev-sandbox locally.

Start specific profile:
```bash
pnpm dev:docker:socials
pnpm dev:docker:charter-blabsy
```

Or use docker compose directly:
```bash
docker compose -f dev-docker-compose.yaml --profile socials up --watch
docker compose -f dev-docker-compose.yaml --profile charter-blabsy up --watch
```
**Databases only:** `pnpm docker:core` (Postgres + Neo4j). Stop with `pnpm docker:core:down`.

## Project Structure

Expand All@@ -93,5 +82,5 @@ prototype/
│ └─ marketplace/
├─ docker/
│ └─ Dockerfile.* (Dedicated Dockerfiles for each service)
└─ dev-docker-compose.yaml (Docker Compose configuration)
└─ docker-compose.databases.yml (Postgres + Neo4j)
```

11 changes: 0 additions & 11 deletions
control-panel.compose.yml

View file


Open in desktop


This file was deleted.

Loading
Loading