dash-platform-sdk 1.3.0 → 1.3.2-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dash-platform-sdk",
-  "version": "1.3.0",
+  "version": "1.3.2-dev.1",
   "main": "index.js",
   "description": "Lightweight SDK for accessing Dash Platform blockchain",
   "ts-standard": {
@@ -48,7 +48,7 @@
     "docs": "typedoc"
   },
   "peerDependencies": {
-    "pshenmic-dpp": "1.1.2-dev.8"
+    "pshenmic-dpp": "1.1.2-dev.9"
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.6.0",
@@ -59,6 +59,6 @@
     "@scure/bip39": "^2.0.0",
     "@scure/btc-signer": "^2.0.1",
     "cbor-x": "^1.6.0",
-    "pshenmic-dpp": "1.1.2-dev.8"
+    "pshenmic-dpp": "1.1.2-dev.9"
   }
 }

package/src/stateTransitions/broadcast.js

@@ -1,10 +1,21 @@
 import { BroadcastStateTransitionRequest } from '../../proto/generated/platform.js';
+import { deserializeConsensusError } from '../utils/deserializeConsensusError.js';
 export default async function broadcast(grpcPool, stateTransition) {
-    if (stateTransition.signature?.length === 0) {
-        throw new Error('State Transition is not signed');
+    try {
+        if (stateTransition.signature?.length === 0) {
+            throw new Error('State Transition is not signed');
+        }
+        const broadcastStateTransitionRequest = BroadcastStateTransitionRequest.create({
+            stateTransition: stateTransition.bytes()
+        });
+        await grpcPool.getClient().broadcastStateTransition(broadcastStateTransitionRequest);
+    }
+    catch (err) {
+        if (err.meta?.['dash-serialized-consensus-error-bin']?.length !== 0) {
+            throw new Error(deserializeConsensusError(err.meta['dash-serialized-consensus-error-bin']));
+        }
+        else {
+            throw err;
+        }
     }
-    const broadcastStateTransitionRequest = BroadcastStateTransitionRequest.create({
-        stateTransition: stateTransition.bytes()
-    });
-    await grpcPool.getClient().broadcastStateTransition(broadcastStateTransitionRequest);
 }

package/src/utils/deserializeConsensusError.d.ts

@@ -0,0 +1 @@
+export declare function deserializeConsensusError(error: string | Uint8Array): string;

package/src/utils/deserializeConsensusError.js

@@ -0,0 +1,17 @@
+import { base64 } from '@scure/base';
+import { ConsensusErrorWASM } from 'pshenmic-dpp';
+export function deserializeConsensusError(error) {
+    let normError;
+    if (typeof error === 'string') {
+        // @scure/base64 works only with padded base64, but cbor can return unpadded base64
+        const padding = error.length % 4;
+        if (padding !== 0) {
+            error += '='.repeat(4 - padding);
+        }
+        normError = base64.decode(error);
+    }
+    else {
+        normError = error;
+    }
+    return ConsensusErrorWASM.deserialize(normError).message;
+}

package/src/utils/index.d.ts

@@ -70,4 +70,11 @@ export declare class UtilsController {
      * @return {boolean}
      * */
     validateIdentifier(identifier: IdentifierLike): boolean;
+    /**
+     * Allows to deserialize consensus error
+     *
+     * @param error {string | Uint8Array} error in base64 or bytes
+     * @return {string}
+     */
+    deserializeConsensusError(error: string | Uint8Array): string;
 }

package/src/utils/index.js

@@ -5,6 +5,7 @@ import bytesToHex from './bytesToHex.js';
 import { createVoterIdentityId } from './createVoterIdentityId.js';
 import { IdentifierWASM } from 'pshenmic-dpp';
 import { createMasternodeIdentityId } from './createMasternodeIdentityId.js';
+import { deserializeConsensusError } from './deserializeConsensusError.js';
 /**
  * Collection of conversion functions
  *
@@ -98,4 +99,13 @@ export class UtilsController {
             return false;
         }
     }
+    /**
+     * Allows to deserialize consensus error
+     *
+     * @param error {string | Uint8Array} error in base64 or bytes
+     * @return {string}
+     */
+    deserializeConsensusError(error) {
+        return deserializeConsensusError(error);
+    }
 }

package/test/unit/SDK.spec.js

@@ -7,4 +7,8 @@ describe('DashPlatformSDK', () => {
     test('should be constructable throw `new`', () => {
         expect(sdk).toEqual(expect.any(DashPlatformSDK));
     });
+    test('should be able to deserialize consensus error', () => {
+        const err = sdk.utils.deserializeConsensusError('AwIiSW52YWxpZCBTdGF0ZSBUcmFuc2l0aW9uIHNpZ25hdHVyZQ');
+        expect(err).toEqual('Invalid State Transition signature');
+    });
 });