tens-city

tens.city

Web Application

The web application is a single-page app for managing JSON-LD objects with GitHub authentication.

Features

• GitHub OAuth login via Supabase Auth
• Query and view objects from the database
• Post new JSON-LD objects with ownership tracking
• ACE editor for JSON editing with syntax highlighting
• Load data from embedded <script type="application/ld+json"> tags
• Auto-update script tags when editor content changes
• Dynamic permalink anchor that updates with editor content
• Share and load JSON-LD via URL parameters

For details on the JSON-LD script tag and permalink features, see docs/JSONLD_SCRIPT_TAG.md.

Quick Start

# Serve the public directory
cd public
python3 -m http.server 8080

Then configure your Supabase credentials in index.html (see public/README.md for details).

1. Ethos: tent city

• Not skyscrapers; actual encampments.
• Anyone can stake a corner — no permission required.
• Minimal structure that belongs to you — dignity-through-shelter even when janky.
• No HOA, no governance tokens: just a tarp and a hook to keep your stuff dry.

2. Basic shelter (software terms)

The "lean-to of sticks" is the absolute minimum runtime that lets something simply live.

Concrete guarantees:

• Each person/object gets a directory.
• The directory is static (only files).
• It is addressable (stable URL / CID).
• Served straight off disk — no app server trying to own content.

Maps to:

• Filesystem-based
• Static web hosting
• The city is literally a filesystem tree

3. Principles (short)

• Provide stable, non-transient spots.
• Keep the runtime minimal and non-opinionated.
• Serve static files directly from disk with a generic viewer.

4. JSON-LD Validation

The database uses the pg_jsonschema PostgreSQL extension to enforce JSON-LD correctness guarantees at the database layer. This ensures that all stored objects meet basic JSON-LD requirements:

• Required @context field: All JSON-LD documents must have a @context field (can be string, object, array, or null)
• Schema validation: Objects are validated against a JSON Schema before insertion
• Database-level enforcement: Invalid JSON-LD documents are rejected at the database level

This provides a safety net ensuring data integrity without requiring application-level validation.

For detailed information about JSON-LD validation, see docs/JSONLD_VALIDATION.md.

5. CLI Tools

seal - Create sealed JSON-LD objects

Seals JSON-LD documents using URDNA2015 canonicalization and computes CIDv1 identifiers.

./seal -in examples/petrinet.jsonld -store data

See cmd/seal/main.go for full options including signing with Ethereum keys.

edge - Database operations

Interact with the PostgreSQL database for importing objects, adding signatures, and querying with pg_graphql.

# Import JSON-LD to database
./edge import -db <DATABASE_URL> -file examples/petrinet.jsonld

# Import filesystem object to database
./edge import-fs -db <DATABASE_URL> -cid <CID> -store data

# Add signature to object
./edge sign -db <DATABASE_URL> -cid <CID> -store data

# Query with pg_graphql
./edge query -db <DATABASE_URL> -query '{objectsCollection{edges{node{cid}}}}'

See docs/edge-cli.md for detailed documentation.

keygen - Generate Ethereum keys

Generate or import Ethereum keystore files for signing.

./keygen -out my-key.keystore -pass mypassword

6. Quick Start

1. Build the tools:

   go build -o seal ./cmd/seal
   go build -o edge ./cmd/edge
   go build -o keygen ./cmd/keygen
   

2. Start the database:

   docker-compose up -d
   

3. Run migrations:

   psql <DATABASE_URL> -f migrations/migrations_20251029_create_tens_city_tables.sql
   psql <DATABASE_URL> -f migrations/migrations_20251030_add_jsonld_validation.sql
   psql <DATABASE_URL> -f migrations/policies_enable_rls_and_policies.sql
   

4. Seal and import a JSON-LD document:

   ./seal -in examples/petrinet.jsonld -store data
   ./edge import-fs -db <DATABASE_URL> -cid <CID> -store data
   

See examples/workflow.sh for a complete workflow example.