522655ef92
Some checks failed
API Endpoint Tests / test-api-endpoints (push) Successful in 10s
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 4s
Documentation Validation / validate-docs (push) Successful in 8s
Documentation Validation / validate-policies-strict (push) Successful in 4s
Integration Tests / test-service-integration (push) Successful in 38s
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 2s
P2P Network Verification / p2p-verification (push) Successful in 3s
Security Scanning / security-scan (push) Successful in 40s
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Successful in 15s
Smart Contract Tests / lint-solidity (push) Successful in 8s
- Relocate blockchain-event-bridge README content to docs/apps/blockchain/blockchain-event-bridge.md - Relocate blockchain-explorer README content to docs/apps/blockchain/blockchain-explorer.md - Replace app READMEs with redirect notices pointing to new documentation location - Consolidate documentation in central docs/ directory for better organization
33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
# Wallet Daemon
|
|
|
|
## Purpose & Scope
|
|
|
|
Local FastAPI service that manages encrypted keys, signs transactions/receipts, and exposes wallet RPC endpoints. Reference `docs/bootstrap/wallet_daemon.md` for the implementation plan.
|
|
|
|
## Development Setup
|
|
|
|
- Create a Python virtual environment under `apps/wallet-daemon/.venv` or use Poetry.
|
|
- Install dependencies via Poetry (preferred):
|
|
```bash
|
|
poetry install
|
|
```
|
|
- Copy/create `.env` and configure coordinator access:
|
|
```bash
|
|
cp .env.example .env # create file if missing
|
|
```
|
|
- `COORDINATOR_BASE_URL` (default `http://localhost:8011`)
|
|
- `COORDINATOR_API_KEY` (development key to verify receipts)
|
|
- Run the service locally:
|
|
```bash
|
|
poetry run uvicorn app.main:app --host 127.0.0.2 --port 8071 --reload
|
|
```
|
|
- REST receipt endpoints:
|
|
- `GET /v1/receipts/{job_id}` (latest receipt + signature validations)
|
|
- `GET /v1/receipts/{job_id}/history` (full history + validations)
|
|
- JSON-RPC interface (`POST /rpc`):
|
|
- Method `receipts.verify_latest`
|
|
- Method `receipts.verify_history`
|
|
- Keystore scaffolding:
|
|
- `KeystoreService` uses Argon2id + XChaCha20-Poly1305 via `app/crypto/encryption.py` (in-memory for now).
|
|
- Future milestones will add persistent storage and wallet lifecycle routes.
|