@witnet/sdk 1.0.1 → 1.0.4

package/.env_witnet

@@ -1,6 +1,6 @@
-### witnet-toolkit
-WITNET_SDK_PROVIDER_URL=
-WITNET_SDK_RADON_ASSETS_PATH=
-WITNET_SDK_WALLET_MASTER_KEY=
-WITNET_SDK_FARM_NODES=
-
+### witnet-toolkit
+WITNET_SDK_PROVIDER_URL=
+WITNET_SDK_RADON_ASSETS_PATH=
+WITNET_SDK_WALLET_MASTER_KEY=
+WITNET_SDK_FARM_NODES=
+

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2023 The Witnet Project
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2023 The Witnet Project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,103 +1,103 @@
-# @witnet/sdk
-
-Interact with the Witnet network without needing to run a Witnet node of your own. Manage and stake your wits. Build and test out your own Witnet-compliant parameterized data requests before asking the Wit/Oracle to attest and forever store results into the Wit/Oracle blockchain.
-
-## Package install
-
-`$ npm install --save-dev @witnet/sdk`
-
-## JS/TS libraries
-### Import clauses
-```javascript
-const Witnet = require('@witnet/sdk')
-const { RadonRequest, Wallet, Utils } from '@witnet/sdk'
-```
-### Usage exmpales
-#### Managing Radon Requests
-```
-const Witnet = require("@witnet/sdk")
-
-// Example 1: CCDR for getting transaction details on a foreign EVM-chain
-const ccdr = Witnet.RadonRetrievals.CrossChainRPC({
-    rpc: Witnet.RadonRetrievals.RPCs.ETH.getTransactionByHash("\\1\\"),
-    script: Witnet.RadonScript().parseJSONMap()
-})
-const template = new Witnet.RadonTemplate({
-    retrieve: ccdr.spawnRetrievals(
-        "https://polygon-amoy.gateway.tenderly.co",
-        "https://rpc.ankr.com/polygon_amoy",
-        "https://polygon-amoy-bor-rpc.publicnode.com",    
-    ),
-    aggregate: Witnet.RadonReducers.Mode(),
-    tally: Witnet.RadonReducers.Mode(),
-});
-const request = template.buildRequestModal("0xfc3c17407f788c075483b0ad5383b1d5e6fbdc7ba500b08397c80423755c5eba")
-
-// Example 2: Compose a regular randomness request
-const request = new Witnet.RadonRequest({
-    retrieve: Witnet.RadonRetrievals.RNG(),
-    tally: Witnet.RadonReducers.ConcatHash(),
-}) 
-
-// Example 3: Leverage a pre-built price feed from the WF's pricefeeds repository
-const assets = require('witnet-feeds')
-const request = assets.legacy.requests.price.crypto.WitOracleRequestPriceAvaxUsd6;
-
-// Example 4: Get WSB addresses on "conflux:core:mainnet"
-const addresses = assets.getAddresses("conflux:core:mainnet")
-
-// Example 5: Serialize a RadonRequest into a hexified buffer
-const hexString = request.toBytecode()
-
-// Example 6: Convert RadonRequest into Witnet-compliant protobuf object
-const protobuf = request.toProtobuf()
-
-// Example 7: Stringify a Witnet-compliant script
-console.info(request.retrieve[0].script.toString())
-
-// Example 8: Decode hexified bytecode into a RadonRequest
-const request = Witnet.RadonRequest.from(hexString)
-
-// Example 9: Get result of dry running a RadonRequest, locally
-const result = JSON.parse(await request.execDryRun())
-```
-#### Interacting with the Witnet network
-#### Sending a Data Request to the Witnet network
-
----
-## CLI binaries
-
-### Optional environment constiables
-```
-WITNET_SDK_WALLET_MASTER_KEY=
-WITNET_SDK_PROVIDER_URL=
-WITNET_TOOLKIT_REPORTER_URL=
-```
-
-### General-purpose usage
-```
-$ npx witnet
-USAGE:
-    npx witnet [FLAGS] <COMMAND>
-
-FLAGS:
-    --help      Describes command or subcommand usage
-    --update    Forces update of underlying binaries
-    --version   Prints toolkit name and version as first line
-
-COMMANDS:
-    fetch     Fetch public data from the Wit/Oracle blockchain.
-    history   Aggregated historical data from the Wit/Oracle blockchain.
-    network   Current information about the Wit/Oracle P2P network.
-    node      Interact with private Wit/Oracle nodes, if reachable.
-    radon     Manage Radon requests and templates within your project.
-    wallet    Simple CLI wallet for spending and staking your Wits.
-```
-### Setting up your own Radon assets workspace
-``` 
-$ npx witnet radon init
-...
-
-$ npx witnet radon
-...
-```
+# @witnet/sdk
+
+Interact with the Witnet network without needing to run a Witnet node of your own. Manage and stake your wits. Build and test out your own Witnet-compliant parameterized data requests before asking the Wit/Oracle to attest and forever store results into the Wit/Oracle blockchain.
+
+## Package install
+
+`$ npm install --save-dev @witnet/sdk`
+
+## JS/TS libraries
+### Import clauses
+```javascript
+const Witnet = require('@witnet/sdk')
+const { RadonRequest, Wallet, Utils } from '@witnet/sdk'
+```
+### Usage exmpales
+#### Managing Radon Requests
+```
+const Witnet = require("@witnet/sdk")
+
+// Example 1: CCDR for getting transaction details on a foreign EVM-chain
+const ccdr = Witnet.RadonRetrievals.CrossChainRPC({
+    rpc: Witnet.RadonRetrievals.RPCs.ETH.getTransactionByHash("\\1\\"),
+    script: Witnet.RadonScript().parseJSONMap()
+})
+const template = new Witnet.RadonTemplate({
+    retrieve: ccdr.spawnRetrievals(
+        "https://polygon-amoy.gateway.tenderly.co",
+        "https://rpc.ankr.com/polygon_amoy",
+        "https://polygon-amoy-bor-rpc.publicnode.com",    
+    ),
+    aggregate: Witnet.RadonReducers.Mode(),
+    tally: Witnet.RadonReducers.Mode(),
+});
+const request = template.buildRequestModal("0xfc3c17407f788c075483b0ad5383b1d5e6fbdc7ba500b08397c80423755c5eba")
+
+// Example 2: Compose a regular randomness request
+const request = new Witnet.RadonRequest({
+    retrieve: Witnet.RadonRetrievals.RNG(),
+    tally: Witnet.RadonReducers.ConcatHash(),
+}) 
+
+// Example 3: Leverage a pre-built price feed from the WF's pricefeeds repository
+const assets = require('witnet-feeds')
+const request = assets.legacy.requests.price.crypto.WitOracleRequestPriceAvaxUsd6;
+
+// Example 4: Get WSB addresses on "conflux:core:mainnet"
+const addresses = assets.getAddresses("conflux:core:mainnet")
+
+// Example 5: Serialize a RadonRequest into a hexified buffer
+const hexString = request.toBytecode()
+
+// Example 6: Convert RadonRequest into Witnet-compliant protobuf object
+const protobuf = request.toProtobuf()
+
+// Example 7: Stringify a Witnet-compliant script
+console.info(request.retrieve[0].script.toString())
+
+// Example 8: Decode hexified bytecode into a RadonRequest
+const request = Witnet.RadonRequest.from(hexString)
+
+// Example 9: Get result of dry running a RadonRequest, locally
+const result = JSON.parse(await request.execDryRun())
+```
+#### Interacting with the Witnet network
+#### Sending a Data Request to the Witnet network
+
+---
+## CLI binaries
+
+### Optional environment constiables
+```
+WITNET_SDK_WALLET_MASTER_KEY=
+WITNET_SDK_PROVIDER_URL=
+WITNET_TOOLKIT_REPORTER_URL=
+```
+
+### General-purpose usage
+```
+$ npx witnet
+USAGE:
+    npx witnet [FLAGS] <COMMAND>
+
+FLAGS:
+    --help      Describes command or subcommand usage
+    --update    Forces update of underlying binaries
+    --version   Prints toolkit name and version as first line
+
+COMMANDS:
+    fetch     Fetch public data from the Wit/Oracle blockchain.
+    history   Aggregated historical data from the Wit/Oracle blockchain.
+    network   Current information about the Wit/Oracle P2P network.
+    node      Interact with private Wit/Oracle nodes, if reachable.
+    radon     Manage Radon requests and templates within your project.
+    wallet    Simple CLI wallet for spending and staking your Wits.
+```
+### Setting up your own Radon assets workspace
+``` 
+$ npx witnet radon init
+...
+
+$ npx witnet radon
+...
+```

package/dist/bin/helpers.d.ts

@@ -0,0 +1,88 @@
+declare function bblue(str: any): string;
+declare function bcyan(str: any): string;
+declare function bgreen(str: any): string;
+declare function bred(str: any): string;
+declare function bviolet(str: any): string;
+declare function cyan(str: any): string;
+declare function gray(str: any): string;
+declare function green(str: any): string;
+declare function magenta(str: any): string;
+declare function red(str: any): string;
+declare function white(str: any): string;
+declare function yellow(str: any): string;
+declare function normal(str: any): string;
+declare function lcyan(str: any): string;
+declare function lgray(str: any): string;
+declare function lgreen(str: any): string;
+declare function lmagenta(str: any): string;
+declare function lyellow(str: any): string;
+declare function mcyan(str: any): string;
+declare function mgreen(str: any): string;
+declare function mmagenta(str: any): string;
+declare function mred(str: any): string;
+declare function myellow(str: any): string;
+export function colorstrip(str: any): any;
+export function commas(number: any): string;
+export function whole_wits(number: any, digits: any): any;
+export function toFixedTrunc(x: any, n: any): any;
+export function fromNanowits(x: any, d: any): string;
+export function fromWits(x: any): number;
+export function countLeaves(t: any, obj: any): any;
+export function execRadonBytecode(bytecode: any, ...flags: any[]): Promise<any>;
+export function deleteExtraFlags(args: any): any;
+export function extractFromArgs(args: any, flags: any): any[];
+export function fromHexString(hexString: any): Uint8Array<ArrayBuffer>;
+export function isHexString(str: any): boolean;
+export function isHexStringOfLength(str: any, length: any): any;
+export function toHexString(buffer: any, prefix0x?: boolean): string;
+export function parseURL(url: any): string[];
+export function ipIsPrivateOrLocalhost(ip: any): boolean;
+export function showUsage(cmd: any, module: any): void;
+export function showUsageError(cmd: any, subcmd: any, module: any, flags: {} | undefined, error: any): void;
+export function showUsageSubcommand(cmd: any, subcmd: any, module: any): void;
+export function showVersion(): void;
+export function toolkitRun(settings: any, args: any): Promise<any>;
+export function toUpperCamelCase(str: any): any;
+export function toUtf8Array(str: any): any[];
+export function utf8ArrayToStr(array: any): string;
+export function prompt(question: any): Promise<any>;
+export function prompter(promise: any): Promise<any>;
+export function traceChecklists(checklists: any): void;
+export function traceHeader(headline: any, color?: (str: any) => string, indent?: string): void;
+export function traceTable(records: any, options: any): void;
+export function traceTransaction(transmitter: any, options: any): Promise<any>;
+export function traceTransactionOnStatusChange(receipt: any): void;
+export function traceTransactionOnCheckpoint(receipt: any): void;
+export function traceTransactionReceipt(receipt: any): void;
+export function isWildcard(str: any): boolean;
+export function getWildcardsCountFromString(str: any): number;
+export function replaceWildcards(obj: any, args: any): any;
+export function spliceWildcard(obj: any, argIndex: any, argValue: any, argsCount: any): any;
+export function txJsonReplacer(key: any, value: any): any;
+export declare namespace colors {
+    export { bblue };
+    export { bcyan };
+    export { bgreen };
+    export { bred };
+    export { bviolet };
+    export { cyan };
+    export { gray };
+    export { green };
+    export { magenta };
+    export { red };
+    export { white };
+    export { yellow };
+    export { normal };
+    export { lcyan };
+    export { lgray };
+    export { lgreen };
+    export { lmagenta };
+    export { lyellow };
+    export { mcyan };
+    export { mgreen };
+    export { mmagenta };
+    export { mred };
+    export { myellow };
+}
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/bin/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/bin/helpers.js"],"names":[],"mappings":"AA4CA,yCAAuD;AACvD,yCAAmD;AACnD,0CAAoD;AACpD,wCAAkD;AAClD,2CAAqD;AAerD,wCAA6C;AAC7C,wCAA6C;AAC7C,yCAA8C;AAC9C,2CAAkD;AAElD,uCAA4C;AAC5C,yCAAgD;AAChD,0CAA+C;AAH/C,0CAA+C;AAjB/C,yCAAgD;AAChD,yCAAgD;AAChD,0CAAiD;AACjD,4CAAmD;AACnD,2CAAkD;AAElD,yCAA8C;AAC9C,0CAA+C;AAC/C,4CAAmD;AACnD,wCAA6C;AAC7C,2CAAgD;AAtDhD,0CAEC;AAED,4CAMC;AAcD,0DAYC;AArBD,kDAOC;AAVD,qDAAsE;AACtE,yCAA2D;AAqD3D,mDAKC;AAoBD,gFAgBC;AAlCD,iDAEC;AAkCD,8DAsBC;AAED,uEAGC;AAwDD,+CAQC;AAjBD,gEAOC;AAYD,qEAMC;AAED,6CAYC;AApFD,yDA2CC;AA2CD,uDAKC;AAaD,4GAUC;AAwED,8EAKC;AAED,oCAEC;AAoDD,mEAaC;AAED,gDAIC;AAED,6CA6BC;AAED,mDA8BC;AAED,oDAWC;AAED,qDAgBC;AAED,uDAoBC;AAED,gGAIC;AAED,6DA8DC;AA2ED,+EAoCC;AAnFD,mEAkBC;AAxBD,iEAIC;AAsBD,4DAyBC;AA1TD,8CAEC;AAhBD,8DAWC;AAOD,2DAcC;AAED,4FAcC;AAyND,0DAUC"}