@twin.org/wallet-connector-entity-storage 0.0.3-next.5 → 0.9.0-next.1

package/dist/es/entityStorageWalletConnector.js

@@ -75,7 +75,7 @@ export class EntityStorageWalletConnector {
     /**
      * Create a new wallet.
      * @param identity The identity of the user to access the vault keys.
-     * @returns Nothing.
+     * @returns A promise that resolves when the wallet has been created and the mnemonic stored.
      */
     async create(identity) {
         Guards.stringValue(EntityStorageWalletConnector.CLASS_NAME, "identity", identity);

package/dist/es/entityStorageWalletConnector.js.map

@@ -1 +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"]}
+{"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 A promise that resolves when the wallet has been created and the mnemonic stored.\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/types/entityStorageWalletConnector.d.ts

@@ -25,7 +25,7 @@ export declare class EntityStorageWalletConnector implements IWalletConnector {
     /**
      * Create a new wallet.
      * @param identity The identity of the user to access the vault keys.
-     * @returns Nothing.
+     * @returns A promise that resolves when the wallet has been created and the mnemonic stored.
      */
     create(identity: string): Promise<void>;
     /**

package/docs/changelog.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.9.0-next.1](https://github.com/iotaledger/twin-wallet/compare/wallet-connector-entity-storage-v0.9.0-next.0...wallet-connector-entity-storage-v0.9.0-next.1) (2026-06-23)
+
+
+### Features
+
+* add context id features ([#46](https://github.com/iotaledger/twin-wallet/issues/46)) ([9389c28](https://github.com/iotaledger/twin-wallet/commit/9389c28084656666d04ed82575cbc8d3fa9f0d88))
+* add validate-locales ([e5200c2](https://github.com/iotaledger/twin-wallet/commit/e5200c279de60592b64eeb64279fa8ed289a677f))
+* eslint migration to flat config ([7068485](https://github.com/iotaledger/twin-wallet/commit/7068485f7c10121b76b6219798fdea4d3e91648a))
+* iota rebased release ([d0c617d](https://github.com/iotaledger/twin-wallet/commit/d0c617d894f3663f7c80f7d53d2da858a0bd64f0))
+* remove bech32 encoding for addresses ([869ef88](https://github.com/iotaledger/twin-wallet/commit/869ef8830eab0bcea6bc748f3bc637fc311e0709))
+* typescript 6 update ([7db75ad](https://github.com/iotaledger/twin-wallet/commit/7db75ade7482bc52f1da01014f0b66fa80d74d51))
+* update dependencies ([a7fc999](https://github.com/iotaledger/twin-wallet/commit/a7fc999be84f1fad40bfa845300b3cf7471cfc7d))
+* update dependencies ([4b47a7d](https://github.com/iotaledger/twin-wallet/commit/4b47a7d900d72d1502d6db54cb391a954818478b))
+* update framework core ([1c8a381](https://github.com/iotaledger/twin-wallet/commit/1c8a381e3c0544803a98db5560d87087fd095c23))
+* use shared store mechanism ([#27](https://github.com/iotaledger/twin-wallet/issues/27)) ([2ba7861](https://github.com/iotaledger/twin-wallet/commit/2ba7861a2a610cf83396a3285c7bbaebe5a31551))
+
+
+### Bug Fixes
+
+* missing dependency ([6f02070](https://github.com/iotaledger/twin-wallet/commit/6f02070f3ad7d6dcdbbddd952c7d18a47386f15d))
+* use async getStore in tests ([985a549](https://github.com/iotaledger/twin-wallet/commit/985a5493ac79f878d01262f01cdaac7e39196676))
+* use async getStore in tests ([4e6d379](https://github.com/iotaledger/twin-wallet/commit/4e6d3799ef9f3b1f6244ec4204d37a189db54913))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/wallet-models bumped from 0.9.0-next.0 to 0.9.0-next.1
+
 ## [0.0.3-next.5](https://github.com/iotaledger/twin-wallet/compare/wallet-connector-entity-storage-v0.0.3-next.4...wallet-connector-entity-storage-v0.0.3-next.5) (2026-05-20)
 
 

package/docs/reference/classes/EntityStorageWalletConnector.md

@@ -80,7 +80,7 @@ The identity of the user to access the vault keys.
 
 `Promise`\<`void`\>
 
-Nothing.
+A promise that resolves when the wallet has been created and the mnemonic stored.
 
 #### Implementation of
 

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@twin.org/wallet-connector-entity-storage",
-	"version": "0.0.3-next.5",
+	"version": "0.9.0-next.1",
 	"description": "Implements wallet and faucet connectors backed by entity storage for local and test workflows",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/iotaledger/wallet.git",
+		"url": "git+https://github.com/iotaledger/twin-wallet.git",
 		"directory": "packages/wallet-connector-entity-storage"
 	},
 	"author": "martyn.janes@iota.org",
@@ -14,13 +14,13 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "next",
-		"@twin.org/crypto": "next",
-		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "next",
-		"@twin.org/nameof": "next",
-		"@twin.org/vault-models": "next",
-		"@twin.org/wallet-models": "0.0.3-next.5"
+		"@twin.org/core": "0.9.0-next.1",
+		"@twin.org/crypto": "0.9.0-next.1",
+		"@twin.org/entity": "0.9.0-next.1",
+		"@twin.org/entity-storage-models": "0.9.0-next.1",
+		"@twin.org/nameof": "0.9.0-next.1",
+		"@twin.org/vault-models": "0.9.0-next.1",
+		"@twin.org/wallet-models": "0.9.0-next.1"
 	},
 	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",
@@ -57,7 +57,7 @@
 		"integration"
 	],
 	"bugs": {
-		"url": "git+https://github.com/iotaledger/wallet/issues"
+		"url": "git+https://github.com/iotaledger/twin-wallet/issues"
 	},
 	"homepage": "https://twindev.org"
 }