@kynesyslabs/demosdk 1.0.13 → 1.0.14

package/build/websdk/utils/forge_converter.d.ts

@@ -0,0 +1,3 @@
+declare function forgeToString(forgeBuffer: any, isHex?: boolean): string;
+declare function stringToForge(string: any, isHex?: boolean): false | Uint8Array;
+export { forgeToString, stringToForge };

package/build/websdk/utils/forge_converter.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringToForge = exports.forgeToString = void 0;
+const buffer_1 = require("buffer/");
+function forgeToString(forgeBuffer, isHex = true) {
+    if (isHex)
+        return ForgeToHex(forgeBuffer);
+    else
+        return forgeToRawString(forgeBuffer);
+}
+exports.forgeToString = forgeToString;
+// NOTE Only if the string is an hex string it can be reverted to a forge buffer
+function stringToForge(string, isHex = true) {
+    if (isHex)
+        return HexToForge(string); // Uint8Array
+    else
+        return rawStringToForge(string); // Will try to hexify and then HexToForge
+}
+exports.stringToForge = stringToForge;
+// NOTE It does output just a stringified version of the buffer
+function forgeToRawString(forgeBuffer) {
+    console.log('[forge to string]');
+    // This should be a Uint8Array-like object or a Buffer or a BinaryBuffer
+    const derived = JSON.stringify(forgeBuffer); // FIXME Error handling!
+    console.log(derived);
+    return derived; // String
+}
+// NOTE Remove if vestigial
+function rawStringToForge(forgeString) {
+    // NOTE This works only if the string can be reduced to a proper hex private key
+    let hexified = buffer_1.Buffer.from(forgeString).toString('hex');
+    if (hexified.length != 128) {
+        console.log('[string to forge] Invalid private key!');
+        return false;
+    }
+    console.log('[string to forge]');
+    const derived = HexToForge(hexified);
+    console.log(derived);
+    return derived;
+}
+// NOTE The following methods must be revertible with each other:
+// - ForgeToHex
+// - HexToForge
+// INFO forgeBuffer comes in as the raw result of forge methods (so is most likely a BinaryBuffer)
+function ForgeToHex(forgeBuffer) {
+    const hex = '';
+    console.log('[forge to string encoded]');
+    console.log(forgeBuffer);
+    // Transforming into a supported Buffer and then to hex string for portability
+    const rebuffer = buffer_1.Buffer.from(forgeBuffer);
+    forgeBuffer = rebuffer.toString('hex');
+    console.log('DECODED INTO:');
+    console.log('0x' + forgeBuffer);
+    return '0x' + forgeBuffer; // String
+}
+// INFO finalArray must come out as an acceptable input for forge methods
+function HexToForge(forgeString) {
+    forgeString = forgeString.slice(2);
+    // Preparing the Uint8Array to be used to revert the hex string
+    const finalArray = new Uint8Array(64);
+    console.log('[string to forge encoded]');
+    console.log(forgeString);
+    // Parsing the hex string into a Uint8Array by splitting it into 2-char chunks and parsing them into decimal values
+    for (let i = 0; i < forgeString.length; i += 2) {
+        const hexValue = forgeString.substr(i, 2);
+        const decimalValue = parseInt(hexValue, 16);
+        finalArray[i / 2] = decimalValue;
+    }
+    console.log('ENCODED INTO:');
+    console.log(finalArray);
+    return finalArray; // Uint8Array
+}
+//# sourceMappingURL=forge_converter.js.map

package/build/websdk/utils/forge_converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge_converter.js","sourceRoot":"","sources":["../../../../src/websdk/utils/forge_converter.ts"],"names":[],"mappings":"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"}

package/build/websdk/utils/required.d.ts

@@ -0,0 +1,21 @@
+/**
+ * INFO Small module to quickly implement a require-like method as seen in Solidity
+ * NOTE Either causes an exception or returns false if the requirement is not met.
+ *
+ * @author TheCookingSenpai
+ * @date 2/9/2023 - 04:15:18
+ *
+ * @param {any} value
+ * @param {boolean} is_fatal
+ * @returns {void | boolean}
+ */
+export declare function required(value: any, is_fatal?: boolean): void | boolean;
+/**
+ * Throw an error if a value is nullish
+ *
+ * @param {any} value The value to check
+ * @param {string} msg The help text on error
+ * @param {boolean} fatal should we raise an error? Default: `true`
+ *
+ */
+export declare function _required(value: any, msg?: string, fatal?: boolean): boolean;

package/build/websdk/utils/required.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._required = exports.required = void 0;
+/**
+ * INFO Small module to quickly implement a require-like method as seen in Solidity
+ * NOTE Either causes an exception or returns false if the requirement is not met.
+ *
+ * @author TheCookingSenpai
+ * @date 2/9/2023 - 04:15:18
+ *
+ * @param {any} value
+ * @param {boolean} is_fatal
+ * @returns {void | boolean}
+ */
+function required(value, is_fatal = true) {
+    if (!value) {
+        if (is_fatal) {
+            throw new Error('Value of ' + value + ' is required and failed');
+        }
+        else {
+            return false;
+        }
+    }
+    // Requirements are met
+    return true;
+}
+exports.required = required;
+/**
+ * Throw an error if a value is nullish
+ *
+ * @param {any} value The value to check
+ * @param {string} msg The help text on error
+ * @param {boolean} fatal should we raise an error? Default: `true`
+ *
+ */
+function _required(value, msg = 'Missing required element', fatal = true) {
+    // INFO: Copied from node repo
+    if (!value) {
+        if (fatal) {
+            throw new Error('[REQUIRED] ' + msg);
+        }
+        ;
+        return false;
+    }
+    return true;
+}
+exports._required = _required;
+//# sourceMappingURL=required.js.map

package/build/websdk/utils/required.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required.js","sourceRoot":"","sources":["../../../../src/websdk/utils/required.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAU,EAAE,WAAoB,IAAI;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,KAAK,GAAG,yBAAyB,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,uBAAuB;IACvB,OAAO,IAAI,CAAC;AACb,CAAC;AAVD,4BAUC;AAED;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAC,KAAU,EAAE,MAAc,0BAA0B,EAAE,QAAiB,IAAI;IACpG,8BAA8B;IAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAA;QACrC,CAAC;QAAA,CAAC;QAEF,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAZD,8BAYC"}

package/build/websdk/utils/sha256.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Hashes any string using crypto subtle
+ */
+export declare function sha256(string: string): Promise<string>;

package/build/websdk/utils/sha256.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256 = void 0;
+/**
+ * Hashes any string using crypto subtle
+ */
+async function sha256(string) {
+    const utf8 = new TextEncoder().encode(string);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', utf8);
+    const hashArray = Array.from(new Uint8Array(hashBuffer)); // FIXME Review if it's to change to buffer here
+    // sourcery skip: inline-immediately-returned-variable
+    const hashHex = hashArray
+        .map((bytes) => bytes.toString(16).padStart(2, '0'))
+        .join('');
+    return hashHex;
+}
+exports.sha256 = sha256;
+//# sourceMappingURL=sha256.js.map

package/build/websdk/utils/sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.js","sourceRoot":"","sources":["../../../../src/websdk/utils/sha256.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACI,KAAK,UAAU,MAAM,CAAE,MAAc;IAC1C,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA,CAAC,gDAAgD;IACzG,sDAAsD;IACtD,MAAM,OAAO,GAAG,SAAS;SACtB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACnD,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,OAAO,OAAO,CAAA;AAChB,CAAC;AATD,wBASC"}

package/build/websdk/utils/skeletons.d.ts

@@ -0,0 +1,37 @@
+import type { Transaction } from '../../types';
+import { EnumWeb2Methods } from '../../types/web2';
+declare const transaction: Transaction;
+declare const crosschain_operation: {
+    chain: null;
+    subchain: null;
+    is_evm: null;
+    rpc: null;
+    task: {
+        type: null;
+        params: {};
+        signedPayloads: never[];
+    };
+};
+declare const web2_request: {
+    raw: {
+        action: string;
+        parameters: never[];
+        requestedParameters: null;
+        method: EnumWeb2Methods;
+        url: string;
+        headers: null;
+        minAttestations: number;
+        stage: {
+            origin: {
+                identity: string;
+                connection_url: string;
+            };
+            hop_number: number;
+        };
+    };
+    result: null;
+    attestations: Map<any, any>;
+    hash: string;
+    signature: string;
+};
+export { crosschain_operation, transaction, web2_request };

package/build/websdk/utils/skeletons.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.web2_request = exports.transaction = exports.crosschain_operation = void 0;
+const web2_1 = require("../../types/web2");
+// TODO This should be a collection of classes now that we use TypeScript
+// FIXME ^
+// INFO An empty transaction
+const transaction = {
+    content: {
+        type: '', // string
+        from: '', // forge.pki.ed25519.BinaryBuffer
+        to: '', // forge.pki.ed25519.BinaryBuffer
+        amount: 0, // number
+        data: ['', ''], // [string, string] // type as string and content in hex string
+        nonce: 0, // number // Increments every time a transaction is sent from the same account
+        timestamp: 0, // number // Is the registered unix timestamp when the transaction was sent the first time
+        transaction_fee: {
+            network_fee: 0,
+            rpc_fee: 0,
+            additional_fee: 0,
+        },
+    },
+    signature: null, // pki.ed25519.BinaryBuffer
+    hash: '', // string
+    status: '', // string
+    blockNumber: null, // number
+};
+exports.transaction = transaction;
+// INFO An empty crosschain operation object
+const crosschain_operation = {
+    chain: null,
+    subchain: null,
+    is_evm: null,
+    rpc: null,
+    task: {
+        type: null,
+        params: {},
+        signedPayloads: [],
+    },
+    // signedPayloads: []
+};
+exports.crosschain_operation = crosschain_operation;
+// INFO An empty web2 request object
+const web2_request = {
+    raw: {
+        action: '',
+        parameters: [],
+        requestedParameters: null, // Means all
+        method: web2_1.EnumWeb2Methods.GET,
+        url: '',
+        headers: null,
+        minAttestations: 2,
+        // Handling the various stages of an IWeb2Request
+        stage: {
+            // The one that will handle the response too
+            origin: {
+                identity: '',
+                connection_url: '',
+            },
+            // Starting from 0, each attestation it is increased
+            hop_number: 0,
+        },
+    },
+    result: null,
+    attestations: new Map(),
+    hash: '',
+    signature: '',
+};
+exports.web2_request = web2_request;
+//# sourceMappingURL=skeletons.js.map

package/build/websdk/utils/skeletons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletons.js","sourceRoot":"","sources":["../../../../src/websdk/utils/skeletons.ts"],"names":[],"mappings":";;;AACA,uCAA8C;AAC9C,yEAAyE;AACzE,UAAU;AAEV,4BAA4B;AAC5B,MAAM,WAAW,GAAgB;IAC7B,OAAO,EAAE;QACL,IAAI,EAAE,EAAE,EAAE,SAAS;QACnB,IAAI,EAAE,EAAE,EAAE,iCAAiC;QAC3C,EAAE,EAAE,EAAE,EAAE,iCAAiC;QACzC,MAAM,EAAE,CAAC,EAAE,SAAS;QACpB,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,+DAA+D;QAC/E,KAAK,EAAE,CAAC,EAAE,8EAA8E;QACxF,SAAS,EAAE,CAAC,EAAE,0FAA0F;QACxG,eAAe,EAAE;YACb,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;YACV,cAAc,EAAE,CAAC;SACpB;KACJ;IACD,SAAS,EAAE,IAAI,EAAE,2BAA2B;IAC5C,IAAI,EAAE,EAAE,EAAE,SAAS;IACnB,MAAM,EAAE,EAAE,EAAE,SAAS;IACrB,WAAW,EAAE,IAAI,EAAE,SAAS;CAC/B,CAAA;AA2C8B,kCAAW;AAzC1C,4CAA4C;AAC5C,MAAM,oBAAoB,GAAG;IACzB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;IACT,IAAI,EAAE;QACF,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,EAAE;KACrB;IACD,qBAAqB;CACxB,CAAA;AA6BQ,oDAAoB;AA3B7B,oCAAoC;AACpC,MAAM,YAAY,GAAG;IACjB,GAAG,EAAE;QACD,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,EAAE;QACd,mBAAmB,EAAE,IAAI,EAAE,YAAY;QACvC,MAAM,EAAE,sBAAe,CAAC,GAAG;QAC3B,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,CAAC;QAClB,iDAAiD;QACjD,KAAK,EAAE;YACH,4CAA4C;YAC5C,MAAM,EAAE;gBACJ,QAAQ,EAAE,EAAE;gBACZ,cAAc,EAAE,EAAE;aACrB;YACD,oDAAoD;YACpD,UAAU,EAAE,CAAC;SAChB;KACJ;IACD,MAAM,EAAE,IAAI;IACZ,YAAY,EAAE,IAAI,GAAG,EAAE;IACvB,IAAI,EAAE,EAAE;IACR,SAAS,EAAE,EAAE;CAChB,CAAA;AAE2C,oCAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynesyslabs/demosdk",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "author": "Kynesys Labs",
@@ -12,6 +12,7 @@
   "exports": {
     ".": "./build/index.js",
     "./types": "./build/types/index.js",
+    "./websdk": "./build/websdk/index.js",
     "./xm-websdk": "./build/multichain/websdk/index.js",
     "./xm-localsdk": "./build/multichain/localsdk/index.js"
   },
@@ -27,6 +28,7 @@
     "@multiversx/sdk-extension-provider": "^3.0.0",
     "@multiversx/sdk-network-providers": "^2.4.3",
     "@multiversx/sdk-wallet": "^4.4.0",
+    "@solana/web3.js": "^1.91.7",
     "ethers": "^6.11.1",
     "node-forge": "^1.3.1",
     "socket.io-client": "^4.7.2",