feat: migrate contracts tutorials to evo-sdk ESM

Migrate all contract register/retrieve/update tutorials from legacy
js-dash-sdk (CJS) to evo-sdk (ESM). Adds new variants (binary,
indexed, timestamps, history-retrieve) and works around
sdk.contracts.fetch() returning undefined for keepsHistory contracts
(dashpay/platform#3165).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: thephez

2-Contracts-and-Documents/contract-register-binary.mjs

@@ -0,0 +1,46 @@
+import { DataContract } from '@dashevo/evo-sdk';
+import { setupDashClient } from '../setupDashClient.mjs';
+
+const { sdk, keyManager } = await setupDashClient();
+const { identity, identityKey, signer } = await keyManager.getAuth();
+
+// Define the document schemas for the contract
+const documentSchemas = {
+  block: {
+    type: 'object',
+    properties: {
+      hash: {
+        type: 'array',
+        byteArray: true,
+        maxItems: 64,
+        description: 'Store block hashes',
+        position: 0,
+      },
+    },
+    additionalProperties: false,
+  },
+};
+
+try {
+  // Get the next identity nonce for contract creation
+  const identityNonce = await sdk.identities.nonce(identity.id.toString());
+
+  // Create the data contract
+  const dataContract = new DataContract({
+    ownerId: identity.id,
+    identityNonce: (identityNonce || 0n) + 1n,
+    schemas: documentSchemas,
+    fullValidation: true,
+  });
+
+  // Publish the contract to the platform
+  const publishedContract = await sdk.contracts.publish({
+    dataContract,
+    identityKey,
+    signer,
+  });
+
+  console.log('Contract registered:\n', publishedContract.toJSON());
+} catch (e) {
+  console.error('Something went wrong:\n', e.message);
+}

2-Contracts-and-Documents/contract-register-history.js

@@ -0,0 +1,49 @@
+// See https://docs.dash.org/projects/platform/en/stable/docs/tutorials/contracts-and-documents/register-a-data-contract.html
+import { DataContract } from '@dashevo/evo-sdk';
+import { setupDashClient } from '../setupDashClient.mjs';
+
+const { sdk, keyManager } = await setupDashClient();
+const { identity, identityKey, signer } = await keyManager.getAuth();
+
+const documentSchemas = {
+  note: {
+    type: 'object',
+    properties: {
+      message: {
+        type: 'string',
+        position: 0,
+      },
+    },
+    additionalProperties: false,
+  },
+};
+
+try {
+  const identityNonce = await sdk.identities.nonce(identity.id.toString());
+
+  const dataContract = new DataContract({
+    ownerId: identity.id,
+    identityNonce: (identityNonce || 0n) + 1n,
+    schemas: documentSchemas,
+    fullValidation: true,
+  });
+
+  // Enable storing of contract history
+  dataContract.setConfig({
+    canBeDeleted: false,
+    readonly: false,
+    keepsHistory: true,
+    documentsKeepHistoryContractDefault: false,
+    documentsMutableContractDefault: true,
+  });
+
+  const publishedContract = await sdk.contracts.publish({
+    dataContract,
+    identityKey,
+    signer,
+  });
+
+  console.log('Contract registered:\n', publishedContract.toJSON());
+} catch (e) {
+  console.error('Something went wrong:\n', e.message);
+}

2-Contracts-and-Documents/contract-register-history.mjs

@@ -0,0 +1,48 @@
+import { DataContract } from '@dashevo/evo-sdk';
+import { setupDashClient } from '../setupDashClient.mjs';
+
+const { sdk, keyManager } = await setupDashClient();
+const { identity, identityKey, signer } = await keyManager.getAuth();
+
+// Define the document schemas for the contract
+const documentSchemas = {
+  note: {
+    type: 'object',
+    indices: [{
+      name: 'ownerId',
+      properties: [{ $ownerId: 'asc' }],
+      unique: false,
+    }],
+    properties: {
+      message: {
+        type: 'string',
+        position: 0,
+      },
+    },
+    additionalProperties: false,
+  },
+};
+
+try {
+  // Get the next identity nonce for contract creation
+  const identityNonce = await sdk.identities.nonce(identity.id.toString());
+
+  // Create the data contract
+  const dataContract = new DataContract({
+    ownerId: identity.id,
+    identityNonce: (identityNonce || 0n) + 1n,
+    schemas: documentSchemas,
+    fullValidation: true,
+  });
+
+  // Publish the contract to the platform
+  const publishedContract = await sdk.contracts.publish({
+    dataContract,
+    identityKey,
+    signer,
+  });
+
+  console.log('Contract registered:\n', publishedContract.toJSON());
+} catch (e) {
+  console.error('Something went wrong:\n', e.message);
+}

2-Contracts-and-Documents/contract-register-indexed.mjs

@@ -0,0 +1,44 @@
+// See https://docs.dash.org/projects/platform/en/stable/docs/tutorials/contracts-and-documents/register-a-data-contract.html
+import { DataContract } from '@dashevo/evo-sdk';
+import { setupDashClient } from '../setupDashClient.mjs';
+
+const { sdk, keyManager } = await setupDashClient();
+const { identity, identityKey, signer } = await keyManager.getAuth();
+
+// Define the document schemas for the contract
+const documentSchemas = {
+  note: {
+    type: 'object',
+    properties: {
+      message: {
+        type: 'string',
+        position: 0,
+      },
+    },
+    additionalProperties: false,
+  },
+};
+
+try {
+  // Get the next identity nonce for contract creation
+  const identityNonce = await sdk.identities.nonce(identity.id.toString());
+
+  // Create the data contract
+  const dataContract = new DataContract({
+    ownerId: identity.id,
+    identityNonce: (identityNonce || 0n) + 1n,
+    schemas: documentSchemas,
+    fullValidation: true,
+  });
+
+  // Publish the contract to the platform
+  const publishedContract = await sdk.contracts.publish({
+    dataContract,
+    identityKey,
+    signer,
+  });
+
+  console.log('Contract registered:\n', publishedContract.toJSON());
+} catch (e) {
+  console.error('Something went wrong:\n', e.message);
+}