@towns-labs/sdk 2.0.1

package/README.md

@@ -0,0 +1,29 @@
+# River-Build SDK
+
+For more details, visit the following resources:
+
+River documentation: https://docs.towns.com/introduction
+River Messaging with encryption: https://docs.towns.com/concepts/encryption
+River Encryption protocol: https://docs.towns.com/build/towns-encryption
+GitHub repository: git+https://github.com/towns-protocol/towns.git
+bugs: https://github.com/towns-protocol/towns/issues
+
+# Debugging Tips
+
+## Logging
+
+Enabling logging for tests in the shell:
+
+    DEBUG=csb:* DEBUG_DEPTH=100 bun run test src/my.test.ts -t testCaseName
+
+To enabling debug logging in the browser, set var in console:
+
+    localStorage.debug = 'csb:*'
+
+## Inspecting Network Traffic
+
+Set this in console to switch encoding to JSON instead of binary:
+
+    localStorage.RIVER_DEBUG_TRANSPORT = 'true'
+
+Now in Network tab of the browser dev tool requests and responses are more readable.

package/dist/appRegistryService.d.ts

@@ -0,0 +1,17 @@
+import { Signer } from 'ethers';
+import { RpcOptions } from './rpcCommon';
+import { SignerContext } from './signerContext';
+export declare class AppRegistryService {
+    private static _authenticateCommon;
+    static authenticate(signerContext: SignerContext, serviceUrl: string, opts?: RpcOptions): Promise<{
+        startResponse: import("@towns-labs/proto").StartAuthenticationResponse;
+        finishResponse: import("@towns-labs/proto").FinishAuthenticationResponse;
+        appRegistryRpcClient: import("./makeAppRegistryRpcClient").AppRegistryRpcClient;
+    }>;
+    static authenticateWithSigner(userId: string | Uint8Array, signer: Signer, serviceUrl: string, opts?: RpcOptions): Promise<{
+        startResponse: import("@towns-labs/proto").StartAuthenticationResponse;
+        finishResponse: import("@towns-labs/proto").FinishAuthenticationResponse;
+        appRegistryRpcClient: import("./makeAppRegistryRpcClient").AppRegistryRpcClient;
+    }>;
+}
+//# sourceMappingURL=appRegistryService.d.ts.map

package/dist/appRegistryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appRegistryService.d.ts","sourceRoot":"","sources":["../src/appRegistryService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI/C,qBAAa,kBAAkB;mBACN,mBAAmB;WAsC3B,YAAY,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU;;;;;WAkBhF,sBAAsB,CAC/B,MAAM,EAAE,MAAM,GAAG,UAAU,EAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,UAAU;;;;;CAiBxB"}

package/dist/appRegistryService.js

@@ -0,0 +1,48 @@
+import { makeAuthenticationRpcClient } from './makeAuthenticationRpcClient';
+import { bin_fromHexString, check } from '@towns-labs/utils';
+import { meganodeAuthHash, riverSign } from './sign';
+import { isDefined } from './check';
+import { hashPersonalMessage } from '@ethereumjs/util';
+import { makeAppRegistryRpcClient } from './makeAppRegistryRpcClient';
+export class AppRegistryService {
+    static async _authenticateCommon(userId, serviceUrl, opts, getSignature, extraFinishAuthParams) {
+        const authenticationRpcClient = makeAuthenticationRpcClient(serviceUrl, opts);
+        const startResponse = await authenticationRpcClient.startAuthentication({ userId });
+        check(startResponse.challenge.length >= 16, 'challenge must be 16 bytes');
+        check(isDefined(startResponse.expiration), 'expiration must be defined');
+        const hash = meganodeAuthHash(userId, startResponse.expiration.seconds, startResponse.challenge);
+        const signature = await getSignature(hash);
+        const finishResponse = await authenticationRpcClient.finishAuthentication({
+            userId,
+            challenge: startResponse.challenge,
+            signature,
+            ...extraFinishAuthParams,
+        });
+        const appRegistryRpcClient = makeAppRegistryRpcClient(serviceUrl, finishResponse.sessionToken, opts);
+        return {
+            startResponse,
+            finishResponse,
+            appRegistryRpcClient,
+        };
+    }
+    static async authenticate(signerContext, serviceUrl, opts) {
+        const userId = signerContext.creatorAddress;
+        return this._authenticateCommon(userId, serviceUrl, opts, async (hashSrc) => {
+            const hash = hashPersonalMessage(hashSrc);
+            return await riverSign(hash, signerContext.signerPrivateKey());
+        }, {
+            delegateSig: signerContext.delegateSig,
+            delegateExpiryEpochMs: signerContext.delegateExpiryEpochMs,
+        });
+    }
+    static async authenticateWithSigner(userId, signer, serviceUrl, opts) {
+        if (typeof userId === 'string') {
+            userId = bin_fromHexString(userId);
+        }
+        return this._authenticateCommon(userId, serviceUrl, opts, async (hash) => {
+            const sigHex = await signer.signMessage(hash);
+            return bin_fromHexString(sigHex);
+        }, {});
+    }
+}
+//# sourceMappingURL=appRegistryService.js.map

package/dist/appRegistryService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appRegistryService.js","sourceRoot":"","sources":["../src/appRegistryService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAInC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAErE,MAAM,OAAO,kBAAkB;IACnB,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACpC,MAAkB,EAClB,UAAkB,EAClB,IAA4B,EAC5B,YAAuD,EACvD,qBAA0C;QAE1C,MAAM,uBAAuB,GAAG,2BAA2B,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAE7E,MAAM,aAAa,GAAG,MAAM,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACnF,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,4BAA4B,CAAC,CAAA;QACzE,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,4BAA4B,CAAC,CAAA;QAExE,MAAM,IAAI,GAAG,gBAAgB,CACzB,MAAM,EACN,aAAa,CAAC,UAAU,CAAC,OAAO,EAChC,aAAa,CAAC,SAAS,CAC1B,CAAA;QAED,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,oBAAoB,CAAC;YACtE,MAAM;YACN,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,SAAS;YACT,GAAG,qBAAqB;SAC3B,CAAC,CAAA;QACF,MAAM,oBAAoB,GAAG,wBAAwB,CACjD,UAAU,EACV,cAAc,CAAC,YAAY,EAC3B,IAAI,CACP,CAAA;QACD,OAAO;YACH,aAAa;YACb,cAAc;YACd,oBAAoB;SACvB,CAAA;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,aAA4B,EAAE,UAAkB,EAAE,IAAiB;QACzF,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAA;QAE3C,OAAO,IAAI,CAAC,mBAAmB,CAC3B,MAAM,EACN,UAAU,EACV,IAAI,EACJ,KAAK,EAAE,OAAO,EAAE,EAAE;YACd,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;YACzC,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAA;QAClE,CAAC,EACD;YACI,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,qBAAqB,EAAE,aAAa,CAAC,qBAAqB;SAC7D,CACJ,CAAA;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAC/B,MAA2B,EAC3B,MAAc,EACd,UAAkB,EAClB,IAAiB;QAEjB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACtC,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAC3B,MAAM,EACN,UAAU,EACV,IAAI,EACJ,KAAK,EAAE,IAAI,EAAE,EAAE;YACX,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YAC7C,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACpC,CAAC,EACD,EAAE,CACL,CAAA;IACL,CAAC;CACJ"}

package/dist/check.d.ts

@@ -0,0 +1,31 @@
+import { Err } from '@towns-labs/proto';
+/**
+ * Use this function in the default case of a exhaustive switch statement to ensure that all cases are handled.
+ * Always throws JSON RPC error.
+ * @param value - Switch value
+ * @param message - Error message
+ * @param code - JSON RPC error code
+ * @param data - Optional data to include in the error
+ */
+export declare function checkNever(value: never, message?: string, code?: Err, data?: any): never;
+/**
+ * Use this function in the default case of a exhaustive switch statement to ensure that all cases are handled,
+ * but you don't want to throw an error.
+ * Typical place you wouldn't want to throw an error - when parsing a protobuf message on the client. The protocol may
+ * have been updated on the server, but the client hasn't been updated yet. In this case, the client will receive a case
+ * that they can't handle, but it shouldn't break other messages in the stream. If you throw in the middle of a loop processing events,
+ * then lots of messages will appear lost, when you could have just gracefully handled a new case.
+ * @param value - Switch value
+ * @param message - Error message
+ * @param code - JSON RPC error code
+ * @param data - Optional data to include in the error
+ */
+export declare function logNever(value: never, message?: string): void;
+export declare function isDefined<T>(value: T | undefined | null): value is T;
+interface Lengthwise {
+    length: number;
+}
+export declare function hasElements<T extends Lengthwise>(value: T | undefined | null): value is T;
+export declare function assert(condition: boolean, message: string): asserts condition;
+export {};
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAKvC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,KAAK,CAMxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAG7D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAEpE;AAED,UAAU,UAAU;IAChB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAEzF;AAED,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAM7E"}

package/dist/check.js

@@ -0,0 +1,44 @@
+import { Err } from '@towns-labs/proto';
+import { dlogError, throwWithCode } from '@towns-labs/utils';
+const log = dlogError('csb:error');
+/**
+ * Use this function in the default case of a exhaustive switch statement to ensure that all cases are handled.
+ * Always throws JSON RPC error.
+ * @param value - Switch value
+ * @param message - Error message
+ * @param code - JSON RPC error code
+ * @param data - Optional data to include in the error
+ */
+export function checkNever(value, message, code, data) {
+    throwWithCode(message ?? `Unhandled switch value ${value}`, code ?? Err.INTERNAL_ERROR_SWITCH, data);
+}
+/**
+ * Use this function in the default case of a exhaustive switch statement to ensure that all cases are handled,
+ * but you don't want to throw an error.
+ * Typical place you wouldn't want to throw an error - when parsing a protobuf message on the client. The protocol may
+ * have been updated on the server, but the client hasn't been updated yet. In this case, the client will receive a case
+ * that they can't handle, but it shouldn't break other messages in the stream. If you throw in the middle of a loop processing events,
+ * then lots of messages will appear lost, when you could have just gracefully handled a new case.
+ * @param value - Switch value
+ * @param message - Error message
+ * @param code - JSON RPC error code
+ * @param data - Optional data to include in the error
+ */
+export function logNever(value, message) {
+    // eslint-disable-next-line no-console
+    console.warn(message ?? `Unhandled switch value: ${value}`);
+}
+export function isDefined(value) {
+    return value !== undefined && value !== null;
+}
+export function hasElements(value) {
+    return isDefined(value) && value.length > 0;
+}
+export function assert(condition, message) {
+    if (!condition) {
+        const e = new Error(message);
+        log('assertion failed: ', e);
+        throw e;
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAA;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,OAAgB,EAAE,IAAU,EAAE,IAAU;IAC7E,aAAa,CACT,OAAO,IAAI,0BAA0B,KAAK,EAAE,EAC5C,IAAI,IAAI,GAAG,CAAC,qBAAqB,EACjC,IAAI,CACP,CAAA;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAE,OAAgB;IACnD,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,2BAA2B,KAAK,EAAE,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,SAAS,CAAI,KAA2B;IACpD,OAAU,KAAK,KAAK,SAAS,IAAO,KAAK,KAAK,IAAI,CAAA;AACtD,CAAC;AAMD,MAAM,UAAU,WAAW,CAAuB,KAA2B;IACzE,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAe;IACtD,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,CAAA;IACX,CAAC;AACL,CAAC"}

package/dist/client-v2.d.ts

@@ -0,0 +1,89 @@
+import { CryptoStore, GroupEncryptionAlgorithmId, GroupEncryptionCrypto, type EncryptionDeviceInitOpts } from '@towns-labs/encryption';
+import { type StreamRpcClient } from './makeStreamRpcClient';
+import { type SignerContext } from './signerContext';
+import { type TownsConfig } from './townsEnv';
+import { ethers } from 'ethers';
+import { type Address } from '@towns-labs/web3';
+import { type ParsedEvent, type MiniblockInfoResponse } from './types';
+import { UnpackEnvelopeOpts } from './sign';
+import { UserInboxPayload_GroupEncryptionSessions, type Envelope, type PlainMessage, type StreamEvent, type Tags } from '@towns-labs/proto';
+import { AppRegistryRpcClient } from './makeAppRegistryRpcClient';
+import { StreamStateView } from './streamStateView';
+type Client_Base = {
+    /** The userId of the Client. */
+    userId: Address;
+    /** The signer context of the Client. */
+    signerContext: SignerContext;
+    /** The wallet of the Client. */
+    wallet: ethers.Wallet;
+    /** RPC client that connects to the Towns network. */
+    rpc: StreamRpcClient;
+    /** The config of the Client. Stores environenment id, base and river chain config */
+    config: TownsConfig;
+    /** Crypto Store */
+    keychain: CryptoStore;
+    /** Crypto Backend */
+    crypto: GroupEncryptionCrypto;
+    /** Algorithm used for group encryption. */
+    defaultGroupEncryptionAlgorithm: GroupEncryptionAlgorithmId;
+    /** Disable hash validation for streams. */
+    disableHashValidation: boolean;
+    /** Disable signature validation for streams. */
+    disableSignatureValidation: boolean;
+    /** Options for unpacking envelopes */
+    unpackEnvelopeOpts: UnpackEnvelopeOpts;
+    /** Get the app service, will authenticate on first call and cache the service for subsequent calls */
+    appServiceClient: () => Promise<AppRegistryRpcClient>;
+    /** Get a stream by streamId and unpack it */
+    getStream: (streamId: string) => Promise<StreamStateView>;
+    /** Get the miniblock info for a stream */
+    getMiniblockInfo: (streamId: string) => Promise<MiniblockInfoResponse>;
+    /** Unpack envelope using client config */
+    unpackEnvelope: (envelope: Envelope) => Promise<ParsedEvent>;
+    /** Unpack envelopes using client config */
+    unpackEnvelopes: (envelopes: Envelope[]) => Promise<ParsedEvent[]>;
+    /** injest a group encryption session */
+    importGroupEncryptionSessions: (payload: {
+        streamId: string;
+        sessions: UserInboxPayload_GroupEncryptionSessions;
+    }) => Promise<void>;
+    /** Send an event to a stream */
+    sendEvent: (streamId: string, eventPayload: PlainMessage<StreamEvent>['payload'], tags?: PlainMessage<Tags>, ephemeral?: boolean) => Promise<{
+        eventId: string;
+        prevMiniblockHash: Uint8Array;
+        envelope: Envelope;
+    }>;
+};
+export type ClientV2<extended extends Extended | undefined = Extended | undefined> = Client_Base & (extended extends Extended ? extended : unknown) & {
+    extend: <const client extends Extended>(fn: (client: ClientV2<extended>) => client) => ClientV2<Prettify<client> & (extended extends Extended ? extended : unknown)>;
+};
+type Extended = Prettify<{
+    [_ in keyof Client_Base]?: undefined;
+} & {
+    [key: string]: unknown;
+}>;
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type CreateTownsClientParams = {
+    env: string;
+    encryptionDevice?: EncryptionDeviceInitOpts;
+    /** Toggle hash validation of Envelopes. Defaults to `false`. */
+    hashValidation?: boolean;
+    /** Toggle signature validation of Envelopes. Defaults to `false`. */
+    signatureValidation?: boolean;
+    /** Maximum number of entries to store in the crypto store (for in-memory stores).
+     *  Helps prevent memory leaks in long-running bots.
+     *  Defaults to 5000.
+     */
+    maxCryptoStoreEntries?: number;
+};
+export declare const createTownsClient: (params: ({
+    privateKey: string;
+} | {
+    mnemonic: string;
+} | {
+    bearerToken: string;
+}) & CreateTownsClientParams) => Promise<ClientV2>;
+export {};
+//# sourceMappingURL=client-v2.d.ts.map

package/dist/client-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-v2.d.ts","sourceRoot":"","sources":["../src/client-v2.ts"],"names":[],"mappings":"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"}

package/dist/client-v2.js

@@ -0,0 +1,293 @@
+import { GroupEncryptionAlgorithmId, GroupEncryptionCrypto, parseGroupEncryptionAlgorithmId, } from '@towns-labs/encryption';
+import { makeStreamRpcClient } from './makeStreamRpcClient';
+import { makeSignerContext, makeSignerContextFromBearerToken, } from './signerContext';
+import { townsEnv } from './townsEnv';
+import { ethers } from 'ethers';
+import { makeSessionKeys } from './decryptionExtensions';
+import { makeBaseProvider } from './sync-agent/utils/providers';
+import { RiverDbManager } from './riverDbManager';
+import { makeUserInboxStreamId, makeUserMetadataStreamId, streamIdAsBytes, streamIdAsString, userIdFromAddress, } from './id';
+import { make_UserInboxPayload_GroupEncryptionSessions, } from './types';
+import { makeEvent, unpackStream, unpackEnvelope as sdk_unpackEnvelope, unpackEnvelopes as sdk_unpackEnvelopes, } from './sign';
+import { bin_toHexString, bin_fromHexString, check } from '@towns-labs/utils';
+import { fromJsonString, toJsonString } from '@bufbuild/protobuf';
+import { SessionKeysSchema, Err, } from '@towns-labs/proto';
+import { errorContains, errorContainsMessage, getRpcErrorProperty } from './rpcInterceptors';
+import { AppRegistryService } from './appRegistryService';
+import { StreamStateView } from './streamStateView';
+export const createTownsClient = async (params) => {
+    const config = townsEnv().makeTownsConfig(params.env);
+    const baseProvider = makeBaseProvider(config);
+    let signerContext;
+    let wallet;
+    if ('mnemonic' in params) {
+        wallet = ethers.Wallet.fromMnemonic(params.mnemonic).connect(baseProvider);
+        const delegateWallet = ethers.Wallet.createRandom();
+        signerContext = await makeSignerContext(wallet, delegateWallet);
+    }
+    else if ('privateKey' in params) {
+        wallet = new ethers.Wallet(params.privateKey).connect(baseProvider);
+        const delegateWallet = ethers.Wallet.createRandom();
+        signerContext = await makeSignerContext(wallet, delegateWallet);
+    }
+    else {
+        signerContext = await makeSignerContextFromBearerToken(params.bearerToken);
+        wallet = new ethers.Wallet(signerContext.signerPrivateKey()).connect(baseProvider);
+    }
+    const rpc = makeStreamRpcClient(config.services.node.url);
+    const userId = userIdFromAddress(signerContext.creatorAddress);
+    const cryptoStore = RiverDbManager.getCryptoDb(userId, undefined, params.maxCryptoStoreEntries);
+    await cryptoStore.initialize();
+    // eslint-disable-next-line prefer-const
+    let crypto;
+    let _appService;
+    const getMiniblockInfo = async (streamId) => {
+        const r = await client.rpc.getLastMiniblockHash({ streamId: streamIdAsBytes(streamId) });
+        return {
+            miniblockNum: r.miniblockNum,
+            miniblockHash: r.hash,
+            encryptionAlgorithm: r.encryptionAlgorithm,
+        };
+    };
+    const getStream = async (streamId) => {
+        const { disableHashValidation, disableSignatureValidation } = client;
+        const stream = await client.rpc.getStream({ streamId: streamIdAsBytes(streamId) });
+        const unpackedResponse = await unpackStream(stream.stream, {
+            disableHashValidation,
+            disableSignatureValidation,
+        });
+        const streamView = new StreamStateView(userId, streamIdAsString(streamId), undefined);
+        streamView.initialize(unpackedResponse.streamAndCookie.nextSyncCookie, unpackedResponse.streamAndCookie.events, unpackedResponse.snapshot, unpackedResponse.streamAndCookie.miniblocks, [], unpackedResponse.prevSnapshotMiniblockNum, undefined, [], undefined);
+        return streamView;
+    };
+    const unpackEnvelope = async (envelope) => {
+        const { disableHashValidation, disableSignatureValidation } = client;
+        return sdk_unpackEnvelope(envelope, {
+            disableHashValidation,
+            disableSignatureValidation,
+        });
+    };
+    const unpackEnvelopes = async (envelopes) => {
+        const { disableHashValidation, disableSignatureValidation } = client;
+        return sdk_unpackEnvelopes(envelopes, { disableHashValidation, disableSignatureValidation });
+    };
+    const withRetry = async (operation) => {
+        const RETRY_POLICY = {
+            [Err.MINIBLOCK_TOO_NEW]: { delay: 1000, maxRetries: 5 },
+            [Err.BAD_PREV_MINIBLOCK_HASH]: { delay: 0, maxRetries: 3 },
+            [Err.PERMISSION_DENIED]: { delay: [200, 400, 800, 1100], maxRetries: 4 },
+        };
+        const attempt = async (retryCount, prev) => {
+            try {
+                return await operation(prev, retryCount);
+            }
+            catch (err) {
+                let policy;
+                let errorType;
+                if (errorContains(err, Err.MINIBLOCK_TOO_NEW)) {
+                    policy = RETRY_POLICY[Err.MINIBLOCK_TOO_NEW];
+                    errorType = Err.MINIBLOCK_TOO_NEW;
+                }
+                else if (errorContains(err, Err.BAD_PREV_MINIBLOCK_HASH)) {
+                    policy = RETRY_POLICY[Err.BAD_PREV_MINIBLOCK_HASH];
+                    errorType = Err.BAD_PREV_MINIBLOCK_HASH;
+                }
+                else if (errorContains(err, Err.PERMISSION_DENIED) &&
+                    (errorContainsMessage(err, 'Transaction has 0 confirmations.') ||
+                        errorContainsMessage(err, 'Transaction receipt not found'))) {
+                    policy = RETRY_POLICY[Err.PERMISSION_DENIED];
+                    errorType = Err.PERMISSION_DENIED;
+                }
+                // Not a retryable error or max retries exceeded
+                if (!policy || !errorType || retryCount >= policy.maxRetries) {
+                    throw err;
+                }
+                // Calculate delay for this retry
+                const delay = typeof policy.delay === 'number'
+                    ? policy.delay
+                    : policy.delay[retryCount] || policy.delay[policy.delay.length - 1];
+                // Handle BAD_PREV_MINIBLOCK_HASH - extract expected hash from error
+                if (errorType === Err.BAD_PREV_MINIBLOCK_HASH) {
+                    const expectedHash = getRpcErrorProperty(err, 'expected');
+                    const expectedMiniblockNum = getRpcErrorProperty(err, 'expNum');
+                    check(expectedHash !== undefined, 'expected hash not found in BAD_PREV_MINIBLOCK_HASH error');
+                    check(expectedMiniblockNum !== undefined, 'expected miniblock num not found in BAD_PREV_MINIBLOCK_HASH error');
+                    if (delay > 0) {
+                        await new Promise((resolve) => setTimeout(resolve, delay));
+                    }
+                    return attempt(retryCount + 1, {
+                        prevMiniblockHash: bin_fromHexString(expectedHash),
+                        prevMiniblockNum: BigInt(expectedMiniblockNum),
+                    });
+                }
+                if (delay > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+                return attempt(retryCount + 1, prev);
+            }
+        };
+        return attempt(0);
+    };
+    const sendEvent = async (streamId, eventPayload, tags, ephemeral) => {
+        return withRetry(async (prev, _retryCount) => {
+            const { hash: miniblockHash, miniblockNum } = prev
+                ? { hash: prev.prevMiniblockHash, miniblockNum: prev.prevMiniblockNum }
+                : await client.rpc.getLastMiniblockHash({
+                    streamId: streamIdAsBytes(streamId),
+                });
+            const envelope = await makeEvent(signerContext, eventPayload, miniblockHash, miniblockNum, tags, ephemeral);
+            const eventId = bin_toHexString(envelope.hash);
+            await client.rpc.addEvent({
+                streamId: streamIdAsBytes(streamId),
+                event: envelope,
+            });
+            return { eventId, prevMiniblockHash: miniblockHash, envelope };
+        });
+    };
+    const buildGroupEncryptionClient = () => {
+        const _downloadUserDeviceInfo = async (userId) => {
+            const streamId = makeUserMetadataStreamId(userId);
+            try {
+                const deviceLookback = 10;
+                const streamView = await getStream(streamId);
+                const userDevices = streamView.userMetadataContent.deviceKeys.slice(-deviceLookback);
+                return { userId, devices: userDevices };
+            }
+            catch (e) {
+                return { userId, devices: [] };
+            }
+        };
+        const _encryptAndShareGroupSessionsToUser = async (streamId, userId, sessionIds, payloadStr, algorithm, userDevice) => {
+            try {
+                const deviceKeys = await _downloadUserDeviceInfo(userId);
+                const ciphertext = await crypto.encryptWithDeviceKeys(payloadStr, deviceKeys.devices);
+                if (Object.keys(ciphertext).length === 0) {
+                    return;
+                }
+                const toStreamId = makeUserInboxStreamId(userId);
+                const { hash: miniblockHash, miniblockNum } = await rpc.getLastMiniblockHash({
+                    streamId: streamIdAsBytes(toStreamId),
+                });
+                const event = await makeEvent(signerContext, make_UserInboxPayload_GroupEncryptionSessions({
+                    streamId: streamIdAsBytes(streamId),
+                    senderKey: userDevice.deviceKey,
+                    sessionIds: sessionIds,
+                    ciphertexts: ciphertext,
+                    algorithm: algorithm,
+                }), miniblockHash, miniblockNum);
+                const eventId = bin_toHexString(event.hash);
+                await rpc.addEvent({
+                    streamId: streamIdAsBytes(toStreamId),
+                    event,
+                });
+                return { miniblockHash, eventId };
+            }
+            catch (e) {
+                return undefined;
+            }
+        };
+        const encryptAndShareGroupSessionsToStream = async (streamId, sessions, algorithm, priorityUserIds) => {
+            const streamView = await getStream(streamId);
+            const otherUsers = Array.from(streamView.getUsersEntitledToKeyExchange()).filter((userId) => !priorityUserIds.includes(userId));
+            check(sessions.length >= 0, 'no sessions to encrypt');
+            check(new Set(sessions.map((s) => s.streamId)).size === 1, 'sessions should all be from the same stream');
+            check(sessions[0].algorithm === algorithm, 'algorithm mismatch');
+            check(new Set(sessions.map((s) => s.algorithm)).size === 1, 'all sessions should be the same algorithm');
+            check(sessions[0].streamId === streamId, 'streamId mismatch');
+            const userDevice = crypto.getUserDevice();
+            const sessionIds = sessions.map((session) => session.sessionId);
+            const payload = makeSessionKeys(sessions);
+            const payloadStr = toJsonString(SessionKeysSchema, payload);
+            // do the priority users first
+            const priorityPromises = priorityUserIds.map(async (userId) => {
+                return _encryptAndShareGroupSessionsToUser(streamId, userId, sessionIds, payloadStr, algorithm, userDevice);
+            });
+            await Promise.all(priorityPromises);
+            // then the other users
+            const otherPromises = otherUsers.map(async (userId) => {
+                return _encryptAndShareGroupSessionsToUser(streamId, userId, sessionIds, payloadStr, algorithm, userDevice);
+            });
+            await Promise.all(otherPromises);
+        };
+        return {
+            getMiniblockInfo,
+            encryptAndShareGroupSessionsToStream,
+        };
+    };
+    const appServiceClient = async () => {
+        if (_appService) {
+            return _appService.appRegistryRpcClient;
+        }
+        _appService = await AppRegistryService.authenticate(signerContext, config.services.appRegistry.url);
+        return _appService.appRegistryRpcClient;
+    };
+    const importGroupEncryptionSessions = async (payload) => {
+        const userDevice = crypto.getUserDevice();
+        const { streamId, sessions: session } = payload;
+        // check if this message is to our device
+        const ciphertext = session.ciphertexts[userDevice.deviceKey];
+        if (!ciphertext) {
+            //log.debug('skipping, no session for our device')
+            return;
+        }
+        // check if it contains any keys we need, default to GroupEncryption if the algorithm is not set
+        const parsed = parseGroupEncryptionAlgorithmId(session.algorithm, GroupEncryptionAlgorithmId.GroupEncryption);
+        if (parsed.kind === 'unrecognized') {
+            // todo dispatch event to update the error message
+            //this.log.error('skipping, invalid algorithm', session.algorithm)
+            return;
+        }
+        const algorithm = parsed.value;
+        // decrypt the message
+        const cleartext = await crypto.decryptWithDeviceKey(ciphertext, session.senderKey);
+        const sessionKeys = fromJsonString(SessionKeysSchema, cleartext);
+        check(sessionKeys.keys.length === session.sessionIds.length, 'bad sessionKeys');
+        // make group sessions
+        const sessions = sessionKeys.keys.map((key, i) => ({
+            streamId: streamId,
+            sessionId: session.sessionIds[i],
+            sessionKey: key,
+            algorithm: algorithm,
+        }));
+        await crypto.importSessionKeys(streamId, sessions);
+    };
+    await cryptoStore.initialize();
+    crypto = new GroupEncryptionCrypto(buildGroupEncryptionClient(), cryptoStore);
+    await crypto.init(params.encryptionDevice);
+    const { hashValidation = false, signatureValidation = false } = params;
+    const unpackEnvelopeOpts = {
+        disableHashValidation: !hashValidation,
+        disableSignatureValidation: !signatureValidation,
+    };
+    const client = {
+        crypto,
+        keychain: cryptoStore,
+        defaultGroupEncryptionAlgorithm: GroupEncryptionAlgorithmId.HybridGroupEncryption,
+        rpc,
+        signerContext,
+        wallet,
+        userId,
+        disableHashValidation: !hashValidation,
+        disableSignatureValidation: !signatureValidation,
+        unpackEnvelopeOpts,
+        appServiceClient,
+        getStream,
+        getMiniblockInfo,
+        sendEvent,
+        unpackEnvelope,
+        unpackEnvelopes,
+        importGroupEncryptionSessions,
+        config,
+    };
+    function extend(base) {
+        return (extendFn) => {
+            const extended = extendFn(base);
+            for (const key in client)
+                delete extended[key];
+            const combined = { ...base, ...extended };
+            return Object.assign(combined, { extend: extend(combined) });
+        };
+    }
+    return Object.assign(client, { extend: extend(client) });
+};
+//# sourceMappingURL=client-v2.js.map

package/dist/client-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-v2.js","sourceRoot":"","sources":["../src/client-v2.ts"],"names":[],"mappings":"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"}