kokio-sdk 3.0.1 → 3.1.0

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

package/dist/types/logic/account-kit/createSmartAccount.d.ts

@@ -63,5 +63,5 @@ type RawGasEstimate = Record<string, Hex>;
  * override placed on the client is never the one it calls.
  */
 export declare const _padGasEstimate: (estimate: RawGasEstimate) => RawGasEstimate;
-export declare const _getSmartWalletClient: (client: WalletClient, pimlicoAPIKey: string, gasPolicyId: string, account: KokioSmartAccount) => Promise<KokioSmartAccountClient>;
+export declare const _getSmartWalletClient: (client: WalletClient, pimlicoAPIKey: string, gasPolicyId: string, account: KokioSmartAccount, bundlerUrl?: string) => Promise<KokioSmartAccountClient>;
 export {};

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

@@ -18,5 +18,8 @@ export interface chainSpecifcConstants {
 export declare const baseMainnetFactoryAddresses: Record<string, Address>;
 export declare const baseSepoliaFactoryAddresses: Record<string, Address>;
 export declare const customErrors: Record<string, string>;
+export declare const _chainId: (client: {
+    getChainId: () => Promise<number>;
+}) => Promise<number>;
 export declare const _extractChainID: (client: WalletClient) => Promise<number>;
 export declare const _getChainSpecificConstants: (chainID: CHAIN_ID.BASE_MAINNET | CHAIN_ID.BASE_SEPOLIA, rpcURL: string, pimlicoAPIKey?: string) => chainSpecifcConstants;

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

@@ -19,6 +19,18 @@ export declare const _toggleAccessToFunds: (client: KokioSmartAccountClient, add
  * a bind from undoing the owner's revocation.
  */
 export declare const _addESIMWallet: (client: KokioSmartAccountClient, address: Address, eSIMWalletAddress: Address) => Promise<`0x${string}`>;
+/**
+ * Deploy an eSIM wallet for this device wallet and bind it, in one user operation.
+ *
+ * Fund access cannot be granted at bind time, so `grantAccessToFunds` adds a
+ * `toggleAccessToFunds` after the bind in the same operation. The device wallet
+ * must already be registered (`registry.isDeviceWalletValid`), or the factory
+ * refuses it.
+ */
+export declare const _deployAndBindESIMWallet: (client: KokioSmartAccountClient, address: Address, salt: bigint, grantAccessToFunds: boolean) => Promise<{
+    userOpHash: Hex;
+    eSIMWalletAddress: Address;
+}>;
 /**
  * Release an eSIM wallet and put it on standby for a transfer.
  *

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

@@ -21,6 +21,14 @@ export declare const _setPriceCapUSDCents: (client: KokioSmartAccountClient, add
  * inventing one.
  */
 export declare const _buyDataBundleWithToken: (client: KokioSmartAccountClient, address: Address, dataBundleDetails: DataBundleDetails, asset: Hex, maxAmountIn: bigint, paymentReference: Hex) => Promise<`0x${string}`>;
+/**
+ * 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 declare const _buyDataBundleWithTransfer: (client: KokioSmartAccountClient, address: Address, dataBundleDetails: DataBundleDetails, asset: Hex, maxAmountIn: bigint, paymentReference: Hex) => Promise<`0x${string}`>;
 /**
  * Send an ERC-20 held by this eSIM wallet back to its owning device wallet.
  * `onlyDeviceWallet`.

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

@@ -1,4 +1,6 @@
 import { Address } from "viem";
 import { KokioSmartAccountClient } from "../types.js";
 export declare const _deployESIMWalletWithUserOp: (client: KokioSmartAccountClient, deviceWalletAddress: Address, salt: bigint) => Promise<`0x${string}`>;
+/** Address `deployESIMWallet` deploys to for this device wallet and salt. */
+export declare const _getESIMWalletCounterFactualAddress: (client: KokioSmartAccountClient, deviceWalletAddress: Address, salt: bigint) => Promise<Address>;
 export declare const _getCurrentESIMWalletImplementation: (client: KokioSmartAccountClient) => Promise<Address>;

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

@@ -107,14 +107,15 @@ export declare class ContractRevertError extends KokioError {
     constructor(data: Hex);
 }
 /**
- * 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 declare const toContractRevertError: (err: unknown) => ContractRevertError | 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/types/logic/utils.d.ts

@@ -1,25 +1,4 @@
 import { Hex } from "viem";
 export declare const _add0x: (data: Hex | string) => Hex;
-export declare const _remove0x: (data: Hex | string) => string;
 export declare function _shouldRemoveLeadingZero(bytes: Uint8Array): boolean;
 export declare function _concatUint8Arrays(arrays: Uint8Array[]): Uint8Array;
-export declare function base64UrlToBuffer(base64url: string): Buffer;
-export interface ClientDataJSON {
-    type: string;
-    challenge: string;
-    origin: string;
-    crossOrigin?: boolean;
-    [key: string]: unknown;
-}
-export declare function decodeClientDataJSON(base64url: string): ClientDataJSON;
-export declare function hexToArrayBuffer(hexString: string): ArrayBuffer;
-export declare function parseDEREncodedSignature(signature: Uint8Array): {
-    r: string;
-    s: string;
-};
-export declare function shouldRemoveLeadingZero(bytes: Uint8Array): boolean;
-export declare function concatUint8Arrays(arrays: Uint8Array[]): Uint8Array;
-export declare function parseSignature(signature: Uint8Array): {
-    r: `0x${string}`;
-    s: `0x${string}`;
-};

package/dist/types/types-export.d.ts

@@ -1,2 +1,3 @@
-export type { P256Key, Call, WebAuthnSignature, P256Credential, DataBundleDetails, Asset, SignedRequest, KokioSmartAccount, KokioSmartAccountClient, OwnerCall, OperationOptions, ScheduledOperation, ScheduledBatchOperation } from './types';
-export { Settlement } from './types';
+export type { P256Key, Call, WebAuthnSignature, P256Credential, DataBundleDetails, Asset, SignedRequest, KokioSmartAccount, KokioSmartAccountClient, OwnerCall, OperationOptions, ScheduledOperation, ScheduledBatchOperation, LazyDeploymentBatch, LazyDeployment, LazyHistoryBatch, LazyHistoryCopy } from './types.js';
+export type { KokioConstants } from './interface/constantsClass.js';
+export { Settlement } from './types.js';

package/dist/types/types.d.ts

@@ -20,7 +20,7 @@ export type OwnerCall = {
     abi: Abi;
     functionName: string;
     args?: readonly unknown[];
-    /** ETH sent with the call. The timelock has to be holding it. */
+    /** ETH sent with the call. `executor.execute` attaches it from the executing account. */
     value?: bigint;
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokio-sdk",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "",
   "type": "module",
   "main": "./dist/esm/config.js",
@@ -32,10 +32,13 @@
   "scripts": {
     "build": "tsc",
     "prepack": "npm run build",
+    "pretest": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:integration": "INTEGRATION=1 vitest run",
-    "test:integration:fork": "INTEGRATION=1 vitest run tests/integration --no-file-parallelism"
+    "test:integration:fork": "INTEGRATION=1 vitest run tests/integration --no-file-parallelism",
+    "test:consumer:fork": "npm run build && INTEGRATION=1 vitest run tests/consumer --no-file-parallelism",
+    "test:consumer:live": "npm run build && KOKIO_LIVE=1 vitest run tests/consumer --no-file-parallelism"
   },
   "repository": {
     "type": "git",
@@ -48,20 +51,31 @@
   },
   "homepage": "https://github.com/Blockchain-Powered-eSIM/kokio-sdk#readme",
   "devDependencies": {
+    "@pimlico/alto": "0.0.21",
+    "@pimlico/mock-paymaster": "0.0.8",
+    "@simplewebauthn/server": "13.3.2",
     "@types/node": "22.20.1",
     "dotenv": "17.4.2",
+    "prool": "0.0.25",
+    "react-native-passkey": "3.6.1",
     "typescript": "5.9.3",
     "vitest": "4.1.11"
   },
   "dependencies": {
     "@noble/curves": "2.3.0",
-    "@peculiar/asn1-ecc": "2.9.3",
-    "@peculiar/asn1-schema": "2.9.3",
-    "@simplewebauthn/server": "13.3.2",
-    "react-native-passkey": "3.6.1",
+    "@scure/base": "1.2.6",
     "viem": "2.55.19"
   },
   "overrides": {
-    "ws": "8.21.0"
+    "ws": "8.21.0",
+    "tar": "7.5.22"
+  },
+  "peerDependencies": {
+    "react-native-passkey": "^3.6.1"
+  },
+  "peerDependenciesMeta": {
+    "react-native-passkey": {
+      "optional": true
+    }
   }
 }