kokio-sdk 3.4.0 → 3.5.0

package/dist/types/logic/admin/protocolAdmin.eoa.d.ts

@@ -57,6 +57,13 @@ export declare const _executeRaw: (client: WalletClient, target: Address, value:
  * proposer also holds.
  */
 export declare const _cancel: (client: WalletClient, id: Hex) => Promise<`0x${string}`>;
+/**
+ * Pause a protocol contract straight away. `GUARDIAN_ROLE`.
+ *
+ * Only stops the contract, which the admin key could already do, and a guardian
+ * can release it at once with `_unpauseInstantly`.
+ */
+export declare const _pauseInstantly: (client: WalletClient, target: Address) => Promise<`0x${string}`>;
 /**
  * Release a pause on a protocol contract straight away. `GUARDIAN_ROLE`.
  *
@@ -138,6 +145,13 @@ export declare const _unpauseCall: (client: WalletClient, target?: Address) => P
  * `target` defaults to the registry.
  */
 export declare const _setDefaultPriceCapUSDCentsCall: (client: WalletClient, cap: bigint, target?: Address) => Promise<OwnerCall>;
+/**
+ * Set what the admin key may charge each newly created eSIM wallet, in USD
+ * cents. Pass the result to `schedule`. Existing wallets keep their own figure.
+ *
+ * `target` defaults to the registry.
+ */
+export declare const _setDefaultAdminAllowanceUSDCentsCall: (client: WalletClient, allowance: bigint, target?: Address) => Promise<OwnerCall>;
 /**
  * Point the registry at a new payment adapter. Pass the result to `schedule`.
  *

package/dist/types/logic/admin/reads/eSIMWallet.reads.d.ts

@@ -11,6 +11,11 @@ export declare const _eSIMUniqueIdentifier: (client: WalletClient, eSIMWalletAdd
  * `buyDataBundleWithToken`, since a price over the ceiling reverts.
  */
 export declare const _priceCapUSDCents: (client: WalletClient, eSIMWalletAddress: Address) => Promise<bigint>;
+/**
+ * What the admin key may still charge this eSIM wallet, in USD cents. Only the
+ * owner can raise it, so a purchase above it needs the user first.
+ */
+export declare const _adminAllowanceUSDCents: (client: WalletClient, eSIMWalletAddress: Address) => Promise<bigint>;
 /** The pending owner proposed via `requestTransferOwnership` (zero if none). */
 export declare const _newRequestedOwner: (client: WalletClient, eSIMWalletAddress: Address) => Promise<Address>;
 /** The current owner (device wallet) of this eSIM wallet. */

package/dist/types/logic/admin/reads/registry.reads.d.ts

@@ -27,6 +27,8 @@ export declare const _paused: (client: WalletClient) => Promise<boolean>;
  * cap of its own. Never zero.
  */
 export declare const _defaultPriceCapUSDCents: (client: WalletClient) => Promise<bigint>;
+/** What the admin key may charge a newly created eSIM wallet in total, in USD cents. */
+export declare const _defaultAdminAllowanceUSDCents: (client: WalletClient) => Promise<bigint>;
 /** The vault EOA recorded in the registry. */
 export declare const _vault: (client: WalletClient) => Promise<Address>;
 /** The pending admin nominated via `requestAdminUpdate` (zero address if none). */

package/dist/types/logic/deviceWallet.d.ts

@@ -44,12 +44,12 @@ export declare const _removeESIMWallet: (client: KokioSmartAccountClient, addres
  * Rotate the P256 key that owns this wallet. The registry is told in the same
  * call, so its record of the owner cannot drift from the wallet's.
  *
- * A key that cannot produce a verifiable signature bricks the wallet: this is
- * reachable only through a signed userOp, so there is no rotating back and no
- * reaching the balance afterwards. The contract rejects a key it can tell is
- * unusable, but check the new key can sign before calling.
+ * `newOwnerSignature` is the new passkey's WebAuthn assertion over
+ * `rotationChallenge(newOwner)`, ABI-encoded as a `WebAuthnSignature` with no
+ * version or validUntil header. Without it the contract reverts with
+ * `NewOwnerKeyCannotSign`, so a wallet can only move to a key that can sign.
  */
-export declare const _transferOwnership: (client: KokioSmartAccountClient, address: Address, newOwner: P256Key) => Promise<`0x${string}`>;
+export declare const _transferOwnership: (client: KokioSmartAccountClient, address: Address, newOwner: P256Key, newOwnerSignature: Hex) => Promise<`0x${string}`>;
 /**
  * Top up the gas deposit the EntryPoint holds for this wallet, from the wallet's
  * own balance. Anyone may pay into any account's deposit, so an EOA can do this
@@ -81,6 +81,12 @@ export declare const _canPullFunds: (client: KokioSmartAccountClient, address: A
  * the same owner key's wallet at a different salt.
  */
 export declare const _isValidSignature: (client: KokioSmartAccountClient, address: Address, messageHash: Hex, signature: Hex) => Promise<Hex>;
+/**
+ * The bytes the new passkey must sign before `transferOwnership` accepts it.
+ * Bound to this wallet, this chain and `newOwner`, so it cannot be reused for
+ * another rotation.
+ */
+export declare const _rotationChallenge: (client: KokioSmartAccountClient, address: Address, newOwner: P256Key) => Promise<Hex>;
 /** The registry this wallet reports its ownership changes to. */
 export declare const _registry: (client: KokioSmartAccountClient, address: Address) => Promise<Address>;
 /** The factory that deploys this wallet's eSIM wallets. */

package/dist/types/logic/eSIMWallet.d.ts

@@ -11,6 +11,14 @@ import { KokioSmartAccountClient } from "../types.js";
  * owner has to set it again.
  */
 export declare const _setPriceCapUSDCents: (client: KokioSmartAccountClient, address: Address, cap: bigint) => Promise<`0x${string}`>;
+/**
+ * Set the total the admin key may charge this eSIM wallet, in USD cents. It
+ * replaces what is left rather than adding to it, and zero stops admin charges.
+ *
+ * `onlyDeviceWallet`, so only the user can raise what the admin may spend. A
+ * handover resets it to the registry default.
+ */
+export declare const _setAdminAllowanceUSDCents: (client: KokioSmartAccountClient, address: Address, allowance: bigint) => Promise<`0x${string}`>;
 /**
  * Buy a data bundle in `asset`, an ERC-20 the payment adapter accepts.
  *
@@ -53,6 +61,12 @@ export declare const _owner: (client: KokioSmartAccountClient, address: Address)
  * state is reachable.
  */
 export declare const _priceCapUSDCents: (client: KokioSmartAccountClient, address: Address) => Promise<bigint>;
+/**
+ * What the admin key may still charge this eSIM wallet, in USD cents. Each admin
+ * purchase lowers it and nothing refills it, so the owner tops it up with
+ * `setAdminAllowanceUSDCents`. The owner's own purchases do not touch it.
+ */
+export declare const _adminAllowanceUSDCents: (client: KokioSmartAccountClient, address: Address) => Promise<bigint>;
 /**
  * The device wallet this eSIM wallet belongs to. Tracks `owner`, but it is its
  * own storage slot with its own getter, so read whichever one you mean.

package/dist/types/logic/errors.d.ts

@@ -149,6 +149,16 @@ export declare class PriceOutOfRangeError extends KokioError {
     readonly priceUSDCents: bigint;
     constructor(priceUSDCents: bigint);
 }
+/**
+ * An admin purchase priced above what the eSIM wallet's owner still allows the
+ * admin key to charge. Thrown before sending, since the contract would revert
+ * with `AdminAllowanceExceeded`. The owner raises it with `setAdminAllowanceUSDCents`.
+ */
+export declare class AdminAllowanceExceededError extends KokioError {
+    readonly priceUSDCents: bigint;
+    readonly remainingUSDCents: bigint;
+    constructor(priceUSDCents: bigint, remainingUSDCents: bigint);
+}
 /**
  * A payment reference that is not 32 bytes, has an empty order part, or
  * carries a tag this SDK cannot write over or read back.

package/dist/types/logic/registry.d.ts

@@ -70,6 +70,8 @@ export declare const _isESIMIdentifierClaimed: (client: KokioSmartAccountClient,
 export declare const _eSIMWalletForIdentifier: (client: KokioSmartAccountClient, eSIMUniqueIdentifier: string) => Promise<Address>;
 /** The fallback price ceiling in USD cents for a wallet holding no cap of its own. */
 export declare const _defaultPriceCapUSDCents: (client: KokioSmartAccountClient) => Promise<bigint>;
+/** What the admin key may charge a newly created eSIM wallet in total, in USD cents. */
+export declare const _defaultAdminAllowanceUSDCents: (client: KokioSmartAccountClient) => Promise<bigint>;
 /** The payment adapter this registry currently points at. */
 export declare const _paymentAdapter: (client: KokioSmartAccountClient) => Promise<Address>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokio-sdk",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "",
   "type": "module",
   "main": "./dist/esm/config.js",