@learncard/init 2.4.3 → 2.4.5

package/package.json

@@ -1,96 +1,88 @@
 {
-  "name": "@learncard/init",
-  "version": "2.4.3",
-  "description": "Primary initialization of LearnCard SDK",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/init.esm.js",
-  "exports": {
-    ".": {
-      "node": {
-        "import": {
-          "types": "./dist/index.d.ts",
-          "default": "./dist/node-esm.mjs"
+    "name": "@learncard/init",
+    "version": "2.4.5",
+    "description": "Primary initialization of LearnCard SDK",
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/init.esm.js",
+    "exports": {
+        ".": {
+            "development": "./src/index.ts",
+            "import": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/init.esm.js"
+            },
+            "require": {
+                "types": "./dist/index.d.cts",
+                "default": "./dist/index.cjs"
+            }
         },
-        "require": {
-          "types": "./dist/index.d.cts",
-          "default": "./dist/index.cjs"
+        "./dist/init.esm.js": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/init.esm.js"
         }
-      },
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/init.esm.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
     },
-    "./dist/init.esm.js": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/init.esm.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "author": "Learning Economy Foundation (www.learningeconomy.io)",
-  "license": "MIT",
-  "homepage": "https://github.com/learningeconomy/LearnCard/tree/main/packages/learn-card-init/README.md",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/learningeconomy/LearnCard"
-  },
-  "bugs": {
-    "url": "https://github.com/learningeconomy/LearnCard/issues"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.2.2",
-    "@types/node": "^17.0.31",
-    "aqu": "0.4.3",
-    "esbuild": "^0.27.1",
-    "esbuild-jest": "^0.5.0",
-    "esbuild-plugin-copy": "^1.3.0",
-    "jest": "^29.3.0",
-    "jest-resolver-enhanced": "^1.1.0",
-    "jimp": "^0.16.1",
-    "qrcode-reader": "^1.0.4",
-    "shx": "^0.3.4",
-    "ts-jest": "^29.0.3"
-  },
-  "types": "./dist/index.d.ts",
-  "dependencies": {
-    "@learncard/chapi-plugin": "1.1.24",
-    "@learncard/core": "9.4.24",
-    "@learncard/didkey-plugin": "1.1.24",
-    "@learncard/dynamic-loader-plugin": "1.1.24",
-    "@learncard/didkit-plugin": "1.9.4",
-    "@learncard/did-web-plugin": "1.1.24",
-    "@learncard/crypto-plugin": "1.1.24",
-    "@learncard/encryption-plugin": "1.1.24",
-    "@learncard/ethereum-plugin": "1.1.25",
-    "@learncard/expiration-plugin": "1.2.24",
-    "@learncard/learn-card-plugin": "1.2.24",
-    "@learncard/learn-cloud-plugin": "2.3.29",
-    "@learncard/helpers": "1.3.6",
-    "@learncard/network-plugin": "^2.13.5",
-    "@learncard/openid4vc-plugin": "0.2.2",
-    "@learncard/sd-jwt-vc-plugin": "0.2.2",
-    "@learncard/types": "5.17.4",
-    "@learncard/vc-api-plugin": "1.1.24",
-    "@learncard/vc-plugin": "1.5.4",
-    "@learncard/vpqr-plugin": "1.1.24",
-    "@learncard/vc-templates-plugin": "1.1.24"
-  },
-  "optionalDependencies": {
-    "@learncard/didkit-plugin-node": "0.2.22"
-  },
-  "sideEffects": false,
-  "scripts": {
-    "build": "node ./scripts/build.mjs && shx cp ./scripts/mixedEntypoint.js ./dist/index.cjs && tsc --p tsconfig.build.json && shx cp ./dist/index.d.ts ./dist/index.d.cts",
-    "start": "aqu watch",
-    "lint": "aqu lint",
-    "lint:fix": "aqu lint --fix",
-    "test": "vitest"
-  }
-}
+    "files": [
+        "dist",
+        "src"
+    ],
+    "scripts": {
+        "build": "node ./scripts/build.mjs && shx cp ./scripts/mixedEntypoint.js ./dist/index.cjs && tsc --p tsconfig.build.json && shx cp ./dist/index.d.ts ./dist/index.d.cts",
+        "start": "aqu watch",
+        "lint": "aqu lint",
+        "lint:fix": "aqu lint --fix",
+        "test": "vitest"
+    },
+    "author": "Learning Economy Foundation (www.learningeconomy.io)",
+    "license": "MIT",
+    "homepage": "https://github.com/learningeconomy/LearnCard/tree/main/packages/learn-card-init/README.md",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/learningeconomy/LearnCard"
+    },
+    "bugs": {
+        "url": "https://github.com/learningeconomy/LearnCard/issues"
+    },
+    "devDependencies": {
+        "@types/jest": "^29.2.2",
+        "@types/node": "^17.0.31",
+        "aqu": "0.4.3",
+        "esbuild": "^0.27.1",
+        "esbuild-jest": "^0.5.0",
+        "esbuild-plugin-copy": "^1.3.0",
+        "jest": "^29.3.0",
+        "jest-resolver-enhanced": "^1.1.0",
+        "jimp": "^0.16.1",
+        "qrcode-reader": "^1.0.4",
+        "shx": "^0.3.4",
+        "ts-jest": "^29.0.3"
+    },
+    "types": "./dist/index.d.ts",
+    "dependencies": {
+        "@learncard/chapi-plugin": "1.1.26",
+        "@learncard/core": "9.4.26",
+        "@learncard/crypto-plugin": "1.1.26",
+        "@learncard/didkey-plugin": "1.1.26",
+        "@learncard/didkit-plugin": "1.9.6",
+        "@learncard/did-web-plugin": "1.1.26",
+        "@learncard/dynamic-loader-plugin": "1.1.26",
+        "@learncard/encryption-plugin": "1.1.26",
+        "@learncard/ethereum-plugin": "1.1.27",
+        "@learncard/expiration-plugin": "1.2.26",
+        "@learncard/helpers": "1.3.8",
+        "@learncard/learn-card-plugin": "1.2.26",
+        "@learncard/learn-cloud-plugin": "2.3.31",
+        "@learncard/network-plugin": "^2.13.7",
+        "@learncard/openid4vc-plugin": "0.2.4",
+        "@learncard/sd-jwt-vc-plugin": "0.2.4",
+        "@learncard/types": "5.17.5",
+        "@learncard/vc-api-plugin": "1.1.26",
+        "@learncard/vc-plugin": "1.5.6",
+        "@learncard/vc-templates-plugin": "1.1.26",
+        "@learncard/vpqr-plugin": "1.1.26"
+    },
+    "optionalDependencies": {
+        "@learncard/didkit-plugin-node": "0.2.24"
+    },
+    "sideEffects": false
+}

package/src/defaults.ts

@@ -0,0 +1,6 @@
+import { EthereumConfig } from '@learncard/ethereum-plugin';
+
+export const defaultEthereumArgs: EthereumConfig = {
+    infuraProjectId: '',
+    network: 'mainnet',
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './init';
+export * from './types/LearnCard';

package/src/init.ts

@@ -0,0 +1,144 @@
+import { customLearnCard } from './initializers/customLearnCard';
+import { emptyLearnCard } from './initializers/emptyLearnCard';
+import { learnCardFromSeed } from './initializers/learnCardFromSeed';
+import { networkLearnCardFromSeed } from './initializers/networkLearnCardFromSeed';
+import { didWebLearnCardFromSeed } from './initializers/didWebLearnCardFromSeed';
+import { didWebNetworkLearnCardFromSeed } from './initializers/didWebNetworkLearnCardFromSeed';
+import { networkLearnCardFromApiKey } from './initializers/networkLearnCardFromApiKey';
+import { learnCardFromApiUrl } from './initializers/apiLearnCard';
+
+import {
+    InitLearnCard,
+    EmptyLearnCard,
+    LearnCardFromSeed,
+    LearnCardFromVcApi,
+    CustomLearnCard,
+    NetworkLearnCardFromSeed,
+    DidWebLearnCardFromSeed,
+    DidWebNetworkLearnCardFromSeed,
+    NetworkLearnCardFromApiKey,
+} from './types/LearnCard';
+
+export * from './initializers/customLearnCard';
+export * from './initializers/emptyLearnCard';
+export * from './initializers/learnCardFromSeed';
+export * from './initializers/networkLearnCardFromSeed';
+export * from './initializers/didWebLearnCardFromSeed';
+export * from './initializers/didWebNetworkLearnCardFromSeed';
+export * from './initializers/apiLearnCard';
+export * from './initializers/networkLearnCardFromApiKey';
+
+// Overloads (Unfortunately necessary boilerplate 😢)
+
+/**
+ * Generates an Empty Wallet
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config?: EmptyLearnCard['args']
+): Promise<EmptyLearnCard['returnValue']>;
+
+/**
+ * Generates a full wallet from a 32 byte seed
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: LearnCardFromSeed['args']
+): Promise<LearnCardFromSeed['returnValue']>;
+
+/**
+ * Generates a full wallet from a 32 byte seed
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: DidWebLearnCardFromSeed['args']
+): Promise<DidWebLearnCardFromSeed['returnValue']>;
+
+/**
+ * Generates a full wallet with access to LearnCard Network from a 32 byte seed
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: NetworkLearnCardFromSeed['args']
+): Promise<NetworkLearnCardFromSeed['returnValue']>;
+
+/**
+ * Generates a full wallet with access to LearnCard Network from a 32 byte seed using a different did:web
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: DidWebNetworkLearnCardFromSeed['args']
+): Promise<DidWebNetworkLearnCardFromSeed['returnValue']>;
+
+/**
+ * Generates a wallet with access to LearnCard Network using an API key (no local seed)
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: NetworkLearnCardFromApiKey['args']
+): Promise<NetworkLearnCardFromApiKey['returnValue']>;
+
+/**
+ * Generates a wallet that can sign VCs/VPs from a VC API
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: LearnCardFromVcApi['args']
+): Promise<LearnCardFromVcApi['returnValue']>;
+
+/**
+ * Generates a custom wallet with no plugins added
+ *
+ * @group Init Functions
+ */
+export function initLearnCard(
+    config: CustomLearnCard['args']
+): Promise<CustomLearnCard['returnValue']>;
+
+// Implementation
+
+/**
+ * Generates a new LearnCard wallet
+ *
+ * @group Init Functions
+ */
+export async function initLearnCard(
+    config: InitLearnCard['args'] = {}
+): InitLearnCard['returnValue'] {
+    if ('custom' in config) return customLearnCard({ debug: config.debug });
+
+    if ('vcApi' in config) {
+        const { vcApi, did, debug } = config;
+
+        return learnCardFromApiUrl({
+            url: typeof vcApi === 'string' ? vcApi : 'https://bridge.learncard.com',
+            did: vcApi === true ? 'did:key:z6MkjSz4mYqcn7dePGuktJ5PxecMkXQQHWRg8Lm6okATyFVh' : did,
+            debug,
+        });
+    }
+
+    if ('apiKey' in config) {
+        return networkLearnCardFromApiKey(config as NetworkLearnCardFromApiKey['args']);
+    }
+
+    if ('seed' in config) {
+        if ('network' in config) {
+            if ('didWeb' in config) return didWebNetworkLearnCardFromSeed(config);
+
+            return networkLearnCardFromSeed(config);
+        }
+
+        if ('didWeb' in config) return didWebLearnCardFromSeed(config);
+
+        return learnCardFromSeed(config);
+    }
+
+    return emptyLearnCard(config);
+}

package/src/initializers/apiLearnCard.ts

@@ -0,0 +1,36 @@
+import { generateLearnCard } from '@learncard/core';
+import { CryptoPlugin } from '@learncard/crypto-plugin';
+import { getVCAPIPlugin } from '@learncard/vc-api-plugin';
+import { expirationPlugin } from '@learncard/expiration-plugin';
+import { getVCTemplatesPlugin } from '@learncard/vc-templates-plugin';
+import { getCHAPIPlugin } from '@learncard/chapi-plugin';
+import { getLearnCardPlugin } from '@learncard/learn-card-plugin';
+
+import { LearnCardFromVcApi } from '../types/LearnCard';
+
+/**
+ * Generates a LearnCard Wallet from a 64 character seed string
+ *
+ * @group Init Functions
+ */
+export const learnCardFromApiUrl = async ({
+    url,
+    did,
+    debug,
+}: {
+    url: string;
+    did?: string;
+    debug?: typeof console.log;
+}): Promise<LearnCardFromVcApi['returnValue']> => {
+    const cryptoLc = await (await generateLearnCard({ debug })).addPlugin(CryptoPlugin);
+
+    const apiLc = await cryptoLc.addPlugin(await getVCAPIPlugin({ url, did }));
+
+    const expirationLc = await apiLc.addPlugin(expirationPlugin(apiLc));
+
+    const templateLc = await expirationLc.addPlugin(getVCTemplatesPlugin());
+
+    const chapiLc = await templateLc.addPlugin(await getCHAPIPlugin());
+
+    return chapiLc.addPlugin(getLearnCardPlugin(chapiLc));
+};

package/src/initializers/customLearnCard.ts

@@ -0,0 +1,11 @@
+import { generateLearnCard } from '@learncard/core';
+import { CustomLearnCard } from '../types/LearnCard';
+
+/**
+ * Generates a custom LearnCard with no plugins added
+ *
+ * @group Init Functions
+ */
+export const customLearnCard = async ({ debug }: Partial<CustomLearnCard['args']> = {}): Promise<
+    CustomLearnCard['returnValue']
+> => generateLearnCard({ debug });

package/src/initializers/didWebLearnCardFromSeed.ts

@@ -0,0 +1,96 @@
+import { generateLearnCard } from '@learncard/core';
+import { DynamicLoaderPlugin } from '@learncard/dynamic-loader-plugin';
+import { CryptoPlugin } from '@learncard/crypto-plugin';
+import { DidMethod, getDidKitPlugin } from '@learncard/didkit-plugin';
+import { getDidKeyPlugin } from '@learncard/didkey-plugin';
+import { getEncryptionPlugin } from '@learncard/encryption-plugin';
+import { getVCPlugin } from '@learncard/vc-plugin';
+import { getVCTemplatesPlugin } from '@learncard/vc-templates-plugin';
+import { getLearnCloudPlugin } from '@learncard/learn-cloud-plugin';
+import { expirationPlugin } from '@learncard/expiration-plugin';
+import { getEthereumPlugin } from '@learncard/ethereum-plugin';
+
+import { getVpqrPlugin } from '@learncard/vpqr-plugin';
+import { getCHAPIPlugin } from '@learncard/chapi-plugin';
+import { getLearnCardPlugin } from '@learncard/learn-card-plugin';
+import { getDidWebPlugin } from '@learncard/did-web-plugin';
+import { getOpenID4VCPlugin } from '@learncard/openid4vc-plugin';
+import { getSdJwtVcPlugin } from '@learncard/sd-jwt-vc-plugin';
+
+import { DidWebLearnCardFromSeed } from '../types/LearnCard';
+import { defaultEthereumArgs } from '../defaults';
+
+/**
+ * Generates a LearnCard Wallet from a 64 character seed string
+ *
+ * @group Init Functions
+ */
+export const didWebLearnCardFromSeed = async ({
+    seed,
+    didWeb,
+    cloud: {
+        url = 'https://cloud.learncard.com/trpc',
+        unencryptedFields = [],
+        unencryptedCustomFields = [],
+        automaticallyAssociateDids = true,
+    } = {},
+    didkit,
+    allowRemoteContexts = false,
+    ethereumConfig = defaultEthereumArgs,
+    openid4vc,
+    debug,
+}: DidWebLearnCardFromSeed['args']): Promise<DidWebLearnCardFromSeed['returnValue']> => {
+    const dynamicLc = await (await generateLearnCard({ debug })).addPlugin(DynamicLoaderPlugin);
+
+    const cryptoLc = await dynamicLc.addPlugin(CryptoPlugin);
+
+    const getDidkit = async (): Promise<typeof getDidKitPlugin> => {
+        if (didkit === 'node') {
+            const mod = await import('@learncard/didkit-plugin-node');
+            return mod.getDidKitPlugin as typeof getDidKitPlugin;
+        }
+        return getDidKitPlugin;
+    };
+
+    const didkitLc = await cryptoLc.addPlugin(
+        await (
+            await getDidkit()
+        )(didkit === 'node' ? undefined : didkit, allowRemoteContexts)
+    );
+
+    const didkeyLc = await didkitLc.addPlugin(
+        await getDidKeyPlugin<DidMethod>(didkitLc, seed, 'key')
+    );
+
+    const encryptionLc = await didkeyLc.addPlugin(await getEncryptionPlugin(didkeyLc));
+
+    const vcLc = await encryptionLc.addPlugin(getVCPlugin(encryptionLc));
+
+    const templateLc = await vcLc.addPlugin(getVCTemplatesPlugin());
+
+    const cloudLc = await templateLc.addPlugin(
+        await getLearnCloudPlugin(
+            templateLc,
+            url,
+            unencryptedFields,
+            unencryptedCustomFields,
+            automaticallyAssociateDids
+        )
+    );
+
+    const expirationLc = await cloudLc.addPlugin(expirationPlugin(cloudLc));
+
+    const ethLc = await expirationLc.addPlugin(getEthereumPlugin(expirationLc, ethereumConfig));
+
+    const vpqrLc = await ethLc.addPlugin(getVpqrPlugin(ethLc));
+
+    const chapiLc = await vpqrLc.addPlugin(await getCHAPIPlugin());
+
+    const sdJwtVcLc = await chapiLc.addPlugin(getSdJwtVcPlugin(chapiLc));
+
+    const lcLc = await sdJwtVcLc.addPlugin(getLearnCardPlugin(sdJwtVcLc));
+
+    const didWebLc = await lcLc.addPlugin(await getDidWebPlugin(lcLc, didWeb));
+
+    return didWebLc.addPlugin(getOpenID4VCPlugin(didWebLc, openid4vc));
+};

package/src/initializers/didWebNetworkLearnCardFromSeed.ts

@@ -0,0 +1,114 @@
+import { generateLearnCard } from '@learncard/core';
+import { DynamicLoaderPlugin } from '@learncard/dynamic-loader-plugin';
+import { CryptoPlugin } from '@learncard/crypto-plugin';
+import { DidMethod, getDidKitPlugin } from '@learncard/didkit-plugin';
+import { getDidKeyPlugin } from '@learncard/didkey-plugin';
+import { getEncryptionPlugin } from '@learncard/encryption-plugin';
+import { getVCPlugin } from '@learncard/vc-plugin';
+import { getVCTemplatesPlugin } from '@learncard/vc-templates-plugin';
+import { getLearnCloudPlugin } from '@learncard/learn-cloud-plugin';
+import { expirationPlugin } from '@learncard/expiration-plugin';
+import { getEthereumPlugin } from '@learncard/ethereum-plugin';
+
+import { getVpqrPlugin } from '@learncard/vpqr-plugin';
+import { getCHAPIPlugin } from '@learncard/chapi-plugin';
+import { getVerifyBoostPlugin, getLearnCardNetworkPlugin } from '@learncard/network-plugin';
+import { getLearnCardPlugin } from '@learncard/learn-card-plugin';
+import { getDidWebPlugin } from '@learncard/did-web-plugin';
+import { getOpenID4VCPlugin } from '@learncard/openid4vc-plugin';
+import { getSdJwtVcPlugin } from '@learncard/sd-jwt-vc-plugin';
+
+import { DidWebNetworkLearnCardFromSeed } from '../types/LearnCard';
+import { defaultEthereumArgs } from '../defaults';
+
+/**
+ * Generates a Network LearnCard Wallet with a custom did:web did from a 64 character seed string
+ *
+ * @group Init Functions
+ */
+export const didWebNetworkLearnCardFromSeed = async ({
+    seed,
+    didWeb,
+    network: _network,
+    trustedBoostRegistry = 'https://raw.githubusercontent.com/learningeconomy/registries/main/learncard/trusted-app-registry.json',
+    guardianApprovalGetter,
+    extraHeaders,
+
+    cloud: {
+        url = 'https://cloud.learncard.com/trpc',
+        unencryptedFields = [],
+        unencryptedCustomFields = [],
+        automaticallyAssociateDids = true,
+    } = {},
+    didkit,
+    allowRemoteContexts = false,
+    ethereumConfig = defaultEthereumArgs,
+    openid4vc,
+    debug,
+}: DidWebNetworkLearnCardFromSeed['args']): Promise<
+    DidWebNetworkLearnCardFromSeed['returnValue']
+> => {
+    const network = typeof _network === 'boolean' ? 'https://network.learncard.com/trpc' : _network;
+
+    const dynamicLc = await (await generateLearnCard({ debug })).addPlugin(DynamicLoaderPlugin);
+
+    const cryptoLc = await dynamicLc.addPlugin(CryptoPlugin);
+
+    const getDidkit = async (): Promise<typeof getDidKitPlugin> => {
+        if (didkit === 'node') {
+            const mod = await import('@learncard/didkit-plugin-node');
+            return mod.getDidKitPlugin as typeof getDidKitPlugin;
+        }
+        return getDidKitPlugin;
+    };
+
+    const didkitLc = await cryptoLc.addPlugin(
+        await (
+            await getDidkit()
+        )(didkit === 'node' ? undefined : didkit, allowRemoteContexts)
+    );
+
+    const didkeyLc = await didkitLc.addPlugin(
+        await getDidKeyPlugin<DidMethod>(didkitLc, seed, 'key')
+    );
+
+    const encryptionLc = await didkeyLc.addPlugin(await getEncryptionPlugin(didkeyLc));
+
+    const vcLc = await encryptionLc.addPlugin(getVCPlugin(encryptionLc));
+
+    const templateLc = await vcLc.addPlugin(getVCTemplatesPlugin());
+
+    const cloudLc = await templateLc.addPlugin(
+        await getLearnCloudPlugin(
+            templateLc,
+            url,
+            unencryptedFields,
+            unencryptedCustomFields,
+            automaticallyAssociateDids
+        )
+    );
+
+    const expirationLc = await cloudLc.addPlugin(expirationPlugin(cloudLc));
+
+    const ethLc = await expirationLc.addPlugin(getEthereumPlugin(expirationLc, ethereumConfig));
+
+    const vpqrLc = await ethLc.addPlugin(getVpqrPlugin(ethLc));
+
+    const chapiLc = await vpqrLc.addPlugin(await getCHAPIPlugin());
+
+    const boostVerificationLc = await chapiLc.addPlugin(
+        await getVerifyBoostPlugin(chapiLc, trustedBoostRegistry)
+    );
+
+    const sdJwtVcLc = await boostVerificationLc.addPlugin(getSdJwtVcPlugin(boostVerificationLc));
+
+    const lcLc = await sdJwtVcLc.addPlugin(getLearnCardPlugin(sdJwtVcLc));
+
+    const didWebLc = await lcLc.addPlugin(await getDidWebPlugin(lcLc, didWeb));
+
+    const networkLc = await didWebLc.addPlugin(
+        await getLearnCardNetworkPlugin(didWebLc, network, { guardianApprovalGetter, extraHeaders })
+    );
+
+    return networkLc.addPlugin(getOpenID4VCPlugin(networkLc, openid4vc));
+};

package/src/initializers/emptyLearnCard.ts

@@ -0,0 +1,46 @@
+import { generateLearnCard } from '@learncard/core';
+import { DynamicLoaderPlugin } from '@learncard/dynamic-loader-plugin';
+import { CryptoPlugin } from '@learncard/crypto-plugin';
+import { getDidKitPlugin } from '@learncard/didkit-plugin';
+import { expirationPlugin } from '@learncard/expiration-plugin';
+import { getVCTemplatesPlugin } from '@learncard/vc-templates-plugin';
+import { getCHAPIPlugin } from '@learncard/chapi-plugin';
+import { getLearnCardPlugin } from '@learncard/learn-card-plugin';
+
+import { EmptyLearnCard } from '../types/LearnCard';
+
+/**
+ * Generates an empty wallet with no key material
+ *
+ * @group Init Functions
+ */
+export const emptyLearnCard = async ({
+    didkit,
+    allowRemoteContexts = false,
+    debug,
+}: EmptyLearnCard['args'] = {}): Promise<EmptyLearnCard['returnValue']> => {
+    const dynamicLc = await (await generateLearnCard({ debug })).addPlugin(DynamicLoaderPlugin);
+
+    const cryptoLc = await dynamicLc.addPlugin(CryptoPlugin);
+
+    const getDidkit = async (): Promise<typeof getDidKitPlugin> => {
+        if (didkit === 'node') {
+            const mod = await import('@learncard/didkit-plugin-node');
+            return mod.getDidKitPlugin as typeof getDidKitPlugin;
+        }
+
+        return getDidKitPlugin;
+    };
+
+    const didkitLc = await cryptoLc.addPlugin(
+        await (await getDidkit())(didkit === 'node' ? undefined : didkit, allowRemoteContexts)
+    );
+
+    const expirationLc = await didkitLc.addPlugin(expirationPlugin(didkitLc));
+
+    const templatesLc = await expirationLc.addPlugin(getVCTemplatesPlugin());
+
+    const chapiLc = await templatesLc.addPlugin(await getCHAPIPlugin());
+
+    return chapiLc.addPlugin(getLearnCardPlugin(chapiLc));
+};