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

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,
@@ -51,6 +58,14 @@ export interface DriverCanistersPage {
   'total' : bigint,
   'canisters' : Array<DriverCanister>,
 }
+export interface DriverFeeAccountView {
+  'pending' : FeeUsage,
+  'bill' : [] | [FeeBill],
+  'lastSettledDay' : [] | [bigint],
+  'canister' : Principal,
+  'paidTotal' : bigint,
+  'lastFee' : [] | [FeeRecord],
+}
 export interface DriverRoomView {
   'recipient' : Principal,
   'driverKey' : string,
@@ -59,6 +74,12 @@ export interface DriverRoomView {
   'roomId' : string,
   'synced' : boolean,
 }
+export interface DriverUsage {
+  'quoteRequests' : bigint,
+  'canister' : Principal,
+  'registrations' : bigint,
+  'rides' : bigint,
+}
 export interface Error { 'details' : ErrorDetails, 'logsJson' : string }
 export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
   { 'RemoteCanisterError' : string } |
@@ -78,13 +99,63 @@ export interface FactoryStatus {
   'driverWasm' : [] | [WasmInfo],
   'registered' : bigint,
 }
+export interface FeeBill {
+  'day' : bigint,
+  'settled' : boolean,
+  'usage' : FeeUsage,
+  'amount' : bigint,
+  'multiplierPermille' : bigint,
+  'rates' : FeeRates,
+}
+export interface FeePaid {
+  'day' : bigint,
+  'accepted' : bigint,
+  'amount' : bigint,
+}
+export interface FeePayArgs { 'day' : bigint }
+export interface FeeRates {
+  'perRegistration' : bigint,
+  'perQuoteRequest' : bigint,
+  'perRide' : bigint,
+}
+export interface FeeRecord {
+  'day' : bigint,
+  'paidAtNs' : bigint,
+  'amount' : bigint,
+}
+export interface FeeStatus {
+  'multiplier' : [] | [{ 'day' : bigint, 'permille' : bigint }],
+  'today' : bigint,
+  'toForward' : bigint,
+  'forwardedTotal' : bigint,
+  'lastForwardError' : [] | [string],
+  'accounts' : bigint,
+  'paidTotal' : bigint,
+  'rates' : FeeRates,
+}
+export interface FeeUsage {
+  'quoteRequests' : bigint,
+  'registrations' : bigint,
+  'rides' : bigint,
+}
 export interface InitArgs {
   'mode' : Mode,
   'admins' : Array<Principal>,
   '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 +190,17 @@ 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' : Array<DriverFeeAccountView> } |
   { 'err' : Error };
-export type Result_11 = {
+export type Result_11 = { 'ok' : DriverCanistersPage } |
+  { 'err' : Error };
+export type Result_12 = { 'ok' : Array<Block> } |
+  { 'err' : Error };
+export type Result_13 = { 'ok' : LeaseAnswer } |
+  { 'err' : Error };
+export type Result_14 = { 'ok' : RideBatchResult } |
+  { 'err' : Error };
+export type Result_15 = {
     'ok' : {
       'subjects' : bigint,
       'headSeq' : bigint,
@@ -130,46 +209,53 @@ export type Result_11 = {
     }
   } |
   { 'err' : Error };
-export type Result_12 = { 'ok' : Wiring } |
+export type Result_16 = { 'ok' : Wiring } |
   { 'err' : Error };
-export type Result_13 = { 'ok' : Array<ProfileEntry> } |
+export type Result_17 = { 'ok' : Array<ProfileEntry> } |
   { 'err' : Error };
-export type Result_14 = { 'ok' : RidesPage } |
+export type Result_18 = { 'ok' : RidesPage } |
   { 'err' : Error };
-export type Result_15 = { 'ok' : [] | [Rating] } |
+export type Result_19 = { 'ok' : [] | [Rating] } |
   { 'err' : Error };
-export type Result_16 = { 'ok' : DriverCanister } |
+export type Result_2 = { 'ok' : boolean } |
   { 'err' : Error };
-export type Result_17 = { 'ok' : FactoryStatus } |
+export type Result_20 = { 'ok' : DriverCanister } |
   { 'err' : Error };
-export type Result_18 = { 'ok' : [] | [RolloutView] } |
+export type Result_21 = { 'ok' : FeeStatus } |
   { 'err' : Error };
-export type Result_19 = { 'ok' : ChatRoomsStatus } |
+export type Result_22 = { 'ok' : FactoryStatus } |
   { 'err' : Error };
-export type Result_2 = { 'ok' : boolean } |
+export type Result_23 = { 'ok' : [] | [RolloutView] } |
   { 'err' : Error };
-export type Result_20 = { 'ok' : Array<Principal> } |
+export type Result_24 = { 'ok' : FeeBill } |
   { 'err' : Error };
-export type Result_21 = { 'ok' : Principal } |
+export type Result_25 = { 'ok' : DriverFeeAccountView } |
   { 'err' : Error };
-export type Result_22 = { 'ok' : WasmInfo } |
+export type Result_26 = { 'ok' : ChatRoomsStatus } |
+  { 'err' : Error };
+export type Result_27 = { 'ok' : Array<Principal> } |
+  { 'err' : Error };
+export type Result_28 = { 'ok' : Principal } |
+  { 'err' : Error };
+export type Result_29 = { 'ok' : WasmInfo } |
   { 'err' : Error };
 export type Result_3 = { 'ok' : RolloutView } |
   { 'err' : Error };
 export type Result_4 = { 'ok' : Profile } |
   { 'err' : Error };
-export type Result_5 = { 'ok' : ChatConfig } |
+export type Result_5 = { 'ok' : FeeRates } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : Array<DriverRoomView> } |
+export type Result_6 = { 'ok' : ChatConfig } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : DriverCanistersPage } |
+export type Result_7 = { 'ok' : FeePaid } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : Array<Block> } |
+export type Result_8 = { 'ok' : ClaimCode } |
   { 'err' : Error };
-export type Result_9 = { 'ok' : LeaseAnswer } |
+export type Result_9 = { 'ok' : Array<DriverRoomView> } |
   { 'err' : Error };
 export interface RideBatch {
   'ratings' : Array<RatingEntry>,
+  'usage' : [] | [UsageBatch],
   'rides' : Array<RideEntry>,
 }
 export interface RideBatchResult {
@@ -220,6 +306,8 @@ export interface RolloutView {
   'finishedAtNs' : [] | [bigint],
 }
 export interface SetProfileArgs { 'name' : string }
+export interface SimulatorRouterArgs { 'router' : [] | [Principal] }
+export interface TestDayArgs { 'days' : bigint }
 export interface TigiCore {
   'abortDriverRollout' : ActorMethod<[], Result_3>,
   /**
@@ -229,7 +317,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_20>,
   /**
    * / Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
    * / drop it at once (WO-2).
@@ -239,29 +327,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_20>,
   '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_29>,
   /**
    * / Admins, localTest: an empty canister from the core's cycles joins the demo pool.
    */
-  'createLocalPoolCanister' : ActorMethod<[], Result_16>,
+  'createLocalPoolCanister' : ActorMethod<[], Result_20>,
   /**
    * / 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_20>,
   /**
    * / Admins: the simulator, created once (F-18).
    */
-  'ensureSimulator' : ActorMethod<[], Result_21>,
+  'ensureSimulator' : ActorMethod<[], Result_28>,
   /**
    * / F-8: 15 min more for the holder of a demo canister.
    */
-  'extendDemoLease' : ActorMethod<[], Result_16>,
-  'getAdmins' : ActorMethod<[], Result_20>,
+  'extendDemoLease' : ActorMethod<[], Result_20>,
+  'getAdmins' : ActorMethod<[], Result_27>,
   /**
    * / 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 +364,46 @@ export interface TigiCore {
   /**
    * / Admins: how far the driver rooms are (C-15).
    */
-  'getChatRoomsStatus' : ActorMethod<[], Result_19>,
+  'getChatRoomsStatus' : ActorMethod<[], Result_26>,
   /**
    * / 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>,
+  /**
+   * / Admins: the account of one driver canister (C-17 … C-20).
+   */
+  'getDriverFeeAccount' : ActorMethod<[CanisterArgs], Result_25>,
+  /**
+   * / C-19: a driver canister of the registry asks for its bill — the events since its
+   * / last settlement, priced on the fee's day. Called by the canister at its first
+   * / "Przyjmuję zlecenia" of a day. A pool canister owes nothing (C-18).
+   */
+  'getDriverFeeBill' : ActorMethod<[], Result_24>,
+  'getDriverRollout' : ActorMethod<[], Result_23>,
+  'getFactoryStatus' : ActorMethod<[], Result_22>,
+  /**
+   * / C-22: the rates, the day, the multiplier cached, the totals.
+   */
+  'getFeeStatus' : ActorMethod<[], Result_21>,
   'getLogs' : ActorMethod<[], string>,
   /**
    * / The caller's own canister, or the demo canister the caller holds now.
    */
-  'getMyDriverCanister' : ActorMethod<[], Result_16>,
+  'getMyDriverCanister' : ActorMethod<[], Result_20>,
   '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_19>,
   /**
    * / C-8: the caller's rides, newest first.
    */
-  'getMyRides' : ActorMethod<[RidesPageArgs], Result_14>,
+  'getMyRides' : ActorMethod<[RidesPageArgs], Result_18>,
   /**
    * / 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_17>,
   /**
    * / F-11: the driver wasms released so far, oldest first.
    */
@@ -307,11 +415,11 @@ export interface TigiCore {
   /**
    * / Admins: the coordinator, the workers confirmed so far, the mode.
    */
-  'getWiring' : ActorMethod<[], Result_12>,
+  'getWiring' : ActorMethod<[], Result_16>,
   /**
    * / Admins: how far the outbox to the workers is (C-6, C-7).
    */
-  'getWorkerOutbox' : ActorMethod<[], Result_11>,
+  'getWorkerOutbox' : ActorMethod<[], Result_15>,
   /**
    * / 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 +431,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_14>,
   /**
    * / 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 +439,31 @@ 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_13>,
+  'listBlocks' : ActorMethod<[PageArgs], Result_12>,
+  'listDriverCanisters' : ActorMethod<[PageArgs], Result_11>,
+  /**
+   * / Admins: the accounts, 100 a page at most.
    */
-  'leaseDemoDriverCanister' : ActorMethod<[], Result_9>,
-  'listBlocks' : ActorMethod<[PageArgs], Result_8>,
-  'listDriverCanisters' : ActorMethod<[PageArgs], Result_7>,
+  'listDriverFeeAccounts' : ActorMethod<[PageArgs], Result_10>,
   /**
    * / Admins: the driver rooms as the core wants them, 100 a page at most.
    */
-  'listDriverRooms' : ActorMethod<[PageArgs], Result_6>,
+  'listDriverRooms' : ActorMethod<[PageArgs], Result_9>,
+  /**
+   * / F-20: a fresh claim code for the caller's running demo lease; the old one stops
+   * / working.
+   */
+  'newClaimCode' : ActorMethod<[], Result_8>,
+  /**
+   * / C-20: the driver canister pays the bill of `day` with the cycles attached to this
+   * / call. The core takes exactly the bill (the rest goes back), or nothing when less is
+   * / attached (`FEE_SHORT`); a day paid already answers `accepted = 0`.
+   */
+  'payDriverFee' : ActorMethod<[FeePayArgs], Result_7>,
   'removeAdmin' : ActorMethod<[PrincipalArgs], Result_2>,
   'resumeDriverRollout' : ActorMethod<[], Result_3>,
   /**
@@ -347,13 +471,33 @@ export interface TigiCore {
    * / (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' : ActorMethod<[ChatConfig], Result_5>,
+  'setChatConfig' : ActorMethod<[ChatConfig], Result_6>,
+  /**
+   * / 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>,
+  /**
+   * / Admins: the cycles per event (C-18).
+   */
+  'setFeeRates' : ActorMethod<[FeeRates], Result_5>,
   'setLoggingEnabled' : ActorMethod<[boolean], Result_2>,
   /**
    * / The coordinator only: the balance below which the core asks for cycles.
    */
   'setLowCyclesBelow' : ActorMethod<[bigint], Result_2>,
   'setMyProfile' : ActorMethod<[SetProfileArgs], Result_4>,
+  /**
+   * / F-21 (2026-10-24, route line): admins — the one principal that routes the simulator's
+   * / quotes (S-N13, a Node process like a driver's front); null removes it. The simulator
+   * / takes it from the core only.
+   */
+  'setSimulatorRouter' : ActorMethod<[SimulatorRouterArgs], Result_2>,
+  /**
+   * / Admins, localTest only: the fee's day moves this many days on (the local check of
+   * / "the next day"). Heap only: an upgrade brings back the real day.
+   */
+  'setTestDayOffset' : ActorMethod<[TestDayArgs], Result>,
   /**
    * / Admins: a rollout of the current driver wasm (F-12): the canary, then the rest, one
    * / canister a step, never during a ride (F-13).
@@ -375,6 +519,10 @@ export interface UnblockDriverArgs {
   'canister' : Principal,
 }
 export interface UnblockRiderArgs { 'rider' : Principal }
+export interface UsageBatch {
+  'entries' : Array<DriverUsage>,
+  'batchId' : bigint,
+}
 export interface WasmChunkArgs {
   'kind' : WasmKind,
   'bytes' : Uint8Array | number[],