kokio-sdk 1.1.0 → 2.0.0

package/dist/esm/abis/RegistryHelper.js

@@ -1,4 +1,23 @@
 const RegistryHelper = [
+    {
+        "type": "function",
+        "name": "claimedESIMIdentifiers",
+        "inputs": [
+            {
+                "name": "hashOfESIMIdentifier",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            }
+        ],
+        "stateMutability": "view"
+    },
     {
         "type": "function",
         "name": "deployLazyWallet",
@@ -23,23 +42,6 @@ const RegistryHelper = [
                 "type": "string[]",
                 "internalType": "string[]"
             },
-            {
-                "name": "_dataBundleDetails",
-                "type": "tuple[][]",
-                "internalType": "struct DataBundleDetails[][]",
-                "components": [
-                    {
-                        "name": "dataBundleID",
-                        "type": "string",
-                        "internalType": "string"
-                    },
-                    {
-                        "name": "dataBundlePrice",
-                        "type": "uint256",
-                        "internalType": "uint256"
-                    }
-                ]
-            },
             {
                 "name": "_depositAmount",
                 "type": "uint256",
@@ -60,6 +62,45 @@ const RegistryHelper = [
         ],
         "stateMutability": "payable"
     },
+    {
+        "type": "function",
+        "name": "deployMoreLazyESIMWallets",
+        "inputs": [
+            {
+                "name": "_deviceWallet",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "_deviceUniqueIdentifier",
+                "type": "string",
+                "internalType": "string"
+            },
+            {
+                "name": "_baseSalt",
+                "type": "uint256",
+                "internalType": "uint256"
+            },
+            {
+                "name": "_startIndex",
+                "type": "uint256",
+                "internalType": "uint256"
+            },
+            {
+                "name": "_eSIMUniqueIdentifiers",
+                "type": "string[]",
+                "internalType": "string[]"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "address[]",
+                "internalType": "address[]"
+            }
+        ],
+        "stateMutability": "nonpayable"
+    },
     {
         "type": "function",
         "name": "deviceWalletFactory",
@@ -110,6 +151,44 @@ const RegistryHelper = [
         ],
         "stateMutability": "view"
     },
+    {
+        "type": "function",
+        "name": "eSIMWalletForIdentifier",
+        "inputs": [
+            {
+                "name": "_eSIMUniqueIdentifier",
+                "type": "string",
+                "internalType": "string"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "address",
+                "internalType": "address"
+            }
+        ],
+        "stateMutability": "view"
+    },
+    {
+        "type": "function",
+        "name": "isDeviceIdentifierAlreadyUsed",
+        "inputs": [
+            {
+                "name": "_deviceUniqueIdentifier",
+                "type": "string",
+                "internalType": "string"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "view"
+    },
     {
         "type": "function",
         "name": "isDeviceWalletValid",
@@ -129,6 +208,25 @@ const RegistryHelper = [
         ],
         "stateMutability": "view"
     },
+    {
+        "type": "function",
+        "name": "isESIMIdentifierClaimed",
+        "inputs": [
+            {
+                "name": "_eSIMUniqueIdentifier",
+                "type": "string",
+                "internalType": "string"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "view"
+    },
     {
         "type": "function",
         "name": "isESIMWalletOnStandby",
@@ -180,6 +278,36 @@ const RegistryHelper = [
         ],
         "stateMutability": "view"
     },
+    {
+        "type": "function",
+        "name": "populateLazyHistory",
+        "inputs": [
+            {
+                "name": "_eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "_dataBundleDetails",
+                "type": "tuple[]",
+                "internalType": "struct DataBundleDetails[]",
+                "components": [
+                    {
+                        "name": "dataBundleID",
+                        "type": "string",
+                        "internalType": "string"
+                    },
+                    {
+                        "name": "dataBundlePrice",
+                        "type": "uint256",
+                        "internalType": "uint256"
+                    }
+                ]
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "nonpayable"
+    },
     {
         "type": "function",
         "name": "registeredP256Keys",
@@ -218,6 +346,108 @@ const RegistryHelper = [
         ],
         "stateMutability": "view"
     },
+    {
+        "type": "event",
+        "name": "AdminDisabled",
+        "inputs": [
+            {
+                "name": "_adminOfRecord",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_caller",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "AdminEnabled",
+        "inputs": [
+            {
+                "name": "_adminOfRecord",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_caller",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "AdminUpdateRequested",
+        "inputs": [
+            {
+                "name": "eSIMWalletAdmin",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_newAdmin",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "AdminUpdateRevoked",
+        "inputs": [
+            {
+                "name": "_caller",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_revokedAddress",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "AdminUpdated",
+        "inputs": [
+            {
+                "name": "_newAdmin",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "DefaultDataBundlePriceCapUpdated",
+        "inputs": [
+            {
+                "name": "_cap",
+                "type": "uint256",
+                "indexed": false,
+                "internalType": "uint256"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "event",
         "name": "DeviceWalletInfoUpdated",
@@ -243,6 +473,56 @@ const RegistryHelper = [
         ],
         "anonymous": false
     },
+    {
+        "type": "event",
+        "name": "DeviceWalletOwnerKeyUpdated",
+        "inputs": [
+            {
+                "name": "_deviceWallet",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_oldOwnerKey",
+                "type": "bytes32[2]",
+                "indexed": false,
+                "internalType": "bytes32[2]"
+            },
+            {
+                "name": "_newOwnerKey",
+                "type": "bytes32[2]",
+                "indexed": false,
+                "internalType": "bytes32[2]"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "ESIMIdentifierClaimed",
+        "inputs": [
+            {
+                "name": "_hashOfESIMIdentifier",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            },
+            {
+                "name": "_eSIMUniqueIdentifier",
+                "type": "string",
+                "indexed": false,
+                "internalType": "string"
+            },
+            {
+                "name": "_eSIMWallet",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "event",
         "name": "ESIMWalletSetOnStandby",
@@ -299,6 +579,19 @@ const RegistryHelper = [
         ],
         "anonymous": false
     },
+    {
+        "type": "event",
+        "name": "Paused",
+        "inputs": [
+            {
+                "name": "_admin",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "event",
         "name": "RegistryInitialized",
@@ -332,11 +625,18 @@ const RegistryHelper = [
                 "type": "address",
                 "indexed": true,
                 "internalType": "address"
-            },
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "Unpaused",
+        "inputs": [
             {
-                "name": "_verifier",
+                "name": "_owner",
                 "type": "address",
-                "indexed": false,
+                "indexed": true,
                 "internalType": "address"
             }
         ],
@@ -374,10 +674,104 @@ const RegistryHelper = [
         ],
         "anonymous": false
     },
+    {
+        "type": "event",
+        "name": "VaultAddressUpdated",
+        "inputs": [
+            {
+                "name": "_updatedVaultAddress",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "error",
+        "name": "DeviceWalletAlreadyExists",
+        "inputs": [
+            {
+                "name": "deviceIdentifier",
+                "type": "string",
+                "internalType": "string"
+            },
+            {
+                "name": "deviceWallet",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    },
+    {
+        "type": "error",
+        "name": "ESIMIdentifierAlreadyClaimed",
+        "inputs": [
+            {
+                "name": "eSIMIdentifier",
+                "type": "string",
+                "internalType": "string"
+            },
+            {
+                "name": "eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    },
+    {
+        "type": "error",
+        "name": "ESIMIdentifierReservedForLazyWallet",
+        "inputs": [
+            {
+                "name": "eSIMIdentifier",
+                "type": "string",
+                "internalType": "string"
+            }
+        ]
+    },
+    {
+        "type": "error",
+        "name": "EmptyESIMIdentifier",
+        "inputs": []
+    },
+    {
+        "type": "error",
+        "name": "NotADeviceWallet",
+        "inputs": [
+            {
+                "name": "account",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    },
+    {
+        "type": "error",
+        "name": "NotAProtocolESIMWallet",
+        "inputs": [
+            {
+                "name": "eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    },
     {
         "type": "error",
         "name": "OnlyLazyWalletRegistry",
         "inputs": []
+    },
+    {
+        "type": "error",
+        "name": "UnknownESIMWallet",
+        "inputs": [
+            {
+                "name": "eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
     }
 ];
 export default RegistryHelper;

package/dist/esm/abis/index.js

@@ -7,4 +7,5 @@ import P256Verifier from './P256Verifier.js';
 import Registry from './Registry.js';
 import RegistryHelper from './RegistryHelper.js';
 import BeaconProxy from './BeaconProxy.js';
-export { DeviceWallet, DeviceWalletFactory, ESIMWallet, ESIMWalletFactory, LazyWalletRegistry, P256Verifier, Registry, RegistryHelper, BeaconProxy };
+import ProtocolAdmin from './ProtocolAdmin.js';
+export { DeviceWallet, DeviceWalletFactory, ESIMWallet, ESIMWalletFactory, LazyWalletRegistry, P256Verifier, Registry, RegistryHelper, BeaconProxy, ProtocolAdmin };

package/dist/esm/admin/config-admin.js

@@ -3,12 +3,16 @@ import { AdminDeviceWalletFactorySubPackage } from "./interface/deviceWalletFact
 import { AdminESIMWalletFactorySubPackage } from "./interface/eSIMWalletFactoryClass.js";
 import { AdminRegistrySubPackage } from "./interface/registryClass.js";
 import { AdminLazyWalletRegistrySubPackage } from "./interface/lazyWalletRegistryClass.js";
+import { AdminProtocolAdminSubPackage } from "./interface/protocolAdminClass.js";
 import { AdminDeviceWalletSubPackage } from "./interface/deviceWalletClass.js";
 import { AdminESIMWalletSubPackage } from "./interface/eSIMWalletClass.js";
 // Re-export the typed error surface so backend consumers can `instanceof
 // KokioError` (or a subclass) and decode reverts without reaching into internal
 // module paths - mirroring `config.ts`.
 export { KokioError, NullOrUndefinedValueError, MissingSmartWalletError, MissingEOAWalletError, InvalidClientError, UnsupportedChainError, UnconfiguredChainError, CounterfactualMismatchError, ContractRevertError, decodeContractRevert, } from "../logic/errors.js";
+// `getOperationState` answers with this, and comparing against it needs the enum
+// at runtime rather than only in the types.
+export { OperationState } from "../logic/admin/reads/protocolAdmin.reads.js";
 /**
  * EOA-only entry point for the NodeJS backend.
  *
@@ -35,6 +39,7 @@ export class KokioAdmin {
     eSIMWalletFactory;
     registry;
     lazyWalletRegistry;
+    protocolAdmin;
     // Instance-scoped surfaces - undefined until their address is known.
     deviceWallet;
     eSIMWallet;
@@ -47,6 +52,7 @@ export class KokioAdmin {
         this.eSIMWalletFactory = new AdminESIMWalletFactorySubPackage(walletClient);
         this.registry = new AdminRegistrySubPackage(walletClient);
         this.lazyWalletRegistry = new AdminLazyWalletRegistrySubPackage(walletClient);
+        this.protocolAdmin = new AdminProtocolAdminSubPackage(walletClient);
         this.deviceWallet = deviceWalletAddress ? new AdminDeviceWalletSubPackage(walletClient, deviceWalletAddress) : undefined;
         this.eSIMWallet = eSIMWalletAddress ? new AdminESIMWalletSubPackage(walletClient, eSIMWalletAddress) : undefined;
     }
@@ -95,6 +101,7 @@ export class KokioAdmin {
         this.eSIMWalletFactory = new AdminESIMWalletFactorySubPackage(walletClient);
         this.registry = new AdminRegistrySubPackage(walletClient);
         this.lazyWalletRegistry = new AdminLazyWalletRegistrySubPackage(walletClient);
+        this.protocolAdmin = new AdminProtocolAdminSubPackage(walletClient);
         this.deviceWallet = this.deviceWalletAddress ? new AdminDeviceWalletSubPackage(walletClient, this.deviceWalletAddress) : undefined;
         this.eSIMWallet = this.eSIMWalletAddress ? new AdminESIMWalletSubPackage(walletClient, this.eSIMWalletAddress) : undefined;
         return this;

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

@@ -1,5 +1,5 @@
-import { _deployESIMWallet, _setESIMUniqueIdentifierForAnESIMWallet, } from "../../logic/admin/deviceWallet.eoa.js";
-import { _deviceUniqueIdentifier, _isValidESIMWallet, _canPullETH, _getVaultAddress, } from "../../logic/admin/reads/deviceWallet.reads.js";
+import { _addDeposit, _deployESIMWallet } from "../../logic/admin/deviceWallet.eoa.js";
+import { _deviceUniqueIdentifier, _isValidESIMWallet, _canPullETH, _getVaultAddress, _getOwner, _getDeposit, _isValidSignature, _registry, _eSIMWalletFactory, _entryPoint, _verifier, } from "../../logic/admin/reads/deviceWallet.reads.js";
 /**
  * Thin EOA wrapper around a specific `DeviceWallet` instance. The instance
  * address is bound at construction; `KokioAdmin.setDeviceWalletAddress` swaps it
@@ -12,11 +12,11 @@ export class AdminDeviceWalletSubPackage {
         this.walletClient = walletClient;
         this.deviceWalletAddress = deviceWalletAddress;
     }
-    deployESIMWallet(hasAccessToETH, salt) {
-        return _deployESIMWallet(this.walletClient, this.deviceWalletAddress, hasAccessToETH, salt);
+    deployESIMWallet(salt) {
+        return _deployESIMWallet(this.walletClient, this.deviceWalletAddress, salt);
     }
-    setESIMUniqueIdentifierForAnESIMWallet(eSIMWalletAddress, eSIMUniqueIdentifier) {
-        return _setESIMUniqueIdentifierForAnESIMWallet(this.walletClient, this.deviceWalletAddress, eSIMWalletAddress, eSIMUniqueIdentifier);
+    addDeposit(amount) {
+        return _addDeposit(this.walletClient, this.deviceWalletAddress, amount);
     }
     // Reads: public storage getters and views
     deviceUniqueIdentifier() {
@@ -31,4 +31,25 @@ export class AdminDeviceWalletSubPackage {
     getVaultAddress() {
         return _getVaultAddress(this.walletClient, this.deviceWalletAddress);
     }
+    getOwner() {
+        return _getOwner(this.walletClient, this.deviceWalletAddress);
+    }
+    getDeposit() {
+        return _getDeposit(this.walletClient, this.deviceWalletAddress);
+    }
+    isValidSignature(messageHash, signature) {
+        return _isValidSignature(this.walletClient, this.deviceWalletAddress, messageHash, signature);
+    }
+    registry() {
+        return _registry(this.walletClient, this.deviceWalletAddress);
+    }
+    eSIMWalletFactory() {
+        return _eSIMWalletFactory(this.walletClient, this.deviceWalletAddress);
+    }
+    entryPoint() {
+        return _entryPoint(this.walletClient, this.deviceWalletAddress);
+    }
+    verifier() {
+        return _verifier(this.walletClient, this.deviceWalletAddress);
+    }
 }

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);
+    }
 }