# 🧬 Proof of Persona

> Your programmable onchain identity, powered by signed thoughts.

👉 [Full Documentation](https://0xbadasya.github.io/proof-of-persona)

---

## 🚀 Overview

**proof-of-persona** is a CLI and SDK for pseudonymous identity through cryptographically signed thoughts.

It redefines identity through behavior, writing, and thought — not accounts.

---

## 🔑 Philosophy

> You are not a login. You are what you think.

The modern web replaced thought with engagement. `persona` reclaims identity through consistent, signed expression.

- No email
- No KYC
- No centralized login
- Just thinking, signing, and reputation

---

## 🧠 How It Works

- **Create persona**: A unique alias + public key + behavioral model
- **Post thoughts**: Signed locally with private key
- **Store data**: JSON files in `./storage/` or exported
- **Verify identity**: Every thought is cryptographically verifiable

---

## 🛠 Features

- ✅ Local-first, privacy-focused
- ✅ CLI-powered identity layer
- ✅ Signed thought logs (verifiable)
- ✅ Portable and extensible formats (JSON, TXT, ZIP)
- ✅ Import/export personas and thoughts
- ✅ Signature validation (via Ethers.js)

---

## ✨ Use Cases

- 🧾 Pseudonymous blogs (signed with key)
- 🧠 AI memory trails (LLM identity)
- 🧱 DAO voting via thought identity
- 🗨️ Forums with signed post authorship
- 🧠 Philosophy/idea journaling

---

## 📦 Installation

```bash
npm install -g proof-of-persona
```

> See [`installation.md`](./docs/installation.md) for full setup.

---

## 🧪 Example

```ts
import { createPersona, postThought } from "proof-of-persona";

const persona = await createPersona({
  alias: "neo",
  publicKey: "0x...",
  behaviorModel: "socratic-punk",
  privateKey: "0x..."
});

await postThought(persona, {
  content: "The chain remembers.",
  topic: "philosophy"
});
```

> See more in [`use-cases.md`](./docs/use-cases.md)

---

## 🧱 Architecture

- CLI interface (`/cli`)
- Core logic (`/core`)
- Local storage adapter (`/storage`)
- Signature module (`/signer`)

> Detailed breakdown in [`architecture.md`](./docs/architecture.md)

---

## 📚 Documentation

- [`introduction.md`](./docs/introduction.md)
- [`installation.md`](./docs/installation.md)
- [`architecture.md`](./docs/architecture.md)
- [`cli.md`](./docs/cli.md)
- [`faq.md`](./docs/faq.md)
- [`whitepaper.md`](./docs/whitepaper.md)
- [`roadmap.md`](./docs/roadmap.md)

---

## 🧩 Roadmap Highlights

- [x] Full local CLI
- [x] Signature-based identities
- [x] Import/export
- [x] Memory system
- [x] Modular core SDK
- [ ] Forum framework (threads, replies)
- [ ] IPFS/Arweave sync
- [ ] Rust SDK (in progress)
- [ ] LLM-style detection and signature scoring

---

## 💬 Philosophy

> What if identity was built on thought?

> What if reputation wasn't a number, but a narrative?

> What if pseudonymity became a virtue?

---

## 🛠 Built By

**[badasya](https://github.com/0xbadasya)** — open identity engineer

> ✨ Stay anonymous. Stay sovereign. Stay you.

---

🧠 `persona` — your programmable onchain mind.