feat(sdk): expose data contract from json

Author: shumkov

packages/js-evo-sdk/src/sdk.ts

@@ -145,3 +145,4 @@ export { GroupFacade } from './group/facade.js';
 export { VotingFacade } from './voting/facade.js';
 export { wallet } from './wallet/functions.js';
 export { verifyIdentityResponse, verifyDataContract, verifyDocuments, start } from './wasm.js';
+export { DataContract } from './wasm.js';

packages/wasm-sdk/src/dpp.rs

@@ -294,7 +294,7 @@ impl IdentityWasm {
 //     }
 // }
 
-#[wasm_bindgen]
+#[wasm_bindgen(js_name=DataContract)]
 pub struct DataContractWasm(DataContract);
 
 impl From<DataContract> for DataContractWasm {
@@ -303,12 +303,30 @@ impl From<DataContract> for DataContractWasm {
     }
 }
 
-#[wasm_bindgen]
+#[wasm_bindgen(js_class=DataContract)]
 impl DataContractWasm {
     pub fn id(&self) -> String {
         self.0.id().to_string(Encoding::Base58)
     }
 
+    #[wasm_bindgen(js_name=fromJSON)]
+    pub fn from_json(json: &JsValue, platform_version: u32) -> Result<DataContractWasm, WasmSdkError> {
+        let platform_version = &PlatformVersion::get(platform_version).map_err(|e| {
+            WasmSdkError::invalid_argument(format!(
+                "unknown platform version {platform_version}: {e}"
+            ))
+        })?;
+
+        let data_contract = DataContract::from_json(serde_wasm_bindgen::from_value(json.clone()).map_err(|e| {
+                WasmSdkError::serialization(format!("failed to convert json: {}", e))
+            })?, true, platform_version)
+            .map_err(|e| {
+                WasmSdkError::serialization(format!("failed to create DataContract from json: {}", e))
+            })?;
+
+        Ok(data_contract.into())
+    }
+
     #[wasm_bindgen(js_name=toJSON)]
     pub fn to_json(&self) -> Result<JsValue, WasmSdkError> {
         let platform_version = PlatformVersion::first();

packages/wasm-sdk/tests/unit/data-contract.spec.mjs

@@ -0,0 +1,23 @@
+import init, * as sdk from '../../dist/sdk.compressed.js';
+import contractFixture from './fixtures/data-contract-crypto-card-game.mjs';
+
+const PLATFORM_VERSION = 1;
+
+describe('DataContract', () => {
+  before(async () => {
+    await init();
+  });
+
+  it('should create a contract from JSON and expose identifiers', async () => {
+    const contract = sdk.DataContract.fromJSON(contractFixture, PLATFORM_VERSION);
+
+    expect(contract).to.be.ok();
+    expect(contract.id()).to.equal(contractFixture.id);
+
+    const roundTripped = contract.toJSON();
+    expect(roundTripped).to.be.an('object');
+    expect(roundTripped.id).to.equal(contractFixture.id);
+
+    contract.free();
+  });
+});

packages/wasm-sdk/tests/unit/fixtures/data-contract-crypto-card-game.mjs

@@ -0,0 +1,98 @@
+const contract = {
+  $format_version: '0',
+  id: '86LHvdC1Tqx5P97LQUSibGFqf2vnKFpB6VkqQ7oso86e',
+  ownerId: '2QjL594djCH2NyDsn45vd6yQjEDHupMKo7CEGVTHtQxU',
+  version: 1,
+  config: {
+    $format_version: '0',
+    canBeDeleted: false,
+    readonly: false,
+    keepsHistory: false,
+    documentsKeepHistoryContractDefault: false,
+    documentsMutableContractDefault: true,
+    documentsCanBeDeletedContractDefault: true,
+    requiresIdentityEncryptionBoundedKey: null,
+    requiresIdentityDecryptionBoundedKey: null,
+  },
+  documentSchemas: {
+    card: {
+      type: 'object',
+      documentsMutable: false,
+      canBeDeleted: true,
+      transferable: 1,
+      tradeMode: 1,
+      properties: {
+        name: {
+          type: 'string',
+          description: 'Name of the card',
+          maxLength: 63,
+          position: 0,
+        },
+        description: {
+          type: 'string',
+          description: 'Description of the card',
+          maxLength: 256,
+          position: 1,
+        },
+        imageUrl: {
+          type: 'string',
+          description: 'URL of the image associated with the card',
+          maxLength: 2048,
+          format: 'uri',
+          position: 2,
+        },
+        imageHash: {
+          type: 'array',
+          description: 'SHA256 hash of the bytes of the image specified by imageUrl',
+          byteArray: true,
+          minItems: 32,
+          maxItems: 32,
+          position: 3,
+        },
+        rarity: {
+          type: 'string',
+          description: 'Rarity level of the card',
+          enum: [
+            'common',
+            'uncommon',
+            'rare',
+            'legendary',
+          ],
+          position: 4,
+        },
+      },
+      required: [
+        '$createdAt',
+        '$updatedAt',
+        'name',
+        'description',
+        'imageUrl',
+        'imageHash',
+        'rarity',
+      ],
+      additionalProperties: false,
+      indices: [
+        {
+          name: 'name',
+          properties: [
+            {
+              name: 'asc',
+            },
+          ],
+          unique: true,
+        },
+        {
+          name: 'rarity',
+          properties: [
+            {
+              rarity: 'asc',
+            },
+          ],
+          unique: false,
+        },
+      ],
+    },
+  },
+};
+
+export default contract;