vana-com/personal-server

آخر نشاط مصدر مسجل: ١٠ فبراير ٢٠٢٦ في ٢٢:٤٣

آخر تحديث لفهرس SkillsMP: ١٢ نوفمبر ٢٠٢٦ في ١٢:٥٢

skills مجمعة: ٤

نجوم GitHub: ١١٦
تفرعات GitHub: ٢١

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/vana-com/personal-server.

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# Vana Personal Server [![CI](https://github.com/vana-com/personal-server-ts/actions/workflows/ci.yml/badge.svg)](https://github.com/vana-com/personal-server-ts/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/@opendatalabs/personal-server-ts)](https://www.npmjs.com/package/@opendatalabs/personal-server-ts) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![node >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org) [![TypeScript 5.7](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org) TypeScript implementation of the Vana Data Portability Protocol's Personal Server. Stores user data locally, serves it to authorized users via grant-enforced APIs, and syncs encrypted copies to storage backends. ## Architecture NPM workspaces monorepo with three packages: | Package | Purpose | | ----------------- | ---------------------------------------------------------------------- | | `packages/core` | Protocol logic — auth, grants, scopes, storage, keys, gateway client | | `packages/server` | Hono HTTP server — routes, middleware, composition root | | `packages/cli` | Facade package for external tools (`@opendatalabs/personal-server-ts`) | By default, Personal Server uses `~/personal-server` as its root namespace: - Data: `~/personal-server/data/` - Config: `~/personal-server/config.json` - Index: `~/personal-server/index.db` - Server keypair: `~/personal-server/key.json` - Access logs: `~/personal-server/logs/` Override the root with `PERSONAL_SERVER_ROOT_PATH` (for example, Data Connect can use `~/data-connect/personal-server`). ## Setup ```bash node -v # >= 20 npm install cp .env.example .env # dev/test master key — see file for details npm run build ``` ## Run ```bash npm start # build + start server npm run dev # run from source (no build step) PERSONAL_SERVER_ROOT_PATH=~/data-connect/personal-server npm start ``` The server starts on the port defined in `${PERSONAL_SERVER_ROOT_PATH:-~/personal-server}/config.json` (default: 8080). Health check at `GET /health`. ## Configuration The server reads `${PERSONAL_SERVER_ROOT_PATH:-~/personal-server}/config.json` on startup (created with defaults if missing). ```json { "server": { "port": 8080 }, "logging": { "level": "info", "pretty": false }, "storage": { "backend": "local" } } ``` Set `"pretty": true` for human-readable logs during development. ### Server Registration Register your server with the Vana Gateway so it can participate in the data portability network: ```bash export VANA_OWNER_PRIVATE_KEY=0x... # your owner wallet private key npm run register-server # uses server.origin from config npm run register-server https://my.server # override server URL PERSONAL_SERVER_ROOT_PATH=~/data-connect/personal-server npm run register-server ``` The script signs an EIP-712 `ServerRegistration` message with the owner key and POSTs it to the gateway. Once registered, `GET /health` will show `delegation.registered: true`. ## Test ```bash npm test # run all tests npm run test:watch # watch mode npm run test:e2e # end-to-end tests (limited mocking) ``` Tests are co-located with source (`foo.ts` → `foo.test.ts`). ## API All authenticated endpoints use `Authorization: Web3Signed <base64url(json)>.<signature>` — no sessions, no cookies. | Endpoint | Method | Auth | Purpose | | --------------------------- | ------ | --------------- | ---------------------- | | `/health` | GET | None | Health check | | `/v1/data/{scope}` | POST | Owner | Ingest data | | `/v1/data` | GET | Builder | List scopes | | `/v1/data/{scope}` | GET | Builder + Grant | Read data | | `/v1/data/{scope}/versions` | GET | Builder | List versions | | `/v1/data/{scope}` | DELETE | Owner | Delete data | | `/v1/grants` | GET | Owner | List grants | | `/v1/grants/verify` | POST | None | Verify grant signature | | `/v1/access-logs` | GET | Owner | Access history | | `/v1/sync/trigger` | POST | Owner | Force sync | | `/v1/sync/status` | GET | Owner | Sync status | | `/v1/sync/file/{fileId}` | POST | Owner | Sync specific file | ## Docs - [DPv1 Protocol Spec](docs/260121-data-portability-protocol-spec.md) — canonical protocol behavior - [Architecture](docs/260127-personal-server-scaffold.md) — design decisions and repo structure

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات

١ فئات مهنية · 100% مصنفة

skill

المهنة

الوصف

آخر تحديث

npm-library-setup

مطوّرو البرمجيات

Comprehensive guidance on setting up npm libraries with package.json, with a preference for ES Modules (ESM). Use when setting up npm packages, configuring ESM, TypeScript packages, or React component libraries.

لغة النص الأصلي: الإنجليزية

2026-02-10

yeet

مطوّرو البرمجيات

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

لغة النص الأصلي: الإنجليزية

2026-02-10

typescript

مطوّرو البرمجيات

This skill should be used when the user asks to "optimize TypeScript performance", "speed up tsc compilation", "configure tsconfig.json", "fix type errors", "improve async patterns", or encounters TS errors (TS2322, TS2339, "is not assignable to"). Also…

لغة النص الأصلي: الإنجليزية

2026-02-04

hono

مطوّرو البرمجيات

Efficiently develop Hono applications using Hono CLI. Supports documentation search, API reference lookup, request testing, and bundle optimization.

لغة النص الأصلي: الإنجليزية

2026-01-28

عرض ٤ من أصل ٤ skills مجمعة.