@kynesyslabs/demosdk 1.0.4 → 1.0.6

package/README.md

@@ -1,48 +1,50 @@
-# DEMOS SDKs
+# @kynesyslabs/demosdk
 
-This repo contains all the Demos SDKs
+Demos SDKs metapackage
 
-## Usage
-
-### Core
-
-TODO: Update once ported.
-
-### Multichain SDKs
+### Multichain SDKs Usage
 
 Check out the [multichain documentation](./documentation/multichain/README.md).
 
-## Organization
 
-The packages are structured like this:
+### Adding stuff
 
-```sh
-./src
-├── core # blockchain interface stuff <todo: port from frontend>
-│
-├── types # shared types
-│
-├── multichain
-│   ├── core     # default chain sdk implementation for all chains
-│   ├── localsdk # local sdks for all chains
-│   └── websdk   # web sdks for all chains
+Create a new folder in the `src` directory and add your stuff. Export items on the `index.ts` file in your new folder. Then add an export entry in `package.json` as shown:
+
+```json
+"exports": {
+    // ...
+    "./stuff": "./build/stuff/index.js"
+}
 ```
 
-## Development setup
-```sh
-yarn install
+This will allow users to use the new things as follows:
+
+```js
+import { Stuff, otherStuff } from '@kynesyslabs/demosdk/stuff'
 ```
 
-## Running tests
+### Running tests
 
 ```sh
 # multichain
 yarn test:multichain
 ```
 
-## Publishing on NPM
+### Publishing on NPM
+
+Publishing to NPM is automated using a Github Workflow. To publish a new version:
+
+1. Incrememt the `package.json` version field
+2. Commit your changes with a message starting with the word `release`
+3. Push to Github.
+
+```sh
+# Example:
+git commit -m "release v1.0.5"
+```
 
-TODO!
+The commit will trigger a workflow run to build the files and publish a new version on NPM.
 
 ## What has Changed?
 
@@ -56,4 +58,3 @@ new: `rpc_url`, `chain_id`, `isEIP1559`
 ## TODOs
 
 -   Review `getBalance` return type. Should it be a string or an object?
--

package/build/types/Operation.d.ts

@@ -2,10 +2,20 @@ import { TxFee } from "./TxFee";
 export interface Operation {
     operator: string;
     actor: string;
-    params: {};
+    params: any;
     hash: string;
     nonce: number;
     timestamp: number;
     status: boolean | "pending";
     fees: TxFee;
 }
+export interface OperationResult {
+    success: boolean;
+    message: string;
+}
+export interface OperationRegistrySlot {
+    operation: Operation;
+    status: boolean | "pending";
+    result: OperationResult;
+    timestamp: number;
+}

package/build/types/StateChange.d.ts

@@ -0,0 +1,19 @@
+import forge from "node-forge";
+interface TokenTransfer {
+    address: string;
+    amount: number;
+}
+interface NFTTransfer {
+    address: string;
+    tokenId: string;
+    amount: number;
+}
+export interface StateChange {
+    sender: forge.pki.ed25519.BinaryBuffer;
+    receiver: forge.pki.ed25519.BinaryBuffer;
+    nativeAmount: number;
+    tx_hash: string;
+    token: TokenTransfer;
+    nft: NFTTransfer;
+}
+export {};

package/build/types/StateChange.js

@@ -0,0 +1,13 @@
+"use strict";
+/* LICENSE
+
+© 2023 by KyneSys Labs, licensed under CC BY-NC-ND 4.0
+
+Full license text: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+Human readable license: https://creativecommons.org/licenses/by-nc-nd/4.0/
+
+KyneSys Labs: https://www.kynesys.xyz/
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=StateChange.js.map

package/build/types/StateChange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateChange.js","sourceRoot":"","sources":["../../../src/types/StateChange.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE"}

package/build/types/Transaction.d.ts

@@ -1,6 +1,16 @@
 import { ISignature } from "./ISignature";
-import { TransactionContent } from "./TransactionContent";
 import * as forge from "node-forge";
+import { TxFee } from "./TxFee";
+export interface TransactionContent {
+    type: string;
+    from: forge.pki.ed25519.BinaryBuffer | forge.pki.PublicKey | ISignature;
+    to: forge.pki.ed25519.BinaryBuffer | forge.pki.PrivateKey | ISignature;
+    amount: number;
+    data: [string, string];
+    nonce: number;
+    timestamp: number;
+    transaction_fee: TxFee;
+}
 export interface Transaction {
     content: TransactionContent;
     signature: ISignature | forge.pki.ed25519.BinaryBuffer;

package/build/types/TransactionContent.d.ts

@@ -1,13 +1 @@
-import forge from 'node-forge';
-import { TxFee } from './TxFee';
-import { ISignature } from './ISignature';
-export interface TransactionContent {
-    type: string;
-    from: forge.pki.ed25519.BinaryBuffer | forge.pki.PublicKey | ISignature;
-    to: forge.pki.ed25519.BinaryBuffer | forge.pki.PrivateKey | ISignature;
-    amount: number;
-    data: [string, string];
-    nonce: number;
-    timestamp: number;
-    transaction_fee: TxFee;
-}
+export {};

package/build/types/addressInfo.d.ts

@@ -0,0 +1,6 @@
+import { StatusNative } from "./statusNative";
+import { statusNative as StatusProperties } from "./statusProperties";
+export default interface AddressInfo {
+    native: StatusNative | null;
+    properties: StatusProperties | null;
+}

package/build/types/addressInfo.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=addressInfo.js.map

package/build/types/addressInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressInfo.js","sourceRoot":"","sources":["../../../src/types/addressInfo.ts"],"names":[],"mappings":""}

package/build/types/blocks.d.ts

@@ -0,0 +1,7 @@
+export interface BlockContent {
+    ordered_transactions: string[];
+    per_address_transactions: Map<string, string[]>;
+    web2data: {};
+    previousHash: string;
+    timestamp: number;
+}

package/build/types/blocks.js

@@ -0,0 +1,13 @@
+"use strict";
+/* LICENSE
+
+© 2023 by KyneSys Labs, licensed under CC BY-NC-ND 4.0
+
+Full license text: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+Human readable license: https://creativecommons.org/licenses/by-nc-nd/4.0/
+
+KyneSys Labs: https://www.kynesys.xyz/
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=blocks.js.map

package/build/types/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/types/blocks.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE"}

package/build/types/communication/transmit.d.ts

@@ -0,0 +1,14 @@
+export interface BundleContent {
+    type: string;
+    message: string;
+    sender: any;
+    receiver: any;
+    timestamp: number;
+    data: any;
+    extra: string;
+}
+export interface Bundle {
+    content: BundleContent;
+    hash: string;
+    signature: any;
+}

package/build/types/communication/transmit.js

@@ -0,0 +1,13 @@
+"use strict";
+/* LICENSE
+
+© 2023 by KyneSys Labs, licensed under CC BY-NC-ND 4.0
+
+Full license text: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+Human readable license: https://creativecommons.org/licenses/by-nc-nd/4.0/
+
+KyneSys Labs: https://www.kynesys.xyz/
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transmit.js.map

package/build/types/communication/transmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmit.js","sourceRoot":"","sources":["../../../../src/types/communication/transmit.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE"}

package/build/types/genesisTypes.d.ts

@@ -0,0 +1,29 @@
+export interface GenesisImmutableProperties {
+    id: number;
+    name: string;
+    currency: string;
+}
+export interface GenesisMutableProperties {
+    minBlocksForValidationOnlineStatus: number;
+}
+export interface GenesisArtifact {
+    properties: GenesisImmutableProperties;
+    mutables: GenesisMutableProperties;
+    balances: [[address: string, amount: string]];
+    timestamp: number;
+    previous_genesis_hash: string;
+    previous_block_hash: string;
+    signature: string;
+    hash: string;
+    number: number;
+}
+export interface StandardGenesis {
+    properties: GenesisImmutableProperties;
+    mutables: GenesisMutableProperties;
+    balances: [[address: string, amount: string]];
+    timestamp: number;
+}
+export interface forkGenesis extends StandardGenesis {
+    previous_genesis_hash: string;
+    previous_block_hash: string;
+}

package/build/types/genesisTypes.js

@@ -0,0 +1,4 @@
+"use strict";
+// SECTION Primitives
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=genesisTypes.js.map

package/build/types/genesisTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesisTypes.js","sourceRoot":"","sources":["../../../src/types/genesisTypes.ts"],"names":[],"mappings":";AAAA,qBAAqB"}

package/build/types/index.d.ts

@@ -1,6 +1,16 @@
-export { ISignature } from './ISignature';
-export { Operation } from './Operation';
-export { Transaction } from './Transaction';
-export { TransactionContent } from './TransactionContent';
+export { GenesisArtifact, GenesisImmutableProperties, GenesisMutableProperties, StandardGenesis, forkGenesis, } from './genesisTypes';
 export { TxFee } from './TxFee';
+export { BlockContent } from './blocks';
+export { ISignature } from './ISignature';
+export { StateChange } from './StateChange';
 export { ValidityData } from './ValidityData';
+export { RawTransaction } from './rawTransaction';
+export { Bundle, BundleContent } from './communication/transmit';
+export { Transaction, TransactionContent } from './Transaction';
+export { StatusNative } from './statusNative';
+export { statusNative as StatusProperties } from './statusProperties';
+export { Operation, OperationRegistrySlot, OperationResult } from './Operation';
+export { ISecurityReport, SIComlink, SIResponseRegistry, } from './network/SecurityTypes';
+export { ExecutionResult } from './network/ExecutionResult';
+export { IPeerConfig } from './peers/Peer';
+export { IParam, IWeb2Payload, IWeb2Request, IWeb2Result, IRawWeb2Request, IWeb2Attestation, } from './web2';

package/build/types/network/ExecutionResult.d.ts

@@ -0,0 +1,7 @@
+import { Operation } from "../Operation";
+export interface ExecutionResult {
+    response: any;
+    extra: any;
+    require_reply: boolean;
+    operations?: Operation[];
+}

package/build/types/network/ExecutionResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ExecutionResult.js.map

package/build/types/network/ExecutionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionResult.js","sourceRoot":"","sources":["../../../../src/types/network/ExecutionResult.ts"],"names":[],"mappings":""}

package/build/types/network/SecurityTypes.d.ts

@@ -0,0 +1,15 @@
+export interface ISecurityReport {
+    state: boolean;
+    code: string;
+    message: string;
+}
+export interface SIResponseRegistry {
+    prune_interval: number;
+}
+export interface SIComlink {
+    rate_limit_size: number;
+    rate_limit_time: number;
+    rate_limit_bin: number;
+    rate_limit_timestamp: number;
+    checkRateLimits: Function;
+}

package/build/types/network/SecurityTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SecurityTypes.js.map

package/build/types/network/SecurityTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityTypes.js","sourceRoot":"","sources":["../../../../src/types/network/SecurityTypes.ts"],"names":[],"mappings":""}

package/build/types/peers/Peer.d.ts

@@ -0,0 +1,6 @@
+import { Socket } from "socket.io-client";
+export interface IPeerConfig {
+    connectionString?: string;
+    socket?: Socket;
+    identity?: string;
+}

package/build/types/peers/Peer.js

@@ -0,0 +1,13 @@
+"use strict";
+/* LICENSE
+
+© 2023 by KyneSys Labs, licensed under CC BY-NC-ND 4.0
+
+Full license text: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+Human readable license: https://creativecommons.org/licenses/by-nc-nd/4.0/
+
+KyneSys Labs: https://www.kynesys.xyz/
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Peer.js.map

package/build/types/peers/Peer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Peer.js","sourceRoot":"","sources":["../../../../src/types/peers/Peer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE"}

package/build/types/rawTransaction.d.ts

@@ -0,0 +1,16 @@
+export interface RawTransaction {
+    blockNumber: number;
+    signature: string;
+    status: string;
+    hash: string;
+    content: NonNullable<string>;
+    type: string;
+    from: any;
+    to: any;
+    amount: number;
+    nonce: number;
+    timestamp: number;
+    networkFee: number;
+    rpcFee: number;
+    additionalFee: number;
+}

package/build/types/rawTransaction.js

@@ -0,0 +1,13 @@
+"use strict";
+/* LICENSE
+
+© 2023 by KyneSys Labs, licensed under CC BY-NC-ND 4.0
+
+Full license text: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+Human readable license: https://creativecommons.org/licenses/by-nc-nd/4.0/
+
+KyneSys Labs: https://www.kynesys.xyz/
+
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rawTransaction.js.map

package/build/types/rawTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawTransaction.js","sourceRoot":"","sources":["../../../src/types/rawTransaction.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE"}

package/build/types/statusNative.d.ts

@@ -0,0 +1,6 @@
+export interface StatusNative {
+    address: string;
+    balance: number;
+    nonce: number;
+    tx_list: string;
+}

package/build/types/statusNative.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=statusNative.js.map

package/build/types/statusNative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusNative.js","sourceRoot":"","sources":["../../../src/types/statusNative.ts"],"names":[],"mappings":""}

package/build/types/statusProperties.d.ts

@@ -0,0 +1,8 @@
+export interface statusNative {
+    address: string;
+    tokens: string;
+    nfts: string;
+    xm: string;
+    web2: string;
+    other: string;
+}

package/build/types/statusProperties.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=statusProperties.js.map

package/build/types/statusProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusProperties.js","sourceRoot":"","sources":["../../../src/types/statusProperties.ts"],"names":[],"mappings":""}

package/build/types/web2/index.d.ts

@@ -0,0 +1,49 @@
+import forge from "node-forge";
+export interface IParam {
+    name: string;
+    value: any;
+}
+export interface IWeb2Payload {
+    type: "web2Request";
+    message: IWeb2Request;
+    sender: any;
+    receiver: any;
+    timestamp: any;
+    data: any;
+    extra: any;
+}
+export interface IWeb2Result {
+    status: number;
+    statusText: string;
+    data: any;
+}
+export interface IWeb2Request {
+    raw: IRawWeb2Request;
+    result: any;
+    attestations: {};
+    hash: string;
+    signature?: forge.pki.ed25519.BinaryBuffer;
+}
+export interface IRawWeb2Request {
+    action: string;
+    parameters: IParam[];
+    requestedParameters: [] | null;
+    method: "POST" | "GET" | "PUT" | "DELETE" | "PATCH";
+    url: string;
+    headers: any;
+    minAttestations: number;
+    stage: {
+        origin: {
+            identity: forge.pki.ed25519.BinaryBuffer;
+            connection_url: string;
+        };
+        hop_number: number;
+    };
+}
+export interface IWeb2Attestation {
+    hash: string;
+    timestamp: number;
+    identity: forge.pki.PublicKey;
+    signature: forge.pki.ed25519.BinaryBuffer;
+    valid: boolean;
+}

package/build/types/web2/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/build/types/web2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/web2/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynesyslabs/demosdk",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "author": "Kynesys Labs",
@@ -29,6 +29,7 @@
     "@multiversx/sdk-wallet": "^4.4.0",
     "ethers": "^6.11.1",
     "node-forge": "^1.3.1",
+    "socket.io-client": "^4.7.2",
     "xrpl": "^3.0.0"
   },
   "devDependencies": {