@jsm-mit/tigi-sharded-package 0.2.0 → 0.3.0

package/README.md

@@ -7,7 +7,8 @@ carries the rider's few driver-canister endpoints (U-14: `getRide`, `cancelRide`
 canister's id.
 
 Status: the rider's side (night 1, U-42); 0.2.0 (stage 2a, U-43) adds the rider's own
-rating and WHERE the chat with a driver is. Version 0.1.0 was the first to publish.
+rating and WHERE the chat with a driver is; 0.3.0 (U-45) adds `DriverCanistersActor` — the
+demo lease and the one-time claim code. Version 0.1.0 was the first to publish.
 
 ## The rider
 
@@ -96,6 +97,44 @@ const driverPlace = await new ChatPlacesActor(coordinatorId, identity, { host })
 - The room may appear a few seconds after the driver's canister (the core's outbox);
   `openChatAsyncUnsafe` answers `NotFound` until then — try again.
 
+## For the fronts: the driver's own canister (U-45)
+
+Internet Identity gives one person a different principal on every origin. The demo lease is
+taken on the rider's site; the driver signs in on the canister's own front
+(`https://<canister>.icp0.io`) with another principal. A fresh lease answers a one-time
+claim code (15 min, single use; the core keeps only its sha256) that hands the canister to
+whoever claims it there (`fabryka.md` F-20).
+
+```ts
+import { DriverCanistersActor, claimLinkOf, claimCodeOfHash } from "@jsm-mit/tigi-sharded-package";
+
+// The rider's site (the lease holder).
+const canisters = new DriverCanistersActor(coordinatorId, identity, { host });
+const lease = await canisters.leaseDemoAsyncUnsafe();       // { kind: "leased", canister, claim? } | { kind: "busy", untilMs }
+if (lease.kind === "leased" && lease.claim) {
+    link = claimLinkOf(lease.canister.canisterId, lease.claim.code);   // "Otwórz swój kanister"
+}
+const fresh = await canisters.newClaimCodeAsyncUnsafe();    // "Nowy link": the old code stops working
+await canisters.extendDemoAsyncUnsafe();                    // F-8: 15 min more
+await canisters.getMineAsyncUnsafe();                       // the held demo canister (or the own one) | undefined
+
+// The driver's front, signed in as a non-owner, with #claim=<code> in the address.
+const code = claimCodeOfHash(window.location.hash);
+if (code) {
+    await new DriverCanistersActor(coordinatorId, identity, { host }).claimAsyncUnsafe(canisterId, code);
+    // clear the fragment, reload: the driver is the owner now
+}
+```
+
+- A refused claim is always `CanisterError` `NotAuthorized` — wrong, expired, used or not
+  this canister's code alike.
+- The lease stays with its holder: `getMineAsyncUnsafe`, `extendDemoAsyncUnsafe` and
+  `newClaimCodeAsyncUnsafe` keep working from the rider's site; `ownerPrincipal` names
+  the driver after the claim. The chat room of the canister gets the driver as its
+  recipient.
+- The same holder leasing again (no reinstall) gets no code: `newClaimCodeAsyncUnsafe`.
+- These views carry the driver canister's id: it is the driver's own address.
+
 The Test Manager (stage and the test modes): `TestManagerActor.hasSimulatedDriversAsyncUnsafe`,
 `spawnDriversAsyncUnsafe` (12 drivers), `setSpeedUpAsyncUnsafe(request, 10)` before choosing.
 Offers of the simulator have `simulated: true`.
@@ -108,7 +147,9 @@ npm run test-unit          # no replica needed
 npm run test-drivers       # (a) 5 real driver canisters, driver-bots, route-stub
 npm run test-simulator     # (b) the simulator, 20 requests, 20 rides
 npm run test-split         # (c) an area split during traffic
+npm run test-claim         # (d) the demo lease and the claim code (U-45)
 npm run test-smoke         # one whole ride with the simulator (run by publish-public)
+npm run load-local         # the load test: 200 simulated drivers, 100 riders (docs/load-test-2026-10-24.md)
 npm run publish-public     # human-run: publish from master (see below)
 npm run sync-declarations  # after a change of a .did (`… protocol` for the protocol and the simulator only)
 ```
@@ -116,7 +157,9 @@ npm run sync-declarations  # after a change of a .did (`… protocol` for the pr
 The end-to-end suites run on the LOCAL replica only (`scripts/run-tests-local.sh`): a fresh
 group, local cycles, the driver and simulator wasms of `../../tigi-driver-rust` (built
 there, never changed). Logs and measurements go to `/tmp/claude-1000/tigi/`
-(`TEST_LOG_DIR`).
+(`TEST_LOG_DIR`). The load test builds its group with its own coordinator
+(`tigi-sharded-coordinator-load`), so the shared local group stays; its settings are
+environment variables (`scripts/load-local.ts`, `scripts/run-load-local.sh`).
 
 ## Publishing
 

package/declarations/core/core.did

@@ -40,54 +40,58 @@ type TigiCore =
    /// Admins: an admin more (the coordinator adds the people who rule the group).
    addAdmin: (args: PrincipalArgs) -> (Result_2);
    /// Admins: a canister the core controls joins the demo pool (U-35).
-   addPoolCanister: (args: CanisterArgs) -> (Result_16);
+   addPoolCanister: (args: CanisterArgs) -> (Result_17);
    /// Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
    /// drop it at once (WO-2).
    blockDriver: (args: BlockDriverArgs) -> (Result_2);
    /// Admins: a rider is blocked (core.md, accepted 2026-10-22).
    blockRider: (args: BlockRiderArgs) -> (Result_2);
+   /// F-20 (U-45): the caller — the driver signed in on the canister's own front — takes
+   /// over the demo canister with the code of the link. Single use, 15 min; every refusal
+   /// answers the same NotAuthorized. The room of the canister gets the caller (C-15).
+   claimDriverCanister: (args: ClaimArgs) -> (Result_17);
    clearLogs: () -> ();
    /// Admins: the chunks become THE module of their kind. A new driver wasm is released
    /// (F-11) and its hash goes to the workers.
-   commitDriverWasm: (args: WasmCommitArgs) -> (Result_22);
+   commitDriverWasm: (args: WasmCommitArgs) -> (Result_23);
    /// Admins, localTest: an empty canister from the core's cycles joins the demo pool.
-   createLocalPoolCanister: () -> (Result_16);
+   createLocalPoolCanister: () -> (Result_17);
    /// F-2 … F-4, F-10: the caller's own driver canister (localTest: from the core's cycles).
-   createMyDriverCanister: () -> (Result_16);
+   createMyDriverCanister: () -> (Result_17);
    /// Admins: the simulator, created once (F-18).
-   ensureSimulator: () -> (Result_21);
+   ensureSimulator: () -> (Result_22);
    /// F-8: 15 min more for the holder of a demo canister.
-   extendDemoLease: () -> (Result_16);
-   getAdmins: () -> (Result_20) query;
+   extendDemoLease: () -> (Result_17);
+   getAdmins: () -> (Result_21) query;
    /// For the fronts (through the package): where the chat of this environment is. Null =
    /// no chat here yet. The room of a driver is `ChatRoomFunctions.driverRoomId`.
    getChatConfig: () -> (opt ChatConfig) query;
    /// Admins: how far the driver rooms are (C-15).
-   getChatRoomsStatus: () -> (Result_19) query;
+   getChatRoomsStatus: () -> (Result_20) query;
    /// WO-1, WO-2: what the core knows of a canister — for the workers and anybody.
    getDriverCanisterStatus: (args: CanisterArgs) ->
     (DriverCanisterStatus) query;
-   getDriverRollout: () -> (Result_18) query;
-   getFactoryStatus: () -> (Result_17) query;
+   getDriverRollout: () -> (Result_19) query;
+   getFactoryStatus: () -> (Result_18) query;
    getLogs: () -> (text) query;
    /// The caller's own canister, or the demo canister the caller holds now.
-   getMyDriverCanister: () -> (Result_16) query;
+   getMyDriverCanister: () -> (Result_17) query;
    getMyProfile: () -> (Result_4) query;
    /// C-16, PF-4: the caller's own rating as a rider (sum and count of stars; null = no
    /// rating yet). Ratings reach the core in the workers' batches, up to a minute late.
-   getMyRating: () -> (Result_15) query;
+   getMyRating: () -> (Result_16) query;
    /// C-8: the caller's rides, newest first.
-   getMyRides: (args: RidesPageArgs) -> (Result_14) query;
+   getMyRides: (args: RidesPageArgs) -> (Result_15) query;
    /// C-3: the names of up to MAX_PROFILES_PER_CALL principals; unknown ones are left out.
-   getProfiles: (args: ProfilesArgs) -> (Result_13) query;
+   getProfiles: (args: ProfilesArgs) -> (Result_14) query;
    /// F-11: the driver wasms released so far, oldest first.
    getReleasedDriverWasms: () -> (vec ReleasedWasm) query;
    /// F-18: the simulator of this group; none in prod or before ensureSimulator.
    getSimulator: () -> (opt principal) query;
    /// Admins: the coordinator, the workers confirmed so far, the mode.
-   getWiring: () -> (Result_12) query;
+   getWiring: () -> (Result_13) query;
    /// Admins: how far the outbox to the workers is (C-6, C-7).
-   getWorkerOutbox: () -> (Result_11) query;
+   getWorkerOutbox: () -> (Result_12) query;
    /// Workers of the group: the core asks the coordinator once and remembers the worker,
    /// which then gets the network state through the outbox. A worker calls it once after
    /// its install. Answers true.
@@ -95,23 +99,30 @@ type TigiCore =
    /// Workers of the group: finished rides and ratings, at most MAX_RIDE_BATCH (C-4, C-5).
    /// Idempotent: a known requestId and a counted rating count once. Invalid entries are
    /// rejected and logged; the worker drops the whole batch after an ok.
-   ingestRideBatch: (batch: RideBatch) -> (Result_10);
+   ingestRideBatch: (batch: RideBatch) -> (Result_11);
    /// C-14: the accounts gate of the chat (U-43). The chat core asks this group's
    /// coordinator WHERE (`accountsCanisterFor` → this core) and asks here: true = an
    /// account with a name exists for the principal and the rider is not blocked.
    isUser: ("principal": principal) -> (bool) query;
-   /// F-5 … F-7: a demo canister for 15 min (outside prod).
-   leaseDemoDriverCanister: () -> (Result_9);
-   listBlocks: (args: PageArgs) -> (Result_8) query;
-   listDriverCanisters: (args: PageArgs) -> (Result_7) query;
+   /// F-5 … F-7: a demo canister for 15 min (outside prod). A fresh lease comes with a
+   /// one-time claim code (F-20, U-45).
+   leaseDemoDriverCanister: () -> (Result_10);
+   listBlocks: (args: PageArgs) -> (Result_9) query;
+   listDriverCanisters: (args: PageArgs) -> (Result_8) query;
    /// Admins: the driver rooms as the core wants them, 100 a page at most.
-   listDriverRooms: (args: PageArgs) -> (Result_6) query;
+   listDriverRooms: (args: PageArgs) -> (Result_7) query;
+   /// F-20: a fresh claim code for the caller's running demo lease; the old one stops
+   /// working.
+   newClaimCode: () -> (Result_6);
    removeAdmin: (args: PrincipalArgs) -> (Result_2);
    resumeDriverRollout: () -> (Result_3);
    /// Admins: the chat of this environment — the chat group's coordinator and the project
    /// (whose admin and accounts field are this group's coordinator). Every call sends every
    /// driver room again (a new project, a chat group set up again).
    setChatConfig: (args: ChatConfig) -> (Result_5);
+   /// Admins, localTest only: new claim codes live this long (the local check of an
+   /// expired code). Heap only: an upgrade brings back 15 min.
+   setClaimCodeTtl: (args: ClaimTtlArgs) -> (Result);
    setLoggingEnabled: (enabled: bool) -> (Result_2);
    /// The coordinator only: the balance below which the core asks for cycles.
    setLowCyclesBelow: (value: nat) -> (Result_2);
@@ -194,22 +205,22 @@ type RideBatch =
 type Result_9 = 
  variant {
    err: Error;
-   ok: LeaseAnswer;
+   ok: vec Block;
  };
 type Result_8 = 
  variant {
    err: Error;
-   ok: vec Block;
+   ok: DriverCanistersPage;
  };
 type Result_7 = 
  variant {
    err: Error;
-   ok: DriverCanistersPage;
+   ok: vec DriverRoomView;
  };
 type Result_6 = 
  variant {
    err: Error;
-   ok: vec DriverRoomView;
+   ok: ClaimCode;
  };
 type Result_5 = 
  variant {
@@ -226,67 +237,67 @@ type Result_3 =
    err: Error;
    ok: RolloutView;
  };
-type Result_22 = 
+type Result_23 = 
  variant {
    err: Error;
    ok: WasmInfo;
  };
-type Result_21 = 
+type Result_22 = 
  variant {
    err: Error;
    ok: principal;
  };
-type Result_20 = 
+type Result_21 = 
  variant {
    err: Error;
    ok: vec principal;
  };
-type Result_2 = 
+type Result_20 = 
  variant {
    err: Error;
-   ok: bool;
+   ok: ChatRoomsStatus;
  };
-type Result_19 = 
+type Result_2 = 
  variant {
    err: Error;
-   ok: ChatRoomsStatus;
+   ok: bool;
  };
-type Result_18 = 
+type Result_19 = 
  variant {
    err: Error;
    ok: opt RolloutView;
  };
-type Result_17 = 
+type Result_18 = 
  variant {
    err: Error;
    ok: FactoryStatus;
  };
-type Result_16 = 
+type Result_17 = 
  variant {
    err: Error;
    ok: DriverCanister;
  };
-type Result_15 = 
+type Result_16 = 
  variant {
    err: Error;
    ok: opt Rating;
  };
-type Result_14 = 
+type Result_15 = 
  variant {
    err: Error;
    ok: RidesPage;
  };
-type Result_13 = 
+type Result_14 = 
  variant {
    err: Error;
    ok: vec ProfileEntry;
  };
-type Result_12 = 
+type Result_13 = 
  variant {
    err: Error;
    ok: Wiring;
  };
-type Result_11 = 
+type Result_12 = 
  variant {
    err: Error;
    ok:
@@ -297,11 +308,16 @@ type Result_11 =
       subjects: nat;
     };
  };
-type Result_10 = 
+type Result_11 = 
  variant {
    err: Error;
    ok: RideBatchResult;
  };
+type Result_10 = 
+ variant {
+   err: Error;
+   ok: LeaseAnswer;
+ };
 type Result_1 = 
  variant {
    err: Error;
@@ -367,10 +383,22 @@ type Mode =
    stage;
    test;
  };
+type LeasedCanister = 
+ record {
+   blocked: bool;
+   canister: principal;
+   claim: opt ClaimCode;
+   createdAtNs: int;
+   installedAtNs: opt int;
+   kind: DriverCanisterKind;
+   leaseUntilNs: opt int;
+   moduleHash: opt blob;
+   owner: principal;
+ };
 type LeaseAnswer = 
  variant {
    busy: record {untilNs: int;};
-   leased: DriverCanister;
+   leased: LeasedCanister;
  };
 type InitArgs = 
  record {
@@ -441,6 +469,18 @@ type DriverCanister =
    moduleHash: opt blob;
    owner: principal;
  };
+type ClaimTtlArgs = record {seconds: nat;};
+type ClaimCode = 
+ record {
+   canister: principal;
+   code: text;
+   expiresAtNs: int;
+ };
+type ClaimArgs = 
+ record {
+   canister: principal;
+   code: text;
+ };
 type ChatRoomsStatus = 
  record {
    config: opt ChatConfig;

package/declarations/core/core.did.d.ts

@@ -30,6 +30,13 @@ export interface ChatRoomsStatus {
   'pendingSinceNs' : [] | [bigint],
   'rooms' : bigint,
 }
+export interface ClaimArgs { 'code' : string, 'canister' : Principal }
+export interface ClaimCode {
+  'expiresAtNs' : bigint,
+  'code' : string,
+  'canister' : Principal,
+}
+export interface ClaimTtlArgs { 'seconds' : bigint }
 export interface DriverCanister {
   'moduleHash' : [] | [Uint8Array | number[]],
   'owner' : Principal,
@@ -84,7 +91,18 @@ export interface InitArgs {
   'coordinator' : [] | [Principal],
 }
 export type LeaseAnswer = { 'busy' : { 'untilNs' : bigint } } |
-  { 'leased' : DriverCanister };
+  { 'leased' : LeasedCanister };
+export interface LeasedCanister {
+  'moduleHash' : [] | [Uint8Array | number[]],
+  'owner' : Principal,
+  'blocked' : boolean,
+  'kind' : DriverCanisterKind,
+  'claim' : [] | [ClaimCode],
+  'createdAtNs' : bigint,
+  'canister' : Principal,
+  'installedAtNs' : [] | [bigint],
+  'leaseUntilNs' : [] | [bigint],
+}
 export type Mode = { 'localTest' : null } |
   { 'prod' : null } |
   { 'test' : null } |
@@ -119,9 +137,11 @@ export type Result = { 'ok' : bigint } |
   { 'err' : Error };
 export type Result_1 = { 'ok' : Uint8Array | number[] } |
   { 'err' : Error };
-export type Result_10 = { 'ok' : RideBatchResult } |
+export type Result_10 = { 'ok' : LeaseAnswer } |
+  { 'err' : Error };
+export type Result_11 = { 'ok' : RideBatchResult } |
   { 'err' : Error };
-export type Result_11 = {
+export type Result_12 = {
     'ok' : {
       'subjects' : bigint,
       'headSeq' : bigint,
@@ -130,29 +150,29 @@ export type Result_11 = {
     }
   } |
   { 'err' : Error };
-export type Result_12 = { 'ok' : Wiring } |
-  { 'err' : Error };
-export type Result_13 = { 'ok' : Array<ProfileEntry> } |
+export type Result_13 = { 'ok' : Wiring } |
   { 'err' : Error };
-export type Result_14 = { 'ok' : RidesPage } |
+export type Result_14 = { 'ok' : Array<ProfileEntry> } |
   { 'err' : Error };
-export type Result_15 = { 'ok' : [] | [Rating] } |
+export type Result_15 = { 'ok' : RidesPage } |
   { 'err' : Error };
-export type Result_16 = { 'ok' : DriverCanister } |
+export type Result_16 = { 'ok' : [] | [Rating] } |
   { 'err' : Error };
-export type Result_17 = { 'ok' : FactoryStatus } |
+export type Result_17 = { 'ok' : DriverCanister } |
   { 'err' : Error };
-export type Result_18 = { 'ok' : [] | [RolloutView] } |
+export type Result_18 = { 'ok' : FactoryStatus } |
   { 'err' : Error };
-export type Result_19 = { 'ok' : ChatRoomsStatus } |
+export type Result_19 = { 'ok' : [] | [RolloutView] } |
   { 'err' : Error };
 export type Result_2 = { 'ok' : boolean } |
   { 'err' : Error };
-export type Result_20 = { 'ok' : Array<Principal> } |
+export type Result_20 = { 'ok' : ChatRoomsStatus } |
   { 'err' : Error };
-export type Result_21 = { 'ok' : Principal } |
+export type Result_21 = { 'ok' : Array<Principal> } |
   { 'err' : Error };
-export type Result_22 = { 'ok' : WasmInfo } |
+export type Result_22 = { 'ok' : Principal } |
+  { 'err' : Error };
+export type Result_23 = { 'ok' : WasmInfo } |
   { 'err' : Error };
 export type Result_3 = { 'ok' : RolloutView } |
   { 'err' : Error };
@@ -160,13 +180,13 @@ export type Result_4 = { 'ok' : Profile } |
   { 'err' : Error };
 export type Result_5 = { 'ok' : ChatConfig } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : Array<DriverRoomView> } |
+export type Result_6 = { 'ok' : ClaimCode } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : DriverCanistersPage } |
+export type Result_7 = { 'ok' : Array<DriverRoomView> } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : Array<Block> } |
+export type Result_8 = { 'ok' : DriverCanistersPage } |
   { 'err' : Error };
-export type Result_9 = { 'ok' : LeaseAnswer } |
+export type Result_9 = { 'ok' : Array<Block> } |
   { 'err' : Error };
 export interface RideBatch {
   'ratings' : Array<RatingEntry>,
@@ -229,7 +249,7 @@ export interface TigiCore {
   /**
    * / Admins: a canister the core controls joins the demo pool (U-35).
    */
-  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_16>,
+  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_17>,
   /**
    * / Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
    * / drop it at once (WO-2).
@@ -239,29 +259,35 @@ export interface TigiCore {
    * / Admins: a rider is blocked (core.md, accepted 2026-10-22).
    */
   'blockRider' : ActorMethod<[BlockRiderArgs], Result_2>,
+  /**
+   * / F-20 (U-45): the caller — the driver signed in on the canister's own front — takes
+   * / over the demo canister with the code of the link. Single use, 15 min; every refusal
+   * / answers the same NotAuthorized. The room of the canister gets the caller (C-15).
+   */
+  'claimDriverCanister' : ActorMethod<[ClaimArgs], Result_17>,
   'clearLogs' : ActorMethod<[], undefined>,
   /**
    * / Admins: the chunks become THE module of their kind. A new driver wasm is released
    * / (F-11) and its hash goes to the workers.
    */
-  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_22>,
+  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_23>,
   /**
    * / Admins, localTest: an empty canister from the core's cycles joins the demo pool.
    */
-  'createLocalPoolCanister' : ActorMethod<[], Result_16>,
+  'createLocalPoolCanister' : ActorMethod<[], Result_17>,
   /**
    * / F-2 … F-4, F-10: the caller's own driver canister (localTest: from the core's cycles).
    */
-  'createMyDriverCanister' : ActorMethod<[], Result_16>,
+  'createMyDriverCanister' : ActorMethod<[], Result_17>,
   /**
    * / Admins: the simulator, created once (F-18).
    */
-  'ensureSimulator' : ActorMethod<[], Result_21>,
+  'ensureSimulator' : ActorMethod<[], Result_22>,
   /**
    * / F-8: 15 min more for the holder of a demo canister.
    */
-  'extendDemoLease' : ActorMethod<[], Result_16>,
-  'getAdmins' : ActorMethod<[], Result_20>,
+  'extendDemoLease' : ActorMethod<[], Result_17>,
+  'getAdmins' : ActorMethod<[], Result_21>,
   /**
    * / For the fronts (through the package): where the chat of this environment is. Null =
    * / no chat here yet. The room of a driver is `ChatRoomFunctions.driverRoomId`.
@@ -270,32 +296,32 @@ export interface TigiCore {
   /**
    * / Admins: how far the driver rooms are (C-15).
    */
-  'getChatRoomsStatus' : ActorMethod<[], Result_19>,
+  'getChatRoomsStatus' : ActorMethod<[], Result_20>,
   /**
    * / WO-1, WO-2: what the core knows of a canister — for the workers and anybody.
    */
   'getDriverCanisterStatus' : ActorMethod<[CanisterArgs], DriverCanisterStatus>,
-  'getDriverRollout' : ActorMethod<[], Result_18>,
-  'getFactoryStatus' : ActorMethod<[], Result_17>,
+  'getDriverRollout' : ActorMethod<[], Result_19>,
+  'getFactoryStatus' : ActorMethod<[], Result_18>,
   'getLogs' : ActorMethod<[], string>,
   /**
    * / The caller's own canister, or the demo canister the caller holds now.
    */
-  'getMyDriverCanister' : ActorMethod<[], Result_16>,
+  'getMyDriverCanister' : ActorMethod<[], Result_17>,
   'getMyProfile' : ActorMethod<[], Result_4>,
   /**
    * / C-16, PF-4: the caller's own rating as a rider (sum and count of stars; null = no
    * / rating yet). Ratings reach the core in the workers' batches, up to a minute late.
    */
-  'getMyRating' : ActorMethod<[], Result_15>,
+  'getMyRating' : ActorMethod<[], Result_16>,
   /**
    * / C-8: the caller's rides, newest first.
    */
-  'getMyRides' : ActorMethod<[RidesPageArgs], Result_14>,
+  'getMyRides' : ActorMethod<[RidesPageArgs], Result_15>,
   /**
    * / C-3: the names of up to MAX_PROFILES_PER_CALL principals; unknown ones are left out.
    */
-  'getProfiles' : ActorMethod<[ProfilesArgs], Result_13>,
+  'getProfiles' : ActorMethod<[ProfilesArgs], Result_14>,
   /**
    * / F-11: the driver wasms released so far, oldest first.
    */
@@ -307,11 +333,11 @@ export interface TigiCore {
   /**
    * / Admins: the coordinator, the workers confirmed so far, the mode.
    */
-  'getWiring' : ActorMethod<[], Result_12>,
+  'getWiring' : ActorMethod<[], Result_13>,
   /**
    * / Admins: how far the outbox to the workers is (C-6, C-7).
    */
-  'getWorkerOutbox' : ActorMethod<[], Result_11>,
+  'getWorkerOutbox' : ActorMethod<[], Result_12>,
   /**
    * / Workers of the group: the core asks the coordinator once and remembers the worker,
    * / which then gets the network state through the outbox. A worker calls it once after
@@ -323,7 +349,7 @@ export interface TigiCore {
    * / Idempotent: a known requestId and a counted rating count once. Invalid entries are
    * / rejected and logged; the worker drops the whole batch after an ok.
    */
-  'ingestRideBatch' : ActorMethod<[RideBatch], Result_10>,
+  'ingestRideBatch' : ActorMethod<[RideBatch], Result_11>,
   /**
    * / C-14: the accounts gate of the chat (U-43). The chat core asks this group's
    * / coordinator WHERE (`accountsCanisterFor` → this core) and asks here: true = an
@@ -331,15 +357,21 @@ export interface TigiCore {
    */
   'isUser' : ActorMethod<[Principal], boolean>,
   /**
-   * / F-5 … F-7: a demo canister for 15 min (outside prod).
+   * / F-5 … F-7: a demo canister for 15 min (outside prod). A fresh lease comes with a
+   * / one-time claim code (F-20, U-45).
    */
-  'leaseDemoDriverCanister' : ActorMethod<[], Result_9>,
-  'listBlocks' : ActorMethod<[PageArgs], Result_8>,
-  'listDriverCanisters' : ActorMethod<[PageArgs], Result_7>,
+  'leaseDemoDriverCanister' : ActorMethod<[], Result_10>,
+  'listBlocks' : ActorMethod<[PageArgs], Result_9>,
+  'listDriverCanisters' : ActorMethod<[PageArgs], Result_8>,
   /**
    * / Admins: the driver rooms as the core wants them, 100 a page at most.
    */
-  'listDriverRooms' : ActorMethod<[PageArgs], Result_6>,
+  'listDriverRooms' : ActorMethod<[PageArgs], Result_7>,
+  /**
+   * / F-20: a fresh claim code for the caller's running demo lease; the old one stops
+   * / working.
+   */
+  'newClaimCode' : ActorMethod<[], Result_6>,
   'removeAdmin' : ActorMethod<[PrincipalArgs], Result_2>,
   'resumeDriverRollout' : ActorMethod<[], Result_3>,
   /**
@@ -348,6 +380,11 @@ export interface TigiCore {
    * / driver room again (a new project, a chat group set up again).
    */
   'setChatConfig' : ActorMethod<[ChatConfig], Result_5>,
+  /**
+   * / Admins, localTest only: new claim codes live this long (the local check of an
+   * / expired code). Heap only: an upgrade brings back 15 min.
+   */
+  'setClaimCodeTtl' : ActorMethod<[ClaimTtlArgs], Result>,
   'setLoggingEnabled' : ActorMethod<[boolean], Result_2>,
   /**
    * / The coordinator only: the balance below which the core asks for cycles.

package/declarations/core/core.did.js

@@ -61,7 +61,7 @@ export const idlFactory = ({ IDL }) => {
     'installedAtNs' : IDL.Opt(IDL.Int),
     'leaseUntilNs' : IDL.Opt(IDL.Int),
   });
-  const Result_16 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
+  const Result_17 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
   const BlockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
     'canister' : IDL.Principal,
@@ -71,6 +71,10 @@ export const idlFactory = ({ IDL }) => {
     'rider' : IDL.Principal,
     'reason' : IDL.Text,
   });
+  const ClaimArgs = IDL.Record({
+    'code' : IDL.Text,
+    'canister' : IDL.Principal,
+  });
   const WasmKind = IDL.Variant({ 'simulator' : IDL.Null, 'driver' : IDL.Null });
   const WasmCommitArgs = IDL.Record({
     'sha256' : IDL.Vec(IDL.Nat8),
@@ -83,9 +87,9 @@ export const idlFactory = ({ IDL }) => {
     'size' : IDL.Nat,
     'committedAtNs' : IDL.Int,
   });
-  const Result_22 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
-  const Result_21 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
-  const Result_20 = IDL.Variant({
+  const Result_23 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
+  const Result_22 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
+  const Result_21 = IDL.Variant({
     'ok' : IDL.Vec(IDL.Principal),
     'err' : Error,
   });
@@ -101,13 +105,13 @@ export const idlFactory = ({ IDL }) => {
     'pendingSinceNs' : IDL.Opt(IDL.Int),
     'rooms' : IDL.Nat,
   });
-  const Result_19 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
+  const Result_20 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
   const DriverCanisterStatus = IDL.Record({
     'moduleHash' : IDL.Opt(IDL.Vec(IDL.Nat8)),
     'blocked' : IDL.Bool,
     'registered' : IDL.Bool,
   });
-  const Result_18 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
+  const Result_19 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
   const FactoryStatus = IDL.Record({
     'simulator' : IDL.Opt(IDL.Principal),
     'mode' : Mode,
@@ -119,7 +123,7 @@ export const idlFactory = ({ IDL }) => {
     'driverWasm' : IDL.Opt(WasmInfo),
     'registered' : IDL.Nat,
   });
-  const Result_17 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
+  const Result_18 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
   const Profile = IDL.Record({
     'updatedAtNs' : IDL.Int,
     'name' : IDL.Text,
@@ -127,7 +131,7 @@ export const idlFactory = ({ IDL }) => {
   });
   const Result_4 = IDL.Variant({ 'ok' : Profile, 'err' : Error });
   const Rating = IDL.Record({ 'sum' : IDL.Nat, 'count' : IDL.Nat });
-  const Result_15 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
+  const Result_16 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
   const RidesPageArgs = IDL.Record({
     'beforeIndex' : IDL.Opt(IDL.Nat),
     'limit' : IDL.Nat,
@@ -151,13 +155,13 @@ export const idlFactory = ({ IDL }) => {
     'nextBeforeIndex' : IDL.Opt(IDL.Nat),
     'rides' : IDL.Vec(RideEntry),
   });
-  const Result_14 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
+  const Result_15 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
   const ProfilesArgs = IDL.Record({ 'principals' : IDL.Vec(IDL.Principal) });
   const ProfileEntry = IDL.Record({
     'principal' : IDL.Principal,
     'name' : IDL.Text,
   });
-  const Result_13 = IDL.Variant({
+  const Result_14 = IDL.Variant({
     'ok' : IDL.Vec(ProfileEntry),
     'err' : Error,
   });
@@ -171,8 +175,8 @@ export const idlFactory = ({ IDL }) => {
     'knownWorkers' : IDL.Vec(IDL.Principal),
     'coordinator' : IDL.Opt(IDL.Principal),
   });
-  const Result_12 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
-  const Result_11 = IDL.Variant({
+  const Result_13 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
+  const Result_12 = IDL.Variant({
     'ok' : IDL.Record({
       'subjects' : IDL.Nat,
       'headSeq' : IDL.Nat64,
@@ -203,12 +207,28 @@ export const idlFactory = ({ IDL }) => {
     'rejected' : IDL.Nat,
     'ratingsCounted' : IDL.Nat,
   });
-  const Result_10 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const Result_11 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const ClaimCode = IDL.Record({
+    'expiresAtNs' : IDL.Int,
+    'code' : IDL.Text,
+    'canister' : IDL.Principal,
+  });
+  const LeasedCanister = IDL.Record({
+    'moduleHash' : IDL.Opt(IDL.Vec(IDL.Nat8)),
+    'owner' : IDL.Principal,
+    'blocked' : IDL.Bool,
+    'kind' : DriverCanisterKind,
+    'claim' : IDL.Opt(ClaimCode),
+    'createdAtNs' : IDL.Int,
+    'canister' : IDL.Principal,
+    'installedAtNs' : IDL.Opt(IDL.Int),
+    'leaseUntilNs' : IDL.Opt(IDL.Int),
+  });
   const LeaseAnswer = IDL.Variant({
     'busy' : IDL.Record({ 'untilNs' : IDL.Int }),
-    'leased' : DriverCanister,
+    'leased' : LeasedCanister,
   });
-  const Result_9 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
+  const Result_10 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
   const PageArgs = IDL.Record({ 'offset' : IDL.Nat, 'limit' : IDL.Nat });
   const BlockTarget = IDL.Variant({
     'driverCanister' : IDL.Principal,
@@ -224,12 +244,12 @@ export const idlFactory = ({ IDL }) => {
     'target' : BlockTarget,
     'reason' : IDL.Text,
   });
-  const Result_8 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
+  const Result_9 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
   const DriverCanistersPage = IDL.Record({
     'total' : IDL.Nat,
     'canisters' : IDL.Vec(DriverCanister),
   });
-  const Result_7 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const Result_8 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
   const DriverRoomView = IDL.Record({
     'recipient' : IDL.Principal,
     'driverKey' : IDL.Text,
@@ -238,11 +258,14 @@ export const idlFactory = ({ IDL }) => {
     'roomId' : IDL.Text,
     'synced' : IDL.Bool,
   });
-  const Result_6 = IDL.Variant({
+  const Result_7 = IDL.Variant({
     'ok' : IDL.Vec(DriverRoomView),
     'err' : Error,
   });
+  const Result_6 = IDL.Variant({ 'ok' : ClaimCode, 'err' : Error });
   const Result_5 = IDL.Variant({ 'ok' : ChatConfig, 'err' : Error });
+  const ClaimTtlArgs = IDL.Record({ 'seconds' : IDL.Nat });
+  const Result = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
   const SetProfileArgs = IDL.Record({ 'name' : IDL.Text });
   const UnblockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
@@ -255,49 +278,51 @@ export const idlFactory = ({ IDL }) => {
     'bytes' : IDL.Vec(IDL.Nat8),
     'index' : IDL.Nat32,
   });
-  const Result = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
   const TigiCore = IDL.Service({
     'abortDriverRollout' : IDL.Func([], [Result_3], []),
     'addAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
-    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_16], []),
+    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_17], []),
     'blockDriver' : IDL.Func([BlockDriverArgs], [Result_2], []),
     'blockRider' : IDL.Func([BlockRiderArgs], [Result_2], []),
+    'claimDriverCanister' : IDL.Func([ClaimArgs], [Result_17], []),
     'clearLogs' : IDL.Func([], [], []),
-    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_22], []),
-    'createLocalPoolCanister' : IDL.Func([], [Result_16], []),
-    'createMyDriverCanister' : IDL.Func([], [Result_16], []),
-    'ensureSimulator' : IDL.Func([], [Result_21], []),
-    'extendDemoLease' : IDL.Func([], [Result_16], []),
-    'getAdmins' : IDL.Func([], [Result_20], ['query']),
+    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_23], []),
+    'createLocalPoolCanister' : IDL.Func([], [Result_17], []),
+    'createMyDriverCanister' : IDL.Func([], [Result_17], []),
+    'ensureSimulator' : IDL.Func([], [Result_22], []),
+    'extendDemoLease' : IDL.Func([], [Result_17], []),
+    'getAdmins' : IDL.Func([], [Result_21], ['query']),
     'getChatConfig' : IDL.Func([], [IDL.Opt(ChatConfig)], ['query']),
-    'getChatRoomsStatus' : IDL.Func([], [Result_19], ['query']),
+    'getChatRoomsStatus' : IDL.Func([], [Result_20], ['query']),
     'getDriverCanisterStatus' : IDL.Func(
         [CanisterArgs],
         [DriverCanisterStatus],
         ['query'],
       ),
-    'getDriverRollout' : IDL.Func([], [Result_18], ['query']),
-    'getFactoryStatus' : IDL.Func([], [Result_17], ['query']),
+    'getDriverRollout' : IDL.Func([], [Result_19], ['query']),
+    'getFactoryStatus' : IDL.Func([], [Result_18], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
-    'getMyDriverCanister' : IDL.Func([], [Result_16], ['query']),
+    'getMyDriverCanister' : IDL.Func([], [Result_17], ['query']),
     'getMyProfile' : IDL.Func([], [Result_4], ['query']),
-    'getMyRating' : IDL.Func([], [Result_15], ['query']),
-    'getMyRides' : IDL.Func([RidesPageArgs], [Result_14], ['query']),
-    'getProfiles' : IDL.Func([ProfilesArgs], [Result_13], ['query']),
+    'getMyRating' : IDL.Func([], [Result_16], ['query']),
+    'getMyRides' : IDL.Func([RidesPageArgs], [Result_15], ['query']),
+    'getProfiles' : IDL.Func([ProfilesArgs], [Result_14], ['query']),
     'getReleasedDriverWasms' : IDL.Func([], [IDL.Vec(ReleasedWasm)], ['query']),
     'getSimulator' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
-    'getWiring' : IDL.Func([], [Result_12], ['query']),
-    'getWorkerOutbox' : IDL.Func([], [Result_11], ['query']),
+    'getWiring' : IDL.Func([], [Result_13], ['query']),
+    'getWorkerOutbox' : IDL.Func([], [Result_12], ['query']),
     'helloFromWorker' : IDL.Func([], [Result_2], []),
-    'ingestRideBatch' : IDL.Func([RideBatch], [Result_10], []),
+    'ingestRideBatch' : IDL.Func([RideBatch], [Result_11], []),
     'isUser' : IDL.Func([IDL.Principal], [IDL.Bool], ['query']),
-    'leaseDemoDriverCanister' : IDL.Func([], [Result_9], []),
-    'listBlocks' : IDL.Func([PageArgs], [Result_8], ['query']),
-    'listDriverCanisters' : IDL.Func([PageArgs], [Result_7], ['query']),
-    'listDriverRooms' : IDL.Func([PageArgs], [Result_6], ['query']),
+    'leaseDemoDriverCanister' : IDL.Func([], [Result_10], []),
+    'listBlocks' : IDL.Func([PageArgs], [Result_9], ['query']),
+    'listDriverCanisters' : IDL.Func([PageArgs], [Result_8], ['query']),
+    'listDriverRooms' : IDL.Func([PageArgs], [Result_7], ['query']),
+    'newClaimCode' : IDL.Func([], [Result_6], []),
     'removeAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
     'resumeDriverRollout' : IDL.Func([], [Result_3], []),
     'setChatConfig' : IDL.Func([ChatConfig], [Result_5], []),
+    'setClaimCodeTtl' : IDL.Func([ClaimTtlArgs], [Result], []),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_2], []),
     'setLowCyclesBelow' : IDL.Func([IDL.Nat], [Result_2], []),
     'setMyProfile' : IDL.Func([SetProfileArgs], [Result_4], []),

package/dist/actors/driver-canisters-actor.d.ts

@@ -0,0 +1,77 @@
+import type { Identity } from "@icp-sdk/core/agent";
+import type { ClaimCode as CandidClaimCode, DriverCanister as CandidDriverCanister } from "../../declarations/core/core.did.js";
+import { type GroupOptions } from "../group/canister-actor.js";
+import type { ClaimCodeView, DemoLeaseView, DriverCanisterView } from "../interfaces.js";
+/** The fragment key of a claim link: `https://<canister>.icp0.io/#claim=<code>`. */
+export declare const CLAIM_FRAGMENT_KEY = "claim";
+/** F-20a: a code is 32 characters of base64url; the core refuses more than this. */
+export declare const MAX_CLAIM_CODE_CHARS = 64;
+/**
+ * F-20: the link the rider's site shows after a lease ("Otwórz swój kanister"). The code
+ * rides in the fragment, which the browser never sends to a server.
+ * @param frontOrigin the origin of the driver canister's front; default `https://<canister>.icp0.io`
+ */
+export declare function claimLinkOf(canisterId: string, code: string, frontOrigin?: string): string;
+/**
+ * F-20: the claim code in a location hash (`#claim=<code>`, also among other `&` parts), or
+ * undefined. The driver's front clears the fragment after the claim.
+ */
+export declare function claimCodeOfHash(hash: string): string | undefined;
+/** @internal */
+export declare function driverCanisterOf(record: Pick<CandidDriverCanister, "canister" | "owner" | "kind" | "leaseUntilNs" | "blocked">): DriverCanisterView;
+/** @internal */
+export declare function claimCodeOf(claim: CandidClaimCode): ClaimCodeView;
+export declare class DriverCanistersActor {
+    private readonly group;
+    constructor(coordinatorId: string, identity: Identity, options?: GroupOptions);
+    /**
+     * F-5 … F-7, F-20a: a demo canister for 15 minutes, reinstalled with the caller as its
+     * owner — or the caller's lease already (no reinstall, no code: `newClaimCodeAsyncUnsafe`).
+     * @returns `leased` with `claim` after a fresh lease (undefined when the core could make
+     *          no code — ask `newClaimCodeAsyncUnsafe`); `busy` with the time the pool frees up
+     * @throws Error with message `CanisterError` — `NotAuthorized` (prod), `NotFound` (no pool),
+     *         `InvalidData` (no driver wasm), `RemoteCanisterError` (the install failed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    leaseDemoAsyncUnsafe(): Promise<DemoLeaseView>;
+    /**
+     * F-8: 15 minutes more for the holder of the demo canister (at most 30 ahead), also after
+     * the end while nobody took it over. The owner stays (F-20f).
+     * @throws Error with message `CanisterError` — `NotFound` (no lease of the caller), `InvalidData` (being installed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    extendDemoAsyncUnsafe(): Promise<DriverCanisterView>;
+    /**
+     * The caller's own driver canister, or the demo canister the caller holds now (as the
+     * lease holder — after a claim the canister's owner is the driver, `ownerPrincipal`).
+     * @returns undefined when the caller has none
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getMineAsyncUnsafe(): Promise<DriverCanisterView | undefined>;
+    /**
+     * F-20c: a new claim code for the caller's running demo lease ("Nowy link"); the code
+     * before it stops working. Good for 15 minutes, once.
+     * @throws Error with message `CanisterError` — `NotFound` (no running lease of the caller),
+     *         `InvalidData` (being installed), `RemoteCanisterError` (no randomness — try again)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    newClaimCodeAsyncUnsafe(): Promise<ClaimCodeView>;
+    /**
+     * F-20d, F-20e: the caller — the driver signed in on the canister's own front — takes
+     * over the demo canister with the code of the link. The canister's owner becomes the
+     * caller, and so does the recipient of its chat room; the lease stays with its holder.
+     * @returns the canister with the caller as `ownerPrincipal`
+     * @throws Error with message `CanisterError` — `NotAuthorized` (the code is wrong, expired,
+     *         used, or not for this canister — one answer for all), `InvalidData` (the canister
+     *         is busy — try again), `RemoteCanisterError` (the driver canister did not take it;
+     *         the code stays good)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    claimAsyncUnsafe(canisterId: string, code: string): Promise<DriverCanisterView>;
+}
+//# sourceMappingURL=driver-canisters-actor.d.ts.map

package/dist/actors/driver-canisters-actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-canisters-actor.d.ts","sourceRoot":"","sources":["../../src/actors/driver-canisters-actor.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChI,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGzF,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,MAAwC,GAAG,MAAM,CAE3H;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBhE;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC,GAAG,kBAAkB,CAUnJ;AAED,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAEjE;AAED,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIjF;;;;;;;;;OASG;IACU,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC;IAS3D;;;;;;OAMG;IACU,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIjE;;;;;;OAMG;IACU,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAS1E;;;;;;;OAOG;IACU,uBAAuB,IAAI,OAAO,CAAC,aAAa,CAAC;IAI9D;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAU/F"}

package/dist/actors/driver-canisters-actor.js

@@ -0,0 +1,147 @@
+// The driver canister of the signed-in person in the core's factory (fabryka.md F-5 … F-8,
+// F-20; U-45): the demo lease, its extension, "mine", and the one-time claim code that hands
+// a demo canister over to the driver's principal on the canister's own front.
+//
+// Internet Identity gives one person a different principal on every origin: the lease is
+// taken on the rider's site, the driver signs in on `https://<canister>.icp0.io`. The
+// rider's site shows the link `claimLinkOf(canisterId, code)`; the driver's front reads the
+// code with `claimCodeOfHash(location.hash)` and calls `claimAsyncUnsafe` as the driver.
+//
+// The driver canister's id is the driver's own address (the link of his front), so these
+// views carry it — unlike the rider's views of other drivers (U-14).
+import { Principal } from "@icp-sdk/core/principal";
+import { errorKeyOf, executeAsyncUnsafe } from "../group/canister-actor.js";
+import { TigiGroup } from "../group/group.js";
+import { msOf } from "../mappers.js";
+/** The fragment key of a claim link: `https://<canister>.icp0.io/#claim=<code>`. */
+export const CLAIM_FRAGMENT_KEY = "claim";
+/** F-20a: a code is 32 characters of base64url; the core refuses more than this. */
+export const MAX_CLAIM_CODE_CHARS = 64;
+/**
+ * F-20: the link the rider's site shows after a lease ("Otwórz swój kanister"). The code
+ * rides in the fragment, which the browser never sends to a server.
+ * @param frontOrigin the origin of the driver canister's front; default `https://<canister>.icp0.io`
+ */
+export function claimLinkOf(canisterId, code, frontOrigin = `https://${canisterId}.icp0.io`) {
+    return `${frontOrigin}/#${CLAIM_FRAGMENT_KEY}=${encodeURIComponent(code)}`;
+}
+/**
+ * F-20: the claim code in a location hash (`#claim=<code>`, also among other `&` parts), or
+ * undefined. The driver's front clears the fragment after the claim.
+ */
+export function claimCodeOfHash(hash) {
+    const text = hash.startsWith("#") ? hash.slice(1) : hash;
+    for (const part of text.split("&")) {
+        const [key, ...rest] = part.split("=");
+        if (key !== CLAIM_FRAGMENT_KEY)
+            continue;
+        let code;
+        try {
+            code = decodeURIComponent(rest.join("="));
+        }
+        catch {
+            return undefined;
+        }
+        return code.length > 0 && code.length <= MAX_CLAIM_CODE_CHARS && /^[A-Za-z0-9_-]+$/.test(code) ? code : undefined;
+    }
+    return undefined;
+}
+/** @internal */
+export function driverCanisterOf(record) {
+    const until = record.leaseUntilNs[0];
+    return {
+        canisterId: record.canister.toText(),
+        kind: "pool" in record.kind ? "pool" : "own",
+        ownerPrincipal: record.owner.toText(),
+        leaseUntilMs: until === undefined ? undefined : msOf(BigInt(until)),
+        blocked: record.blocked,
+    };
+}
+/** @internal */
+export function claimCodeOf(claim) {
+    return { canisterId: claim.canister.toText(), code: claim.code, expiresAtMs: msOf(BigInt(claim.expiresAtNs)) };
+}
+export class DriverCanistersActor {
+    group;
+    constructor(coordinatorId, identity, options = {}) {
+        this.group = TigiGroup.of(coordinatorId, identity, options);
+    }
+    /**
+     * F-5 … F-7, F-20a: a demo canister for 15 minutes, reinstalled with the caller as its
+     * owner — or the caller's lease already (no reinstall, no code: `newClaimCodeAsyncUnsafe`).
+     * @returns `leased` with `claim` after a fresh lease (undefined when the core could make
+     *          no code — ask `newClaimCodeAsyncUnsafe`); `busy` with the time the pool frees up
+     * @throws Error with message `CanisterError` — `NotAuthorized` (prod), `NotFound` (no pool),
+     *         `InvalidData` (no driver wasm), `RemoteCanisterError` (the install failed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async leaseDemoAsyncUnsafe() {
+        const answer = await executeAsyncUnsafe(async () => (await this.group.coreAsync()).leaseDemoDriverCanister());
+        if ("busy" in answer)
+            return { kind: "busy", untilMs: msOf(BigInt(answer.busy.untilNs)) };
+        const leased = answer.leased;
+        const claim = leased.claim[0];
+        return { kind: "leased", canister: driverCanisterOf(leased), claim: claim === undefined ? undefined : claimCodeOf(claim) };
+    }
+    /**
+     * F-8: 15 minutes more for the holder of the demo canister (at most 30 ahead), also after
+     * the end while nobody took it over. The owner stays (F-20f).
+     * @throws Error with message `CanisterError` — `NotFound` (no lease of the caller), `InvalidData` (being installed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async extendDemoAsyncUnsafe() {
+        return driverCanisterOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).extendDemoLease()));
+    }
+    /**
+     * The caller's own driver canister, or the demo canister the caller holds now (as the
+     * lease holder — after a claim the canister's owner is the driver, `ownerPrincipal`).
+     * @returns undefined when the caller has none
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async getMineAsyncUnsafe() {
+        try {
+            return driverCanisterOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).getMyDriverCanister()));
+        }
+        catch (err) {
+            if (errorKeyOf(err) === "NotFound")
+                return undefined;
+            throw err;
+        }
+    }
+    /**
+     * F-20c: a new claim code for the caller's running demo lease ("Nowy link"); the code
+     * before it stops working. Good for 15 minutes, once.
+     * @throws Error with message `CanisterError` — `NotFound` (no running lease of the caller),
+     *         `InvalidData` (being installed), `RemoteCanisterError` (no randomness — try again)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async newClaimCodeAsyncUnsafe() {
+        return claimCodeOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).newClaimCode()));
+    }
+    /**
+     * F-20d, F-20e: the caller — the driver signed in on the canister's own front — takes
+     * over the demo canister with the code of the link. The canister's owner becomes the
+     * caller, and so does the recipient of its chat room; the lease stays with its holder.
+     * @returns the canister with the caller as `ownerPrincipal`
+     * @throws Error with message `CanisterError` — `NotAuthorized` (the code is wrong, expired,
+     *         used, or not for this canister — one answer for all), `InvalidData` (the canister
+     *         is busy — try again), `RemoteCanisterError` (the driver canister did not take it;
+     *         the code stays good)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async claimAsyncUnsafe(canisterId, code) {
+        let canister;
+        try {
+            canister = Principal.fromText(canisterId);
+        }
+        catch {
+            throw new Error("CanisterError", { cause: { errorKey: "InvalidData", errorMessage: "not a canister id", logs: [] } });
+        }
+        return driverCanisterOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).claimDriverCanister({ canister, code })));
+    }
+}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { MAINNET_HOST, STOPPED_RETRY_ATTEMPTS, canisterError, errorKeyOf, isCani
 export { RidesActor, RideRequest, refusalKeyOf, REFRESH_WAIT_MS, REQUEST_POLL_MS, RIDE_POLL_MS, RIDE_POLL_NEAR_MS, SEARCH_RADIUS_METERS, WIDE_RADIUS_METERS, WIDEN_AFTER_MS, type RequestRideArgs, } from "./actors/rides-actor.js";
 export { ProfilesActor, RIDES_PAGE } from "./actors/profiles-actor.js";
 export { TestManagerActor, SIMULATED_DRIVERS } from "./actors/test-manager-actor.js";
+export { DriverCanistersActor, CLAIM_FRAGMENT_KEY, MAX_CLAIM_CODE_CHARS, claimCodeOfHash, claimLinkOf } from "./actors/driver-canisters-actor.js";
 export { ChatPlacesActor, CHAT_CONFIG_TTL_MS, DRIVER_ROOM_PREFIX, MAX_ROOM_ID_CHARS, driverRoomId } from "./chat.js";
 export { cellsWithin, decodeGeohashCenter, distanceMeters, encodeGeohash } from "./geo.js";
 export type * from "./interfaces.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3F,mBAAmB,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAClJ,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3F,mBAAmB,iBAAiB,CAAC"}

package/dist/index.js

@@ -7,9 +7,12 @@
 // account, the rating and the history in the core), `TestManagerActor` (simulated drivers,
 // ×10). The chat (U-43): `ChatPlacesActor` and `RideRequest.getChatPlaceAsyncUnsafe` say
 // WHERE a driver's room is; the fronts use `@jsm-mit/chat-sharded-package` for the messages.
+// The driver's own canister (U-45): `DriverCanistersActor` (the demo lease, its extension,
+// "mine", the one-time claim code and the claim from the canister's own front).
 export { MAINNET_HOST, STOPPED_RETRY_ATTEMPTS, canisterError, errorKeyOf, isCanisterStoppedError, retrySettings, } from "./group/canister-actor.js";
 export { RidesActor, RideRequest, refusalKeyOf, REFRESH_WAIT_MS, REQUEST_POLL_MS, RIDE_POLL_MS, RIDE_POLL_NEAR_MS, SEARCH_RADIUS_METERS, WIDE_RADIUS_METERS, WIDEN_AFTER_MS, } from "./actors/rides-actor.js";
 export { ProfilesActor, RIDES_PAGE } from "./actors/profiles-actor.js";
 export { TestManagerActor, SIMULATED_DRIVERS } from "./actors/test-manager-actor.js";
+export { DriverCanistersActor, CLAIM_FRAGMENT_KEY, MAX_CLAIM_CODE_CHARS, claimCodeOfHash, claimLinkOf } from "./actors/driver-canisters-actor.js";
 export { ChatPlacesActor, CHAT_CONFIG_TTL_MS, DRIVER_ROOM_PREFIX, MAX_ROOM_ID_CHARS, driverRoomId } from "./chat.js";
 export { cellsWithin, decodeGeohashCenter, distanceMeters, encodeGeohash } from "./geo.js";

package/dist/interfaces.d.ts

@@ -165,4 +165,32 @@ export interface ChatPlace {
     projectId: string;
     roomId: string;
 }
+/**
+ * A driver canister of the signed-in person: their own (`own`) or a demo canister they
+ * hold (`pool`). Its id is the driver's own address (`https://<canisterId>.icp0.io`).
+ */
+export interface DriverCanisterView {
+    canisterId: string;
+    kind: "own" | "pool";
+    /** The admin of the canister: after a claim (F-20) the driver, not the lease holder. */
+    ownerPrincipal: string;
+    /** A demo lease ends then (pool canisters). */
+    leaseUntilMs?: number;
+    blocked: boolean;
+}
+/** F-20: a one-time code that hands the demo canister to whoever claims it, until `expiresAtMs`. */
+export interface ClaimCodeView {
+    canisterId: string;
+    code: string;
+    expiresAtMs: number;
+}
+/** F-6, F-20a: a lease (with a claim code after a fresh one), or busy until then. */
+export type DemoLeaseView = {
+    kind: "leased";
+    canister: DriverCanisterView;
+    claim?: ClaimCodeView;
+} | {
+    kind: "busy";
+    untilMs: number;
+};
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/tigi-sharded-package",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "description": "The one package of the Tigi network group: takes the coordinator's id and hides the coordinator, the core and the workers — for a consumer the group is one canister; plus the rider's few driver-canister endpoints (U-14).",
     "homepage": "https://github.com/JSM-Tigi/tigi-sharded/tree/master/package#readme",
     "repository": {
@@ -38,7 +38,9 @@
         "test-simulator": "bash scripts/run-tests-local.sh tests/test-simulator.ts",
         "test-drivers": "bash scripts/run-tests-local.sh tests/test-drivers.ts",
         "test-split": "bash scripts/run-tests-local.sh tests/test-split.ts",
-        "test-e2e": "npm run test-drivers && npm run test-simulator && npm run test-split"
+        "test-claim": "bash scripts/run-tests-local.sh tests/test-claim.ts",
+        "load-local": "bash scripts/run-load-local.sh",
+        "test-e2e": "npm run test-drivers && npm run test-simulator && npm run test-split && npm run test-claim"
     },
     "dependencies": {
         "@icp-sdk/core": "^6.1.0"
@@ -54,11 +56,11 @@
     "tigiSharded": {
         "repo": "tigi-sharded",
         "repoUrl": "https://github.com/JSM-Tigi/tigi-sharded",
-        "commit": "57f965916bd67e1de8b3e478b7244d8a4abfc18b"
+        "commit": "8b9fac7d28569db8ee2633e5e40364528bd5aaa1"
     },
     "tigiDriverRust": {
         "repo": "tigi-driver-rust",
         "repoUrl": "https://github.com/JSM-Tigi/tigi-driver-rust",
-        "commit": "4625c46295bdebf434ede4784a22528c1beeb461"
+        "commit": "6870f40829f8532baa7209832e1c553d2c270f94"
     }
 }