kokio-sdk 3.0.2 → 3.1.0

package/dist/esm/logic/deviceWalletFactory.js

@@ -1,8 +1,8 @@
-import { _getChainSpecificConstants } from "./constants.js";
+import { _chainId, _getChainSpecificConstants } from "./constants.js";
 import { MissingEOAWalletError } from "./errors.js";
 import { DeviceWalletFactory } from "../abis/index.js";
 export const _createAccountWithEOA = async (client, deviceUniqueIdentifier, deviceWalletOwnerKey, salt, depositAmount) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
@@ -12,7 +12,7 @@ export const _createAccountWithEOA = async (client, deviceUniqueIdentifier, devi
     return client.writeContract({
         address: values.factoryAddresses.DEVICE_WALLET_FACTORY,
         chain: values.chain,
-        account: client.account.address,
+        account: client.account,
         abi: DeviceWalletFactory,
         functionName: 'createAccount',
         args: [deviceUniqueIdentifier, deviceWalletOwnerKey, salt],
@@ -23,7 +23,7 @@ export const _createAccountWithEOA = async (client, deviceUniqueIdentifier, devi
 // On-chain arg order is (bytes32[2] ownerKey, string uid, uint256 salt); note this
 // differs from `createAccount`.
 export const _getAddress = async (client, deviceUniqueIdentifier, deviceWalletOwnerKey, salt) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -35,7 +35,7 @@ export const _getAddress = async (client, deviceUniqueIdentifier, deviceWalletOw
 };
 // `getCurrentDeviceWalletImplementation` is a `view` - read it directly instead of a userOp.
 export const _getCurrentDeviceWalletImplementation = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -57,7 +57,7 @@ export const _getCurrentDeviceWalletImplementation = async (client) => {
  * Reverts on an empty identifier or a key that is not a point on the P256 curve.
  */
 export const _preCreateAccountValidation = async (client, deviceUniqueIdentifier, deviceWalletOwnerKey) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -73,7 +73,7 @@ export const _preCreateAccountValidation = async (client, deviceUniqueIdentifier
  * registers it.
  */
 export const _deviceWalletInfoAdded = async (client, deviceWallet) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -88,7 +88,7 @@ export const _deviceWalletInfoAdded = async (client, deviceWallet) => {
  * all of them and no wallet can decline it.
  */
 export const _beacon = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -100,7 +100,7 @@ export const _beacon = async (client) => {
 };
 /** The registry the factory writes new wallets into. */
 export const _registry = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -112,7 +112,7 @@ export const _registry = async (client) => {
 };
 /** The EntryPoint baked into every device wallet this factory deploys. */
 export const _entryPoint = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -124,7 +124,7 @@ export const _entryPoint = async (client) => {
 };
 /** The contract new device wallets verify WebAuthn assertions through. */
 export const _verifier = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({

package/dist/esm/logic/eSIMWallet.js

@@ -1,6 +1,7 @@
-import { encodeFunctionData, maxUint256 } from "viem";
+import { encodeFunctionData, erc20Abi, maxUint256 } from "viem";
 import { MissingSmartWalletError } from "./errors.js";
-import { ESIMWallet } from "../abis/index.js";
+import { ESIMWallet, PaymentAdapter, Registry } from "../abis/index.js";
+import { _chainId, _getChainSpecificConstants } from "./constants.js";
 import { _defaultPriceCapUSDCents } from "./registry.js";
 // Not exposed on this surface:
 //   - populateHistory and setESIMUniqueIdentifier are `onlyRegistry` - callable
@@ -61,6 +62,53 @@ export const _buyDataBundleWithToken = async (client, address, dataBundleDetails
             }]
     });
 };
+/**
+ * Buy a data bundle with tokens the device wallet sends over in the same user
+ * operation, so the eSIM wallet needs no access to the device wallet's funds.
+ *
+ * Only the shortfall is sent: the quote for the bundle minus what this eSIM
+ * wallet already holds of `asset`. Arguments are as for `buyDataBundleWithToken`.
+ */
+export const _buyDataBundleWithTransfer = async (client, address, dataBundleDetails, asset, maxAmountIn, paymentReference) => {
+    const chainID = await _chainId(client);
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    if (!client.account)
+        throw new MissingSmartWalletError();
+    // The eSIM wallet pays through whichever adapter the registry names, so read it there.
+    const adapter = await client.readContract({
+        address: values.factoryAddresses.REGISTRY, abi: Registry, functionName: "paymentAdapter"
+    });
+    const [{ token }, amountIn] = await Promise.all([
+        client.readContract({
+            address: adapter, abi: PaymentAdapter, functionName: "resolveAsset", args: [asset]
+        }),
+        client.readContract({
+            address: adapter, abi: PaymentAdapter, functionName: "quote", args: [asset, dataBundleDetails.priceUSDCents]
+        }),
+    ]);
+    const held = await client.readContract({
+        address: token, abi: erc20Abi, functionName: "balanceOf", args: [address]
+    });
+    const buy = {
+        to: address,
+        data: encodeFunctionData({
+            abi: ESIMWallet,
+            functionName: "buyDataBundleWithToken",
+            args: [dataBundleDetails, asset, maxAmountIn, paymentReference]
+        })
+    };
+    return client.sendUserOperation({
+        account: client.account,
+        calls: held >= amountIn ? [buy] : [
+            {
+                to: token,
+                data: encodeFunctionData({ abi: erc20Abi, functionName: "transfer", args: [address, amountIn - held] })
+            },
+            buy
+        ]
+    });
+};
 /**
  * Send an ERC-20 held by this eSIM wallet back to its owning device wallet.
  * `onlyDeviceWallet`.

package/dist/esm/logic/eSIMWalletFactory.js

@@ -1,5 +1,5 @@
 import { encodeFunctionData } from "viem";
-import { _getChainSpecificConstants } from "./constants.js";
+import { _chainId, _getChainSpecificConstants } from "./constants.js";
 import { MissingSmartWalletError } from "./errors.js";
 import { ESIMWalletFactory } from "../abis/index.js";
 // Not exposed on this surface:
@@ -10,7 +10,7 @@ import { ESIMWalletFactory } from "../abis/index.js";
 // `deployESIMWalletWithUserOp` works because a registered device wallet passes
 // `registry.isDeviceWalletValid(msg.sender)`, so the userOp sender satisfies the modifier.
 export const _deployESIMWalletWithUserOp = async (client, deviceWalletAddress, salt) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
@@ -28,8 +28,20 @@ export const _deployESIMWalletWithUserOp = async (client, deviceWalletAddress, s
             }]
     });
 };
+/** Address `deployESIMWallet` deploys to for this device wallet and salt. */
+export const _getESIMWalletCounterFactualAddress = async (client, deviceWalletAddress, salt) => {
+    const chainID = await _chainId(client);
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    return client.readContract({
+        address: values.factoryAddresses.ESIM_WALLET_FACTORY,
+        abi: ESIMWalletFactory,
+        functionName: "getCounterFactualAddress",
+        args: [deviceWalletAddress, salt]
+    });
+};
 export const _getCurrentESIMWalletImplementation = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     // `getCurrentESIMWalletImplementation` is a `view` - read it directly instead of a userOp.

package/dist/esm/logic/errors.js

@@ -1,5 +1,5 @@
 import { BaseError, ContractFunctionRevertedError, decodeErrorResult, isHex, } from "viem";
-import { DeviceWallet, DeviceWalletFactory, ESIMWallet, ESIMWalletFactory, LazyWalletRegistry, P256Verifier, Registry, RegistryHelper, } from "../abis/index.js";
+import { DeviceWallet, DeviceWalletFactory, ESIMWallet, ESIMWalletFactory, LazyWalletRegistry, P256Verifier, Registry, RegistryHelper, ProtocolAdmin, PaymentAdapter, } from "../abis/index.js";
 /**
  * Base class for every error the Kokio SDK throws deliberately. Consumers can
  * `instanceof KokioError` to distinguish SDK-originated failures from viem /
@@ -144,6 +144,8 @@ const REVERTABLE_ABIS = [
     P256Verifier,
     Registry,
     RegistryHelper,
+    ProtocolAdmin,
+    PaymentAdapter,
 ];
 /**
  * Best-effort decode of raw revert data (the ABI-encoded `Error(string)`,
@@ -181,21 +183,25 @@ export class ContractRevertError extends KokioError {
     }
 }
 /**
- * Pulls a ContractRevertError out of an error thrown by viem, or `null` if it
- * isn't a revert viem could decode a selector for.
+ * Pulls a ContractRevertError out of an error thrown by viem, or `null` when
+ * the error carries no revert data (a network failure, a rejected signature).
  */
 export const toContractRevertError = (err) => {
     if (!(err instanceof BaseError))
         return null;
     const revert = err.walk((e) => e instanceof ContractFunctionRevertedError);
-    if (!(revert instanceof ContractFunctionRevertedError) || !revert.raw)
-        return null;
-    return new ContractRevertError(revert.raw);
+    if (revert instanceof ContractFunctionRevertedError && revert.raw)
+        return new ContractRevertError(revert.raw);
+    // A bundler rejects a reverting user operation while estimating its gas, and
+    // puts the revert data only in the error message.
+    const data = err.details?.match(/reverted during simulation with reason: (0x[0-9a-fA-F]+)/)?.[1];
+    return data ? new ContractRevertError(data) : null;
 };
 /**
- * `client.writeContract`, but a recognised on-chain revert comes back as a
- * ContractRevertError instead of viem's raw error chain. Anything else -
- * network failures, an unrecognised revert selector - is rethrown as-is.
+ * `client.writeContract`, but a revert comes back as a ContractRevertError
+ * instead of viem's raw error chain. Its `decoded` is null when the selector
+ * belongs to none of the Kokio contracts. Anything that is not a revert, such
+ * as a network failure, is rethrown as-is.
  *
  * Mirrors `WalletClient["writeContract"]`'s own generics rather than reading
  * them off `Parameters<...>`, since that would collapse the per-call overload

package/dist/esm/logic/paymentAdapter.js

@@ -1,4 +1,4 @@
-import { _getChainSpecificConstants } from "./constants.js";
+import { _chainId, _getChainSpecificConstants } from "./constants.js";
 import { PaymentAdapter } from "../abis/index.js";
 // Every function here is a view. The adapter's only writes reachable from a
 // userOp are `settle` (`onlyESIMWallet`, called from inside
@@ -10,7 +10,7 @@ import { PaymentAdapter } from "../abis/index.js";
  * The registry this adapter reads `vault()` and `isESIMWalletValid()` from.
  */
 export const _registry = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -22,7 +22,7 @@ export const _registry = async (client) => {
 };
 /** The ERC-20 registered under the `USDC` symbol at configure time. */
 export const _settlementToken = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -38,7 +38,7 @@ export const _settlementToken = async (client) => {
  * from "registered but withdrawn" (`allowed: false`).
  */
 export const _assets = async (client, symbol) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     const [allowed, isDollarUnit, decimals, token] = await client.readContract({
@@ -56,7 +56,7 @@ export const _assets = async (client, symbol) => {
  * purchase will revert with `AssetNotTransferable`.
  */
 export const _resolveAsset = async (client, symbol) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -74,7 +74,7 @@ export const _resolveAsset = async (client, symbol) => {
  * but the contract will not assume that on the caller's behalf.
  */
 export const _quote = async (client, symbol, priceUSDCents) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -92,7 +92,7 @@ export const _quote = async (client, symbol, priceUSDCents) => {
  * still reads the adapter's own record from before that move.
  */
 export const _usedReferences = async (client, paymentReference) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -104,7 +104,7 @@ export const _usedReferences = async (client, paymentReference) => {
 };
 /** The address holding upgrade authority over this adapter (its owner). */
 export const _upgradeManager = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({

package/dist/esm/logic/registry.js

@@ -1,5 +1,5 @@
 import { encodeFunctionData } from "viem";
-import { _getChainSpecificConstants } from "./constants.js";
+import { _chainId, _getChainSpecificConstants } from "./constants.js";
 import { Registry } from "../abis/index.js";
 import { MissingSmartWalletError } from "./errors.js";
 // A userOp from a device wallet arrives at the registry with msg.sender set to the
@@ -27,7 +27,7 @@ import { MissingSmartWalletError } from "./errors.js";
 export const _bindESIMWallet = async (client, eSIMWalletAddress) => {
     if (!client.account)
         throw new MissingSmartWalletError();
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.sendUserOperation({
@@ -53,7 +53,7 @@ export const _bindESIMWallet = async (client, eSIMWalletAddress) => {
 export const _toggleESIMWalletStandbyStatus = async (client, eSIMWalletAddress, isOnStandby) => {
     if (!client.account)
         throw new MissingSmartWalletError();
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.sendUserOperation({
@@ -75,7 +75,7 @@ export const _toggleESIMWalletStandbyStatus = async (client, eSIMWalletAddress,
  * deployed.
  */
 export const _isDeviceIdentifierAlreadyUsed = async (client, deviceUniqueIdentifier) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     // A `view` - read it directly instead of spending a userOp.
@@ -92,7 +92,7 @@ export const _isDeviceIdentifierAlreadyUsed = async (client, deviceUniqueIdentif
  * purchase.
  */
 export const _paused = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -108,7 +108,7 @@ export const _paused = async (client) => {
  * failure to carry the protocol's own revert reason.
  */
 export const _requireNotPaused = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     await client.readContract({
@@ -125,7 +125,7 @@ export const _requireNotPaused = async (client) => {
  * holds it now. Ask `deviceWallet.isValidESIMWallet` for that.
  */
 export const _isESIMWalletValid = async (client, eSIMWalletAddress) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -144,7 +144,7 @@ export const _isESIMWalletValid = async (client, eSIMWalletAddress) => {
  * association to still name the device wallet that raised the flag.
  */
 export const _isESIMWalletOnStandby = async (client, eSIMWalletAddress) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -156,7 +156,7 @@ export const _isESIMWalletOnStandby = async (client, eSIMWalletAddress) => {
 };
 /** Whether a device wallet is registered with the protocol. */
 export const _isDeviceWalletValid = async (client, deviceWalletAddress) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -168,7 +168,7 @@ export const _isDeviceWalletValid = async (client, deviceWalletAddress) => {
 };
 /** The device wallet registered for a device identifier, zero if none. */
 export const _uniqueIdentifierToDeviceWallet = async (client, deviceUniqueIdentifier) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -180,7 +180,7 @@ export const _uniqueIdentifierToDeviceWallet = async (client, deviceUniqueIdenti
 };
 /** Whether an eSIM identifier is already held by a wallet. */
 export const _isESIMIdentifierClaimed = async (client, eSIMUniqueIdentifier) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -196,7 +196,7 @@ export const _isESIMIdentifierClaimed = async (client, eSIMUniqueIdentifier) =>
  * belongs to the wallet rather than to whichever device is holding it.
  */
 export const _eSIMWalletForIdentifier = async (client, eSIMUniqueIdentifier) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -208,7 +208,7 @@ export const _eSIMWalletForIdentifier = async (client, eSIMUniqueIdentifier) =>
 };
 /** The fallback price ceiling in USD cents for a wallet holding no cap of its own. */
 export const _defaultPriceCapUSDCents = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -220,7 +220,7 @@ export const _defaultPriceCapUSDCents = async (client) => {
 };
 /** The payment adapter this registry currently points at. */
 export const _paymentAdapter = async (client) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -236,7 +236,7 @@ export const _paymentAdapter = async (client) => {
  * the contract keys `usedPaymentReferences` by, not the bare reference.
  */
 export const _usedPaymentReferences = async (client, scopedReference) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     return client.readContract({
@@ -252,7 +252,7 @@ export const _usedPaymentReferences = async (client, scopedReference) => {
  * calling it first only turns that revert into a typed error ahead of a userOp.
  */
 export const _requireLazyHistoryCopied = async (client, eSIMWallet) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     await client.readContract({
@@ -269,7 +269,7 @@ export const _requireLazyHistoryCopied = async (client, eSIMWallet) => {
  * all then refuse it.
  */
 export const _requireDeviceIdentifierNotReserved = async (client, deviceUniqueIdentifier) => {
-    const chainID = await client.getChainId();
+    const chainID = await _chainId(client);
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     await client.readContract({

package/dist/esm/logic/utils.js

@@ -1,6 +1,4 @@
-import { isHex, toHex } from "viem";
-import { AsnParser } from "@peculiar/asn1-schema";
-import { ECDSASigValue } from "@peculiar/asn1-ecc";
+import { isHex } from "viem";
 import { NullOrUndefinedValueError } from "./errors.js";
 export const _add0x = (data) => {
     if (!data) {
@@ -8,12 +6,6 @@ export const _add0x = (data) => {
     }
     return (data.indexOf('0x') !== -1) ? isHex(data) ? data : `0x${data}` : `0x${data}`;
 };
-export const _remove0x = (data) => {
-    if (!data) {
-        throw new NullOrUndefinedValueError();
-    }
-    return (data.indexOf('0x') !== -1) ? data.slice(2) : data;
-};
 export function _shouldRemoveLeadingZero(bytes) {
     return bytes[0] === 0x0 && (bytes[1] & (1 << 7)) !== 0;
 }
@@ -27,75 +19,3 @@ export function _concatUint8Arrays(arrays) {
     });
     return toReturn;
 }
-export function base64UrlToBuffer(base64url) {
-    const base64 = base64url
-        .replace(/-/g, "+")
-        .replace(/_/g, "/")
-        .padEnd((base64url.length + 3) & ~3, "=");
-    return Buffer.from(base64, "base64");
-}
-export function decodeClientDataJSON(base64url) {
-    const base64 = base64url
-        .replace(/-/g, "+")
-        .replace(/_/g, "/")
-        .padEnd((base64url.length + 3) & ~3, "=");
-    const jsonString = Buffer.from(base64, "base64").toString("utf-8");
-    return JSON.parse(jsonString);
-}
-export function hexToArrayBuffer(hexString) {
-    const cleanHex = hexString.startsWith("0x") ? hexString.slice(2) : hexString;
-    const bytes = new Uint8Array(cleanHex.length / 2);
-    for (let i = 0; i < bytes.length; i++) {
-        bytes[i] = parseInt(cleanHex.substr(i * 2, 2), 16);
-    }
-    return bytes.buffer;
-}
-export function parseDEREncodedSignature(signature) {
-    let offset = 0;
-    if (signature[offset++] !== 0x30)
-        throw new Error("Invalid DER sequence");
-    // Sequence length byte. Skipped, because r and s each carry their own length.
-    offset++;
-    if (signature[offset++] !== 0x02)
-        throw new Error("Expected integer for r");
-    const rLen = signature[offset++];
-    const r = signature.slice(offset, offset + rLen);
-    offset += rLen;
-    if (signature[offset++] !== 0x02)
-        throw new Error("Expected integer for s");
-    const sLen = signature[offset++];
-    const s = signature.slice(offset, offset + sLen);
-    return {
-        r: Buffer.from(r).toString("hex"),
-        s: Buffer.from(s).toString("hex"),
-    };
-}
-export function shouldRemoveLeadingZero(bytes) {
-    return bytes[0] === 0x0 && (bytes[1] & (1 << 7)) !== 0;
-}
-export function concatUint8Arrays(arrays) {
-    let pointer = 0;
-    const totalLength = arrays.reduce((prev, curr) => prev + curr.length, 0);
-    const toReturn = new Uint8Array(totalLength);
-    arrays.forEach((arr) => {
-        toReturn.set(arr, pointer);
-        pointer += arr.length;
-    });
-    return toReturn;
-}
-export function parseSignature(signature) {
-    const parsedSignature = AsnParser.parse(signature, ECDSASigValue);
-    let rBytes = new Uint8Array(parsedSignature.r);
-    let sBytes = new Uint8Array(parsedSignature.s);
-    if (shouldRemoveLeadingZero(rBytes)) {
-        rBytes = rBytes.slice(1);
-    }
-    if (shouldRemoveLeadingZero(sBytes)) {
-        sBytes = sBytes.slice(1);
-    }
-    const finalSignature = concatUint8Arrays([rBytes, sBytes]);
-    return {
-        r: toHex(finalSignature.slice(0, 32)),
-        s: toHex(finalSignature.slice(32)),
-    };
-}

package/dist/types/admin/config-admin.d.ts

@@ -8,7 +8,7 @@ import { AdminProtocolAdminSubPackage } from "./interface/protocolAdminClass.js"
 import { AdminDeviceWalletSubPackage } from "./interface/deviceWalletClass.js";
 import { AdminESIMWalletSubPackage } from "./interface/eSIMWalletClass.js";
 import { AdminPaymentAdapterSubPackage } from "./interface/paymentAdapterClass.js";
-export { KokioError, NullOrUndefinedValueError, MissingSmartWalletError, MissingEOAWalletError, InvalidClientError, UnsupportedChainError, UnconfiguredChainError, CounterfactualMismatchError, ContractRevertError, decodeContractRevert, } from "../logic/errors.js";
+export { KokioError, NullOrUndefinedValueError, MissingSmartWalletError, MissingEOAWalletError, InvalidClientError, UnsupportedChainError, UnconfiguredChainError, CounterfactualMismatchError, BatchSizeOutOfRangeError, DepositOnResumeError, ESIMWalletNotLazyDeployedError, MissingBatchEventError, StalledBatchError, ContractRevertError, decodeContractRevert, } from "../logic/errors.js";
 export type { DecodedRevert } from "../logic/errors.js";
 export { OperationState } from "../logic/admin/reads/protocolAdmin.reads.js";
 /**

package/dist/types/config.d.ts

@@ -9,7 +9,7 @@ import { ESIMWalletSubPackage } from "./interface/eSIMWalletClass.js";
 import { ESIMWalletFactorySubPackage } from "./interface/eSIMWalletFactoryClass.js";
 import { PaymentAdapterSubPackage } from "./interface/paymentAdapterClass.js";
 import { KokioSmartAccountClient } from "./types.js";
-export { KokioError, NullOrUndefinedValueError, MissingSmartWalletError, MissingEOAWalletError, InvalidClientError, UnsupportedChainError, UnconfiguredChainError, CounterfactualMismatchError, ContractRevertError, decodeContractRevert, } from "./logic/errors.js";
+export { KokioError, NullOrUndefinedValueError, MissingSmartWalletError, MissingEOAWalletError, InvalidClientError, UnsupportedChainError, UnconfiguredChainError, CounterfactualMismatchError, BatchSizeOutOfRangeError, DepositOnResumeError, ESIMWalletNotLazyDeployedError, MissingBatchEventError, StalledBatchError, ContractRevertError, decodeContractRevert, } from "./logic/errors.js";
 export type { DecodedRevert } from "./logic/errors.js";
 export declare class Kokio {
     viemWalletClient: WalletClient;

package/dist/types/interface/deviceWalletClass.d.ts

@@ -8,6 +8,18 @@ export declare class DeviceWalletSubPackage {
     sendUserOperation(calls: Call[]): Promise<`0x${string}`>;
     addDeposit(amount: bigint): Promise<`0x${string}`>;
     addESIMWallet(eSIMWalletAddress: Address): Promise<`0x${string}`>;
+    /**
+     * Deploy an eSIM wallet and bind it to this device wallet in one user
+     * operation, optionally granting it access to this wallet's tokens too.
+     * Resolves once the operation is sent, with its hash and the eSIM wallet's
+     * address.
+     */
+    deployAndBindESIMWallet(salt: bigint, options?: {
+        grantAccessToFunds?: boolean;
+    }): Promise<{
+        userOpHash: Hex;
+        eSIMWalletAddress: Address;
+    }>;
     getVaultAddress(): Promise<`0x${string}`>;
     removeESIMWallet(eSIMWalletAddress: Address, callBackETH: boolean): Promise<`0x${string}`>;
     toggleAccessToFunds(eSIMWalletAddress: Address, hasAccessToFunds: boolean): Promise<`0x${string}`>;

package/dist/types/interface/eSIMWalletClass.d.ts

@@ -7,6 +7,12 @@ export declare class ESIMWalletSubPackage {
     constructor(client: KokioSmartAccountClient, address: Address);
     acceptOwnershipTransfer(): Promise<`0x${string}`>;
     buyDataBundleWithToken(dataBundleDetails: DataBundleDetails, asset: Hex, maxAmountIn: bigint, paymentReference: Hex): Promise<`0x${string}`>;
+    /**
+     * Same purchase as `buyDataBundleWithToken`, with the device wallet sending
+     * the tokens it needs in the same user operation. Works without having granted
+     * this eSIM wallet access to the device wallet's funds.
+     */
+    buyDataBundleWithTransfer(dataBundleDetails: DataBundleDetails, asset: Hex, maxAmountIn: bigint, paymentReference: Hex): Promise<`0x${string}`>;
     priceCapUSDCents(): Promise<bigint>;
     deviceWallet(): Promise<`0x${string}`>;
     owner(): Promise<`0x${string}`>;

package/dist/types/interface/eSIMWalletFactoryClass.d.ts

@@ -4,6 +4,12 @@ export declare class ESIMWalletFactorySubPackage {
     smartAccountClient: KokioSmartAccountClient;
     walletClient: WalletClient;
     constructor(walletClient: WalletClient, smartAccountClient: KokioSmartAccountClient);
+    /**
+     * @deprecated Deploys without binding, so the device wallet does not treat the
+     * new eSIM wallet as its own. Use `deviceWallet.deployAndBindESIMWallet`.
+     */
     deployESIMWalletWithUserOp(deviceWalletAddress: Address, salt: bigint): Promise<`0x${string}`>;
+    /** Address the eSIM wallet for this device wallet and salt deploys to. */
+    getCounterFactualAddress(deviceWalletAddress: Address, salt: bigint): Promise<`0x${string}`>;
     getCurrentESIMWalletImplementation(): Promise<`0x${string}`>;
 }

package/dist/types/interface/registryClass.d.ts

@@ -3,6 +3,14 @@ import { KokioSmartAccountClient } from "../types.js";
 export declare class RegistrySubPackage {
     client: KokioSmartAccountClient;
     constructor(client: KokioSmartAccountClient);
+    /**
+     * Record in the registry that this device wallet holds the eSIM wallet.
+     *
+     * Registry side only: the device wallet itself still does not treat the eSIM
+     * wallet as its own (`isValidESIMWallet` stays false, so it cannot manage it or
+     * grant it fund access). To take on an eSIM wallet use `deviceWallet.addESIMWallet`,
+     * which writes both sides.
+     */
     bindESIMWallet(eSIMWalletAddress: Address): Promise<`0x${string}`>;
     toggleESIMWalletStandbyStatus(eSIMWalletAddress: Address, isOnStandby: boolean): Promise<`0x${string}`>;
     isDeviceIdentifierAlreadyUsed(deviceUniqueIdentifier: string): Promise<boolean>;

package/dist/types/interface/smartAccountClass.d.ts

@@ -8,5 +8,14 @@ export declare class SmartAccountSubPackage {
     gasPolicyId: string;
     constructor(client: WalletClient, credentialId: string, rpId: string, pimlicoAPIKey: string, gasPolicyId: string);
     getSmartWallet(deviceUniqueIdentifier: string, deviceWalletOwnerKey: P256Key, salt: bigint): Promise<KokioSmartAccount>;
-    getSmartWalletClient(account: KokioSmartAccount): Promise<KokioSmartAccountClient>;
+    /**
+     * Client that sends the account's user operations through a bundler, with
+     * gas sponsored by the paymaster at the same endpoint.
+     *
+     * @param options.bundlerUrl Bundler and ERC-7677 paymaster endpoint. Defaults to
+     * Pimlico for the wallet client's chain, keyed by the API key given to `Kokio`.
+     */
+    getSmartWalletClient(account: KokioSmartAccount, options?: {
+        bundlerUrl?: string;
+    }): Promise<KokioSmartAccountClient>;
 }