@twin.org/wallet-connector-entity-storage 0.0.2-next.5 → 0.0.3-next.2

package/dist/es/entities/walletAddress.js

@@ -0,0 +1,37 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { entity, property } from "@twin.org/entity";
+/**
+ * Class describing a wallet address.
+ */
+let WalletAddress = class WalletAddress {
+    /**
+     * The address in the wallet.
+     */
+    address;
+    /**
+     * The identity of the owner.
+     */
+    identity;
+    /**
+     * The balance of the wallet as bigint.
+     */
+    balance;
+};
+__decorate([
+    property({ type: "string", isPrimary: true }),
+    __metadata("design:type", String)
+], WalletAddress.prototype, "address", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], WalletAddress.prototype, "identity", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], WalletAddress.prototype, "balance", void 0);
+WalletAddress = __decorate([
+    entity()
+], WalletAddress);
+export { WalletAddress };
+//# sourceMappingURL=walletAddress.js.map

package/dist/es/entities/walletAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletAddress.js","sourceRoot":"","sources":["../../../src/entities/walletAddress.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IACzB;;OAEG;IAEI,OAAO,CAAU;IAExB;;OAEG;IAEI,QAAQ,CAAU;IAEzB;;OAEG;IAEI,OAAO,CAAU;CACxB,CAAA;AAbO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;8CACtB;AAMjB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;+CACJ;AAMlB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;8CACL;AAjBZ,aAAa;IADzB,MAAM,EAAE;GACI,aAAa,CAkBzB","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { entity, property } from \"@twin.org/entity\";\n\n/**\n * Class describing a wallet address.\n */\n@entity()\nexport class WalletAddress {\n\t/**\n\t * The address in the wallet.\n\t */\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic address!: string;\n\n\t/**\n\t * The identity of the owner.\n\t */\n\t@property({ type: \"string\" })\n\tpublic identity!: string;\n\n\t/**\n\t * The balance of the wallet as bigint.\n\t */\n\t@property({ type: \"string\" })\n\tpublic balance!: string;\n}\n"]}

package/dist/es/entityStorageFaucetConnector.js

@@ -0,0 +1,61 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Coerce, Guards, Is } from "@twin.org/core";
+import { EntityStorageConnectorFactory } from "@twin.org/entity-storage-models";
+/**
+ * Class for performing faucet operations using entity storage.
+ */
+export class EntityStorageFaucetConnector {
+    /**
+     * The namespace supported by the wallet connector.
+     */
+    static NAMESPACE = "entity-storage";
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "EntityStorageFaucetConnector";
+    /**
+     * The entity storage for wallets.
+     * @internal
+     */
+    _walletAddressEntityStorage;
+    /**
+     * Create a new instance of EntityStorageFaucetConnector.
+     * @param options The options for the wallet connector.
+     */
+    constructor(options) {
+        this._walletAddressEntityStorage = EntityStorageConnectorFactory.get(options?.walletAddressEntityStorageType ?? "wallet-address");
+    }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return EntityStorageFaucetConnector.CLASS_NAME;
+    }
+    /**
+     * Fund the wallet from the faucet.
+     * @param identity The identity of the user to access the vault keys.
+     * @param address The hex encoded address of the address to fund.
+     * @param timeoutInSeconds The timeout in seconds to wait for the funding to complete.
+     * @returns The amount added to the address by the faucet.
+     */
+    async fundAddress(identity, address, timeoutInSeconds = 60) {
+        Guards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, "identity", identity);
+        Guards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, "address", address);
+        let walletAddress = await this._walletAddressEntityStorage.get(address);
+        if (Is.empty(walletAddress)) {
+            walletAddress = {
+                balance: "0",
+                identity,
+                address
+            };
+        }
+        const maxFundAmount = 1000000000n;
+        const balance = Coerce.bigint(walletAddress.balance) ?? 0n;
+        walletAddress.balance = (balance + maxFundAmount).toString();
+        await this._walletAddressEntityStorage.set(walletAddress);
+        return maxFundAmount;
+    }
+}
+//# sourceMappingURL=entityStorageFaucetConnector.js.map

package/dist/es/entityStorageFaucetConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityStorageFaucetConnector.js","sourceRoot":"","sources":["../../src/entityStorageFaucetConnector.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACN,6BAA6B,EAE7B,MAAM,iCAAiC,CAAC;AAMzC;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACxC;;OAEG;IACI,MAAM,CAAU,SAAS,GAAW,gBAAgB,CAAC;IAE5D;;OAEG;IACI,MAAM,CAAU,UAAU,kCAAkD;IAEnF;;;OAGG;IACc,2BAA2B,CAAyC;IAErF;;;OAGG;IACH,YAAY,OAAyD;QACpE,IAAI,CAAC,2BAA2B,GAAG,6BAA6B,CAAC,GAAG,CACnE,OAAO,EAAE,8BAA8B,IAAI,gBAAgB,CAC3D,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,SAAS;QACf,OAAO,4BAA4B,CAAC,UAAU,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,WAAW,CACvB,QAAgB,EAChB,OAAe,EACf,mBAA2B,EAAE;QAE7B,MAAM,CAAC,WAAW,CAAC,4BAA4B,CAAC,UAAU,cAAoB,QAAQ,CAAC,CAAC;QACxF,MAAM,CAAC,WAAW,CAAC,4BAA4B,CAAC,UAAU,aAAmB,OAAO,CAAC,CAAC;QAEtF,IAAI,aAAa,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7B,aAAa,GAAG;gBACf,OAAO,EAAE,GAAG;gBACZ,QAAQ;gBACR,OAAO;aACP,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,WAAW,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3D,aAAa,CAAC,OAAO,GAAG,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE7D,MAAM,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAE1D,OAAO,aAAa,CAAC;IACtB,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Coerce, Guards, Is } from \"@twin.org/core\";\nimport {\n\tEntityStorageConnectorFactory,\n\ttype IEntityStorageConnector\n} from \"@twin.org/entity-storage-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport type { IFaucetConnector } from \"@twin.org/wallet-models\";\nimport type { WalletAddress } from \"./entities/walletAddress.js\";\nimport type { IEntityStorageFaucetConnectorConstructorOptions } from \"./models/IEntityStorageFaucetConnectorConstructorOptions.js\";\n\n/**\n * Class for performing faucet operations using entity storage.\n */\nexport class EntityStorageFaucetConnector implements IFaucetConnector {\n\t/**\n\t * The namespace supported by the wallet connector.\n\t */\n\tpublic static readonly NAMESPACE: string = \"entity-storage\";\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<EntityStorageFaucetConnector>();\n\n\t/**\n\t * The entity storage for wallets.\n\t * @internal\n\t */\n\tprivate readonly _walletAddressEntityStorage: IEntityStorageConnector<WalletAddress>;\n\n\t/**\n\t * Create a new instance of EntityStorageFaucetConnector.\n\t * @param options The options for the wallet connector.\n\t */\n\tconstructor(options?: IEntityStorageFaucetConnectorConstructorOptions) {\n\t\tthis._walletAddressEntityStorage = EntityStorageConnectorFactory.get(\n\t\t\toptions?.walletAddressEntityStorageType ?? \"wallet-address\"\n\t\t);\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn EntityStorageFaucetConnector.CLASS_NAME;\n\t}\n\n\t/**\n\t * Fund the wallet from the faucet.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @param address The hex encoded address of the address to fund.\n\t * @param timeoutInSeconds The timeout in seconds to wait for the funding to complete.\n\t * @returns The amount added to the address by the faucet.\n\t */\n\tpublic async fundAddress(\n\t\tidentity: string,\n\t\taddress: string,\n\t\ttimeoutInSeconds: number = 60\n\t): Promise<bigint> {\n\t\tGuards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, nameof(identity), identity);\n\t\tGuards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, nameof(address), address);\n\n\t\tlet walletAddress = await this._walletAddressEntityStorage.get(address);\n\t\tif (Is.empty(walletAddress)) {\n\t\t\twalletAddress = {\n\t\t\t\tbalance: \"0\",\n\t\t\t\tidentity,\n\t\t\t\taddress\n\t\t\t};\n\t\t}\n\n\t\tconst maxFundAmount = 1000000000n;\n\t\tconst balance = Coerce.bigint(walletAddress.balance) ?? 0n;\n\t\twalletAddress.balance = (balance + maxFundAmount).toString();\n\n\t\tawait this._walletAddressEntityStorage.set(walletAddress);\n\n\t\treturn maxFundAmount;\n\t}\n}\n"]}

package/dist/{esm/index.mjs → es/entityStorageWalletConnector.js}

@@ -1,103 +1,15 @@
-import { property, entity, ComparisonOperator, LogicalOperator, EntitySchemaFactory, EntitySchemaHelper } from '@twin.org/entity';
-import { Guards, Is, Coerce, GeneralError } from '@twin.org/core';
-import { EntityStorageConnectorFactory } from '@twin.org/entity-storage-models';
-import { Bip39, Bip44, KeyType } from '@twin.org/crypto';
-import { VaultConnectorFactory } from '@twin.org/vault-models';
-import { FaucetConnectorFactory } from '@twin.org/wallet-models';
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class describing a wallet address.
- */
-let WalletAddress = class WalletAddress {
-    /**
-     * The address in the wallet.
-     */
-    address;
-    /**
-     * The identity of the owner.
-     */
-    identity;
-    /**
-     * The balance of the wallet as bigint.
-     */
-    balance;
-};
-__decorate([
-    property({ type: "string", isPrimary: true }),
-    __metadata("design:type", String)
-], WalletAddress.prototype, "address", void 0);
-__decorate([
-    property({ type: "string" }),
-    __metadata("design:type", String)
-], WalletAddress.prototype, "identity", void 0);
-__decorate([
-    property({ type: "string" }),
-    __metadata("design:type", String)
-], WalletAddress.prototype, "balance", void 0);
-WalletAddress = __decorate([
-    entity()
-], WalletAddress);
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class for performing faucet operations using entity storage.
- */
-class EntityStorageFaucetConnector {
-    /**
-     * The namespace supported by the wallet connector.
-     */
-    static NAMESPACE = "entity-storage";
-    /**
-     * Runtime name for the class.
-     */
-    static CLASS_NAME = "EntityStorageFaucetConnector";
-    /**
-     * The entity storage for wallets.
-     * @internal
-     */
-    _walletAddressEntityStorage;
-    /**
-     * Create a new instance of EntityStorageFaucetConnector.
-     * @param options The options for the wallet connector.
-     */
-    constructor(options) {
-        this._walletAddressEntityStorage = EntityStorageConnectorFactory.get(options?.walletAddressEntityStorageType ?? "wallet-address");
-    }
-    /**
-     * Fund the wallet from the faucet.
-     * @param identity The identity of the user to access the vault keys.
-     * @param address The hex encoded address of the address to fund.
-     * @param timeoutInSeconds The timeout in seconds to wait for the funding to complete.
-     * @returns The amount added to the address by the faucet.
-     */
-    async fundAddress(identity, address, timeoutInSeconds = 60) {
-        Guards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, "identity", identity);
-        Guards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, "address", address);
-        let walletAddress = await this._walletAddressEntityStorage.get(address);
-        if (Is.empty(walletAddress)) {
-            walletAddress = {
-                balance: "0",
-                identity,
-                address
-            };
-        }
-        const maxFundAmount = 1000000000n;
-        const balance = Coerce.bigint(walletAddress.balance) ?? 0n;
-        walletAddress.balance = (balance + maxFundAmount).toString();
-        await this._walletAddressEntityStorage.set(walletAddress);
-        return maxFundAmount;
-    }
-}
-
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
+import { Coerce, GeneralError, Guards, Is } from "@twin.org/core";
+import { Bip39, Bip44, KeyType } from "@twin.org/crypto";
+import { ComparisonOperator, LogicalOperator } from "@twin.org/entity";
+import { EntityStorageConnectorFactory } from "@twin.org/entity-storage-models";
+import { VaultConnectorFactory } from "@twin.org/vault-models";
+import { FaucetConnectorFactory } from "@twin.org/wallet-models";
 /**
  * Class for performing wallet operations using in-memory storage.
  */
-class EntityStorageWalletConnector {
+export class EntityStorageWalletConnector {
     /**
      * Runtime name for the class.
      */
@@ -153,6 +65,13 @@ class EntityStorageWalletConnector {
         this._config.coinType ??= EntityStorageWalletConnector._DEFAULT_COIN_TYPE;
         this._config.networkName ??= EntityStorageWalletConnector._DEFAULT_NETWORK_NAME;
     }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return EntityStorageWalletConnector.CLASS_NAME;
+    }
     /**
      * Create a new wallet.
      * @param identity The identity of the user to access the vault keys.
@@ -290,14 +209,4 @@ class EntityStorageWalletConnector {
         return `${identity}/${this._config.vaultMnemonicId ?? EntityStorageWalletConnector._DEFAULT_MNEMONIC_SECRET_NAME}`;
     }
 }
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Initialize the schema for the wallet entity storage connector.
- */
-function initSchema() {
-    EntitySchemaFactory.register("WalletAddress", () => EntitySchemaHelper.getSchema(WalletAddress));
-}
-
-export { EntityStorageFaucetConnector, EntityStorageWalletConnector, WalletAddress, initSchema };
+//# sourceMappingURL=entityStorageWalletConnector.js.map

package/dist/es/entityStorageWalletConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityStorageWalletConnector.js","sourceRoot":"","sources":["../../src/entityStorageWalletConnector.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Coerce, GeneralError, Guards, Is } from \"@twin.org/core\";\nimport { Bip39, Bip44, KeyType } from \"@twin.org/crypto\";\nimport { ComparisonOperator, LogicalOperator } from \"@twin.org/entity\";\nimport {\n\tEntityStorageConnectorFactory,\n\ttype IEntityStorageConnector\n} from \"@twin.org/entity-storage-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { VaultConnectorFactory, type IVaultConnector } from \"@twin.org/vault-models\";\nimport {\n\tFaucetConnectorFactory,\n\ttype IFaucetConnector,\n\ttype IWalletConnector\n} from \"@twin.org/wallet-models\";\nimport type { WalletAddress } from \"./entities/walletAddress.js\";\nimport type { IEntityStorageWalletConnectorConfig } from \"./models/IEntityStorageWalletConnectorConfig.js\";\nimport type { IEntityStorageWalletConnectorConstructorOptions } from \"./models/IEntityStorageWalletConnectorConstructorOptions.js\";\n\n/**\n * Class for performing wallet operations using in-memory storage.\n */\nexport class EntityStorageWalletConnector implements IWalletConnector {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<EntityStorageWalletConnector>();\n\n\t/**\n\t * The namespace supported by the wallet connector.\n\t */\n\tpublic static readonly NAMESPACE: string = \"entity-storage\";\n\n\t/**\n\t * Default name for the mnemonic secret.\n\t * @internal\n\t */\n\tprivate static readonly _DEFAULT_MNEMONIC_SECRET_NAME: string = \"mnemonic\";\n\n\t/**\n\t * Default coin type.\n\t * @internal\n\t */\n\tprivate static readonly _DEFAULT_COIN_TYPE: number = 9999;\n\n\t/**\n\t * Default network name.\n\t * @internal\n\t */\n\tprivate static readonly _DEFAULT_NETWORK_NAME: string = \"ent\";\n\n\t/**\n\t * The vault for the mnemonic.\n\t * @internal\n\t */\n\tprivate readonly _vaultConnector: IVaultConnector;\n\n\t/**\n\t * The faucet.\n\t * @internal\n\t */\n\tprivate readonly _faucetConnector?: IFaucetConnector;\n\n\t/**\n\t * The entity storage for wallets.\n\t * @internal\n\t */\n\tprivate readonly _walletAddressEntityStorage: IEntityStorageConnector<WalletAddress>;\n\n\t/**\n\t * The configuration to use for tangle operations.\n\t * @internal\n\t */\n\tprivate readonly _config: IEntityStorageWalletConnectorConfig;\n\n\t/**\n\t * Create a new instance of EntityStorageWalletConnector.\n\t * @param options The options for the wallet connector.\n\t */\n\tconstructor(options?: IEntityStorageWalletConnectorConstructorOptions) {\n\t\tthis._vaultConnector = VaultConnectorFactory.get(options?.vaultConnectorType ?? \"vault\");\n\t\tthis._faucetConnector = FaucetConnectorFactory.getIfExists(\n\t\t\toptions?.faucetConnectorType ?? \"faucet\"\n\t\t);\n\t\tthis._walletAddressEntityStorage = EntityStorageConnectorFactory.get(\n\t\t\toptions?.walletAddressEntityStorageType ?? \"wallet-address\"\n\t\t);\n\t\tthis._config = options?.config ?? {};\n\t\tthis._config.coinType ??= EntityStorageWalletConnector._DEFAULT_COIN_TYPE;\n\t\tthis._config.networkName ??= EntityStorageWalletConnector._DEFAULT_NETWORK_NAME;\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn EntityStorageWalletConnector.CLASS_NAME;\n\t}\n\n\t/**\n\t * Create a new wallet.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @returns Nothing.\n\t */\n\tpublic async create(identity: string): Promise<void> {\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(identity), identity);\n\n\t\tconst mnemonic = Bip39.randomMnemonic();\n\t\tawait this._vaultConnector.setSecret<string>(this.buildMnemonicKey(identity), mnemonic);\n\t}\n\n\t/**\n\t * Get the addresses for the requested range.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @param accountIndex The account index to get the addresses for.\n\t * @param startAddressIndex The start index for the addresses.\n\t * @param count The number of addresses to generate.\n\t * @returns The list of addresses.\n\t */\n\tpublic async getAddresses(\n\t\tidentity: string,\n\t\taccountIndex: number,\n\t\tstartAddressIndex: number,\n\t\tcount: number\n\t): Promise<string[]> {\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(identity), identity);\n\t\tGuards.integer(\n\t\t\tEntityStorageWalletConnector.CLASS_NAME,\n\t\t\tnameof(startAddressIndex),\n\t\t\tstartAddressIndex\n\t\t);\n\t\tGuards.integer(EntityStorageWalletConnector.CLASS_NAME, nameof(count), count);\n\n\t\tconst mnemonic = await this._vaultConnector.getSecret<string>(this.buildMnemonicKey(identity));\n\n\t\tconst seed = Bip39.mnemonicToSeed(mnemonic);\n\n\t\tconst keyPairs: string[] = [];\n\n\t\tfor (let i = startAddressIndex; i < startAddressIndex + count; i++) {\n\t\t\tconst addressKeyPair = Bip44.address(\n\t\t\t\tseed,\n\t\t\t\tKeyType.Ed25519,\n\t\t\t\tthis._config.coinType ?? EntityStorageWalletConnector._DEFAULT_COIN_TYPE,\n\t\t\t\taccountIndex,\n\t\t\t\tfalse,\n\t\t\t\ti\n\t\t\t);\n\n\t\t\tkeyPairs.push(addressKeyPair.address);\n\t\t}\n\n\t\treturn keyPairs;\n\t}\n\n\t/**\n\t * Get the balance for an address in a wallet.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @param address The hex encoded address.\n\t * @returns The balance of the wallet address.\n\t */\n\tpublic async getBalance(identity: string, address: string): Promise<bigint> {\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(address), address);\n\n\t\tconst walletAddress = await this._walletAddressEntityStorage.get(address);\n\n\t\treturn Coerce.bigint(walletAddress?.balance) ?? 0n;\n\t}\n\n\t/**\n\t * Ensure the balance for an address in a wallet.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @param address The hex encoded address.\n\t * @param ensureBalance The balance to ensure on the address.\n\t * @param timeoutInSeconds The timeout in seconds to wait for the funding to complete.\n\t * @returns True if the balance has been ensured.\n\t */\n\tpublic async ensureBalance(\n\t\tidentity: string,\n\t\taddress: string,\n\t\tensureBalance: bigint,\n\t\ttimeoutInSeconds?: number\n\t): Promise<boolean> {\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(identity), identity);\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(address), address);\n\t\tGuards.bigint(EntityStorageWalletConnector.CLASS_NAME, nameof(ensureBalance), ensureBalance);\n\n\t\tif (this._faucetConnector) {\n\t\t\tlet retryCount = 10;\n\t\t\tlet currentBalance = await this.getBalance(identity, address);\n\n\t\t\twhile (currentBalance < ensureBalance && retryCount > 0) {\n\t\t\t\tconst addedBalance = await this._faucetConnector.fundAddress(\n\t\t\t\t\tidentity,\n\t\t\t\t\taddress,\n\t\t\t\t\ttimeoutInSeconds\n\t\t\t\t);\n\t\t\t\tif (addedBalance === 0n) {\n\t\t\t\t\t// The balance has not increased, so return.\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tcurrentBalance += addedBalance;\n\t\t\t\tif (currentBalance < ensureBalance) {\n\t\t\t\t\t// The balance has increased but is still not enough, wait and try again.\n\t\t\t\t\tawait new Promise(resolve => setTimeout(resolve, 100));\n\t\t\t\t\tretryCount--;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn currentBalance >= ensureBalance;\n\t\t}\n\n\t\treturn false;\n\t}\n\n\t/**\n\t * Transfer funds to an address.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @param addressSource The hex encoded address to send the funds from.\n\t * @param addressDest The hex encoded address to send the funds to.\n\t * @param amount The amount to transfer.\n\t * @returns An identifier for the transfer if there was one.\n\t */\n\tpublic async transfer(\n\t\tidentity: string,\n\t\taddressSource: string,\n\t\taddressDest: string,\n\t\tamount: bigint\n\t): Promise<string | undefined> {\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(identity), identity);\n\t\tGuards.stringValue(\n\t\t\tEntityStorageWalletConnector.CLASS_NAME,\n\t\t\tnameof(addressSource),\n\t\t\taddressSource\n\t\t);\n\t\tGuards.stringValue(EntityStorageWalletConnector.CLASS_NAME, nameof(addressDest), addressDest);\n\t\tGuards.bigint(EntityStorageWalletConnector.CLASS_NAME, nameof(amount), amount);\n\n\t\tconst walletAddresses = await this._walletAddressEntityStorage.query({\n\t\t\tlogicalOperator: LogicalOperator.And,\n\t\t\tconditions: [\n\t\t\t\t{\n\t\t\t\t\tproperty: \"identity\",\n\t\t\t\t\tcomparison: ComparisonOperator.Equals,\n\t\t\t\t\tvalue: identity\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tproperty: \"address\",\n\t\t\t\t\tcomparison: ComparisonOperator.Equals,\n\t\t\t\t\tvalue: addressSource\n\t\t\t\t}\n\t\t\t]\n\t\t});\n\n\t\tlet walletAddress: WalletAddress | undefined;\n\t\tlet balance = 0n;\n\t\tif (walletAddresses.entities.length > 0) {\n\t\t\twalletAddress = walletAddresses.entities[0] as WalletAddress;\n\t\t\tbalance = BigInt(walletAddress.balance);\n\t\t\twalletAddress.balance = (BigInt(walletAddress.balance) - amount).toString();\n\t\t}\n\n\t\tif (balance < amount) {\n\t\t\tthrow new GeneralError(EntityStorageWalletConnector.CLASS_NAME, \"insufficientFunds\");\n\t\t}\n\n\t\tif (!Is.empty(walletAddress)) {\n\t\t\tawait this._walletAddressEntityStorage.set(walletAddress);\n\n\t\t\tlet destWalletAddress = await this._walletAddressEntityStorage.get(addressDest);\n\n\t\t\tif (Is.empty(destWalletAddress)) {\n\t\t\t\tdestWalletAddress = {\n\t\t\t\t\tbalance: \"0\",\n\t\t\t\t\tidentity: \"\",\n\t\t\t\t\taddress: addressDest\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tdestWalletAddress.balance = (BigInt(destWalletAddress.balance) + amount).toString();\n\n\t\t\tawait this._walletAddressEntityStorage.set(destWalletAddress);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Build the key name to access the mnemonic in the vault.\n\t * @param identity The identity of the user to access the vault keys.\n\t * @returns The vault key.\n\t * @internal\n\t */\n\tprivate buildMnemonicKey(identity: string): string {\n\t\treturn `${identity}/${this._config.vaultMnemonicId ?? EntityStorageWalletConnector._DEFAULT_MNEMONIC_SECRET_NAME}`;\n\t}\n}\n"]}

package/dist/es/index.js

@@ -0,0 +1,10 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export * from "./entities/walletAddress.js";
+export * from "./entityStorageFaucetConnector.js";
+export * from "./entityStorageWalletConnector.js";
+export * from "./models/IEntityStorageFaucetConnectorConstructorOptions.js";
+export * from "./models/IEntityStorageWalletConnectorConfig.js";
+export * from "./models/IEntityStorageWalletConnectorConstructorOptions.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6DAA6D,CAAC;AAC5E,cAAc,iDAAiD,CAAC;AAChE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,aAAa,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./entities/walletAddress.js\";\nexport * from \"./entityStorageFaucetConnector.js\";\nexport * from \"./entityStorageWalletConnector.js\";\nexport * from \"./models/IEntityStorageFaucetConnectorConstructorOptions.js\";\nexport * from \"./models/IEntityStorageWalletConnectorConfig.js\";\nexport * from \"./models/IEntityStorageWalletConnectorConstructorOptions.js\";\nexport * from \"./schema.js\";\n"]}

package/dist/es/models/IEntityStorageFaucetConnectorConstructorOptions.js

@@ -0,0 +1,4 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export {};
+//# sourceMappingURL=IEntityStorageFaucetConnectorConstructorOptions.js.map

package/dist/es/models/IEntityStorageFaucetConnectorConstructorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityStorageFaucetConnectorConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IEntityStorageFaucetConnectorConstructorOptions.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Options for the entity storage faucet connector.\n */\nexport interface IEntityStorageFaucetConnectorConstructorOptions {\n\t/**\n\t * The entity storage type for wallet addresses.\n\t * @default wallet-address\n\t */\n\twalletAddressEntityStorageType?: string;\n}\n"]}

package/dist/es/models/IEntityStorageWalletConnectorConfig.js

@@ -0,0 +1,4 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export {};
+//# sourceMappingURL=IEntityStorageWalletConnectorConfig.js.map

package/dist/es/models/IEntityStorageWalletConnectorConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityStorageWalletConnectorConfig.js","sourceRoot":"","sources":["../../../src/models/IEntityStorageWalletConnectorConfig.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Configuration for the Entity Storage Wallet Connector.\n */\nexport interface IEntityStorageWalletConnectorConfig {\n\t/**\n\t * The id of the entry in the vault containing the mnemonic.\n\t * @default mnemonic\n\t */\n\tvaultMnemonicId?: string;\n\n\t/**\n\t * The coin type.\n\t * @default 9999\n\t */\n\tcoinType?: number;\n\n\t/**\n\t * The network name part for the addresses.\n\t * @default ent\n\t */\n\tnetworkName?: string;\n}\n"]}

package/dist/es/models/IEntityStorageWalletConnectorConstructorOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEntityStorageWalletConnectorConstructorOptions.js.map

package/dist/es/models/IEntityStorageWalletConnectorConstructorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityStorageWalletConnectorConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IEntityStorageWalletConnectorConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IEntityStorageWalletConnectorConfig } from \"./IEntityStorageWalletConnectorConfig.js\";\n\n/**\n * Options for the entity storage wallet connector.\n */\nexport interface IEntityStorageWalletConnectorConstructorOptions {\n\t/**\n\t * Vault connector to use for wallet secrets.\n\t * @default vault\n\t */\n\tvaultConnectorType?: string;\n\n\t/**\n\t * Optional faucet for requesting funds.\n\t * @default faucet\n\t */\n\tfaucetConnectorType?: string;\n\n\t/**\n\t * The entity storage for wallets.\n\t * @default wallet-address\n\t */\n\twalletAddressEntityStorageType?: string;\n\n\t/**\n\t * The configuration for the wallet connector.\n\t */\n\tconfig?: IEntityStorageWalletConnectorConfig;\n}\n"]}

package/dist/es/schema.js

@@ -0,0 +1,11 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { EntitySchemaFactory, EntitySchemaHelper } from "@twin.org/entity";
+import { WalletAddress } from "./entities/walletAddress.js";
+/**
+ * Initialize the schema for the wallet entity storage connector.
+ */
+export function initSchema() {
+    EntitySchemaFactory.register("WalletAddress", () => EntitySchemaHelper.getSchema(WalletAddress));
+}
+//# sourceMappingURL=schema.js.map

package/dist/es/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,kBAA0B,GAAG,EAAE,CAC1D,kBAAkB,CAAC,SAAS,CAAC,aAAa,CAAC,CAC3C,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { WalletAddress } from \"./entities/walletAddress.js\";\n\n/**\n * Initialize the schema for the wallet entity storage connector.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<WalletAddress>(), () =>\n\t\tEntitySchemaHelper.getSchema(WalletAddress)\n\t);\n}\n"]}

package/dist/types/entityStorageFaucetConnector.d.ts

@@ -1,5 +1,5 @@
 import type { IFaucetConnector } from "@twin.org/wallet-models";
-import type { IEntityStorageFaucetConnectorConstructorOptions } from "./models/IEntityStorageFaucetConnectorConstructorOptions";
+import type { IEntityStorageFaucetConnectorConstructorOptions } from "./models/IEntityStorageFaucetConnectorConstructorOptions.js";
 /**
  * Class for performing faucet operations using entity storage.
  */
@@ -17,6 +17,11 @@ export declare class EntityStorageFaucetConnector implements IFaucetConnector {
      * @param options The options for the wallet connector.
      */
     constructor(options?: IEntityStorageFaucetConnectorConstructorOptions);
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className(): string;
     /**
      * Fund the wallet from the faucet.
      * @param identity The identity of the user to access the vault keys.

package/dist/types/entityStorageWalletConnector.d.ts

@@ -1,5 +1,5 @@
 import { type IWalletConnector } from "@twin.org/wallet-models";
-import type { IEntityStorageWalletConnectorConstructorOptions } from "./models/IEntityStorageWalletConnectorConstructorOptions";
+import type { IEntityStorageWalletConnectorConstructorOptions } from "./models/IEntityStorageWalletConnectorConstructorOptions.js";
 /**
  * Class for performing wallet operations using in-memory storage.
  */
@@ -17,6 +17,11 @@ export declare class EntityStorageWalletConnector implements IWalletConnector {
      * @param options The options for the wallet connector.
      */
     constructor(options?: IEntityStorageWalletConnectorConstructorOptions);
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className(): string;
     /**
      * Create a new wallet.
      * @param identity The identity of the user to access the vault keys.

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
-export * from "./entities/walletAddress";
-export * from "./entityStorageFaucetConnector";
-export * from "./entityStorageWalletConnector";
-export * from "./models/IEntityStorageFaucetConnectorConstructorOptions";
-export * from "./models/IEntityStorageWalletConnectorConfig";
-export * from "./models/IEntityStorageWalletConnectorConstructorOptions";
-export * from "./schema";
+export * from "./entities/walletAddress.js";
+export * from "./entityStorageFaucetConnector.js";
+export * from "./entityStorageWalletConnector.js";
+export * from "./models/IEntityStorageFaucetConnectorConstructorOptions.js";
+export * from "./models/IEntityStorageWalletConnectorConfig.js";
+export * from "./models/IEntityStorageWalletConnectorConstructorOptions.js";
+export * from "./schema.js";

package/dist/types/models/IEntityStorageWalletConnectorConstructorOptions.d.ts

@@ -1,4 +1,4 @@
-import type { IEntityStorageWalletConnectorConfig } from "./IEntityStorageWalletConnectorConfig";
+import type { IEntityStorageWalletConnectorConfig } from "./IEntityStorageWalletConnectorConfig.js";
 /**
  * Options for the entity storage wallet connector.
  */

package/docs/changelog.md

@@ -1,5 +1,40 @@
 # @twin.org/wallet-connector-entity-storage - Changelog
 
+## [0.0.3-next.2](https://github.com/twinfoundation/wallet/compare/wallet-connector-entity-storage-v0.0.3-next.1...wallet-connector-entity-storage-v0.0.3-next.2) (2026-02-25)
+
+
+### Bug Fixes
+
+* missing dependency ([6f02070](https://github.com/twinfoundation/wallet/commit/6f02070f3ad7d6dcdbbddd952c7d18a47386f15d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/wallet-models bumped from 0.0.3-next.1 to 0.0.3-next.2
+
+## [0.0.3-next.1](https://github.com/twinfoundation/wallet/compare/wallet-connector-entity-storage-v0.0.3-next.0...wallet-connector-entity-storage-v0.0.3-next.1) (2025-11-11)
+
+
+### Features
+
+* add context id features ([#46](https://github.com/twinfoundation/wallet/issues/46)) ([9389c28](https://github.com/twinfoundation/wallet/commit/9389c28084656666d04ed82575cbc8d3fa9f0d88))
+* add validate-locales ([e5200c2](https://github.com/twinfoundation/wallet/commit/e5200c279de60592b64eeb64279fa8ed289a677f))
+* eslint migration to flat config ([7068485](https://github.com/twinfoundation/wallet/commit/7068485f7c10121b76b6219798fdea4d3e91648a))
+* iota rebased release ([d0c617d](https://github.com/twinfoundation/wallet/commit/d0c617d894f3663f7c80f7d53d2da858a0bd64f0))
+* remove bech32 encoding for addresses ([869ef88](https://github.com/twinfoundation/wallet/commit/869ef8830eab0bcea6bc748f3bc637fc311e0709))
+* update dependencies ([4b47a7d](https://github.com/twinfoundation/wallet/commit/4b47a7d900d72d1502d6db54cb391a954818478b))
+* update framework core ([1c8a381](https://github.com/twinfoundation/wallet/commit/1c8a381e3c0544803a98db5560d87087fd095c23))
+* use shared store mechanism ([#27](https://github.com/twinfoundation/wallet/issues/27)) ([2ba7861](https://github.com/twinfoundation/wallet/commit/2ba7861a2a610cf83396a3285c7bbaebe5a31551))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/wallet-models bumped from 0.0.3-next.0 to 0.0.3-next.1
+
 ## [0.0.2-next.5](https://github.com/twinfoundation/wallet/compare/wallet-connector-entity-storage-v0.0.2-next.4...wallet-connector-entity-storage-v0.0.2-next.5) (2025-10-09)
 
 

package/docs/reference/classes/EntityStorageFaucetConnector.md

@@ -44,6 +44,24 @@ Runtime name for the class.
 
 ## Methods
 
+### className()
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Implementation of
+
+`IFaucetConnector.className`
+
+***
+
 ### fundAddress()
 
 > **fundAddress**(`identity`, `address`, `timeoutInSeconds`): `Promise`\<`bigint`\>

package/docs/reference/classes/EntityStorageWalletConnector.md

@@ -44,6 +44,24 @@ The namespace supported by the wallet connector.
 
 ## Methods
 
+### className()
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Implementation of
+
+`IWalletConnector.className`
+
+***
+
 ### create()
 
 > **create**(`identity`): `Promise`\<`void`\>
@@ -192,7 +210,7 @@ True if the balance has been ensured.
 
 ### transfer()
 
-> **transfer**(`identity`, `addressSource`, `addressDest`, `amount`): `Promise`\<`undefined` \| `string`\>
+> **transfer**(`identity`, `addressSource`, `addressDest`, `amount`): `Promise`\<`string` \| `undefined`\>
 
 Transfer funds to an address.
 
@@ -224,7 +242,7 @@ The amount to transfer.
 
 #### Returns
 
-`Promise`\<`undefined` \| `string`\>
+`Promise`\<`string` \| `undefined`\>
 
 An identifier for the transfer if there was one.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/wallet-connector-entity-storage",
-	"version": "0.0.2-next.5",
+	"version": "0.0.3-next.2",
 	"description": "Wallet connector implementation using entity storage",
 	"repository": {
 		"type": "git",
@@ -20,22 +20,20 @@
 		"@twin.org/entity-storage-models": "next",
 		"@twin.org/nameof": "next",
 		"@twin.org/vault-models": "next",
-		"@twin.org/wallet-models": "0.0.2-next.5"
+		"@twin.org/wallet-models": "0.0.3-next.2"
 	},
-	"main": "./dist/cjs/index.cjs",
-	"module": "./dist/esm/index.mjs",
+	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
 			"types": "./dist/types/index.d.ts",
-			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs"
+			"import": "./dist/es/index.js",
+			"default": "./dist/es/index.js"
 		},
 		"./locales/*.json": "./locales/*.json"
 	},
 	"files": [
-		"dist/cjs",
-		"dist/esm",
+		"dist/es",
 		"dist/types",
 		"locales",
 		"docs"

package/dist/cjs/index.cjs

@@ -1,307 +0,0 @@
-'use strict';
-
-var entity = require('@twin.org/entity');
-var core = require('@twin.org/core');
-var entityStorageModels = require('@twin.org/entity-storage-models');
-var crypto = require('@twin.org/crypto');
-var vaultModels = require('@twin.org/vault-models');
-var walletModels = require('@twin.org/wallet-models');
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class describing a wallet address.
- */
-exports.WalletAddress = class WalletAddress {
-    /**
-     * The address in the wallet.
-     */
-    address;
-    /**
-     * The identity of the owner.
-     */
-    identity;
-    /**
-     * The balance of the wallet as bigint.
-     */
-    balance;
-};
-__decorate([
-    entity.property({ type: "string", isPrimary: true }),
-    __metadata("design:type", String)
-], exports.WalletAddress.prototype, "address", void 0);
-__decorate([
-    entity.property({ type: "string" }),
-    __metadata("design:type", String)
-], exports.WalletAddress.prototype, "identity", void 0);
-__decorate([
-    entity.property({ type: "string" }),
-    __metadata("design:type", String)
-], exports.WalletAddress.prototype, "balance", void 0);
-exports.WalletAddress = __decorate([
-    entity.entity()
-], exports.WalletAddress);
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class for performing faucet operations using entity storage.
- */
-class EntityStorageFaucetConnector {
-    /**
-     * The namespace supported by the wallet connector.
-     */
-    static NAMESPACE = "entity-storage";
-    /**
-     * Runtime name for the class.
-     */
-    static CLASS_NAME = "EntityStorageFaucetConnector";
-    /**
-     * The entity storage for wallets.
-     * @internal
-     */
-    _walletAddressEntityStorage;
-    /**
-     * Create a new instance of EntityStorageFaucetConnector.
-     * @param options The options for the wallet connector.
-     */
-    constructor(options) {
-        this._walletAddressEntityStorage = entityStorageModels.EntityStorageConnectorFactory.get(options?.walletAddressEntityStorageType ?? "wallet-address");
-    }
-    /**
-     * Fund the wallet from the faucet.
-     * @param identity The identity of the user to access the vault keys.
-     * @param address The hex encoded address of the address to fund.
-     * @param timeoutInSeconds The timeout in seconds to wait for the funding to complete.
-     * @returns The amount added to the address by the faucet.
-     */
-    async fundAddress(identity, address, timeoutInSeconds = 60) {
-        core.Guards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, "identity", identity);
-        core.Guards.stringValue(EntityStorageFaucetConnector.CLASS_NAME, "address", address);
-        let walletAddress = await this._walletAddressEntityStorage.get(address);
-        if (core.Is.empty(walletAddress)) {
-            walletAddress = {
-                balance: "0",
-                identity,
-                address
-            };
-        }
-        const maxFundAmount = 1000000000n;
-        const balance = core.Coerce.bigint(walletAddress.balance) ?? 0n;
-        walletAddress.balance = (balance + maxFundAmount).toString();
-        await this._walletAddressEntityStorage.set(walletAddress);
-        return maxFundAmount;
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class for performing wallet operations using in-memory storage.
- */
-class EntityStorageWalletConnector {
-    /**
-     * Runtime name for the class.
-     */
-    static CLASS_NAME = "EntityStorageWalletConnector";
-    /**
-     * The namespace supported by the wallet connector.
-     */
-    static NAMESPACE = "entity-storage";
-    /**
-     * Default name for the mnemonic secret.
-     * @internal
-     */
-    static _DEFAULT_MNEMONIC_SECRET_NAME = "mnemonic";
-    /**
-     * Default coin type.
-     * @internal
-     */
-    static _DEFAULT_COIN_TYPE = 9999;
-    /**
-     * Default network name.
-     * @internal
-     */
-    static _DEFAULT_NETWORK_NAME = "ent";
-    /**
-     * The vault for the mnemonic.
-     * @internal
-     */
-    _vaultConnector;
-    /**
-     * The faucet.
-     * @internal
-     */
-    _faucetConnector;
-    /**
-     * The entity storage for wallets.
-     * @internal
-     */
-    _walletAddressEntityStorage;
-    /**
-     * The configuration to use for tangle operations.
-     * @internal
-     */
-    _config;
-    /**
-     * Create a new instance of EntityStorageWalletConnector.
-     * @param options The options for the wallet connector.
-     */
-    constructor(options) {
-        this._vaultConnector = vaultModels.VaultConnectorFactory.get(options?.vaultConnectorType ?? "vault");
-        this._faucetConnector = walletModels.FaucetConnectorFactory.getIfExists(options?.faucetConnectorType ?? "faucet");
-        this._walletAddressEntityStorage = entityStorageModels.EntityStorageConnectorFactory.get(options?.walletAddressEntityStorageType ?? "wallet-address");
-        this._config = options?.config ?? {};
-        this._config.coinType ??= EntityStorageWalletConnector._DEFAULT_COIN_TYPE;
-        this._config.networkName ??= EntityStorageWalletConnector._DEFAULT_NETWORK_NAME;
-    }
-    /**
-     * Create a new wallet.
-     * @param identity The identity of the user to access the vault keys.
-     * @returns Nothing.
-     */
-    async create(identity) {
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "identity", identity);
-        const mnemonic = crypto.Bip39.randomMnemonic();
-        await this._vaultConnector.setSecret(this.buildMnemonicKey(identity), mnemonic);
-    }
-    /**
-     * Get the addresses for the requested range.
-     * @param identity The identity of the user to access the vault keys.
-     * @param accountIndex The account index to get the addresses for.
-     * @param startAddressIndex The start index for the addresses.
-     * @param count The number of addresses to generate.
-     * @returns The list of addresses.
-     */
-    async getAddresses(identity, accountIndex, startAddressIndex, count) {
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "identity", identity);
-        core.Guards.integer(EntityStorageWalletConnector.CLASS_NAME, "startAddressIndex", startAddressIndex);
-        core.Guards.integer(EntityStorageWalletConnector.CLASS_NAME, "count", count);
-        const mnemonic = await this._vaultConnector.getSecret(this.buildMnemonicKey(identity));
-        const seed = crypto.Bip39.mnemonicToSeed(mnemonic);
-        const keyPairs = [];
-        for (let i = startAddressIndex; i < startAddressIndex + count; i++) {
-            const addressKeyPair = crypto.Bip44.address(seed, crypto.KeyType.Ed25519, this._config.coinType ?? EntityStorageWalletConnector._DEFAULT_COIN_TYPE, accountIndex, false, i);
-            keyPairs.push(addressKeyPair.address);
-        }
-        return keyPairs;
-    }
-    /**
-     * Get the balance for an address in a wallet.
-     * @param identity The identity of the user to access the vault keys.
-     * @param address The hex encoded address.
-     * @returns The balance of the wallet address.
-     */
-    async getBalance(identity, address) {
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "address", address);
-        const walletAddress = await this._walletAddressEntityStorage.get(address);
-        return core.Coerce.bigint(walletAddress?.balance) ?? 0n;
-    }
-    /**
-     * Ensure the balance for an address in a wallet.
-     * @param identity The identity of the user to access the vault keys.
-     * @param address The hex encoded address.
-     * @param ensureBalance The balance to ensure on the address.
-     * @param timeoutInSeconds The timeout in seconds to wait for the funding to complete.
-     * @returns True if the balance has been ensured.
-     */
-    async ensureBalance(identity, address, ensureBalance, timeoutInSeconds) {
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "identity", identity);
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "address", address);
-        core.Guards.bigint(EntityStorageWalletConnector.CLASS_NAME, "ensureBalance", ensureBalance);
-        if (this._faucetConnector) {
-            let retryCount = 10;
-            let currentBalance = await this.getBalance(identity, address);
-            while (currentBalance < ensureBalance && retryCount > 0) {
-                const addedBalance = await this._faucetConnector.fundAddress(identity, address, timeoutInSeconds);
-                if (addedBalance === 0n) {
-                    // The balance has not increased, so return.
-                    return false;
-                }
-                currentBalance += addedBalance;
-                if (currentBalance < ensureBalance) {
-                    // The balance has increased but is still not enough, wait and try again.
-                    await new Promise(resolve => setTimeout(resolve, 100));
-                    retryCount--;
-                }
-            }
-            return currentBalance >= ensureBalance;
-        }
-        return false;
-    }
-    /**
-     * Transfer funds to an address.
-     * @param identity The identity of the user to access the vault keys.
-     * @param addressSource The hex encoded address to send the funds from.
-     * @param addressDest The hex encoded address to send the funds to.
-     * @param amount The amount to transfer.
-     * @returns An identifier for the transfer if there was one.
-     */
-    async transfer(identity, addressSource, addressDest, amount) {
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "identity", identity);
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "addressSource", addressSource);
-        core.Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "addressDest", addressDest);
-        core.Guards.bigint(EntityStorageWalletConnector.CLASS_NAME, "amount", amount);
-        const walletAddresses = await this._walletAddressEntityStorage.query({
-            logicalOperator: entity.LogicalOperator.And,
-            conditions: [
-                {
-                    property: "identity",
-                    comparison: entity.ComparisonOperator.Equals,
-                    value: identity
-                },
-                {
-                    property: "address",
-                    comparison: entity.ComparisonOperator.Equals,
-                    value: addressSource
-                }
-            ]
-        });
-        let walletAddress;
-        let balance = 0n;
-        if (walletAddresses.entities.length > 0) {
-            walletAddress = walletAddresses.entities[0];
-            balance = BigInt(walletAddress.balance);
-            walletAddress.balance = (BigInt(walletAddress.balance) - amount).toString();
-        }
-        if (balance < amount) {
-            throw new core.GeneralError(EntityStorageWalletConnector.CLASS_NAME, "insufficientFunds");
-        }
-        if (!core.Is.empty(walletAddress)) {
-            await this._walletAddressEntityStorage.set(walletAddress);
-            let destWalletAddress = await this._walletAddressEntityStorage.get(addressDest);
-            if (core.Is.empty(destWalletAddress)) {
-                destWalletAddress = {
-                    balance: "0",
-                    identity: "",
-                    address: addressDest
-                };
-            }
-            destWalletAddress.balance = (BigInt(destWalletAddress.balance) + amount).toString();
-            await this._walletAddressEntityStorage.set(destWalletAddress);
-        }
-        return undefined;
-    }
-    /**
-     * Build the key name to access the mnemonic in the vault.
-     * @param identity The identity of the user to access the vault keys.
-     * @returns The vault key.
-     * @internal
-     */
-    buildMnemonicKey(identity) {
-        return `${identity}/${this._config.vaultMnemonicId ?? EntityStorageWalletConnector._DEFAULT_MNEMONIC_SECRET_NAME}`;
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Initialize the schema for the wallet entity storage connector.
- */
-function initSchema() {
-    entity.EntitySchemaFactory.register("WalletAddress", () => entity.EntitySchemaHelper.getSchema(exports.WalletAddress));
-}
-
-exports.EntityStorageFaucetConnector = EntityStorageFaucetConnector;
-exports.EntityStorageWalletConnector = EntityStorageWalletConnector;
-exports.initSchema = initSchema;