@witnet/sdk 1.2.7 → 3.0.0

package/.env_witnet

@@ -1,19 +1,19 @@
-### @witnet/sdk
-WITNET_SDK_FARM_NODES=
-WITNET_SDK_KERMIT_URL
-WITNET_SDK_PROVIDER_URL=
-WITNET_SDK_RADON_ASSETS_PATH=
-WITNET_SDK_WALLET_MASTER_KEY=
-
-### @witnet/sdk watcher
-WITNET_SDK_WATCHER_BALANCE_SCHEDULE=
-WITNET_SDK_WATCHER_DRY_RUN_SCHEDULE=
-WITNET_SDK_WATCHER_WIT_COOLDOWN_SECS=
-WITNET_SDK_WATCHER_WIT_DEVIATION_PERCENTAGE=
-WITNET_SDK_WATCHER_WIT_HEARTBEAT_SECS=
-WITNET_SDK_WATCHER_WIT_MIN_BALANCE=
-WITNET_SDK_WATCHER_WIT_NETWORK=
-WITNET_SDK_WATCHER_WIT_NETWORK_PRIORITY=
-WITNET_SDK_WATCHER_WIT_RADON_REQUEST=
-WITNET_SDK_WATCHER_WIT_SIGNER=
+### @witnet/sdk
+WITNET_SDK_FARM_NODES=
+WITNET_SDK_KERMIT_URL
+WITNET_SDK_PROVIDER_URL=
+WITNET_SDK_RADON_ASSETS_PATH=
+WITNET_SDK_WALLET_MASTER_KEY=
+
+### @witnet/sdk watcher
+WITNET_SDK_WATCHER_BALANCE_SCHEDULE=
+WITNET_SDK_WATCHER_DRY_RUN_SCHEDULE=
+WITNET_SDK_WATCHER_WIT_COOLDOWN_SECS=
+WITNET_SDK_WATCHER_WIT_DEVIATION_PERCENTAGE=
+WITNET_SDK_WATCHER_WIT_HEARTBEAT_SECS=
+WITNET_SDK_WATCHER_WIT_MIN_BALANCE=
+WITNET_SDK_WATCHER_WIT_NETWORK=
+WITNET_SDK_WATCHER_WIT_NETWORK_PRIORITY=
+WITNET_SDK_WATCHER_WIT_RADON_REQUEST=
+WITNET_SDK_WATCHER_WIT_SIGNER=
 WITNET_SDK_WATCHER_WIT_WITNESSES=

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 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) 2025 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,116 +1,116 @@
-# Witnet Javascript SDK and CLI tools
-
-> Typescript library and CLI tooling for Web3 buidlers willing to interact with the Witnet blockchain.
-> The **Witnet Javascript SDK** empowers devops and Web3 developers to seamlessly interact with the Witnet blockchain.
-
-## ✨ Overview
-
-Users of the Witnet Javascript library or the embedded CLI tools, will be able to:
-
-- 👛 Create self-custody HD-wallets to hold and transact with $WIT coins.
-- 🌱 Stake and withdraw $WIT coins into and from Witnet validators.
-- 🧮 Build oracle queries adapted to all sorts of data sources and use cases.
-- 🩺 Simulate resolution of oracle queries, locally and at no cost.
-- 🧑‍⚖️ Notarize resolution of oracle queries on the Witnet blockchain.
-- ⛓️ Check dynamic information on the Witnet P2P network.
-- 🔎 Explore public data on the Witnet blockchain.
-- 🪪 Generate legit stake-authorization codes for external customers.
-
-## 📦 Installation
-
-### CLI as a global binary
-Install the `witsdk` binary:
-```bash
-$ npm install -g @witnet/sdk
-$ witsdk --version
-```
-
-### SDK as project dependency
-- Add the @witnet/sdk package to your project:
-```bash
-$ npm install --save-dev @witnet/sdk`
-```
-- Import from Javascript:
-```javascript
-const { requests, modals } = require("@witnet/sdk/assets")
-const { utils, Witnet } = require("@witnet/sdk")
-```
-- Import from Typescript:
-```typescript
-import { requests, modals } from "@witnet/sdk/assets"
-import { utils, Witnet } from "@witnet/sdk"
-```
-
-## ⚙️ Requirements
-- Node.js >= 20.
-- Witnet wallet with sufficient $WIT balance.
-
-## 🔧 Configuration
-Both the CLI and the library can be configured by using a **.env** file declaring this variable:
-```bash
-WITNET_SDK_WALLET_MASTER_KEY="xprv_string_here_as_exported_from_a_node_mww_or_sheikah"
-```
-
-You can optionally:
-- Settle your preferred WIT/RPC provider, like a Witnet node of your own, or third-party providers, by using the command-line option `--provider` (if using the CLI), or by setting the `WITNET_SDK_PROVIDER_URL` environment variable.
-
-## 🧪 Supported Networks
-| Witnet Network | Network id | WIT/RPC endpoints |
-| -: | :-: | :- 
-| Mainnet | `0x9fed` | https://rpc-01.witnet.io
-| Testnet | `0x749f` | https://rpc-testnet.witnet.io
-
-## 🛠️ Usage
-
-### Library modules
-
-> *Please, find Javascript and Typescript code snippets in the [Witnet Docs site](https://docs.witnet.io/witnet-sdk/how-to-guides).*
-
-### CLI modules
-
----
-#### `npx witsdk network`
-Retrieve dynamic information from the Witnet's P2P network:
-![Snapshot showing Witnet SDK's network commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/network.png)
-
----
-#### `npx witsdk wallet`
-Self-custody local wallet for spending and staking at will your own $WIT coins:
-![Snapshot showing Witnet SDK's wallet commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/wallet.png)
-
----
-#### `npx witsdk inspect`
-Inspect public data from the Witnet blockchain:
-![Snapshot showing Witnet SDK's inspection commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/inspect.png)
-
----
-#### `npx witsdk radon`
-- Manage pre-built Witnet-compliant data requests and templates (aka. Radon assets):
-![Snapshot showing Witnet SDK's radon commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/radon.png)
-
-- If willing to customize Radon assets specific to your Web3 project, please initialize the **witnet/** workspace folder:
-  ```bash
-  $ npx witsdk radon init
-  ```
-
----
-#### `npx witsdk nodes`
-Interact with your own private Witnet nodes, if reachable:
-![Snapshot showing Witnet SDK's nodes farming commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/nodes.png)
-
-
-## 🔐 Security
-- Do not share your private keys.
-- Use trusted RPC endpoints when using third-party providers.
-- Disable "sensitive methods" on your Witnet node if willing to publish any of its RPC ports.
-
-## Documentation
-Learn more about Witnet, the $WIT coin and the Wit/Oracle framework for smart contracts at:
-
-👉 https://docs.witnet.io 
-👉 https://witnet.io
-👉 https://witnet.foundation/
-
-## 🧾 License
-MIT © 2025 — Maintained by the [Witnet Project](https://github.com/witnet).
-
+# Witnet Javascript SDK and CLI tools
+
+> Typescript library and CLI tooling for Web3 buidlers willing to interact with the Witnet blockchain.
+> The **Witnet Javascript SDK** empowers devops and Web3 developers to seamlessly interact with the Witnet blockchain.
+
+## ✨ Overview
+
+Users of the Witnet Javascript library or the embedded CLI tools, will be able to:
+
+- 👛 Create self-custody HD-wallets to hold and transact with $WIT coins.
+- 🌱 Stake and withdraw $WIT coins into and from Witnet validators.
+- 🧮 Build oracle queries adapted to all sorts of data sources and use cases.
+- 🩺 Simulate resolution of oracle queries, locally and at no cost.
+- 🧑‍⚖️ Notarize resolution of oracle queries on the Witnet blockchain.
+- ⛓️ Check dynamic information on the Witnet P2P network.
+- 🔎 Explore public data on the Witnet blockchain.
+- 🪪 Generate legit stake-authorization codes for external customers.
+
+## 📦 Installation
+
+### CLI as a global binary
+Install the `witsdk` binary:
+```bash
+$ npm install -g @witnet/sdk
+$ witsdk --version
+```
+
+### SDK as project dependency
+- Add the @witnet/sdk package to your project:
+```bash
+$ npm install --save-dev @witnet/sdk`
+```
+- Import from Javascript:
+```javascript
+const { requests, modals } = require("@witnet/sdk/assets")
+const { utils, Witnet } = require("@witnet/sdk")
+```
+- Import from Typescript:
+```typescript
+import { requests, modals } from "@witnet/sdk/assets"
+import { utils, Witnet } from "@witnet/sdk"
+```
+
+## ⚙️ Requirements
+- Node.js >= 20.
+- Witnet wallet with sufficient $WIT balance.
+
+## 🔧 Configuration
+Both the CLI and the library can be configured by using a **.env** file declaring this variable:
+```bash
+WITNET_SDK_WALLET_MASTER_KEY="xprv_string_here_as_exported_from_a_node_mww_or_sheikah"
+```
+
+You can optionally:
+- Settle your preferred WIT/RPC provider, like a Witnet node of your own, or third-party providers, by using the command-line option `--provider` (if using the CLI), or by setting the `WITNET_SDK_PROVIDER_URL` environment variable.
+
+## 🧪 Supported Networks
+| Witnet Network | Network id | WIT/RPC endpoints |
+| -: | :-: | :- 
+| Mainnet | `0x9fed` | https://rpc-01.witnet.io
+| Testnet | `0x749f` | https://rpc-testnet.witnet.io
+
+## 🛠️ Usage
+
+### Library modules
+
+> *Please, find Javascript and Typescript code snippets in the [Witnet Docs site](https://docs.witnet.io/witnet-sdk/how-to-guides).*
+
+### CLI modules
+
+---
+#### `npx witsdk network`
+Retrieve dynamic information from the Witnet's P2P network:
+![Snapshot showing Witnet SDK's network commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/network.png)
+
+---
+#### `npx witsdk wallet`
+Self-custody local wallet for spending and staking at will your own $WIT coins:
+![Snapshot showing Witnet SDK's wallet commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/wallet.png)
+
+---
+#### `npx witsdk inspect`
+Inspect public data from the Witnet blockchain:
+![Snapshot showing Witnet SDK's inspection commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/inspect.png)
+
+---
+#### `npx witsdk radon`
+- Manage pre-built Witnet-compliant data requests and templates (aka. Radon assets):
+![Snapshot showing Witnet SDK's radon commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/radon.png)
+
+- If willing to customize Radon assets specific to your Web3 project, please initialize the **witnet/** workspace folder:
+  ```bash
+  $ npx witsdk radon init
+  ```
+
+---
+#### `npx witsdk nodes`
+Interact with your own private Witnet nodes, if reachable:
+![Snapshot showing Witnet SDK's nodes farming commands](https://raw.githubusercontent.com/witnet/witnet-toolkit/main/docs/nodes.png)
+
+
+## 🔐 Security
+- Do not share your private keys.
+- Use trusted RPC endpoints when using third-party providers.
+- Disable "sensitive methods" on your Witnet node if willing to publish any of its RPC ports.
+
+## Documentation
+Learn more about Witnet, the $WIT coin and the Wit/Oracle framework for smart contracts at:
+
+👉 https://docs.witnet.io 
+👉 https://witnet.io
+👉 https://witnet.foundation/
+
+## 🧾 License
+MIT © 2025 — Maintained by the [Witnet Project](https://github.com/witnet).
+

package/dist/package.json

@@ -1,7 +1,11 @@
 {
     "name": "@witnet/sdk",
-    "version": "1.2.7",
+    "version": "3.0.0",
     "description": "Typescript library and CLI tooling for Web3 buidlers willing to interact with the Witnet blockchain.",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/witnet/witnet-sdk"
+    },
     "author": "Witnet Foundation",
     "license": "MIT",
     "private": false,
@@ -49,8 +53,8 @@
     "scripts": {
         "build": "pbjs --target json witnet/witnet.proto -o witnet/witnet.proto.json && npm run clean && tsc -p tsconfig.json",
         "clean": "node ./scripts/clean.cjs dist",
-        "fmt": "npx biome check --unsafe ./src ./scripts",
-        "fmt!": "npx biome check --write --unsafe ./src ./scripts",
+        "fmt": "npx biome check --unsafe",
+        "fmt!": "npx biome check --write --unsafe",
         "postinstall": "node scripts/postinstall.cjs",
         "prepare": "pnpm run build",
         "watcher": "node ./src/bin/bots/watcher.cjs",
@@ -87,5 +91,12 @@
         "cross-env": "10.0.0",
         "protobufjs-cli": "^1.1.3",
         "typescript": "^5.9.3"
+    },
+    "pnpm": {
+        "onlyBuiltDependencies": [
+            "keccak",
+            "protobufjs",
+            "secp256k1"
+        ]
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/bin/helpers.js"],"names":[],"mappings":"AAwBA,kDAOC;AAiFD,mDAUC;AAED,iDAEC;AAED,qDAgBC;AAED,gFAiBC;AAED,8DAsBC;AAED,uEAKC;AAED,yDAsCC;AAED,gEAOC;AAED,+CAOC;AAED,qEAUC;AAED,6CAYC;AAED,uDAMC;AAED,mDAcC;AAED,iGAUC;AAED,mDAuBC;AAED,iDA+BC;AAED,4EA8BC;AAED,qDA6BC;AAED,8EAKC;AAED,oCAIC;AAED,8DAWC;AAED,wDAiBC;AAED,8CAEC;AAED,2DAiBC;AAED;;EAWC;AAED,4FAeC;AAED,mEAaC;AAED,gDAIC;AAED,gEAQC;AAED,6CA8BC;AAED,mDAqCC;AAED,oDAWC;AAED,4CAeC;AAED,uDAgCC;AAED,gGAIC;AAED,6DA4EC;AAUD,0DAcC;AAED,iEAgBC;AAED,iEAIC;AAED,mEAuBC;AAED,4DA8CC;AAED,+EAkDC;AAED,+CAeC;AAp8BM,0CAIL;AAEK,4CAON;AAWM,6DAqBN;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,yCAAuD;AACvD,yCAAmD;AACnD,0CAAoD;AACpD,wCAAkD;AAClD,2CAAqD;AAErD,yCAAgD;AAChD,yCAAgD;AAChD,0CAAiD;AACjD,4CAAmD;AACnD,2CAAkD;AAClD,yCAA8C;AAC9C,yCAA8C;AAC9C,0CAA+C;AAC/C,4CAAmD;AACnD,wCAA6C;AAC7C,2CAAgD;AAEhD,wCAA6C;AAC7C,wCAA6C;AAC7C,wCAA6C;AAC7C,yCAA8C;AAC9C,2CAAkD;AAClD,0CAA+C;AAC/C,uCAA4C;AAC5C,yCAAgD;AAChD,0CAA+C"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/bin/helpers.js"],"names":[],"mappings":"AAqBA,kDAOC;AA2ED,mDAKC;AAED,iDAEC;AAED,qDAYC;AAED,gFAiBC;AAED,8DAsBC;AAED,uEAGC;AAED,yDAsCC;AAED,gEAKC;AAED,+CAMC;AAED,qEAUC;AAED,6CAOC;AAED,uDAMC;AAED,mDASC;AAED,iGAUC;AAED,mDAmBC;AAED,iDAwBC;AAED,4EAwBC;AAED,qDAoBC;AAED,8EAKC;AAED,oCAEC;AAED,8DAWC;AAED,wDAqBC;AAED,8CAEC;AAED,2DAeC;AAED;;EAWC;AAED,4FAaC;AAED,mEAaC;AAED,gDAEC;AAED,gEAQC;AAED,6CAyBC;AAED,mDAmCC;AAED,oDAWC;AAED,4CAeC;AAED,uDAuBC;AAED,gGAIC;AAED,6DAiEC;AAUD,0DAcC;AAED,iEAgBC;AAED,iEAIC;AAED,mEAqBC;AAED,4DAkCC;AAED,+EAgDC;AAED,+CAeC;AA11BM,0CACwF;AAExF,4CAON;AAWM,6DAeN;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,yCAAuD;AACvD,yCAAmD;AACnD,0CAAoD;AACpD,wCAAkD;AAClD,2CAAqD;AAErD,yCAAgD;AAChD,yCAAgD;AAChD,0CAAiD;AACjD,4CAAmD;AACnD,2CAAkD;AAClD,yCAA8C;AAC9C,yCAA8C;AAC9C,0CAA+C;AAC/C,4CAAmD;AACnD,wCAA6C;AAC7C,2CAAgD;AAEhD,wCAA6C;AAC7C,wCAA6C;AAC7C,wCAA6C;AAC7C,yCAA8C;AAC9C,2CAAkD;AAClD,0CAA+C;AAC/C,uCAA4C;AAC5C,yCAAgD;AAChD,0CAA+C"}