kokio-sdk 1.0.0 → 2.0.0

package/dist/esm/admin/interface/deviceWalletFactoryClass.js

@@ -1,6 +1,6 @@
 import { _createAccountWithEOA } from "../../logic/deviceWalletFactory.js";
-import { _deployDeviceWalletForUsers, _postCreateAccount, _addRegistryAddress, _updateVaultAddress, _requestAdminUpdate, _acceptAdminUpdate, _updateDeviceWalletImplementation, } from "../../logic/admin/deviceWalletFactory.eoa.js";
-import { _eSIMWalletAdmin, _vault, _newRequestedAdmin, _deviceWalletInfoAdded, _getCurrentDeviceWalletImplementation, _getCounterFactualAddress, } from "../../logic/admin/reads/deviceWalletFactory.reads.js";
+import { _deployDeviceWalletForUsers, _postCreateAccount, _addRegistryAddress, _updateDeviceWalletImplementation, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/deviceWalletFactory.eoa.js";
+import { _eSIMWalletAdmin, _deviceWalletInfoAdded, _getCurrentDeviceWalletImplementation, _getCounterFactualAddress, _preCreateAccountValidation, _beacon, _registry, _entryPoint, _verifier, _owner, _pendingOwner, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/deviceWalletFactory.reads.js";
 /**
  * Thin EOA wrapper around `DeviceWalletFactory`. Holds only the wallet client;
  * every method forwards to a logic function. `createAccountWithEOA` reuses the
@@ -17,21 +17,12 @@ export class AdminDeviceWalletFactorySubPackage {
     deployDeviceWalletForUsers(deviceUniqueIdentifiers, deviceWalletOwnersKey, salts, depositAmounts, value) {
         return _deployDeviceWalletForUsers(this.walletClient, deviceUniqueIdentifiers, deviceWalletOwnersKey, salts, depositAmounts, value);
     }
-    postCreateAccount(deviceWallet, deviceUniqueIdentifier, deviceWalletOwnerKey) {
-        return _postCreateAccount(this.walletClient, deviceWallet, deviceUniqueIdentifier, deviceWalletOwnerKey);
+    postCreateAccount(deviceWallet, deviceUniqueIdentifier, deviceWalletOwnerKey, salt) {
+        return _postCreateAccount(this.walletClient, deviceWallet, deviceUniqueIdentifier, deviceWalletOwnerKey, salt);
     }
     addRegistryAddress(registryContractAddress) {
         return _addRegistryAddress(this.walletClient, registryContractAddress);
     }
-    updateVaultAddress(newVaultAddress) {
-        return _updateVaultAddress(this.walletClient, newVaultAddress);
-    }
-    requestAdminUpdate(newAdmin) {
-        return _requestAdminUpdate(this.walletClient, newAdmin);
-    }
-    acceptAdminUpdate() {
-        return _acceptAdminUpdate(this.walletClient);
-    }
     updateDeviceWalletImplementation(newDeviceImpl) {
         return _updateDeviceWalletImplementation(this.walletClient, newDeviceImpl);
     }
@@ -39,12 +30,6 @@ export class AdminDeviceWalletFactorySubPackage {
     eSIMWalletAdmin() {
         return _eSIMWalletAdmin(this.walletClient);
     }
-    vault() {
-        return _vault(this.walletClient);
-    }
-    newRequestedAdmin() {
-        return _newRequestedAdmin(this.walletClient);
-    }
     deviceWalletInfoAdded(deviceWallet) {
         return _deviceWalletInfoAdded(this.walletClient, deviceWallet);
     }
@@ -54,4 +39,41 @@ export class AdminDeviceWalletFactorySubPackage {
     getCounterFactualAddress(deviceWalletOwnerKey, deviceUniqueIdentifier, salt) {
         return _getCounterFactualAddress(this.walletClient, deviceWalletOwnerKey, deviceUniqueIdentifier, salt);
     }
+    preCreateAccountValidation(deviceUniqueIdentifier, deviceWalletOwnerKey) {
+        return _preCreateAccountValidation(this.walletClient, deviceUniqueIdentifier, deviceWalletOwnerKey);
+    }
+    beacon() {
+        return _beacon(this.walletClient);
+    }
+    registry() {
+        return _registry(this.walletClient);
+    }
+    entryPoint() {
+        return _entryPoint(this.walletClient);
+    }
+    verifier() {
+        return _verifier(this.walletClient);
+    }
+    owner() {
+        return _owner(this.walletClient);
+    }
+    pendingOwner() {
+        return _pendingOwner(this.walletClient);
+    }
+    proxiableUUID() {
+        return _proxiableUUID(this.walletClient);
+    }
+    upgradeInterfaceVersion() {
+        return _upgradeInterfaceVersion(this.walletClient);
+    }
+    acceptOwnership() {
+        return _acceptOwnership(this.walletClient);
+    }
+    // Owner payloads: hand the result to `protocolAdmin.schedule`
+    transferOwnershipCall(newOwner) {
+        return _transferOwnershipCall(this.walletClient, newOwner);
+    }
+    upgradeCall(newImplementation, data) {
+        return _upgradeCall(this.walletClient, newImplementation, data);
+    }
 }

package/dist/esm/admin/interface/eSIMWalletClass.js

@@ -1,5 +1,5 @@
 import { _buyDataBundle } from "../../logic/admin/eSIMWallet.eoa.js";
-import { _eSIMWalletFactory, _eSIMUniqueIdentifier, _newRequestedOwner, _owner, } from "../../logic/admin/reads/eSIMWallet.reads.js";
+import { _eSIMWalletFactory, _eSIMUniqueIdentifier, _newRequestedOwner, _owner, _dataBundlePriceCap, _deviceWallet, _transactionHistory, } from "../../logic/admin/reads/eSIMWallet.reads.js";
 /**
  * Thin EOA wrapper around a specific `ESIMWallet` instance. The instance address
  * is bound at construction; `KokioAdmin.setESIMWalletAddress` swaps it by
@@ -28,4 +28,13 @@ export class AdminESIMWalletSubPackage {
     owner() {
         return _owner(this.walletClient, this.eSIMWalletAddress);
     }
+    dataBundlePriceCap() {
+        return _dataBundlePriceCap(this.walletClient, this.eSIMWalletAddress);
+    }
+    deviceWallet() {
+        return _deviceWallet(this.walletClient, this.eSIMWalletAddress);
+    }
+    transactionHistory(index) {
+        return _transactionHistory(this.walletClient, this.eSIMWalletAddress, index);
+    }
 }

package/dist/esm/admin/interface/eSIMWalletFactoryClass.js

@@ -1,5 +1,5 @@
-import { _addRegistryAddress, _updateESIMWalletImplementation, } from "../../logic/admin/eSIMWalletFactory.eoa.js";
-import { _isESIMWalletDeployed, _getCurrentESIMWalletImplementation, } from "../../logic/admin/reads/eSIMWalletFactory.reads.js";
+import { _addRegistryAddress, _updateESIMWalletImplementation, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/eSIMWalletFactory.eoa.js";
+import { _isESIMWalletDeployed, _getCurrentESIMWalletImplementation, _owner, _pendingOwner, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/eSIMWalletFactory.reads.js";
 /** Thin EOA (owner) wrapper around `ESIMWalletFactory`. */
 export class AdminESIMWalletFactorySubPackage {
     walletClient;
@@ -12,6 +12,16 @@ export class AdminESIMWalletFactorySubPackage {
     updateESIMWalletImplementation(eSIMWalletImpl) {
         return _updateESIMWalletImplementation(this.walletClient, eSIMWalletImpl);
     }
+    acceptOwnership() {
+        return _acceptOwnership(this.walletClient);
+    }
+    // Owner payloads: hand the result to `protocolAdmin.schedule`
+    transferOwnershipCall(newOwner) {
+        return _transferOwnershipCall(this.walletClient, newOwner);
+    }
+    upgradeCall(newImplementation, data) {
+        return _upgradeCall(this.walletClient, newImplementation, data);
+    }
     // Reads: public storage getters and views
     isESIMWalletDeployed(eSIMWallet) {
         return _isESIMWalletDeployed(this.walletClient, eSIMWallet);
@@ -19,4 +29,16 @@ export class AdminESIMWalletFactorySubPackage {
     getCurrentESIMWalletImplementation() {
         return _getCurrentESIMWalletImplementation(this.walletClient);
     }
+    owner() {
+        return _owner(this.walletClient);
+    }
+    pendingOwner() {
+        return _pendingOwner(this.walletClient);
+    }
+    proxiableUUID() {
+        return _proxiableUUID(this.walletClient);
+    }
+    upgradeInterfaceVersion() {
+        return _upgradeInterfaceVersion(this.walletClient);
+    }
 }

package/dist/esm/admin/interface/lazyWalletRegistryClass.js

@@ -1,5 +1,5 @@
-import { _batchPopulateHistory, _deployLazyWalletAndSetESIMIdentifier, _switchESIMIdentifierToNewDeviceIdentifier, } from "../../logic/admin/lazyWalletRegistry.eoa.js";
-import { _upgradeManager, _eSIMIdentifierToDeviceIdentifier, _deviceIdentifierToESIMDetails, _eSIMIdentifiersAssociatedWithDeviceIdentifier, } from "../../logic/admin/reads/lazyWalletRegistry.reads.js";
+import { _batchPopulateHistory, _deployLazyWalletAllBatches, _deployLazyWalletAndSetESIMIdentifier, _deployMoreESIMWalletsForLazyDevice, _setHistoryForLazyWallet, _setHistoryForLazyWalletAllBatches, _switchESIMIdentifierToNewDeviceIdentifier, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/lazyWalletRegistry.eoa.js";
+import { _upgradeManager, _eSIMIdentifierToDeviceIdentifier, _deviceIdentifierToESIMDetails, _eSIMIdentifiersAssociatedWithDeviceIdentifier, _eSIMWalletsDeployed, _historyEntriesCopied, _isDeviceIdentifierReserved, _isESIMIdentifierReserved, _lazyDeployedESIMWallet, _lazyDeploymentSalt, _maxESIMWalletsPerCall, _maxHistoryEntriesPerCall, _owner, _pendingOwner, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/lazyWalletRegistry.reads.js";
 /** Thin EOA (eSIMWalletAdmin) wrapper around `LazyWalletRegistry`. */
 export class AdminLazyWalletRegistrySubPackage {
     walletClient;
@@ -9,12 +9,43 @@ export class AdminLazyWalletRegistrySubPackage {
     batchPopulateHistory(deviceUniqueIdentifiers, eSIMUniqueIdentifiers, dataBundleDetails) {
         return _batchPopulateHistory(this.walletClient, deviceUniqueIdentifiers, eSIMUniqueIdentifiers, dataBundleDetails);
     }
-    deployLazyWalletAndSetESIMIdentifier(deviceOwnerPublicKey, deviceUniqueIdentifier, salt, depositAmount) {
-        return _deployLazyWalletAndSetESIMIdentifier(this.walletClient, deviceOwnerPublicKey, deviceUniqueIdentifier, salt, depositAmount);
+    /**
+     * Deploy a lazy device and all of its eSIM wallets. Sends as many transactions
+     * as the device needs and resolves once every wallet exists, so the caller
+     * does not deal with the on-chain batching at all.
+     *
+     * Resumable: call it again with the same arguments (and a deposit of 0) to
+     * pick a part-deployed device up from where it stopped.
+     *
+     * Record all of the device's purchase history before this runs.
+     */
+    deployLazyWalletAndSetESIMIdentifier(deviceOwnerPublicKey, deviceUniqueIdentifier, salt, depositAmount, maxWallets) {
+        return _deployLazyWalletAllBatches(this.walletClient, deviceOwnerPublicKey, deviceUniqueIdentifier, salt, depositAmount, maxWallets);
+    }
+    /**
+     * Copy an eSIM's whole purchase history onto its wallet, over as many
+     * transactions as it takes. Resumable, and safe to run while the device's
+     * other eSIM wallets are still being deployed.
+     */
+    setHistoryForLazyWallet(eSIMIdentifier, maxEntries) {
+        return _setHistoryForLazyWalletAllBatches(this.walletClient, eSIMIdentifier, maxEntries);
     }
     switchESIMIdentifierToNewDeviceIdentifier(eSIMIdentifier, oldDeviceIdentifier, newDeviceIdentifier) {
         return _switchESIMIdentifierToNewDeviceIdentifier(this.walletClient, eSIMIdentifier, oldDeviceIdentifier, newDeviceIdentifier);
     }
+    // Single-transaction calls, mirroring the contract one for one. The paginated
+    // versions above are the ones to reach for; these are here for a caller that
+    // wants to drive the batching itself, and each returns a transaction hash
+    // rather than waiting for a receipt.
+    deployLazyWalletFirstBatch(deviceOwnerPublicKey, deviceUniqueIdentifier, salt, depositAmount, maxWallets) {
+        return _deployLazyWalletAndSetESIMIdentifier(this.walletClient, deviceOwnerPublicKey, deviceUniqueIdentifier, salt, depositAmount, maxWallets);
+    }
+    deployMoreESIMWalletsForLazyDevice(deviceUniqueIdentifier, maxWallets) {
+        return _deployMoreESIMWalletsForLazyDevice(this.walletClient, deviceUniqueIdentifier, maxWallets);
+    }
+    setHistoryForLazyWalletBatch(eSIMIdentifier, maxEntries) {
+        return _setHistoryForLazyWallet(this.walletClient, eSIMIdentifier, maxEntries);
+    }
     // Reads: public storage getters
     upgradeManager() {
         return _upgradeManager(this.walletClient);
@@ -22,6 +53,32 @@ export class AdminLazyWalletRegistrySubPackage {
     eSIMIdentifierToDeviceIdentifier(eSIMIdentifier) {
         return _eSIMIdentifierToDeviceIdentifier(this.walletClient, eSIMIdentifier);
     }
+    MAX_ESIM_WALLETS_PER_CALL() {
+        return _maxESIMWalletsPerCall(this.walletClient);
+    }
+    MAX_HISTORY_ENTRIES_PER_CALL() {
+        return _maxHistoryEntriesPerCall(this.walletClient);
+    }
+    /** Deploy cursor. Non-zero exactly when the lazy route ran this device's first batch. */
+    eSIMWalletsDeployed(deviceIdentifier) {
+        return _eSIMWalletsDeployed(this.walletClient, deviceIdentifier);
+    }
+    lazyDeploymentSalt(deviceIdentifier) {
+        return _lazyDeploymentSalt(this.walletClient, deviceIdentifier);
+    }
+    lazyDeployedESIMWallet(eSIMIdentifier) {
+        return _lazyDeployedESIMWallet(this.walletClient, eSIMIdentifier);
+    }
+    /** History cursor, per eSIM. */
+    historyEntriesCopied(eSIMIdentifier) {
+        return _historyEntriesCopied(this.walletClient, eSIMIdentifier);
+    }
+    isDeviceIdentifierReserved(deviceIdentifier) {
+        return _isDeviceIdentifierReserved(this.walletClient, deviceIdentifier);
+    }
+    isESIMIdentifierReserved(eSIMIdentifier) {
+        return _isESIMIdentifierReserved(this.walletClient, eSIMIdentifier);
+    }
     // Array-backed getters take an element index and return one entry - iterate
     // indices to read the full list (there is no on-chain full-array getter).
     deviceIdentifierToESIMDetails(deviceIdentifier, eSIMIdentifier, index) {
@@ -30,4 +87,26 @@ export class AdminLazyWalletRegistrySubPackage {
     eSIMIdentifiersAssociatedWithDeviceIdentifier(deviceIdentifier, index) {
         return _eSIMIdentifiersAssociatedWithDeviceIdentifier(this.walletClient, deviceIdentifier, index);
     }
+    owner() {
+        return _owner(this.walletClient);
+    }
+    pendingOwner() {
+        return _pendingOwner(this.walletClient);
+    }
+    proxiableUUID() {
+        return _proxiableUUID(this.walletClient);
+    }
+    upgradeInterfaceVersion() {
+        return _upgradeInterfaceVersion(this.walletClient);
+    }
+    acceptOwnership() {
+        return _acceptOwnership(this.walletClient);
+    }
+    // Owner payloads: hand the result to `protocolAdmin.schedule`
+    transferOwnershipCall(newOwner) {
+        return _transferOwnershipCall(this.walletClient, newOwner);
+    }
+    upgradeCall(newImplementation, data) {
+        return _upgradeCall(this.walletClient, newImplementation, data);
+    }
 }

package/dist/esm/admin/interface/protocolAdminClass.js

@@ -0,0 +1,195 @@
+import { _operationId, _operationIdBatch, _operationIdRaw, _operationIdBatchRaw, _schedule, _scheduleBatch, _scheduleRaw, _execute, _executeBatch, _executeRaw, _cancel, _unpauseInstantly, _revokeCancellersInstantly, _disableAdminInstantly, _acceptOwnershipBatch, _renounceRole, _grantRoleCall, _revokeRoleCall, _updateDelayCall, _disableAndNominateCall, _disableAdminCall, _enableAdminCall, _unpauseCall, _setDefaultDataBundlePriceCapCall, } from "../../logic/admin/protocolAdmin.eoa.js";
+import { _getMinDelay, _minDelayFloor, _getOperationState, _getTimestamp, _isOperation, _isOperationPending, _isOperationReady, _isOperationDone, _hasRole, _getRoleAdmin, _defaultAdminRole, _proposerRole, _cancellerRole, _executorRole, _guardianRole, } from "../../logic/admin/reads/protocolAdmin.reads.js";
+/** Schedules operations. Needs an EOA holding `PROPOSER_ROLE`. */
+export class ProtocolAdminProposerSubPackage {
+    walletClient;
+    constructor(walletClient) {
+        this.walletClient = walletClient;
+    }
+    schedule(call, opts, delay) {
+        return _schedule(this.walletClient, call, opts, delay);
+    }
+    scheduleBatch(calls, opts, delay) {
+        return _scheduleBatch(this.walletClient, calls, opts, delay);
+    }
+    scheduleRaw(target, value, payload, predecessor, salt, delay) {
+        return _scheduleRaw(this.walletClient, target, value, payload, predecessor, salt, delay);
+    }
+}
+/** Runs operations whose delay has elapsed. Open to any funded EOA. */
+export class ProtocolAdminExecutorSubPackage {
+    walletClient;
+    constructor(walletClient) {
+        this.walletClient = walletClient;
+    }
+    execute(operation) {
+        return _execute(this.walletClient, operation);
+    }
+    executeBatch(operation) {
+        return _executeBatch(this.walletClient, operation);
+    }
+    executeRaw(target, value, payload, predecessor, salt) {
+        return _executeRaw(this.walletClient, target, value, payload, predecessor, salt);
+    }
+}
+/** Drops a scheduled operation. Needs `CANCELLER_ROLE`, which proposers also hold. */
+export class ProtocolAdminCancellerSubPackage {
+    walletClient;
+    constructor(walletClient) {
+        this.walletClient = walletClient;
+    }
+    cancel(id) {
+        return _cancel(this.walletClient, id);
+    }
+}
+/**
+ * The three instant powers. Needs `GUARDIAN_ROLE`.
+ *
+ * Each one takes something away and none grants anything, which is what keeps
+ * the role away from user funds. Undoing any of them is an owner action and
+ * waits, so the side taking power away wins the race against the side handing it
+ * back.
+ */
+export class ProtocolAdminGuardianSubPackage {
+    walletClient;
+    constructor(walletClient) {
+        this.walletClient = walletClient;
+    }
+    unpauseInstantly(target) {
+        return _unpauseInstantly(this.walletClient, target);
+    }
+    revokeCancellersInstantly(accounts) {
+        return _revokeCancellersInstantly(this.walletClient, accounts);
+    }
+    disableAdminInstantly(target) {
+        return _disableAdminInstantly(this.walletClient, target);
+    }
+}
+/**
+ * The timelock that owns `Registry`, `LazyWalletRegistry`, `DeviceWalletFactory`
+ * and `ESIMWalletFactory`.
+ *
+ * Owner calls go one way: `proposer.schedule` announces one, the delay elapses,
+ * and `executor.execute` runs it. The role surfaces are separate because they
+ * need different keys, and `executor` needs no role at all.
+ *
+ * ```ts
+ * const op = await admin.protocolAdmin.proposer.schedule({
+ *     address: registryAddress,
+ *     abi: Registry,
+ *     functionName: "updateVaultAddress",
+ *     args: [newVault],
+ * });
+ * // ... wait out admin.protocolAdmin.getMinDelay() ...
+ * await admin.protocolAdmin.executor.execute(op);
+ * ```
+ */
+export class AdminProtocolAdminSubPackage {
+    walletClient;
+    proposer;
+    executor;
+    canceller;
+    guardian;
+    constructor(walletClient) {
+        this.walletClient = walletClient;
+        this.proposer = new ProtocolAdminProposerSubPackage(walletClient);
+        this.executor = new ProtocolAdminExecutorSubPackage(walletClient);
+        this.canceller = new ProtocolAdminCancellerSubPackage(walletClient);
+        this.guardian = new ProtocolAdminGuardianSubPackage(walletClient);
+    }
+    // Writes that need no role
+    acceptOwnershipBatch(targets) {
+        return _acceptOwnershipBatch(this.walletClient, targets);
+    }
+    renounceRole(role, account) {
+        return _renounceRole(this.walletClient, role, account);
+    }
+    // Payload builders for the self-call-only functions. Hand the result to
+    // `proposer.schedule`; there is no way to call these directly.
+    grantRoleCall(role, account) {
+        return _grantRoleCall(this.walletClient, role, account);
+    }
+    revokeRoleCall(role, account) {
+        return _revokeRoleCall(this.walletClient, role, account);
+    }
+    updateDelayCall(newDelay) {
+        return _updateDelayCall(this.walletClient, newDelay);
+    }
+    disableAndNominateCall(target, newAdmin) {
+        return _disableAndNominateCall(this.walletClient, target, newAdmin);
+    }
+    // Payload builders for the target contract's own owner functions. Same
+    // route: hand the result to `proposer.schedule`.
+    disableAdminCall(target) {
+        return _disableAdminCall(this.walletClient, target);
+    }
+    enableAdminCall(target) {
+        return _enableAdminCall(this.walletClient, target);
+    }
+    unpauseCall(target) {
+        return _unpauseCall(this.walletClient, target);
+    }
+    setDefaultDataBundlePriceCapCall(cap, target) {
+        return _setDefaultDataBundlePriceCapCall(this.walletClient, cap, target);
+    }
+    // Operation ids
+    operationId(call, opts) {
+        return _operationId(this.walletClient, call, opts);
+    }
+    operationIdBatch(calls, opts) {
+        return _operationIdBatch(this.walletClient, calls, opts);
+    }
+    operationIdRaw(target, value, payload, predecessor, salt) {
+        return _operationIdRaw(this.walletClient, target, value, payload, predecessor, salt);
+    }
+    operationIdBatchRaw(targets, values, payloads, predecessor, salt) {
+        return _operationIdBatchRaw(this.walletClient, targets, values, payloads, predecessor, salt);
+    }
+    // Reads
+    getMinDelay() {
+        return _getMinDelay(this.walletClient);
+    }
+    minDelayFloor() {
+        return _minDelayFloor(this.walletClient);
+    }
+    getOperationState(id) {
+        return _getOperationState(this.walletClient, id);
+    }
+    getTimestamp(id) {
+        return _getTimestamp(this.walletClient, id);
+    }
+    isOperation(id) {
+        return _isOperation(this.walletClient, id);
+    }
+    isOperationPending(id) {
+        return _isOperationPending(this.walletClient, id);
+    }
+    isOperationReady(id) {
+        return _isOperationReady(this.walletClient, id);
+    }
+    isOperationDone(id) {
+        return _isOperationDone(this.walletClient, id);
+    }
+    hasRole(role, account) {
+        return _hasRole(this.walletClient, role, account);
+    }
+    getRoleAdmin(role) {
+        return _getRoleAdmin(this.walletClient, role);
+    }
+    // Role ids, read off the contract rather than hardcoded
+    DEFAULT_ADMIN_ROLE() {
+        return _defaultAdminRole(this.walletClient);
+    }
+    PROPOSER_ROLE() {
+        return _proposerRole(this.walletClient);
+    }
+    CANCELLER_ROLE() {
+        return _cancellerRole(this.walletClient);
+    }
+    EXECUTOR_ROLE() {
+        return _executorRole(this.walletClient);
+    }
+    GUARDIAN_ROLE() {
+        return _guardianRole(this.walletClient);
+    }
+}

package/dist/esm/admin/interface/registryClass.js

@@ -1,5 +1,5 @@
-import { _addOrUpdateLazyWalletRegistryAddress } from "../../logic/admin/registry.eoa.js";
-import { _eSIMWalletAdmin, _vault, _upgradeManager, _lazyWalletRegistry, _uniqueIdentifierToDeviceWallet, _deviceWalletToOwner, _registeredP256Keys, _isDeviceWalletValid, _isESIMWalletValid, _isESIMWalletOnStandby, } from "../../logic/admin/reads/registry.reads.js";
+import { _addOrUpdateLazyWalletRegistryAddress, _updateVaultAddress, _requestAdminUpdate, _disableAdmin, _enableAdmin, _acceptAdminUpdate, _assignESIMIdentifier, _pause, _unpause, _setDefaultDataBundlePriceCap, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/registry.eoa.js";
+import { _owner, _eSIMWalletAdmin, _adminOfRecord, _adminDisabled, _newRequestedAdmin, _vault, _upgradeManager, _lazyWalletRegistry, _uniqueIdentifierToDeviceWallet, _deviceWalletToOwner, _registeredP256Keys, _isDeviceWalletValid, _isESIMWalletValid, _isESIMWalletOnStandby, _paused, _defaultDataBundlePriceCap, _isDeviceIdentifierAlreadyUsed, _isESIMIdentifierClaimed, _eSIMWalletForIdentifier, _claimedESIMIdentifiers, _requireDeviceIdentifierNotReserved, _pendingOwner, _deviceWalletFactory, _eSIMWalletFactory, _entryPoint, _requireNotPaused, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/registry.reads.js";
 /** Thin EOA (owner) wrapper around `Registry`. */
 export class AdminRegistrySubPackage {
     walletClient;
@@ -9,10 +9,59 @@ export class AdminRegistrySubPackage {
     addOrUpdateLazyWalletRegistryAddress(lazyWalletRegistry) {
         return _addOrUpdateLazyWalletRegistryAddress(this.walletClient, lazyWalletRegistry);
     }
+    updateVaultAddress(newVaultAddress) {
+        return _updateVaultAddress(this.walletClient, newVaultAddress);
+    }
+    requestAdminUpdate(newAdmin) {
+        return _requestAdminUpdate(this.walletClient, newAdmin);
+    }
+    disableAdmin() {
+        return _disableAdmin(this.walletClient);
+    }
+    enableAdmin() {
+        return _enableAdmin(this.walletClient);
+    }
+    acceptAdminUpdate() {
+        return _acceptAdminUpdate(this.walletClient);
+    }
+    assignESIMIdentifier(eSIMWalletAddress, eSIMUniqueIdentifier) {
+        return _assignESIMIdentifier(this.walletClient, eSIMWalletAddress, eSIMUniqueIdentifier);
+    }
+    pause() {
+        return _pause(this.walletClient);
+    }
+    unpause() {
+        return _unpause(this.walletClient);
+    }
+    setDefaultDataBundlePriceCap(cap) {
+        return _setDefaultDataBundlePriceCap(this.walletClient, cap);
+    }
+    acceptOwnership() {
+        return _acceptOwnership(this.walletClient);
+    }
+    // Owner payloads: hand the result to `protocolAdmin.schedule`
+    transferOwnershipCall(newOwner) {
+        return _transferOwnershipCall(this.walletClient, newOwner);
+    }
+    upgradeCall(newImplementation, data) {
+        return _upgradeCall(this.walletClient, newImplementation, data);
+    }
     // Reads: public storage getters, including the inherited RegistryHelper mappings
+    owner() {
+        return _owner(this.walletClient);
+    }
     eSIMWalletAdmin() {
         return _eSIMWalletAdmin(this.walletClient);
     }
+    adminOfRecord() {
+        return _adminOfRecord(this.walletClient);
+    }
+    adminDisabled() {
+        return _adminDisabled(this.walletClient);
+    }
+    newRequestedAdmin() {
+        return _newRequestedAdmin(this.walletClient);
+    }
     vault() {
         return _vault(this.walletClient);
     }
@@ -40,4 +89,46 @@ export class AdminRegistrySubPackage {
     isESIMWalletOnStandby(eSIMWallet) {
         return _isESIMWalletOnStandby(this.walletClient, eSIMWallet);
     }
+    paused() {
+        return _paused(this.walletClient);
+    }
+    defaultDataBundlePriceCap() {
+        return _defaultDataBundlePriceCap(this.walletClient);
+    }
+    isDeviceIdentifierAlreadyUsed(deviceUniqueIdentifier) {
+        return _isDeviceIdentifierAlreadyUsed(this.walletClient, deviceUniqueIdentifier);
+    }
+    isESIMIdentifierClaimed(eSIMUniqueIdentifier) {
+        return _isESIMIdentifierClaimed(this.walletClient, eSIMUniqueIdentifier);
+    }
+    eSIMWalletForIdentifier(eSIMUniqueIdentifier) {
+        return _eSIMWalletForIdentifier(this.walletClient, eSIMUniqueIdentifier);
+    }
+    claimedESIMIdentifiers(hashOfESIMIdentifier) {
+        return _claimedESIMIdentifiers(this.walletClient, hashOfESIMIdentifier);
+    }
+    requireDeviceIdentifierNotReserved(deviceUniqueIdentifier) {
+        return _requireDeviceIdentifierNotReserved(this.walletClient, deviceUniqueIdentifier);
+    }
+    requireNotPaused() {
+        return _requireNotPaused(this.walletClient);
+    }
+    pendingOwner() {
+        return _pendingOwner(this.walletClient);
+    }
+    deviceWalletFactory() {
+        return _deviceWalletFactory(this.walletClient);
+    }
+    eSIMWalletFactory() {
+        return _eSIMWalletFactory(this.walletClient);
+    }
+    entryPoint() {
+        return _entryPoint(this.walletClient);
+    }
+    proxiableUUID() {
+        return _proxiableUUID(this.walletClient);
+    }
+    upgradeInterfaceVersion() {
+        return _upgradeInterfaceVersion(this.walletClient);
+    }
 }

package/dist/esm/config.js

@@ -2,7 +2,7 @@ import { ConstantsSubPackage } from "./interface/constantsClass.js";
 import { SmartAccountSubPackage } from "./interface/smartAccountClass.js";
 import { DeviceWalletFactorySubPackage } from "./interface/deviceWalletFactoryClass.js";
 import { P256VerifierSubPackage } from "./interface/P256VerifierClass.js";
-import { LazyWalletRegistrySubPackage } from "./interface/lazyWalletRegistryClass.js";
+import { RegistrySubPackage } from "./interface/registryClass.js";
 import { DeviceWalletSubPackage } from "./interface/deviceWalletClass.js";
 import { ESIMWalletSubPackage } from "./interface/eSIMWalletClass.js";
 import { ESIMWalletFactorySubPackage } from "./interface/eSIMWalletFactoryClass.js";
@@ -14,29 +14,33 @@ export class Kokio {
     viemWalletClient;
     credentialId;
     rpId;
-    organizationId;
     pimlicoAPIKey;
     gasPolicyId;
+    smartAccountClient;
+    deviceWalletAddress;
+    eSIMWalletAddress;
     _constants;
     smartAccount;
     deviceWalletFactory;
     eSIMWalletFactory;
-    lazyWalletRegistry;
+    registry;
     deviceWallet;
     eSIMWallet;
     P256Verifier;
-    constructor(viemWalletClient, credentialId, rpId, organizationId, pimlicoAPIKey, gasPolicyId, smartAccountClient, deviceWalletAddress, eSIMWalletAddress) {
+    constructor(viemWalletClient, credentialId, rpId, pimlicoAPIKey, gasPolicyId, smartAccountClient, deviceWalletAddress, eSIMWalletAddress) {
         this.viemWalletClient = viemWalletClient;
         this.credentialId = credentialId;
         this.rpId = rpId;
-        this.organizationId = organizationId;
         this.pimlicoAPIKey = pimlicoAPIKey;
         this.gasPolicyId = gasPolicyId;
+        this.smartAccountClient = smartAccountClient;
+        this.deviceWalletAddress = deviceWalletAddress;
+        this.eSIMWalletAddress = eSIMWalletAddress;
         this._constants = new ConstantsSubPackage(this.viemWalletClient, this.pimlicoAPIKey);
-        this.smartAccount = new SmartAccountSubPackage(this.viemWalletClient, this.credentialId, this.rpId, this.organizationId, this.pimlicoAPIKey, this.gasPolicyId);
+        this.smartAccount = new SmartAccountSubPackage(this.viemWalletClient, this.credentialId, this.rpId, this.pimlicoAPIKey, this.gasPolicyId);
         this.deviceWalletFactory = smartAccountClient ? new DeviceWalletFactorySubPackage(viemWalletClient, smartAccountClient) : undefined;
         this.eSIMWalletFactory = smartAccountClient ? new ESIMWalletFactorySubPackage(viemWalletClient, smartAccountClient) : undefined;
-        this.lazyWalletRegistry = smartAccountClient ? new LazyWalletRegistrySubPackage(smartAccountClient) : undefined;
+        this.registry = smartAccountClient ? new RegistrySubPackage(smartAccountClient) : undefined;
         this.P256Verifier = smartAccountClient ? new P256VerifierSubPackage(smartAccountClient) : undefined;
         this.deviceWallet = deviceWalletAddress && smartAccountClient ? new DeviceWalletSubPackage(viemWalletClient, smartAccountClient, deviceWalletAddress) : undefined;
         this.eSIMWallet = eSIMWalletAddress && smartAccountClient ? new ESIMWalletSubPackage(smartAccountClient, eSIMWalletAddress) : undefined;
@@ -53,4 +57,35 @@ export class Kokio {
     get constants() {
         return this._constants.load();
     }
+    /**
+     * Bind a `DeviceWallet` instance address after construction and (re)wire
+     * the `deviceWallet` surface to it. Returns `this` for chaining.
+     *
+     * Needs a `smartAccountClient` already on this instance - every write on
+     * `deviceWallet` sends a user operation through it. Without one,
+     * `deviceWallet` stays `undefined`, same as when no address is passed to
+     * the constructor.
+     */
+    setDeviceWalletAddress(deviceWalletAddress) {
+        this.deviceWalletAddress = deviceWalletAddress;
+        this.deviceWallet = this.smartAccountClient
+            ? new DeviceWalletSubPackage(this.viemWalletClient, this.smartAccountClient, deviceWalletAddress)
+            : undefined;
+        return this;
+    }
+    /**
+     * Bind an `ESIMWallet` instance address after construction and (re)wire
+     * the `eSIMWallet` surface to it. Returns `this` for chaining.
+     *
+     * A user holding several eSIM wallets can call this to switch which one
+     * `kokio.eSIMWallet` acts on, without re-creating `Kokio`. Same
+     * `smartAccountClient` requirement as {@link setDeviceWalletAddress}.
+     */
+    setESIMWalletAddress(eSIMWalletAddress) {
+        this.eSIMWalletAddress = eSIMWalletAddress;
+        this.eSIMWallet = this.smartAccountClient
+            ? new ESIMWalletSubPackage(this.smartAccountClient, eSIMWalletAddress)
+            : undefined;
+        return this;
+    }
 }