@velocity-exchange/sdk 0.2.5 → 0.4.0

package/src/accounts/websocketProgramUserAccountSubscriber.ts

@@ -11,6 +11,13 @@ import { Context, PublicKey } from '@solana/web3.js';
 import { WebSocketProgramAccountSubscriber } from './webSocketProgramAccountSubscriber';
 import { UserAccount } from '../types';
 
+/**
+ * `UserAccountSubscriber` that filters a *shared* `WebSocketProgramAccountSubscriber` (subscribed
+ * once, program-wide, by the caller) down to a single `UserAccount` by pubkey, instead of opening
+ * its own dedicated subscription. Overwrites the shared subscriber's `onChange` callback in
+ * `subscribe()` — only one `WebSocketProgramUserAccountSubscriber` can usefully attach to a given
+ * `programSubscriber` at a time, since each `subscribe()` call replaces the previous `onChange`.
+ */
 export class WebSocketProgramUserAccountSubscriber
 	implements UserAccountSubscriber
 {
@@ -22,6 +29,11 @@ export class WebSocketProgramUserAccountSubscriber
 	private programSubscriber: WebSocketProgramAccountSubscriber<UserAccount>;
 	private userAccountAndSlot?: DataAndSlot<UserAccount>;
 
+	/**
+	 * @param program Anchor program used for the one-off `fetch()` fallback.
+	 * @param userAccountPublicKey Address of the `UserAccount` to filter for.
+	 * @param programSubscriber Shared, already-created program-account subscriber (not subscribed by this constructor — see `subscribe()`).
+	 */
 	public constructor(
 		program: VelocityProgram,
 		userAccountPublicKey: PublicKey,
@@ -34,6 +46,13 @@ export class WebSocketProgramUserAccountSubscriber
 		this.programSubscriber = programSubscriber;
 	}
 
+	/**
+	 * Installs (overwriting) an `onChange` handler on the shared `programSubscriber` that filters
+	 * updates down to this instance's `userAccountPublicKey`. Does not itself call
+	 * `programSubscriber.subscribe()` — the caller is responsible for starting the shared program
+	 * subscription separately.
+	 * @param userAccount Optional pre-fetched account data to seed with immediately (at slot 0).
+	 */
 	async subscribe(userAccount?: UserAccount): Promise<boolean> {
 		if (this.isSubscribed) {
 			return true;
@@ -48,6 +67,11 @@ export class WebSocketProgramUserAccountSubscriber
 			data: UserAccount,
 			context: Context
 		) => {
+			// the shared programSubscriber callback isn't detached on unsubscribe(), so
+			// guard here to stop delivering updates once this facade is unsubscribed
+			if (!this.isSubscribed) {
+				return;
+			}
 			if (accountId.equals(this.userAccountPublicKey)) {
 				this.updateData(data, context.slot);
 				this.eventEmitter.emit('userAccountUpdate', data);
@@ -59,6 +83,7 @@ export class WebSocketProgramUserAccountSubscriber
 		return true;
 	}
 
+	/** Fetches the account once directly via `program.account.user.fetch` (independent of the shared program subscription), storing the result at slot 0 (not the fetch's actual slot). Throws `NotSubscribedError` if not subscribed. */
 	async fetch(): Promise<void> {
 		if (!this.isSubscribed) {
 			throw new NotSubscribedError(
@@ -72,6 +97,12 @@ export class WebSocketProgramUserAccountSubscriber
 		this.updateData(account as UserAccount, 0);
 	}
 
+	/**
+	 * Overwrites the cached data unconditionally — unlike most other `updateData` implementations
+	 * in this directory, there is no slot-ordering guard here, so a caller must not pass stale data.
+	 * @param userAccount Decoded account data to store.
+	 * @param slot Slot the data was observed at.
+	 */
 	updateData(userAccount: UserAccount, slot: number): void {
 		this.userAccountAndSlot = {
 			data: userAccount,
@@ -79,10 +110,12 @@ export class WebSocketProgramUserAccountSubscriber
 		};
 	}
 
+	/** Marks this facade unsubscribed. Does not touch the shared `programSubscriber`'s `onChange` handler or its subscription state. */
 	async unsubscribe(): Promise<void> {
 		this.isSubscribed = false;
 	}
 
+	/** Throws `NotSubscribedError` if not subscribed. Returns undefined only if subscribed but no data has loaded yet. */
 	getUserAccountAndSlot(): DataAndSlot<UserAccount> | undefined {
 		if (!this.isSubscribed) {
 			throw new NotSubscribedError(

package/src/addresses/marketAddresses.ts

@@ -2,6 +2,16 @@ import { PublicKey } from '@solana/web3.js';
 import { getPerpMarketPublicKey } from './pda';
 
 const CACHE = new Map<string, PublicKey>();
+/**
+ * Derives (and memoizes) a `PerpMarket` account's PDA. Thin wrapper over
+ * `getPerpMarketPublicKey` that caches results in a module-level `Map` keyed by
+ * `${programId}-${marketIndex}` so repeated calls for the same market avoid redoing the
+ * `findProgramAddress` computation. The cache is process-lifetime and never invalidated/evicted —
+ * safe because a market's PDA for a given `programId`/`marketIndex` never changes.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Perp market index.
+ * @returns The `PerpMarket` account's public key.
+ */
 export async function getMarketAddress(
 	programId: PublicKey,
 	marketIndex: number

package/src/addresses/pda.ts

@@ -1,7 +1,7 @@
 /**
  * PDA derivation helpers for all Velocity protocol accounts.
- * Covers: User, UserStats, PerpMarket, SpotMarket, InsuranceFundStake,
- * HighLeverageModeConfig, State, and vault PDAs.
+ * Covers: User, UserStats, PerpMarket, SpotMarket, InsuranceFundStake, State,
+ * LP pool (and its constituents/caches), revenue share, and vault PDAs.
  * All functions are pure (no RPC calls).
  */
 import { PublicKey } from '@solana/web3.js';
@@ -13,36 +13,66 @@ import {
 } from '@solana/spl-token';
 import { SpotMarketAccount, TokenProgramFlag } from '../types';
 
+/**
+ * Derives the singleton `State` account PDA (seed `"velocity_state"`), plus its bump nonce. There
+ * is exactly one `State` account per program deployment.
+ * @param programId - Deployed velocity program id.
+ * @returns Tuple of `[stateAccountPublicKey, bumpNonce]`.
+ */
 export async function getVelocityStateAccountPublicKeyAndNonce(
 	programId: PublicKey
 ): Promise<[PublicKey, number]> {
-	return PublicKey.findProgramAddress(
-		[Buffer.from(anchor.utils.bytes.utf8.encode('velocity_state'))],
-		programId
+	return Promise.resolve(
+		PublicKey.findProgramAddressSync(
+			[Buffer.from(anchor.utils.bytes.utf8.encode('velocity_state'))],
+			programId
+		)
 	);
 }
 
+/**
+ * Derives the singleton `State` account PDA (seed `"velocity_state"`).
+ * @param programId - Deployed velocity program id.
+ * @returns The `State` account's public key.
+ */
 export async function getVelocityStateAccountPublicKey(
 	programId: PublicKey
 ): Promise<PublicKey> {
 	return (await getVelocityStateAccountPublicKeyAndNonce(programId))[0];
 }
 
+/**
+ * Derives a `User` (sub-account) PDA, plus its bump nonce, from seeds `["user", authority,
+ * subAccountId as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey that owns the sub-account.
+ * @param subAccountId - Sub-account index (u16); defaults to 0, the wallet's first/main sub-account.
+ * @returns Tuple of `[userAccountPublicKey, bumpNonce]`.
+ */
 export async function getUserAccountPublicKeyAndNonce(
 	programId: PublicKey,
 	authority: PublicKey,
 	subAccountId = 0
 ): Promise<[PublicKey, number]> {
-	return PublicKey.findProgramAddress(
-		[
-			Buffer.from(anchor.utils.bytes.utf8.encode('user')),
-			authority.toBuffer(),
-			new anchor.BN(subAccountId).toArrayLike(Buffer, 'le', 2),
-		],
-		programId
+	return Promise.resolve(
+		PublicKey.findProgramAddressSync(
+			[
+				Buffer.from(anchor.utils.bytes.utf8.encode('user')),
+				authority.toBuffer(),
+				new anchor.BN(subAccountId).toArrayLike(Buffer, 'le', 2),
+			],
+			programId
+		)
 	);
 }
 
+/**
+ * Derives a `User` (sub-account) PDA from seeds `["user", authority, subAccountId as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey that owns the sub-account.
+ * @param subAccountId - Sub-account index (u16); defaults to 0, the wallet's first/main sub-account.
+ * @returns The `User` account's public key.
+ */
 export async function getUserAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey,
@@ -53,6 +83,13 @@ export async function getUserAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Synchronous variant of `getUserAccountPublicKey` (no RPC/async round-trip; pure PDA math).
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey that owns the sub-account.
+ * @param subAccountId - Sub-account index (u16); defaults to 0.
+ * @returns The `User` account's public key.
+ */
 export function getUserAccountPublicKeySync(
 	programId: PublicKey,
 	authority: PublicKey,
@@ -68,6 +105,13 @@ export function getUserAccountPublicKeySync(
 	)[0];
 }
 
+/**
+ * Derives the `UserStats` PDA (one per authority, shared across all of that authority's
+ * sub-accounts) from seeds `["user_stats", authority]`.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey the stats account tracks.
+ * @returns The `UserStats` account's public key.
+ */
 export function getUserStatsAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey
@@ -81,6 +125,13 @@ export function getUserStatsAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the `SignedMsgUserOrders` PDA (holds a user's pending swift/signed-message orders) from
+ * seeds `["SIGNED_MSG", authority]`.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey (the user's main authority, not the sub-account) that owns the account.
+ * @returns The `SignedMsgUserOrders` account's public key.
+ */
 export function getSignedMsgUserAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey
@@ -94,6 +145,13 @@ export function getSignedMsgUserAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the PDA that stores a user's approved signed-message (swift) websocket delegate keys,
+ * from seeds `["SIGNED_MSG_WS", authority]`.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey (the user's main authority) that owns the delegates account.
+ * @returns The delegates account's public key.
+ */
 export function getSignedMsgWsDelegatesAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey
@@ -107,6 +165,12 @@ export function getSignedMsgWsDelegatesAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Derives a `PerpMarket` PDA from seeds `["perp_market", marketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Perp market index.
+ * @returns The `PerpMarket` account's public key.
+ */
 export async function getPerpMarketPublicKey(
 	programId: PublicKey,
 	marketIndex: number
@@ -122,6 +186,12 @@ export async function getPerpMarketPublicKey(
 	)[0];
 }
 
+/**
+ * Synchronous variant of `getPerpMarketPublicKey`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Perp market index.
+ * @returns The `PerpMarket` account's public key.
+ */
 export function getPerpMarketPublicKeySync(
 	programId: PublicKey,
 	marketIndex: number
@@ -135,6 +205,12 @@ export function getPerpMarketPublicKeySync(
 	)[0];
 }
 
+/**
+ * Derives a `SpotMarket` PDA from seeds `["spot_market", marketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Spot market index.
+ * @returns The `SpotMarket` account's public key.
+ */
 export async function getSpotMarketPublicKey(
 	programId: PublicKey,
 	marketIndex: number
@@ -150,6 +226,12 @@ export async function getSpotMarketPublicKey(
 	)[0];
 }
 
+/**
+ * Synchronous variant of `getSpotMarketPublicKey`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Spot market index.
+ * @returns The `SpotMarket` account's public key.
+ */
 export function getSpotMarketPublicKeySync(
 	programId: PublicKey,
 	marketIndex: number
@@ -163,6 +245,13 @@ export function getSpotMarketPublicKeySync(
 	)[0];
 }
 
+/**
+ * Derives the token vault PDA (an SPL/Token-2022 token account owned by the `velocity_signer` PDA)
+ * that custodies a spot market's deposits, from seeds `["spot_market_vault", marketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Spot market index.
+ * @returns The spot market vault token account's public key.
+ */
 export async function getSpotMarketVaultPublicKey(
 	programId: PublicKey,
 	marketIndex: number
@@ -178,6 +267,13 @@ export async function getSpotMarketVaultPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the insurance fund's token vault PDA for a market, from seeds `["insurance_fund_vault",
+ * marketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Spot market index whose insurance fund this vault backs.
+ * @returns The insurance fund vault token account's public key.
+ */
 export async function getInsuranceFundVaultPublicKey(
 	programId: PublicKey,
 	marketIndex: number
@@ -193,6 +289,14 @@ export async function getInsuranceFundVaultPublicKey(
 	)[0];
 }
 
+/**
+ * Derives an `InsuranceFundStake` PDA (an authority's staked share of one market's insurance fund)
+ * from seeds `["insurance_fund_stake", authority, marketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey staking into the insurance fund.
+ * @param marketIndex - Spot market index whose insurance fund is being staked into.
+ * @returns The `InsuranceFundStake` account's public key.
+ */
 export function getInsuranceFundStakeAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey,
@@ -208,6 +312,12 @@ export function getInsuranceFundStakeAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the singleton `velocity_signer` PDA — the program-derived authority that owns/signs for
+ * all program-controlled token vaults (spot market vaults, insurance fund vaults, etc.) via CPI.
+ * @param programId - Deployed velocity program id.
+ * @returns The velocity signer PDA's public key.
+ */
 export function getVelocitySignerPublicKey(programId: PublicKey): PublicKey {
 	return PublicKey.findProgramAddressSync(
 		[Buffer.from(anchor.utils.bytes.utf8.encode('velocity_signer'))],
@@ -215,6 +325,13 @@ export function getVelocitySignerPublicKey(programId: PublicKey): PublicKey {
 	)[0];
 }
 
+/**
+ * Derives the PDA that reserves a unique referrer name, from seeds `["referrer_name", nameBuffer]`.
+ * Used to enforce name uniqueness for referrers on-chain.
+ * @param programId - Deployed velocity program id.
+ * @param nameBuffer - The 32-byte encoded name (see `encodeName`) to reserve.
+ * @returns The referrer-name PDA's public key.
+ */
 export function getReferrerNamePublicKeySync(
 	programId: PublicKey,
 	nameBuffer: number[]
@@ -228,6 +345,13 @@ export function getReferrerNamePublicKeySync(
 	)[0];
 }
 
+/**
+ * Derives the `PrelaunchOracle` PDA used as a placeholder/synthetic oracle for a not-yet-listed
+ * perp market, from seeds `["prelaunch_oracle", marketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param marketIndex - Perp market index the prelaunch oracle backs.
+ * @returns The `PrelaunchOracle` account's public key.
+ */
 export function getPrelaunchOraclePublicKey(
 	programId: PublicKey,
 	marketIndex: number
@@ -241,6 +365,13 @@ export function getPrelaunchOraclePublicKey(
 	)[0];
 }
 
+/**
+ * Derives a Pyth Lazer oracle account PDA from seeds `["pyth_lazer", feedId as u32 LE]`. One
+ * account exists per Lazer feed id and is shared across all markets using that feed.
+ * @param progarmId - Deployed velocity program id (note: parameter name is misspelled but stable API).
+ * @param feedId - Pyth Lazer feed id (u32).
+ * @returns The Pyth Lazer oracle account's public key.
+ */
 export function getPythLazerOraclePublicKey(
 	progarmId: PublicKey,
 	feedId: number
@@ -258,6 +389,13 @@ export function getPythLazerOraclePublicKey(
 	)[0];
 }
 
+/**
+ * Picks the correct SPL token program for a spot market's mint, based on its `tokenProgramFlag`.
+ * Needed because Velocity supports both classic SPL tokens and Token-2022 mints; passing the wrong
+ * token program id to an instruction's accounts will fail owner checks.
+ * @param spotMarketAccount - The spot market to inspect.
+ * @returns `TOKEN_2022_PROGRAM_ID` if `TokenProgramFlag.Token2022` is set, otherwise `TOKEN_PROGRAM_ID`.
+ */
 export function getTokenProgramForSpotMarket(
 	spotMarketAccount: SpotMarketAccount
 ): PublicKey {
@@ -267,6 +405,13 @@ export function getTokenProgramForSpotMarket(
 	return TOKEN_PROGRAM_ID;
 }
 
+/**
+ * Derives a builder/referrer's `RevenueShare` PDA from seeds `["REV_SHARE", authority]`. Tracks
+ * fees a builder/referrer has accrued from orders that credited them.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey of the builder/referrer.
+ * @returns The `RevenueShare` account's public key.
+ */
 export function getRevenueShareAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey
@@ -280,6 +425,14 @@ export function getRevenueShareAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Derives a user's `RevenueShareEscrow` PDA from seeds `["REV_ESCROW", authority]`. Holds the
+ * user's referrer link and approved builder-fee list; required as a remaining account whenever a
+ * placed order references a `builderIdx`/builder fee, or when a taker was referred.
+ * @param programId - Deployed velocity program id.
+ * @param authority - Wallet pubkey of the user (order placer), not the builder/referrer.
+ * @returns The `RevenueShareEscrow` account's public key.
+ */
 export function getRevenueShareEscrowAccountPublicKey(
 	programId: PublicKey,
 	authority: PublicKey
@@ -293,6 +446,12 @@ export function getRevenueShareEscrowAccountPublicKey(
 	)[0];
 }
 
+/**
+ * Derives an `LpPool` PDA from seeds `["lp_pool", lpPoolId as u8 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPoolId - Single-byte LP pool id.
+ * @returns The `LpPool` account's public key.
+ */
 export function getLpPoolPublicKey(
 	programId: PublicKey,
 	lpPoolId: number
@@ -306,6 +465,13 @@ export function getLpPoolPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the token vault PDA holding an `LpPool`'s minted LP token supply's backing, from seeds
+ * `["LP_POOL_TOKEN_VAULT", lpPool]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPool - The `LpPool` account's public key.
+ * @returns The LP pool token vault's public key.
+ */
 export function getLpPoolTokenVaultPublicKey(
 	programId: PublicKey,
 	lpPool: PublicKey
@@ -318,6 +484,13 @@ export function getLpPoolTokenVaultPublicKey(
 		programId
 	)[0];
 }
+/**
+ * Derives the `AmmConstituentMapping` PDA (maps LP-pool constituents to the perp AMMs they hedge)
+ * from seeds `["AMM_MAP", lpPoolPublicKey]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPoolPublicKey - The `LpPool` account's public key.
+ * @returns The `AmmConstituentMapping` account's public key.
+ */
 export function getAmmConstituentMappingPublicKey(
 	programId: PublicKey,
 	lpPoolPublicKey: PublicKey
@@ -331,6 +504,13 @@ export function getAmmConstituentMappingPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the `ConstituentTargetBase` PDA (target base-asset weights for an LP pool's
+ * constituents) from seeds `["constituent_target_base_seed", lpPoolPublicKey]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPoolPublicKey - The `LpPool` account's public key.
+ * @returns The `ConstituentTargetBase` account's public key.
+ */
 export function getConstituentTargetBasePublicKey(
 	programId: PublicKey,
 	lpPoolPublicKey: PublicKey
@@ -346,6 +526,14 @@ export function getConstituentTargetBasePublicKey(
 	)[0];
 }
 
+/**
+ * Derives a `Constituent` PDA (one per spot market backing an LP pool) from seeds `["CONSTITUENT",
+ * lpPoolPublicKey, spotMarketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPoolPublicKey - The `LpPool` account's public key.
+ * @param spotMarketIndex - Spot market index of this constituent.
+ * @returns The `Constituent` account's public key.
+ */
 export function getConstituentPublicKey(
 	programId: PublicKey,
 	lpPoolPublicKey: PublicKey,
@@ -361,6 +549,14 @@ export function getConstituentPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the token vault PDA that custodies a `Constituent`'s deposits, from seeds
+ * `["CONSTITUENT_VAULT", lpPoolPublicKey, spotMarketIndex as u16 LE]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPoolPublicKey - The `LpPool` account's public key.
+ * @param spotMarketIndex - Spot market index of the constituent this vault backs.
+ * @returns The constituent vault token account's public key.
+ */
 export function getConstituentVaultPublicKey(
 	programId: PublicKey,
 	lpPoolPublicKey: PublicKey,
@@ -376,6 +572,12 @@ export function getConstituentVaultPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the singleton `AmmCache` PDA (caches per-AMM data used by LP-pool hedging/settlement)
+ * from seed `"amm_cache_seed"`. One per program deployment.
+ * @param programId - Deployed velocity program id.
+ * @returns The `AmmCache` account's public key.
+ */
 export function getAmmCachePublicKey(programId: PublicKey): PublicKey {
 	return PublicKey.findProgramAddressSync(
 		[Buffer.from(anchor.utils.bytes.utf8.encode('amm_cache_seed'))],
@@ -383,6 +585,13 @@ export function getAmmCachePublicKey(programId: PublicKey): PublicKey {
 	)[0];
 }
 
+/**
+ * Derives the `ConstituentCorrelations` PDA (pairwise correlation data between an LP pool's
+ * constituents) from seeds `["constituent_correlations", lpPoolPublicKey]`.
+ * @param programId - Deployed velocity program id.
+ * @param lpPoolPublicKey - The `LpPool` account's public key.
+ * @returns The `ConstituentCorrelations` account's public key.
+ */
 export function getConstituentCorrelationsPublicKey(
 	programId: PublicKey,
 	lpPoolPublicKey: PublicKey
@@ -396,6 +605,13 @@ export function getConstituentCorrelationsPublicKey(
 	)[0];
 }
 
+/**
+ * Derives the associated token account for an LP pool's mint under a given owner (not a
+ * program-derived PDA — a standard SPL associated token account).
+ * @param lpPoolTokenMint - The LP pool's token mint.
+ * @param authority - Owner of the associated token account.
+ * @returns The associated token account's public key.
+ */
 export async function getLpPoolTokenTokenAccountPublicKey(
 	lpPoolTokenMint: PublicKey,
 	authority: PublicKey