Keeps Wallet#

A Tezos wallet for managing your aesthetic.computer keeps (NFTs).

Quick Start#

cd wallet/extension
npm install
npm run build:icons  # Generate icons
npm run build        # Build for Chrome

Then load in Chrome:

Open chrome://extensions
Enable "Developer mode" (top right toggle)
Click "Load unpacked"
Select wallet/extension/dist

Two Modes#

1. Integrated (Logged-in Users)#

Users logged into prompt.ac get wallet functionality built-in:

Encrypted keys stored server-side tied to their account
No extension needed
Seamless keeps minting, buying, selling
Keys derived from account + password

2. Chrome Extension (Standalone)#

For power users and cross-dApp usage:

Self-custody keys (you control the seed phrase)
Works on any Tezos dApp
Portfolio view of all your keeps
Clean aesthetic.computer UI

Directory Structure#

wallet/
├── README.md              # This file
├── llm.md                 # AI assistant context
├── extension/             # Chrome extension
│   ├── manifest.json
│   ├── background.js      # Service worker (key ops)
│   ├── content.js         # Page injection
│   ├── popup/             # Extension popup UI
│   └── lib/               # Shared crypto/tezos libs
└── integrated/            # Server-side wallet for logged-in users
    └── (future)

Tech Stack#

Tezos SDK: @taquito/taquito
Crypto: libsodium (ed25519 keys), bip39 (seed phrases)
Storage: chrome.storage.local (extension), server-side encrypted (integrated)
NFT API: TzKT for keeps metadata & history

Security Model#

Extension#

Seed phrase encrypted with user password
Keys never leave extension context
Page requests signing via message passing
User confirms each transaction in popup

Integrated (logged-in)#

Keys encrypted with password-derived key
Stored in user's account data
Server never sees plaintext keys
Decryption happens client-side only

Keeps Features#

View your keeps collection
Mint new keeps
Transfer keeps
List keeps for sale (objkt.com integration)
View keep history & provenance