wallet-attached-storage-server 0.1.0

Server implementation for the Wallet Attached Storage specification

Wallet Attached Storage Server

Python server for the Wallet Attached Storage specification, built with FastAPI.

Installation

pip install wallet-attached-storage-server

Usage

# Start the server
uvicorn was_server:app --port 8080

# Or with auto-reload for development
uvicorn was_server:app --reload --port 8080

The server exposes the full WAS API at the root path. Clients authenticate with Cavage draft-12 HTTP Signatures using Ed25519 did:key identifiers.

API

Spaces

Method	Path	Auth	Description
PUT	/space/{id}	Yes	Create or update a space
GET	/space/{id}	Yes	Read space metadata
DELETE	/space/{id}	Yes	Delete space and all its resources
POST	/spaces/	Yes	Create a space (server-generated ID)
GET	/spaces/	Yes	List spaces you control

Resources

Method	Path	Auth	Description
GET	/space/{id}/{path}	No	Read a resource
PUT	/space/{id}/{path}	Yes	Create or update
POST	/space/{id}/{path}	Yes	Create (returns 201)
DELETE	/space/{id}/{path}	Yes	Delete (idempotent)

Authorization

Each space has a controller field set to a did:key DID. All write operations and space reads require an HTTP Signature whose signing key matches the space controller. Resource reads are unsigned (public).

Storage Backend

The server ships with an in-memory storage backend. The storage layer is defined as a Python protocol, so you can swap in a file, database, or S3 backend by implementing StorageBackend.

Development

uv run ruff check
uv run flake8 src tests
uv run bandit -r src
uv run bandit -r tests -s B101
uv run safety scan
uv run -m pytest -vv --cov=src --cov-report=term

CI runs all of the above on every push and PR (Python 3.11–3.14). To publish a release, tag and push:

git tag -sm "Initial release." "v0.1.0"
git push

Acceptance Tests

The companion client library includes a live test suite that runs against localhost:8080:

# Terminal 1
uv run uvicorn was_server:app --port 8080

# Terminal 2 (in the client repo)
uv run -m pytest tests/test_live.py -vv

References

• Wallet Attached Storage Specification
• Wallet Attached Storage Client (Python)
• Wallet Attached Storage (JavaScript reference)
• Wallet Attached Storage Specification (source)