Tenant Management

Comet Engine is multi-tenant. Every wallet, asset, and journal entry is scoped to a tenant.

WARNING

Tenant management (creating tenants, rotating secrets) is done through the Admin Dashboard at http://localhost:3000. Admin endpoints are not exposed in the public API documentation.

Default Tenant

The "comet" tenant (Comet Wallet) is automatically seeded at boot. This is the default tenant used when no tenantSlug is specified.

Tenant Data Isolation

Each tenant has isolated:

• Wallets — (tenant_id, user_id) unique constraint
• Journal entries — scoped to tenant_id
• API access — API key resolves to a specific tenant

MongoDB Collections

Collection	Scope
tenants	Tenant registry
evm_wallets	Per-tenant wallets (unique on tenant_id + user_id)
journal_entries	Per-tenant journal (indexed on tenant_id)