Add wasm32 identity client implementation

Cargo.toml

@@ -43,7 +43,7 @@ result_large_err = "allow"
 
 [profile.release.package.iota_interaction_ts]
 opt-level = 's'
-# Enabling debug for profile.release may lead to more helpfull loged call stacks.
+# Enabling debug for profile.release may lead to more helpful logged call stacks.
 # TODO: Clarify if 'debug = true' facilitates error analysis via console logs.
 #       If not, remove the next line
 #       If yes, describe the helping effect in the comment above

bindings/wasm/identity_wasm/Cargo.toml

@@ -16,6 +16,7 @@ description = "Web Assembly bindings for the identity-rs crate."
 crate-type = ["cdylib", "rlib"]
 
 [dependencies]
+anyhow = "1.0.95"
 async-trait = { version = "0.1", default-features = false }
 console_error_panic_hook = { version = "0.1" }
 fastcrypto = { git = "https://github.com/MystenLabs/fastcrypto", rev = "5f2c63266a065996d53f98156f0412782b468597", package = "fastcrypto" }
@@ -26,7 +27,7 @@ iota-sdk = { version = "1.1.5", default-features = false, features = ["serde", "
 js-sys = { version = "0.3.61" }
 json-proof-token = "0.3.4"
 proc_typescript = { version = "0.1.0", path = "./proc_typescript" }
-secret-storage = { git = "https://github.com/iotaledger/secret-storage.git", default-features = false, branch = "main" }
+secret-storage = { git = "https://github.com/iotaledger/secret-storage.git", default-features = false, tag = "v0.1.0" }
 serde = { version = "1.0", features = ["derive"] }
 serde-wasm-bindgen = "0.6.5"
 serde_json = { version = "1.0", default-features = false }

bindings/wasm/identity_wasm/examples/src/0_basic/0_create_did.ts

@@ -1,83 +1,50 @@
 // Copyright 2020-2023 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
+import { IotaDID } from '@iota/identity-wasm/node';
+import { IotaClient as KinesisClient } from "@iota/iota.js/client";
 import {
-    IotaDID,
-    IotaDocument,
-    IotaIdentityClient,
-    JwkMemStore,
-    JwsAlgorithm,
-    KeyIdMemStore,
-    MethodScope,
-    Storage,
-} from "@iota/identity-wasm/node";
-import { AliasOutput, Client, MnemonicSecretManager, SecretManager, Utils } from "@iota/sdk-wasm/node";
-import { API_ENDPOINT, ensureAddressHasFunds } from "../util";
-
-/** Demonstrate how to create a DID Document and publish it in a new Alias Output. */
-export async function createIdentity(): Promise<{
-    didClient: IotaIdentityClient;
-    secretManager: SecretManager;
-    walletAddressBech32: string;
-    did: IotaDID;
-}> {
-    const client = new Client({
-        primaryNode: API_ENDPOINT,
-        localPow: true,
-    });
-    const didClient = new IotaIdentityClient(client);
-
-    // Get the Bech32 human-readable part (HRP) of the network.
-    const networkHrp: string = await didClient.getNetworkHrp();
-
-    const mnemonicSecretManager: MnemonicSecretManager = {
-        mnemonic: Utils.generateMnemonic(),
-    };
-
-    // Generate a random mnemonic for our wallet.
-    const secretManager: SecretManager = new SecretManager(mnemonicSecretManager);
-
-    const walletAddressBech32 = (await secretManager.generateEd25519Addresses({
-        accountIndex: 0,
-        range: {
-            start: 0,
-            end: 1,
-        },
-        bech32Hrp: networkHrp,
-    }))[0];
-    console.log("Wallet address Bech32:", walletAddressBech32);
-
-    // Request funds for the wallet, if needed - only works on development networks.
-    await ensureAddressHasFunds(client, walletAddressBech32);
-
-    // Create a new DID document with a placeholder DID.
-    // The DID will be derived from the Alias Id of the Alias Output after publishing.
-    const document = new IotaDocument(networkHrp);
-    const storage: Storage = new Storage(new JwkMemStore(), new KeyIdMemStore());
-
-    // Insert a new Ed25519 verification method in the DID document.
-    await document.generateMethod(
-        storage,
-        JwkMemStore.ed25519KeyType(),
-        JwsAlgorithm.EdDSA,
-        "#key-1",
-        MethodScope.VerificationMethod(),
-    );
-
-    // Construct an Alias Output containing the DID document, with the wallet address
-    // set as both the state controller and governor.
-    const address = Utils.parseBech32Address(walletAddressBech32);
-    const aliasOutput: AliasOutput = await didClient.newDidOutput(address, document);
-    console.log("Alias Output:", JSON.stringify(aliasOutput, null, 2));
-
-    // Publish the Alias Output and get the published DID document.
-    const published = await didClient.publishDidOutput(mnemonicSecretManager, aliasOutput);
-    console.log("Published DID document:", JSON.stringify(published, null, 2));
-
-    return {
-        didClient,
-        secretManager,
-        walletAddressBech32,
-        did: published.id(),
-    };
-}
+    createDocumentForNetwork,
+    getClientAndCreateAccount,
+    getMemstorage,
+    NETWORK_URL,
+} from '../utils_alpha';
+
+/** Demonstrate how to create a DID Document and publish it. */
+export async function createIdentity(): Promise<void>  {
+    // create new client to connect to IOTA network
+    const kinesisClient = new KinesisClient({ url: NETWORK_URL });
+    const network = await kinesisClient.getChainIdentifier();
+
+    const storage = getMemstorage();
+    // TODO: check if we can update storage implementation to a non-owning variant
+    // order is important here as wrapped storage will be set to a null pointer after passing it to a client
+    const [unpublished] = await createDocumentForNetwork(storage, network);
+    // create new client that offers identity related functions
+    const identityClient = await getClientAndCreateAccount(storage);
+
+    console.log(`Unpublished DID document: ${JSON.stringify(unpublished, null, 2)}`); 
+    let did: IotaDID;
+
+    // TODO: decide upon wich style to use here
+    // so let's go with both for now, to show that both work
+    if (Math.random() > .5) {
+        console.log('Creating new identity fully via client flow');
+        const { output: identity } = await identityClient
+            .createIdentity(unpublished)
+            .finish()
+            .execute(identityClient);
+        did = IotaDID.fromAliasId(identity.id(), identityClient.network());
+    } else {
+        console.log('Publishing document to identity');
+        const { output: published } = await identityClient
+            .publishDidDocument(unpublished)
+            .execute(identityClient);
+        did = published.id();
+    }
+
+    // check if we can resolve it via client
+    const resolved = await identityClient.resolveDid(did);
+    console.log(`Resolved DID document: ${JSON.stringify(resolved, null, 2)}`);
+  }
+

bindings/wasm/identity_wasm/examples/src/0_basic/1_update_did.ts

@@ -2,87 +2,77 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import {
-    IotaDocument,
-    IotaIdentityClient,
+    IotaDID,
     JwkMemStore,
     JwsAlgorithm,
-    KeyIdMemStore,
     MethodRelationship,
     MethodScope,
     Service,
-    Storage,
     Timestamp,
     VerificationMethod,
 } from "@iota/identity-wasm/node";
-import { AliasOutput, Client, IRent, MnemonicSecretManager, Utils } from "@iota/sdk-wasm/node";
-import { API_ENDPOINT, createDid } from "../util";
+import { IotaClient as KinesisClient } from "@iota/iota.js/client";
+import {
+    createDocumentForNetwork,
+    getClientAndCreateAccount,
+    getMemstorage,
+    NETWORK_URL,
+    TEST_GAS_BUDGET,
+} from '../utils_alpha';
 
 /** Demonstrates how to update a DID document in an existing Alias Output. */
 export async function updateIdentity() {
-    const client = new Client({
-        primaryNode: API_ENDPOINT,
-        localPow: true,
-    });
-    const didClient = new IotaIdentityClient(client);
-
-    // Generate a random mnemonic for our wallet.
-    const secretManager: MnemonicSecretManager = {
-        mnemonic: Utils.generateMnemonic(),
-    };
+    // create new clients and create new account
+    const kinesisClient = new KinesisClient({ url: NETWORK_URL });
+    const network = await kinesisClient.getChainIdentifier();
+    const storage = getMemstorage();
+    const [unpublished, vmFragment1] = await createDocumentForNetwork(storage, network);
+    const identityClient = await getClientAndCreateAccount(storage);
 
-    // Creates a new wallet and identity (see "0_create_did" example).
-    const storage: Storage = new Storage(new JwkMemStore(), new KeyIdMemStore());
-    let { document, fragment } = await createDid(
-        client,
-        secretManager,
-        storage,
-    );
-    const did = document.id();
+    // create new identity for this account and publish document for it
+    const { output: identity } = await identityClient
+        .createIdentity(unpublished)
+        .finish()
+        .execute(identityClient);
+    const did = IotaDID.fromAliasId(identity.id(), identityClient.network());
 
     // Resolve the latest state of the document.
     // Technically this is equivalent to the document above.
-    document = await didClient.resolveDid(did);
+    const resolved = await identityClient.resolveDid(did);
 
-    // Insert a new Ed25519 verification method in the DID document.
-    await document.generateMethod(
-        storage,
-        JwkMemStore.ed25519KeyType(),
-        JwsAlgorithm.EdDSA,
-        "#key-2",
-        MethodScope.VerificationMethod(),
-    );
+    if ((storage as any).__wbg_ptr === 0) {
+        console.log('cannot re-use storage, skipping generating new method');
+    } else {
+        console.log('can re-use storage, generating new method');
+        // Insert a new Ed25519 verification method in the DID document.
+        await resolved.generateMethod(
+            storage,
+            JwkMemStore.ed25519KeyType(),
+            JwsAlgorithm.EdDSA,
+            "#key-2",
+            MethodScope.VerificationMethod(),
+        );
 
-    // Attach a new method relationship to the inserted method.
-    document.attachMethodRelationship(did.join("#key-2"), MethodRelationship.Authentication);
+        // Attach a new method relationship to the inserted method.
+        resolved.attachMethodRelationship(did.join("#key-2"), MethodRelationship.Authentication);
+
+        // Remove a verification method.
+        let originalMethod = resolved.resolveMethod(vmFragment1) as VerificationMethod;
+        await resolved.purgeMethod(storage, originalMethod?.id());
+    }
 
     // Add a new Service.
     const service: Service = new Service({
         id: did.join("#linked-domain"),
         type: "LinkedDomains",
         serviceEndpoint: "https://iota.org/",
     });
-    document.insertService(service);
-    document.setMetadataUpdated(Timestamp.nowUTC());
-
-    // Remove a verification method.
-    let originalMethod = document.resolveMethod(fragment) as VerificationMethod;
-    await document.purgeMethod(storage, originalMethod?.id());
-
-    // Resolve the latest output and update it with the given document.
-    let aliasOutput: AliasOutput = await didClient.updateDidOutput(document);
-
-    // Because the size of the DID document increased, we have to increase the allocated storage deposit.
-    // This increases the deposit amount to the new minimum.
-    const rentStructure: IRent = await didClient.getRentStructure();
-
-    aliasOutput = await client.buildAliasOutput({
-        ...aliasOutput,
-        amount: Utils.computeStorageDeposit(aliasOutput, rentStructure),
-        aliasId: aliasOutput.getAliasId(),
-        unlockConditions: aliasOutput.getUnlockConditions(),
-    });
+    resolved.insertService(service);
+    resolved.setMetadataUpdated(Timestamp.nowUTC());
 
-    // Publish the output.
-    const updated: IotaDocument = await didClient.publishDidOutput(secretManager, aliasOutput);
-    console.log("Updated DID document:", JSON.stringify(updated, null, 2));
+    let updated = await identityClient
+        .publishDidDocumentUpdate(resolved.clone(), TEST_GAS_BUDGET);
+    // and resolve again to make sure we're looking at the onchain information
+    const resolvedAgain = await identityClient.resolveDid(did);
+    console.log(`Updated DID document result: ${JSON.stringify(resolvedAgain, null, 2)}`);
 }

bindings/wasm/identity_wasm/examples/src/0_basic/2_resolve_did.ts

@@ -1,6 +1,11 @@
 // Copyright 2020-2023 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
+// TODO:
+// - [ ] clarify if we need/want a resolver example
+// - [ ] clarify if we need/want the AliasOutput -> ObjectID example
+
+
 import {
     CoreDocument,
     DIDJwk,
@@ -12,40 +17,29 @@ import {
     Resolver,
     Storage,
 } from "@iota/identity-wasm/node";
-import { AliasOutput, Client, MnemonicSecretManager, Utils } from "@iota/sdk-wasm/node";
+import { AliasOutput,  } from "@iota/sdk-wasm/node";
 import { API_ENDPOINT, createDid } from "../util";
+import { createDidDocument, getClientAndCreateAccount, getMemstorage } from "../utils_alpha";
 
 const DID_JWK: string =
     "did:jwk:eyJjcnYiOiJQLTI1NiIsImt0eSI6IkVDIiwieCI6ImFjYklRaXVNczNpOF91c3pFakoydHBUdFJNNEVVM3l6OTFQSDZDZEgyVjAiLCJ5IjoiX0tjeUxqOXZXTXB0bm1LdG00NkdxRHo4d2Y3NEk1TEtncmwyR3pIM25TRSJ9";
 
 /** Demonstrates how to resolve an existing DID in an Alias Output. */
 export async function resolveIdentity() {
-    const client = new Client({
-        primaryNode: API_ENDPOINT,
-        localPow: true,
-    });
-    const didClient = new IotaIdentityClient(client);
-
-    // Generate a random mnemonic for our wallet.
-    const secretManager: MnemonicSecretManager = {
-        mnemonic: Utils.generateMnemonic(),
-    };
-
-    // Creates a new wallet and identity (see "0_create_did" example).
-    const storage: Storage = new Storage(new JwkMemStore(), new KeyIdMemStore());
-    let { document } = await createDid(
-        client,
-        secretManager,
-        storage,
-    );
-    const did = document.id();
+    // create new client to interact with chain and get funded account with keys
+    const storage = getMemstorage();
+    const identityClient = await getClientAndCreateAccount(storage);
+
+    // create new DID document and publish it
+    let [document] = await createDidDocument(identityClient, storage);
+    let did = document.id();
 
     // Resolve the associated Alias Output and extract the DID document from it.
-    const resolved: IotaDocument = await didClient.resolveDid(did);
+    const resolved: IotaDocument = await identityClient.resolveDid(did);
     console.log("Resolved DID document:", JSON.stringify(resolved, null, 2));
 
-    // We can also resolve the Alias Output directly.
-    const aliasOutput: AliasOutput = await didClient.resolveDidOutput(did);
+    // We can also resolve the Object ID reictly
+    const aliasOutput: AliasOutput = await identityClient.resolveDidOutput(did);
     console.log("The Alias Output holds " + aliasOutput.getAmount() + " tokens");
 
     // did:jwk can be resolved as well.