Kitchen Sink

Everything in one page. Use this to test components before wiring into real content.


Callouts

info

This is a note. Use it for general supplementary information.

lightbulb

This is a tip. Use it for helpful shortcuts or recommendations.

warning

This is a warning. Use it when something could go wrong.

dangerous

This is a danger. Use it for irreversible or destructive actions.


Code Block — single language

let session = TrueSealSession::create("my-app", relay_url, relay_pub_key).await?;
session.start_pairing(on_member_request).await?;

Code Block — multi language tabs

let session = TrueSealSession::create("my-app", relay_url, relay_pub_key).await?;
session.start_pairing(on_member_request).await?;

Tables

NameTypeDescription
session_idStringUnique identifier for this session
relay_urlStringWebSocket URL of the relay
keypairKeypairDevice identity keypair, generated on first launch
timeout_msInteger?Optional timeout. Defaults to 5000

Flow Diagram

NODE_A INITIATOR
key Gen Ephemeral Key
lock_clock Nonce Timestamp
arrow_forward
hub TRUESEAL RELAY NETWORK Blind Forwarding
latency: <10msdrop: 0%
arrow_forward
NODE_B RECEIVER
verified Verify Signature
vpn_key Derive Shared Secret

Phase Stack

PHASE 01 Handshake

The initial connection requires mutual authentication. Both devices exchange ephemeral public keys encrypted with the relay's static public key.

{
"v": "1.2",
"type": "HS_INIT",
"payload": {
  "eph_key": "x25519_pub_...",
  "ts": 1715428912,
  "sig": "ed25519_sig_..."
}
}
PHASE 02 Relay Validation

The relay blindly routes the encrypted packet, validating only the outer envelope headers without accessing the inner payload.

  • check_box Header Length Check
  • check_box TTL > 0 Validation
  • check_box Recipient key exists in active sessions
PHASE 03 State Sync

Once the secure tunnel is established, the sender's outbox is flushed. Each envelope is addressed individually to the recipient's noise public key.


Typography scale

h1 — Display heading

h2 — Section heading

h3 — Subsection heading

h4 — Label heading

Regular body paragraph. trueseal provides composable infrastructure for encrypted sync, device identity, and relay delivery without trusting any server or platform.

Bold text. Italic text. inline code. Link text.

Blockquote — used for pull quotes or notable statements.


Next page