@dynamic-labs-sdk/client 0.0.1-alpha.24 → 0.0.1-alpha.25

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+## 0.0.1-alpha.25 (2025-08-27)
+
+### 🚀 Features
+
+- add ethereum netowrk providers ([#267](https://github.com/dynamic-labs/dynamic-sdk/pull/267))
+- add solana network provider ([#268](https://github.com/dynamic-labs/dynamic-sdk/pull/268))
+- add proveWalletAccountOwnership function ([#295](https://github.com/dynamic-labs/dynamic-sdk/pull/295))
+- format evm wallet addresses to conform to eip55 ([#300](https://github.com/dynamic-labs/dynamic-sdk/pull/300))
+- add viem public client ([#272](https://github.com/dynamic-labs/dynamic-sdk/pull/272))
+- add getSolanaConnection ([#275](https://github.com/dynamic-labs/dynamic-sdk/pull/275))
+- add dynamic waas evm extension ([#299](https://github.com/dynamic-labs/dynamic-sdk/pull/299))
+- add refreshUser function ([#332](https://github.com/dynamic-labs/dynamic-sdk/pull/332))
+- add get network method ([#321](https://github.com/dynamic-labs/dynamic-sdk/pull/321))
+
+### 🩹 Fixes
+
+- update default API base URL ([#296](https://github.com/dynamic-labs/dynamic-sdk/pull/296))
+
+### 🔧 Refactors
+
+- reorganize exports index file ([#303](https://github.com/dynamic-labs/dynamic-sdk/pull/303))
+- rename events folder to clientEvents ([#305](https://github.com/dynamic-labs/dynamic-sdk/pull/305))
+- dry network provider type ([#308](https://github.com/dynamic-labs/dynamic-sdk/pull/308))
+- rename types files to include the features name ([#319](https://github.com/dynamic-labs/dynamic-sdk/pull/319))
+- use evm instead of other terms ([#306](https://github.com/dynamic-labs/dynamic-sdk/pull/306))
+- rename net configuration to net data ([#322](https://github.com/dynamic-labs/dynamic-sdk/pull/322))
+- move waas-utils to client package ([#342](https://github.com/dynamic-labs/dynamic-sdk/pull/342))
+
 ## 0.0.1-alpha.24 (2025-08-14)
 
 This was a version bump only, there were no code changes.

package/bufferToHex.cjs.js

@@ -0,0 +1,51 @@
+'use strict';
+
+var sdkApiCore = require('@dynamic-labs/sdk-api-core');
+var constants = require('./constants.cjs.js');
+var buffer = require('buffer');
+
+/**
+ * Returns true if the client is using Dynamic cookies or a BYO JWT cookie.
+ */ const isCookieEnabled = (client)=>{
+    var _securitySettings_auth, _securitySettings_externalAuth;
+    constants.assertDefined(client.projectSettings, 'Project settings are not defined');
+    const securitySettings = client.projectSettings.security;
+    if (!securitySettings) return false;
+    // client uses Dynamic cookies
+    const dynamicCookiesEnabled = (((_securitySettings_auth = securitySettings.auth) == null ? void 0 : _securitySettings_auth.storage) || []).includes(sdkApiCore.AuthStorageEnum.Cookie);
+    // BYO JWT client puts their non-Dynamic JWT in a cookie
+    const byoJwtCookieEnabled = Boolean((_securitySettings_externalAuth = securitySettings.externalAuth) == null ? void 0 : _securitySettings_externalAuth.cookieName);
+    // should return true for both of these scenarios
+    // because we also need to do `credentials: true` in api.ts when
+    // a byo jwt client sets their named cookie for their jwt and
+    // needs to send it to our backend
+    return dynamicCookiesEnabled || byoJwtCookieEnabled;
+};
+
+const getBuffer = ()=>typeof Buffer !== 'undefined' ? Buffer : buffer.Buffer;
+
+const getSessionKeys = (client)=>{
+    const core = constants.getCore(client);
+    const encodedKeys = core.state.get().sessionKeys;
+    if (!encodedKeys) {
+        return undefined;
+    }
+    try {
+        const decodedKeys = JSON.parse(getBuffer().from(encodedKeys, 'base64').toString());
+        return decodedKeys;
+    } catch (error) {
+        core.logger.error('Error decoding session keys', error);
+        return undefined;
+    }
+};
+
+/**
+ * Converts an ArrayBuffer to a hex-encoded string
+ */ const bufferToHex = (buffer)=>[
+        ...new Uint8Array(buffer)
+    ].map((x)=>x.toString(16).padStart(2, '0')).join('');
+
+exports.bufferToHex = bufferToHex;
+exports.getBuffer = getBuffer;
+exports.getSessionKeys = getSessionKeys;
+exports.isCookieEnabled = isCookieEnabled;

package/bufferToHex.esm.js

@@ -0,0 +1,46 @@
+import { AuthStorageEnum } from '@dynamic-labs/sdk-api-core';
+import { a as assertDefined, g as getCore } from './constants.esm.js';
+import { Buffer as Buffer$1 } from 'buffer';
+
+/**
+ * Returns true if the client is using Dynamic cookies or a BYO JWT cookie.
+ */ const isCookieEnabled = (client)=>{
+    var _securitySettings_auth, _securitySettings_externalAuth;
+    assertDefined(client.projectSettings, 'Project settings are not defined');
+    const securitySettings = client.projectSettings.security;
+    if (!securitySettings) return false;
+    // client uses Dynamic cookies
+    const dynamicCookiesEnabled = (((_securitySettings_auth = securitySettings.auth) == null ? void 0 : _securitySettings_auth.storage) || []).includes(AuthStorageEnum.Cookie);
+    // BYO JWT client puts their non-Dynamic JWT in a cookie
+    const byoJwtCookieEnabled = Boolean((_securitySettings_externalAuth = securitySettings.externalAuth) == null ? void 0 : _securitySettings_externalAuth.cookieName);
+    // should return true for both of these scenarios
+    // because we also need to do `credentials: true` in api.ts when
+    // a byo jwt client sets their named cookie for their jwt and
+    // needs to send it to our backend
+    return dynamicCookiesEnabled || byoJwtCookieEnabled;
+};
+
+const getBuffer = ()=>typeof Buffer !== 'undefined' ? Buffer : Buffer$1;
+
+const getSessionKeys = (client)=>{
+    const core = getCore(client);
+    const encodedKeys = core.state.get().sessionKeys;
+    if (!encodedKeys) {
+        return undefined;
+    }
+    try {
+        const decodedKeys = JSON.parse(getBuffer().from(encodedKeys, 'base64').toString());
+        return decodedKeys;
+    } catch (error) {
+        core.logger.error('Error decoding session keys', error);
+        return undefined;
+    }
+};
+
+/**
+ * Converts an ArrayBuffer to a hex-encoded string
+ */ const bufferToHex = (buffer)=>[
+        ...new Uint8Array(buffer)
+    ].map((x)=>x.toString(16).padStart(2, '0')).join('');
+
+export { getSessionKeys as a, bufferToHex as b, getBuffer as g, isCookieEnabled as i };

package/constants.cjs.js

@@ -0,0 +1,178 @@
+'use strict';
+
+var name = "@dynamic-labs-sdk/client";
+var version = "0.0.1-alpha.25";
+var dependencies = {
+    "@dynamic-labs/sdk-api-core": "0.0.762"};
+
+function _extends() {
+    _extends = Object.assign || function assign(target) {
+        for(var i = 1; i < arguments.length; i++){
+            var source = arguments[i];
+            for(var key in source)if (Object.prototype.hasOwnProperty.call(source, key)) target[key] = source[key];
+        }
+        return target;
+    };
+    return _extends.apply(this, arguments);
+}
+
+const getDetails = ({ details, cause })=>{
+    if (cause instanceof BaseError) {
+        return cause.details;
+    }
+    if (cause == null ? void 0 : cause.message) {
+        return cause.message;
+    }
+    return details;
+};
+/**
+ * Formats the error message with all available information
+ */ const formatMessage = ({ shortMessage, details, docsUrl, metaMessages })=>{
+    return [
+        shortMessage,
+        '',
+        ...metaMessages ? [
+            ...metaMessages,
+            ''
+        ] : [],
+        ...docsUrl ? [
+            `Docs: ${docsUrl}`
+        ] : [],
+        ...details ? [
+            `Details: ${details}`
+        ] : [],
+        `Version: ${version}`,
+        `Timestamp: ${new Date().toISOString()}`
+    ].join('\n');
+};
+/**
+ * Base error class that provides structured error handling with detailed information
+ */ class BaseError extends Error {
+    /**
+   * Walks the cause chain of the error and returns the root error
+   */ walk() {
+        const cause = this.cause;
+        if (cause instanceof BaseError) {
+            return cause.walk();
+        }
+        return cause;
+    }
+    toString() {
+        return this.formattedMessage;
+    }
+    constructor(args){
+        const details = getDetails(args);
+        const formattedMessage = formatMessage(_extends({}, args, {
+            details
+        }));
+        var _args_shortMessage;
+        super((_args_shortMessage = args.shortMessage) != null ? _args_shortMessage : formattedMessage, args.cause ? {
+            cause: args.cause
+        } : undefined);
+        this.name = 'BaseError';
+        this.formattedMessage = formattedMessage;
+        this.details = details;
+        var _args_name;
+        this.name = (_args_name = args.name) != null ? _args_name : this.name;
+        var _args_cause;
+        this.cause = (_args_cause = args.cause) != null ? _args_cause : this.cause;
+        this.code = args.code;
+    }
+}
+
+const getCore = (client)=>{
+    // @ts-expect-error - this was hidden from the public API
+    return client.__core;
+};
+
+class ValueMustBeDefinedError extends BaseError {
+    constructor(message){
+        super({
+            cause: null,
+            code: 'value_must_be_defined_error',
+            docsUrl: null,
+            name: 'ValueMustBeDefined',
+            shortMessage: message
+        });
+    }
+}
+
+/**
+ * Asserts that a value is not null or undefined, throwing an error if it is.
+ * This function acts as a type guard, narrowing the type to exclude null and undefined.
+ *
+ * @template T - The type of the value being checked
+ * @param value - The value to check for null or undefined
+ * @param message - The error message to throw if the value is null or undefined
+ * @throws Throws an error with the provided message if value is null or undefined
+ * @example
+ * ```typescript
+ * const maybeString: string | null = getValue();
+ * assertDefined(maybeString, 'String value is required');
+ * // maybeString is now typed as string (null is excluded)
+ * ```
+ */ function assertDefined(value, message) {
+    if (value === null || value === undefined) {
+        throw new ValueMustBeDefinedError(message);
+    }
+}
+
+const CHAINS_INFO_MAP = {
+    ALGO: {
+        apiChainName: 'algo',
+        blockchainName: 'Algorand',
+        verifiedCredentialChainName: 'algorand'
+    },
+    BTC: {
+        apiChainName: 'btc',
+        blockchainName: 'Bitcoin',
+        verifiedCredentialChainName: 'bip122'
+    },
+    COSMOS: {
+        apiChainName: 'cosmos',
+        blockchainName: 'Cosmos',
+        verifiedCredentialChainName: 'cosmos'
+    },
+    EVM: {
+        apiChainName: 'evm',
+        // eslint-disable-next-line custom-rules/ban-ethereum-eth-terms
+        blockchainName: 'Ethereum',
+        verifiedCredentialChainName: 'eip155'
+    },
+    FLOW: {
+        apiChainName: 'flow',
+        blockchainName: 'Flow',
+        verifiedCredentialChainName: 'flow'
+    },
+    SOL: {
+        apiChainName: 'solana',
+        blockchainName: 'Solana',
+        verifiedCredentialChainName: 'solana',
+        waasChainNameOverride: 'SVM'
+    },
+    SPARK: {
+        apiChainName: 'spark',
+        blockchainName: 'Spark',
+        verifiedCredentialChainName: 'spark'
+    },
+    STARK: {
+        apiChainName: 'starknet',
+        blockchainName: 'Starknet',
+        verifiedCredentialChainName: 'starknet'
+    },
+    SUI: {
+        apiChainName: 'sui',
+        blockchainName: 'Sui',
+        verifiedCredentialChainName: 'sui'
+    }
+};
+
+exports.BaseError = BaseError;
+exports.CHAINS_INFO_MAP = CHAINS_INFO_MAP;
+exports.ValueMustBeDefinedError = ValueMustBeDefinedError;
+exports._extends = _extends;
+exports.assertDefined = assertDefined;
+exports.dependencies = dependencies;
+exports.getCore = getCore;
+exports.name = name;
+exports.version = version;

package/constants.cjs2.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const DEFAULT_WAAS_BASE_API_URL = 'https://app.dynamicauth.com';
+const DEFAULT_WAAS_BASE_MPC_RELAY_API_URL = 'https://relay.dynamicauth.com';
+const DYNAMIC_WAAS_METADATA = {
+    icon: 'https://iconic.dynamic-static-assets.com/icons/sprite.svg#dynamicwaas',
+    key: 'dynamicwaas',
+    name: 'Dynamic WaaS'
+};
+
+exports.DEFAULT_WAAS_BASE_API_URL = DEFAULT_WAAS_BASE_API_URL;
+exports.DEFAULT_WAAS_BASE_MPC_RELAY_API_URL = DEFAULT_WAAS_BASE_MPC_RELAY_API_URL;
+exports.DYNAMIC_WAAS_METADATA = DYNAMIC_WAAS_METADATA;

package/constants.esm.js

@@ -0,0 +1,168 @@
+var name = "@dynamic-labs-sdk/client";
+var version = "0.0.1-alpha.25";
+var dependencies = {
+    "@dynamic-labs/sdk-api-core": "0.0.762"};
+
+function _extends() {
+    _extends = Object.assign || function assign(target) {
+        for(var i = 1; i < arguments.length; i++){
+            var source = arguments[i];
+            for(var key in source)if (Object.prototype.hasOwnProperty.call(source, key)) target[key] = source[key];
+        }
+        return target;
+    };
+    return _extends.apply(this, arguments);
+}
+
+const getDetails = ({ details, cause })=>{
+    if (cause instanceof BaseError) {
+        return cause.details;
+    }
+    if (cause == null ? void 0 : cause.message) {
+        return cause.message;
+    }
+    return details;
+};
+/**
+ * Formats the error message with all available information
+ */ const formatMessage = ({ shortMessage, details, docsUrl, metaMessages })=>{
+    return [
+        shortMessage,
+        '',
+        ...metaMessages ? [
+            ...metaMessages,
+            ''
+        ] : [],
+        ...docsUrl ? [
+            `Docs: ${docsUrl}`
+        ] : [],
+        ...details ? [
+            `Details: ${details}`
+        ] : [],
+        `Version: ${version}`,
+        `Timestamp: ${new Date().toISOString()}`
+    ].join('\n');
+};
+/**
+ * Base error class that provides structured error handling with detailed information
+ */ class BaseError extends Error {
+    /**
+   * Walks the cause chain of the error and returns the root error
+   */ walk() {
+        const cause = this.cause;
+        if (cause instanceof BaseError) {
+            return cause.walk();
+        }
+        return cause;
+    }
+    toString() {
+        return this.formattedMessage;
+    }
+    constructor(args){
+        const details = getDetails(args);
+        const formattedMessage = formatMessage(_extends({}, args, {
+            details
+        }));
+        var _args_shortMessage;
+        super((_args_shortMessage = args.shortMessage) != null ? _args_shortMessage : formattedMessage, args.cause ? {
+            cause: args.cause
+        } : undefined);
+        this.name = 'BaseError';
+        this.formattedMessage = formattedMessage;
+        this.details = details;
+        var _args_name;
+        this.name = (_args_name = args.name) != null ? _args_name : this.name;
+        var _args_cause;
+        this.cause = (_args_cause = args.cause) != null ? _args_cause : this.cause;
+        this.code = args.code;
+    }
+}
+
+const getCore = (client)=>{
+    // @ts-expect-error - this was hidden from the public API
+    return client.__core;
+};
+
+class ValueMustBeDefinedError extends BaseError {
+    constructor(message){
+        super({
+            cause: null,
+            code: 'value_must_be_defined_error',
+            docsUrl: null,
+            name: 'ValueMustBeDefined',
+            shortMessage: message
+        });
+    }
+}
+
+/**
+ * Asserts that a value is not null or undefined, throwing an error if it is.
+ * This function acts as a type guard, narrowing the type to exclude null and undefined.
+ *
+ * @template T - The type of the value being checked
+ * @param value - The value to check for null or undefined
+ * @param message - The error message to throw if the value is null or undefined
+ * @throws Throws an error with the provided message if value is null or undefined
+ * @example
+ * ```typescript
+ * const maybeString: string | null = getValue();
+ * assertDefined(maybeString, 'String value is required');
+ * // maybeString is now typed as string (null is excluded)
+ * ```
+ */ function assertDefined(value, message) {
+    if (value === null || value === undefined) {
+        throw new ValueMustBeDefinedError(message);
+    }
+}
+
+const CHAINS_INFO_MAP = {
+    ALGO: {
+        apiChainName: 'algo',
+        blockchainName: 'Algorand',
+        verifiedCredentialChainName: 'algorand'
+    },
+    BTC: {
+        apiChainName: 'btc',
+        blockchainName: 'Bitcoin',
+        verifiedCredentialChainName: 'bip122'
+    },
+    COSMOS: {
+        apiChainName: 'cosmos',
+        blockchainName: 'Cosmos',
+        verifiedCredentialChainName: 'cosmos'
+    },
+    EVM: {
+        apiChainName: 'evm',
+        // eslint-disable-next-line custom-rules/ban-ethereum-eth-terms
+        blockchainName: 'Ethereum',
+        verifiedCredentialChainName: 'eip155'
+    },
+    FLOW: {
+        apiChainName: 'flow',
+        blockchainName: 'Flow',
+        verifiedCredentialChainName: 'flow'
+    },
+    SOL: {
+        apiChainName: 'solana',
+        blockchainName: 'Solana',
+        verifiedCredentialChainName: 'solana',
+        waasChainNameOverride: 'SVM'
+    },
+    SPARK: {
+        apiChainName: 'spark',
+        blockchainName: 'Spark',
+        verifiedCredentialChainName: 'spark'
+    },
+    STARK: {
+        apiChainName: 'starknet',
+        blockchainName: 'Starknet',
+        verifiedCredentialChainName: 'starknet'
+    },
+    SUI: {
+        apiChainName: 'sui',
+        blockchainName: 'Sui',
+        verifiedCredentialChainName: 'sui'
+    }
+};
+
+export { BaseError as B, CHAINS_INFO_MAP as C, ValueMustBeDefinedError as V, _extends as _, assertDefined as a, dependencies as d, getCore as g, name as n, version as v };

package/constants.esm2.js

@@ -0,0 +1,9 @@
+const DEFAULT_WAAS_BASE_API_URL = 'https://app.dynamicauth.com';
+const DEFAULT_WAAS_BASE_MPC_RELAY_API_URL = 'https://relay.dynamicauth.com';
+const DYNAMIC_WAAS_METADATA = {
+    icon: 'https://iconic.dynamic-static-assets.com/icons/sprite.svg#dynamicwaas',
+    key: 'dynamicwaas',
+    name: 'Dynamic WaaS'
+};
+
+export { DYNAMIC_WAAS_METADATA as D, DEFAULT_WAAS_BASE_MPC_RELAY_API_URL as a, DEFAULT_WAAS_BASE_API_URL as b };