Milestone 1 — Application-Layer Developer Tooling
Estimated Delivery: 3 weeks | Funding: 100,000 CC
Effort Rationale: Approximately 3 weeks of full-team engineering effort distributed across @partylayer/session lifecycle and resilience layer (~25%), multi-framework CLI scaffolding (~20%), @partylayer/testing mock provider and harness implementation (~20%), PartyLayer Studio interactive workbench (~20%), and Pattern Cookbook authoring (~15%). The funding allocation reflects implementation effort weighted toward developer-facing artifacts that establish a reliable onboarding baseline for the application-layer surface, anchored by the session resilience foundation that subsequent milestones build upon.
Deliverables:
@partylayer/session — Session Lifecycle & Resilience Layer
A production-grade session management layer that sits above the Canton dApp SDK's transport primitives, handling the stateful concerns every Canton dApp currently rebuilds independently:
- Persistent session restore across page reloads via encrypted storage (Web Crypto API AES-GCM, localStorage and IndexedDB backends)
- Multi-tab synchronization via BroadcastChannel — disconnect in one tab propagates to all open tabs of the same dApp
- Party-switch detection — when the user changes the primary party in their wallet, dApp state is invalidated and re-fetched automatically
- Network and synchronizer change handling with cache invalidation and reconnect orchestration
- Automatic reconnect with exponential backoff and configurable retry policies for transient network failures
- Session expiry detection and graceful re-authentication flows that preserve in-flight transaction state
useSession,useAccount,useAccountEffecthooks for React and equivalent composables for Vue, providing reactive access to session, primary account, and lifecycle events- Session schema migration helpers for backward-compatible storage upgrades across SDK versions
- Origin-bound session isolation preventing cross-site session leakage
This layer operates strictly above @canton-network/dapp-sdk, consuming its connect, disconnect, status, and statusChanged primitives and adding the stateful resilience patterns that wallet-side transport does not provide.
npx create-partylayer-app — Multi-Framework Application Scaffolder
Four framework-aware boilerplates, each pre-wired with PartyLayer's application-layer patterns:
- React + Vite template — PartyLayer Provider, TanStack Query Client, pre-configured hooks, themed components wired
- Next.js App Router template — Server Components hydration via cookieStorage SSR pattern, route-level wallet gates, server-side party fetching
- Vue 3 + Nuxt 3 template — composables with API parity to React hooks, Pinia store integration, SSR hydration
- Vanilla JS template — framework-agnostic core for legacy frontends or progressive enhancement
Each template ships with a working transaction lifecycle UI, mock wallet setup from @partylayer/testing, session resilience pre-configured via @partylayer/session, and CIP-0103 conformance test integration.
@partylayer/testing v1.0 — Application-Layer Testing Harness
- Mock CIP-0103 wallet provider with configurable response scenarios (connect rejection, insufficient traffic, synchronizer error, transaction timeout)
- Simulated transaction lifecycle with controllable phase transitions for testing
isPreparing → isSubmitting → isConfirming → isFinalizedstates - Session lifecycle simulation utilities (forced session expiry, party-switch events, multi-tab disconnect propagation, reconnect scenarios)
- TanStack Query test utilities for asserting cache state, query invalidation, and optimistic update rollback
- Offline integration test utilities — no DevNet dependency required for unit tests
PartyLayer Studio — Interactive Pattern Workbench
An in-browser sandbox built on Sandpack that runs PartyLayer code without local installation:
- Live code editor with PartyLayer types pre-loaded — IntelliSense for all hooks, composables, and components
- Mock wallet driver integrated — simulate any CIP-0103 method response without a real wallet
- Embedded React Query DevTools showing live cache state, query keys, invalidations, and refetch triggers
- Transaction lifecycle stepper with pause/resume controls for walking through state transitions and rollback simulation
- Session resilience scenarios — multi-tab sync demonstration, party-switch invalidation walkthrough, reconnect-after-expiry replay
- Framework toggle — switch the same example between React, Vue, and Vanilla JS variants
- Scenario library — pre-built scenarios for multi-wallet switching, optimistic update rollback, CIP-0104 cost preview, synchronizer failover
PartyLayer Pattern Cookbook
Pattern-oriented cookbook of runnable patterns for common application-layer problems:
- Persistent session restore on page re
