@yellow-org/sdk 1.2.1 → 1.3.0

package/README.md

@@ -3,7 +3,9 @@
 [![npm version](https://img.shields.io/npm/v/@yellow-org/sdk.svg)](https://www.npmjs.com/package/@yellow-org/sdk)
 [![License](https://img.shields.io/npm/l/@yellow-org/sdk.svg)](https://github.com/layer-3/nitrolite/blob/main/LICENSE)
 
-TypeScript SDK for Clearnode payment channels providing both high-level and low-level operations in a unified client:
+> The off-chain broker was renamed from "Clearnode" to "Nitronode" in v1.3.0. The default WebSocket sandbox URL is now `wss://nitronode-sandbox.yellow.org/v1/ws`. See [`MIGRATION-NITRONODE.md`](../../MIGRATION-NITRONODE.md).
+
+TypeScript SDK for Nitronode payment channels providing both high-level and low-level operations in a unified client:
 - **State Operations**: `deposit()`, `withdraw()`, `transfer()`, `closeHomeChannel()`, `acknowledge()` - build and co-sign states off-chain
 - **Blockchain Settlement**: `checkpoint()` - the single entry point for all on-chain transactions
 - **Low-Level Operations**: Direct RPC access for custom flows and advanced use cases
@@ -76,16 +78,18 @@ client.rebalanceAppSessions(signedUpdates)                      // Atomic rebala
 
 ### App Session Keys
 ```typescript
-client.signSessionKeyState(state)                               // Sign app session key state
-client.submitSessionKeyState(state)                             // Register/update app session key
-client.getLastKeyStates(userAddress, sessionKey?)               // Get active app session key states
+client.signSessionKeyState(state)                                       // Wallet user_sig over app session key state
+client.signAppSessionKeyOwnership(state, sessionKeySigner)              // Session-key holder's session_key_sig
+client.submitSessionKeyState(state)                                     // Register/update app session key (both sigs required)
+client.getLastAppKeyStates(userAddress, sessionKey?, options?)          // Get app session key states (active-only by default; pass { includeInactive: true } to include expired)
 ```
 
 ### Channel Session Keys
 ```typescript
-client.signChannelSessionKeyState(state)                        // Sign channel session key state
-client.submitChannelSessionKeyState(state)                      // Register/update channel session key
-client.getLastChannelKeyStates(userAddress, sessionKey?)        // Get active channel session key states
+client.signChannelSessionKeyState(state)                                // Wallet user_sig over channel session key state
+client.signChannelSessionKeyOwnership(state, sessionKeySigner)          // Session-key holder's session_key_sig
+client.submitChannelSessionKeyState(state)                              // Register/update channel session key (both sigs required)
+client.getLastChannelKeyStates(userAddress, sessionKey?, options?)      // Get channel session key states (active-only by default; pass { includeInactive: true } to include expired)
 ```
 
 ### Shared Utilities
@@ -123,7 +127,7 @@ async function main() {
 
   // Create unified client
   const client = await Client.create(
-    'wss://clearnode.example.com/ws',
+    'wss://nitronode.example.com/ws',
     stateSigner,
     txSigner,
     withBlockchainRPC(80002n, 'https://polygon-amoy.alchemy.com/v2/KEY')
@@ -490,58 +494,65 @@ const sessionKeySigner = new AppSessionKeySignerV1(sessionKeyMsgSigner);
 
 ### App Session Keys
 
+Registration requires two signatures: the wallet's `user_sig` (authorizing the
+delegation) and the session-key holder's `session_key_sig` (proving possession of the key
+being registered). The node rejects submits that lack a valid `session_key_sig`.
+
 ```typescript
-// Sign and submit an app session key state
-const sig = await client.signSessionKeyState({
+// sessionKeyHolder is an EthereumMsgSigner whose address equals state.session_key.
+// Use a raw message signer (not a wrapped StateSigner) — the node expects a
+// raw 65-byte EIP-191 signature for session_key_sig.
+const sessionKeyHolder = new EthereumMsgSigner(sessionKeyPrivateKey);
+const state = {
   user_address: '0x1234...',
   session_key: '0xabcd...',
   version: '1',
   application_ids: ['app1'],
   app_session_ids: [],
   expires_at: String(Math.floor(Date.now() / 1000) + 86400),
-  user_sig: '0x',
-});
+  user_sig: '',
+  session_key_sig: '',
+};
+state.user_sig = await client.signSessionKeyState(state);
+state.session_key_sig = await client.signAppSessionKeyOwnership(state, sessionKeyHolder);
 
-await client.submitSessionKeyState({
-  user_address: '0x1234...',
-  session_key: '0xabcd...',
-  version: '1',
-  application_ids: ['app1'],
-  app_session_ids: [],
-  expires_at: String(Math.floor(Date.now() / 1000) + 86400),
-  user_sig: sig,
-});
+await client.submitSessionKeyState(state);
 
-// Query active app session key states
-const states = await client.getLastKeyStates('0x1234...');
-const filtered = await client.getLastKeyStates('0x1234...', '0xSessionKey...');
+// Query app session key states (active-only by default)
+const states = await client.getLastAppKeyStates('0x1234...');
+const filtered = await client.getLastAppKeyStates('0x1234...', '0xSessionKey...');
+
+// Include expired/revoked latest states (e.g. for rotation flows that need the prior version)
+const all = await client.getLastAppKeyStates('0x1234...', '0xSessionKey...', { includeInactive: true });
 ```
 
 ### Channel Session Keys
 
 ```typescript
-// Sign and submit a channel session key state
-const sig = await client.signChannelSessionKeyState({
+// sessionKeyHolder is an EthereumMsgSigner whose address equals state.session_key.
+// Use a raw message signer (not a wrapped StateSigner) — the node expects a
+// raw 65-byte EIP-191 signature for session_key_sig.
+const sessionKeyHolder = new EthereumMsgSigner(sessionKeyPrivateKey);
+const state = {
   user_address: '0x1234...',
   session_key: '0xabcd...',
   version: '1',
   assets: ['usdc'],
   expires_at: String(Math.floor(Date.now() / 1000) + 86400),
-  user_sig: '0x',
-});
+  user_sig: '',
+  session_key_sig: '',
+};
+state.user_sig = await client.signChannelSessionKeyState(state);
+state.session_key_sig = await client.signChannelSessionKeyOwnership(state, sessionKeyHolder);
 
-await client.submitChannelSessionKeyState({
-  user_address: '0x1234...',
-  session_key: '0xabcd...',
-  version: '1',
-  assets: ['usdc'],
-  expires_at: String(Math.floor(Date.now() / 1000) + 86400),
-  user_sig: sig,
-});
+await client.submitChannelSessionKeyState(state);
 
-// Query active channel session key states
+// Query channel session key states (active-only by default)
 const states = await client.getLastChannelKeyStates('0x1234...');
 const filtered = await client.getLastChannelKeyStates('0x1234...', '0xSessionKey...');
+
+// Include expired/revoked latest states (e.g. for rotation flows that need the prior version)
+const all = await client.getLastChannelKeyStates('0x1234...', '0xSessionKey...', { includeInactive: true });
 ```
 
 ## Key Concepts
@@ -688,7 +699,7 @@ async function basicExample() {
   const { stateSigner, txSigner } = createSigners(process.env.PRIVATE_KEY!);
 
   const client = await Client.create(
-    'wss://clearnode.example.com/ws',
+    'wss://nitronode.example.com/ws',
     stateSigner,
     txSigner,
     withBlockchainRPC(80002n, process.env.RPC_URL!)
@@ -737,7 +748,7 @@ async function multiChainExample() {
   const { stateSigner, txSigner } = createSigners(process.env.PRIVATE_KEY!);
 
   const client = await Client.create(
-    'wss://clearnode.example.com/ws',
+    'wss://nitronode.example.com/ws',
     stateSigner,
     txSigner,
     withBlockchainRPC(80002n, process.env.POLYGON_RPC!), // Polygon Amoy
@@ -775,7 +786,7 @@ import { Client, createSigners } from '@yellow-org/sdk';
 async function queryTransactions() {
   const { stateSigner, txSigner } = createSigners(process.env.PRIVATE_KEY!);
   const client = await Client.create(
-    'wss://clearnode.example.com/ws',
+    'wss://nitronode.example.com/ws',
     stateSigner,
     txSigner
   );
@@ -821,7 +832,7 @@ import Decimal from 'decimal.js';
 async function appSessionExample() {
   const { stateSigner, txSigner } = createSigners(process.env.PRIVATE_KEY!);
   const client = await Client.create(
-    'wss://clearnode.example.com/ws',
+    'wss://nitronode.example.com/ws',
     stateSigner,
     txSigner,
     withBlockchainRPC(80002n, process.env.RPC_URL!)
@@ -902,7 +913,7 @@ async function monitorConnection() {
   const { stateSigner, txSigner } = createSigners(process.env.PRIVATE_KEY!);
 
   const client = await Client.create(
-    'wss://clearnode.example.com/ws',
+    'wss://nitronode.example.com/ws',
     stateSigner,
     txSigner,
     withPingInterval(3000),
@@ -1073,7 +1084,7 @@ For understanding how operations work under the hood:
 
 - **Node.js**: 20.0.0 or later
 - **TypeScript**: 5.3.0 or later (for development)
-- **Running Clearnode instance** or access to public node
+- **Running Nitronode instance** or access to public node
 - **Blockchain RPC endpoint** (for on-chain operations via `checkpoint()`)
 
 ## License

package/dist/app/packing.js

@@ -1,4 +1,4 @@
-import { encodeAbiParameters, keccak256, pad, toHex } from 'viem';
+import { encodeAbiParameters, keccak256, toHex } from 'viem';
 export function packCreateAppSessionRequestV1(definition, sessionData) {
     const participantComponents = [
         { name: 'walletAddress', type: 'address' },
@@ -106,26 +106,9 @@ export function packAppV1(app) {
     ]);
     return keccak256(packed);
 }
-function hexToBytes32(s) {
-    let hex = s.startsWith('0x') || s.startsWith('0X') ? s.slice(2) : s;
-    if (hex.length % 2 === 1) {
-        hex = '0' + hex;
-    }
-    if (!/^[0-9a-fA-F]*$/.test(hex)) {
-        return pad('0x00', { size: 32 });
-    }
-    if (hex.length === 0) {
-        return pad('0x00', { size: 32 });
-    }
-    if (hex.length > 64) {
-        hex = hex.slice(hex.length - 64);
-    }
-    const padded = hex.padStart(64, '0');
-    return `0x${padded}`;
-}
 export function packAppSessionKeyStateV1(state) {
-    const applicationIDHashes = state.application_ids.map(hexToBytes32);
-    const appSessionIDHashes = state.app_session_ids.map(hexToBytes32);
+    const applicationIDHashes = state.application_ids.map((id) => keccak256(toHex(id)));
+    const appSessionIDHashes = state.app_session_ids.map((id) => keccak256(toHex(id)));
     const packed = encodeAbiParameters([
         { type: 'address' },
         { type: 'address' },

package/dist/app/types.d.ts

@@ -81,6 +81,7 @@ export interface AppSessionKeyStateV1 {
     app_session_ids: string[];
     expires_at: string;
     user_sig: string;
+    session_key_sig: string;
 }
 export interface AssetAllowanceV1 {
     asset: string;

package/dist/blockchain/evm/channel_hub_abi.d.ts

@@ -30,6 +30,16 @@ export declare const ChannelHubAbi: readonly [{
         readonly internalType: "uint32";
     }];
     readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_CHALLENGE_DURATION";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint32";
+        readonly internalType: "uint32";
+    }];
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "MAX_DEPOSIT_ESCROW_STEPS";
@@ -335,7 +345,7 @@ export declare const ChannelHubAbi: readonly [{
         }];
     }];
     readonly outputs: readonly [];
-    readonly stateMutability: "payable";
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "claimFunds";
@@ -450,7 +460,7 @@ export declare const ChannelHubAbi: readonly [{
         }];
     }];
     readonly outputs: readonly [];
-    readonly stateMutability: "payable";
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "createChannel";
@@ -2009,7 +2019,7 @@ export declare const ChannelHubAbi: readonly [{
         }];
     }];
     readonly outputs: readonly [];
-    readonly stateMutability: "payable";
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
     readonly name: "withdrawFromNode";
@@ -3234,6 +3244,11 @@ export declare const ChannelHubAbi: readonly [{
     readonly type: "event";
     readonly name: "EscrowDepositsPurged";
     readonly inputs: readonly [{
+        readonly name: "escrowIds";
+        readonly type: "bytes32[]";
+        readonly indexed: false;
+        readonly internalType: "bytes32[]";
+    }, {
         readonly name: "purgedCount";
         readonly type: "uint256";
         readonly indexed: false;
@@ -4325,6 +4340,10 @@ export declare const ChannelHubAbi: readonly [{
     readonly type: "error";
     readonly name: "IncorrectChannelStatus";
     readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "IncorrectMsgSender";
+    readonly inputs: readonly [];
 }, {
     readonly type: "error";
     readonly name: "IncorrectNode";

package/dist/blockchain/evm/channel_hub_abi.js

@@ -41,6 +41,19 @@ export const ChannelHubAbi = [
         ],
         stateMutability: 'view'
     },
+    {
+        type: 'function',
+        name: 'MAX_CHALLENGE_DURATION',
+        inputs: [],
+        outputs: [
+            {
+                name: '',
+                type: 'uint32',
+                internalType: 'uint32'
+            }
+        ],
+        stateMutability: 'view'
+    },
     {
         type: 'function',
         name: 'MAX_DEPOSIT_ESCROW_STEPS',
@@ -431,7 +444,7 @@ export const ChannelHubAbi = [
             }
         ],
         outputs: [],
-        stateMutability: 'payable'
+        stateMutability: 'nonpayable'
     },
     {
         type: 'function',
@@ -578,7 +591,7 @@ export const ChannelHubAbi = [
             }
         ],
         outputs: [],
-        stateMutability: 'payable'
+        stateMutability: 'nonpayable'
     },
     {
         type: 'function',
@@ -2578,7 +2591,7 @@ export const ChannelHubAbi = [
             }
         ],
         outputs: [],
-        stateMutability: 'payable'
+        stateMutability: 'nonpayable'
     },
     {
         type: 'function',
@@ -4136,6 +4149,12 @@ export const ChannelHubAbi = [
         type: 'event',
         name: 'EscrowDepositsPurged',
         inputs: [
+            {
+                name: 'escrowIds',
+                type: 'bytes32[]',
+                indexed: false,
+                internalType: 'bytes32[]'
+            },
             {
                 name: 'purgedCount',
                 type: 'uint256',
@@ -5526,6 +5545,11 @@ export const ChannelHubAbi = [
         name: 'IncorrectChannelStatus',
         inputs: []
     },
+    {
+        type: 'error',
+        name: 'IncorrectMsgSender',
+        inputs: []
+    },
     {
         type: 'error',
         name: 'IncorrectNode',

package/dist/blockchain/evm/client.js

@@ -132,7 +132,7 @@ export class Client {
                 abi: ChannelHubAbi,
                 functionName: 'depositToNode',
                 args: [token, amountBig],
-                account: this.walletSigner.account.address,
+                account: this.walletSigner.account,
                 ...(token === zeroAddress ? { value: amountBig } : {}),
             });
             console.log('✅ Simulation successful - executing deposit...');
@@ -179,7 +179,7 @@ export class Client {
                 abi: ChannelHubAbi,
                 functionName: 'withdrawFromNode',
                 args: [to, token, amountBig],
-                account: this.walletSigner.account.address,
+                account: this.walletSigner.account,
             });
             console.log('✅ Simulation successful - executing withdrawal...');
             const hash = await this.walletSigner.writeContract(request);
@@ -237,7 +237,7 @@ export class Client {
                 abi: ChannelHubAbi,
                 functionName: 'createChannel',
                 args: [contractDef, contractState],
-                account: this.walletSigner.account.address,
+                account: this.walletSigner.account,
                 ...(nativeValue != null ? { value: nativeValue } : {}),
             }));
             console.log('✅ Simulation successful - executing transaction...');

package/dist/blockchain/evm/erc20.js

@@ -26,19 +26,18 @@ export class ERC20 {
             throw new Error('Wallet signer is required for approve operation');
         }
         try {
-            const { request } = (await this.client.simulateContract({
+            const hash = await this.walletSigner.writeContract({
                 address: this.tokenAddress,
                 abi: Erc20Abi,
                 functionName: 'approve',
                 args: [spender, amount],
-                account: this.walletSigner.account.address,
-            }));
-            const hash = await this.walletSigner.writeContract(request);
-            await this.client.waitForTransactionReceipt({ hash });
+                account: this.walletSigner.account,
+            });
+            await this.client.waitForTransactionReceipt({ hash, confirmations: 3 });
             return hash;
         }
         catch (error) {
-            console.error('❌ Approve simulation/execution failed!');
+            console.error('❌ Approve execution failed!');
             if (error.message) {
                 console.error('   Reason:', error.message);
             }

package/dist/blockchain/evm/index.d.ts

@@ -6,3 +6,4 @@ export * from './channel_hub_abi.js';
 export * from './client.js';
 export * from './app_registry_abi.js';
 export * from './locking_client.js';
+export * from './validator_watcher.js';

package/dist/blockchain/evm/index.js

@@ -6,3 +6,4 @@ export * from './channel_hub_abi.js';
 export * from './client.js';
 export * from './app_registry_abi.js';
 export * from './locking_client.js';
+export * from './validator_watcher.js';

package/dist/blockchain/evm/validator_watcher.d.ts

@@ -0,0 +1,4 @@
+import { Address } from 'viem';
+import { EVMClient } from './interface.js';
+import { ValidatorRegisteredEvent } from '../../core/event.js';
+export declare function watchValidatorRegistered(contractAddress: Address, client: EVMClient, blockchainId: bigint, fromBlock: bigint, signal?: AbortSignal): AsyncGenerator<ValidatorRegisteredEvent>;

package/dist/blockchain/evm/validator_watcher.js

@@ -0,0 +1,119 @@
+import { getAddress } from 'viem';
+import { ChannelHubAbi } from './channel_hub_abi.js';
+const VALIDATOR_REGISTERED_ABI = [
+    {
+        type: 'event',
+        name: 'ValidatorRegistered',
+        inputs: [
+            { name: 'validatorId', type: 'uint8', indexed: true, internalType: 'uint8' },
+            { name: 'validator', type: 'address', indexed: true, internalType: 'contract ISignatureValidator' },
+        ],
+        anonymous: false,
+    },
+];
+export async function* watchValidatorRegistered(contractAddress, client, blockchainId, fromBlock, signal) {
+    let headBlock = 0n;
+    try {
+        headBlock = await client.getBlockNumber();
+    }
+    catch (err) {
+        if (!signal?.aborted) {
+            console.warn('[nitrolite] watchValidatorRegistered: failed to fetch block number, historical replay and transition gap-fill skipped', err);
+        }
+    }
+    if (fromBlock > 0n && headBlock >= fromBlock) {
+        try {
+            const logs = await client.getLogs({
+                address: contractAddress,
+                event: VALIDATOR_REGISTERED_ABI[0],
+                fromBlock,
+                toBlock: headBlock,
+                strict: true,
+            });
+            for (const log of logs) {
+                if (log.removed)
+                    continue;
+                if (signal?.aborted)
+                    return;
+                yield {
+                    blockchainId,
+                    validatorId: log.args.validatorId,
+                    validator: getAddress(log.args.validator),
+                    blockNumber: log.blockNumber ?? headBlock,
+                };
+            }
+        }
+        catch (err) {
+            if (!signal?.aborted) {
+                console.warn('[nitrolite] watchValidatorRegistered: failed to fetch historical logs, gap fill incomplete', err);
+            }
+        }
+    }
+    if (signal?.aborted)
+        return;
+    const liveFromBlock = headBlock > 0n ? headBlock + 1n : undefined;
+    const queue = [];
+    let wakeUp = null;
+    let watchError = null;
+    let done = false;
+    const notify = () => {
+        const resolve = wakeUp;
+        wakeUp = null;
+        resolve?.();
+    };
+    const unwatch = client.watchContractEvent({
+        address: contractAddress,
+        abi: ChannelHubAbi,
+        eventName: 'ValidatorRegistered',
+        fromBlock: liveFromBlock,
+        onLogs(logs) {
+            for (const log of logs) {
+                if (log.removed)
+                    continue;
+                if (log.blockNumber === null)
+                    continue;
+                const { validatorId, validator } = log.args;
+                if (validatorId === undefined || !validator)
+                    continue;
+                queue.push({
+                    blockchainId,
+                    validatorId,
+                    validator: getAddress(validator),
+                    blockNumber: log.blockNumber,
+                });
+            }
+            notify();
+        },
+        onError(err) {
+            watchError = err;
+            done = true;
+            notify();
+        },
+    });
+    const onAbort = () => {
+        done = true;
+        notify();
+    };
+    signal?.addEventListener('abort', onAbort);
+    try {
+        while (!done || queue.length > 0) {
+            while (queue.length > 0) {
+                if (signal?.aborted)
+                    return;
+                yield queue.shift();
+            }
+            if (!done) {
+                await new Promise((resolve) => {
+                    wakeUp = resolve;
+                });
+            }
+        }
+        if (watchError && !signal?.aborted) {
+            throw watchError;
+        }
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+        unwatch();
+    }
+}

package/dist/client.d.ts

@@ -4,7 +4,7 @@ import * as core from './core/index.js';
 import * as app from './app/index.js';
 import { ChannelSessionKeyStateV1, AppInfoV1 } from './rpc/types.js';
 import { Option } from './config.js';
-import { StateSigner, TransactionSigner } from './signers.js';
+import { EthereumMsgSigner, StateSigner, TransactionSigner } from './signers.js';
 export declare const DEFAULT_CHALLENGE_PERIOD = 86400;
 export type { StateSigner, TransactionSigner };
 export declare class Client {
@@ -70,9 +70,9 @@ export declare class Client {
         channels: core.Channel[];
         metadata: core.PaginationMetadata;
     }>;
-    getHomeChannel(wallet: Address, asset: string): Promise<core.Channel>;
-    getEscrowChannel(escrowChannelId: string): Promise<core.Channel>;
-    getLatestState(wallet: Address, asset: string, onlySigned: boolean): Promise<core.State>;
+    getHomeChannel(wallet: Address, asset: string): Promise<core.Channel | null>;
+    getEscrowChannel(escrowChannelId: string): Promise<core.Channel | null>;
+    getLatestState(wallet: Address, asset: string, onlySigned: boolean): Promise<core.State | null>;
     getAppSessions(options?: {
         appSessionId?: string;
         wallet?: Address;
@@ -83,7 +83,7 @@ export declare class Client {
         sessions: app.AppSessionInfoV1[];
         metadata: core.PaginationMetadata;
     }>;
-    getAppDefinition(appSessionId: string): Promise<app.AppDefinitionV1>;
+    getAppDefinition(appSessionId: string): Promise<app.AppDefinitionV1 | null>;
     createAppSession(definition: app.AppDefinitionV1, sessionData: string, quorumSigs: string[], opts?: {
         ownerSig?: string;
     }): Promise<{
@@ -105,11 +105,18 @@ export declare class Client {
     }>;
     registerApp(appID: string, metadata: string, creationApprovalNotRequired: boolean): Promise<void>;
     signChannelSessionKeyState(state: ChannelSessionKeyStateV1): Promise<Hex>;
+    signChannelSessionKeyOwnership(state: ChannelSessionKeyStateV1, sessionKeySigner: EthereumMsgSigner): Promise<Hex>;
     submitChannelSessionKeyState(state: ChannelSessionKeyStateV1): Promise<void>;
-    getLastChannelKeyStates(userAddress: string, sessionKey?: string): Promise<ChannelSessionKeyStateV1[]>;
+    getLastChannelKeyStates(userAddress: string, sessionKey?: string, options?: {
+        includeInactive?: boolean;
+    }): Promise<ChannelSessionKeyStateV1[]>;
     signSessionKeyState(state: app.AppSessionKeyStateV1): Promise<Hex>;
+    signAppSessionKeyOwnership(state: app.AppSessionKeyStateV1, sessionKeySigner: EthereumMsgSigner): Promise<Hex>;
     submitSessionKeyState(state: app.AppSessionKeyStateV1): Promise<void>;
-    getLastKeyStates(userAddress: string, sessionKey?: string): Promise<app.AppSessionKeyStateV1[]>;
+    getLastAppKeyStates(userAddress: string, sessionKey?: string, options?: {
+        includeInactive?: boolean;
+    }): Promise<app.AppSessionKeyStateV1[]>;
+    watchValidatorRegistered(chainId: bigint, fromBlock?: bigint, signal?: AbortSignal): AsyncGenerator<core.ValidatorRegisteredEvent>;
     private getBlockchainRPCInfo;
     private createEVMClients;
     private initializeBlockchainClient;