@witnet/sdk 1.0.4 → 1.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env_witnet +6 -6
- package/LICENSE +21 -21
- package/README.md +103 -103
- package/dist/package.json +3 -4
- package/dist/src/bin/helpers.js +2 -2
- package/dist/src/index.js +1 -1
- package/dist/src/lib/crypto/account.d.ts +3 -1
- package/dist/src/lib/crypto/account.d.ts.map +1 -1
- package/dist/src/lib/crypto/account.js +7 -1
- package/dist/src/lib/crypto/coinbase.js +1 -1
- package/dist/src/lib/crypto/index.js +1 -1
- package/dist/src/lib/crypto/interfaces.d.ts +2 -0
- package/dist/src/lib/crypto/interfaces.d.ts.map +1 -1
- package/dist/src/lib/crypto/interfaces.js +1 -1
- package/dist/src/lib/crypto/payloads/DataRequestPayload.js +1 -1
- package/dist/src/lib/crypto/payloads/StakePayload.js +1 -1
- package/dist/src/lib/crypto/payloads/UnstakePayload.js +1 -1
- package/dist/src/lib/crypto/payloads/ValueTransferPayload.js +1 -1
- package/dist/src/lib/crypto/payloads.d.ts.map +1 -1
- package/dist/src/lib/crypto/payloads.js +12 -1
- package/dist/src/lib/crypto/signer.d.ts +1 -0
- package/dist/src/lib/crypto/signer.d.ts.map +1 -1
- package/dist/src/lib/crypto/signer.js +18 -1
- package/dist/src/lib/crypto/transmitters/DataRequests.js +1 -1
- package/dist/src/lib/crypto/transmitters/StakeDeposits.js +1 -1
- package/dist/src/lib/crypto/transmitters/StakeWithdrawals.js +1 -1
- package/dist/src/lib/crypto/transmitters/ValueTransfers.js +1 -1
- package/dist/src/lib/crypto/transmitters.d.ts +1 -1
- package/dist/src/lib/crypto/transmitters.d.ts.map +1 -1
- package/dist/src/lib/crypto/transmitters.js +4 -4
- package/dist/src/lib/crypto/types.d.ts.map +1 -1
- package/dist/src/lib/crypto/types.js +2 -1
- package/dist/src/lib/crypto/utils.js +1 -1
- package/dist/src/lib/crypto/wallet.d.ts +3 -1
- package/dist/src/lib/crypto/wallet.d.ts.map +1 -1
- package/dist/src/lib/crypto/wallet.js +10 -1
- package/dist/src/lib/index.js +1 -1
- package/dist/src/lib/radon/ccdr/eth.js +1 -1
- package/dist/src/lib/radon/ccdr/index.js +1 -1
- package/dist/src/lib/radon/ccdr/wit.js +1 -1
- package/dist/src/lib/radon/filters.js +1 -1
- package/dist/src/lib/radon/index.js +1 -1
- package/dist/src/lib/radon/reducers.js +1 -1
- package/dist/src/lib/radon/types.js +1 -1
- package/dist/src/lib/radon/utils.js +1 -1
- package/dist/src/lib/rpc/index.js +1 -1
- package/dist/src/lib/rpc/nodes.js +1 -1
- package/dist/src/lib/rpc/provider.js +1 -1
- package/dist/src/lib/rpc/types.d.ts +6 -4
- package/dist/src/lib/rpc/types.d.ts.map +1 -1
- package/dist/src/lib/rpc/types.js +1 -1
- package/dist/src/lib/types.d.ts +0 -1
- package/dist/src/lib/types.d.ts.map +1 -1
- package/dist/src/lib/types.js +1 -1
- package/dist/src/lib/utils.js +1 -1
- package/dist/witnet/assets/index.js +1 -1
- package/dist/witnet/assets/modals/index.js +1 -1
- package/dist/witnet/assets/modals/web3/eth.js +1 -1
- package/dist/witnet/assets/modals/web3/ipfs.js +1 -1
- package/dist/witnet/assets/modals/web3/wit.js +1 -1
- package/dist/witnet/assets/requests.js +1 -1
- package/package.json +3 -4
- package/src/bin/cli/history.js +31 -31
- package/src/bin/cli/inspect.js +405 -405
- package/src/bin/cli/network.js +594 -594
- package/src/bin/cli/nodes.js +364 -364
- package/src/bin/cli/radon.js +817 -815
- package/src/bin/cli/wallet.js +1121 -1117
- package/src/bin/helpers.js +840 -840
- package/src/bin/postinstall.js +9 -9
- package/src/bin/toolkit.js +295 -295
- package/witnet/assets/_index.js +8 -8
- package/witnet/assets/_requests.js +25 -25
- package/witnet/assets/_sources.js +36 -36
- package/witnet/assets/_templates.js +36 -36
- package/witnet/assets/index.js +4 -4
- package/witnet/assets/modals/index.js +9 -9
- package/witnet/assets/modals/web3/eth.js +29 -29
- package/witnet/assets/modals/web3/ipfs.js +19 -19
- package/witnet/assets/modals/web3/wit.js +21 -21
- package/witnet/assets/requests.js +95 -95
- package/dist/bin/helpers.d.ts +0 -88
- package/dist/bin/helpers.d.ts.map +0 -1
- package/dist/bin/helpers.js +0 -866
- package/dist/index.d.ts +0 -4
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -42
- package/dist/lib/crypto/account.d.ts +0 -18
- package/dist/lib/crypto/account.d.ts.map +0 -1
- package/dist/lib/crypto/account.js +0 -152
- package/dist/lib/crypto/coinbase.d.ts +0 -9
- package/dist/lib/crypto/coinbase.d.ts.map +0 -1
- package/dist/lib/crypto/coinbase.js +0 -39
- package/dist/lib/crypto/index.d.ts +0 -7
- package/dist/lib/crypto/index.d.ts.map +0 -1
- package/dist/lib/crypto/index.js +0 -28
- package/dist/lib/crypto/interfaces.d.ts +0 -80
- package/dist/lib/crypto/interfaces.d.ts.map +0 -1
- package/dist/lib/crypto/interfaces.js +0 -3
- package/dist/lib/crypto/payloads/DataRequestPayload.d.ts +0 -47
- package/dist/lib/crypto/payloads/DataRequestPayload.d.ts.map +0 -1
- package/dist/lib/crypto/payloads/DataRequestPayload.js +0 -384
- package/dist/lib/crypto/payloads/StakePayload.d.ts +0 -27
- package/dist/lib/crypto/payloads/StakePayload.d.ts.map +0 -1
- package/dist/lib/crypto/payloads/StakePayload.js +0 -184
- package/dist/lib/crypto/payloads/UnstakePayload.d.ts +0 -35
- package/dist/lib/crypto/payloads/UnstakePayload.d.ts.map +0 -1
- package/dist/lib/crypto/payloads/UnstakePayload.js +0 -244
- package/dist/lib/crypto/payloads/ValueTransferPayload.d.ts +0 -24
- package/dist/lib/crypto/payloads/ValueTransferPayload.d.ts.map +0 -1
- package/dist/lib/crypto/payloads/ValueTransferPayload.js +0 -182
- package/dist/lib/crypto/payloads.d.ts +0 -54
- package/dist/lib/crypto/payloads.d.ts.map +0 -1
- package/dist/lib/crypto/payloads.js +0 -224
- package/dist/lib/crypto/signer.d.ts +0 -26
- package/dist/lib/crypto/signer.d.ts.map +0 -1
- package/dist/lib/crypto/signer.js +0 -299
- package/dist/lib/crypto/transmitters/DataRequests.d.ts +0 -14
- package/dist/lib/crypto/transmitters/DataRequests.d.ts.map +0 -1
- package/dist/lib/crypto/transmitters/DataRequests.js +0 -62
- package/dist/lib/crypto/transmitters/StakeDeposits.d.ts +0 -11
- package/dist/lib/crypto/transmitters/StakeDeposits.d.ts.map +0 -1
- package/dist/lib/crypto/transmitters/StakeDeposits.js +0 -48
- package/dist/lib/crypto/transmitters/StakeWithdrawals.d.ts +0 -17
- package/dist/lib/crypto/transmitters/StakeWithdrawals.d.ts.map +0 -1
- package/dist/lib/crypto/transmitters/StakeWithdrawals.js +0 -115
- package/dist/lib/crypto/transmitters/ValueTransfers.d.ts +0 -10
- package/dist/lib/crypto/transmitters/ValueTransfers.d.ts.map +0 -1
- package/dist/lib/crypto/transmitters/ValueTransfers.js +0 -47
- package/dist/lib/crypto/transmitters.d.ts +0 -46
- package/dist/lib/crypto/transmitters.d.ts.map +0 -1
- package/dist/lib/crypto/transmitters.js +0 -506
- package/dist/lib/crypto/types.d.ts +0 -127
- package/dist/lib/crypto/types.d.ts.map +0 -1
- package/dist/lib/crypto/types.js +0 -261
- package/dist/lib/crypto/utils.d.ts +0 -10
- package/dist/lib/crypto/utils.d.ts.map +0 -1
- package/dist/lib/crypto/utils.js +0 -97
- package/dist/lib/crypto/wallet.d.ts +0 -26
- package/dist/lib/crypto/wallet.d.ts.map +0 -1
- package/dist/lib/crypto/wallet.js +0 -327
- package/dist/lib/helpers.d.ts +0 -90
- package/dist/lib/helpers.d.ts.map +0 -1
- package/dist/lib/helpers.js +0 -1031
- package/dist/lib/index.d.ts +0 -5
- package/dist/lib/index.d.ts.map +0 -1
- package/dist/lib/index.js +0 -21
- package/dist/lib/radon/artifacts.d.ts +0 -55
- package/dist/lib/radon/artifacts.d.ts.map +0 -1
- package/dist/lib/radon/artifacts.js +0 -347
- package/dist/lib/radon/ccdr/eth.d.ts +0 -100
- package/dist/lib/radon/ccdr/eth.d.ts.map +0 -1
- package/dist/lib/radon/ccdr/eth.js +0 -237
- package/dist/lib/radon/ccdr/index.d.ts +0 -34
- package/dist/lib/radon/ccdr/index.d.ts.map +0 -1
- package/dist/lib/radon/ccdr/index.js +0 -63
- package/dist/lib/radon/ccdr/wit.d.ts +0 -29
- package/dist/lib/radon/ccdr/wit.d.ts.map +0 -1
- package/dist/lib/radon/ccdr/wit.js +0 -60
- package/dist/lib/radon/filters.d.ts +0 -14
- package/dist/lib/radon/filters.d.ts.map +0 -1
- package/dist/lib/radon/filters.js +0 -47
- package/dist/lib/radon/index.d.ts +0 -36
- package/dist/lib/radon/index.d.ts.map +0 -1
- package/dist/lib/radon/index.js +0 -154
- package/dist/lib/radon/reducers.d.ts +0 -29
- package/dist/lib/radon/reducers.d.ts.map +0 -1
- package/dist/lib/radon/reducers.js +0 -101
- package/dist/lib/radon/retrievals.d.ts +0 -120
- package/dist/lib/radon/retrievals.d.ts.map +0 -1
- package/dist/lib/radon/retrievals.js +0 -358
- package/dist/lib/radon/sources.d.ts +0 -102
- package/dist/lib/radon/sources.d.ts.map +0 -1
- package/dist/lib/radon/sources.js +0 -294
- package/dist/lib/radon/types.d.ts +0 -521
- package/dist/lib/radon/types.d.ts.map +0 -1
- package/dist/lib/radon/types.js +0 -1066
- package/dist/lib/radon/utils.d.ts +0 -55
- package/dist/lib/radon/utils.d.ts.map +0 -1
- package/dist/lib/radon/utils.js +0 -181
- package/dist/lib/rpc/farm.d.ts +0 -66
- package/dist/lib/rpc/farm.d.ts.map +0 -1
- package/dist/lib/rpc/farm.js +0 -808
- package/dist/lib/rpc/index.d.ts +0 -3
- package/dist/lib/rpc/index.d.ts.map +0 -1
- package/dist/lib/rpc/index.js +0 -19
- package/dist/lib/rpc/node.d.ts +0 -38
- package/dist/lib/rpc/node.d.ts.map +0 -1
- package/dist/lib/rpc/node.js +0 -335
- package/dist/lib/rpc/nodes.d.ts +0 -40
- package/dist/lib/rpc/nodes.d.ts.map +0 -1
- package/dist/lib/rpc/nodes.js +0 -531
- package/dist/lib/rpc/provider.d.ts +0 -72
- package/dist/lib/rpc/provider.d.ts.map +0 -1
- package/dist/lib/rpc/provider.js +0 -402
- package/dist/lib/rpc/reporter.d.ts +0 -18
- package/dist/lib/rpc/reporter.d.ts.map +0 -1
- package/dist/lib/rpc/reporter.js +0 -99
- package/dist/lib/rpc/types.d.ts +0 -396
- package/dist/lib/rpc/types.d.ts.map +0 -1
- package/dist/lib/rpc/types.js +0 -81
- package/dist/lib/rpc/wallet.d.ts +0 -72
- package/dist/lib/rpc/wallet.d.ts.map +0 -1
- package/dist/lib/rpc/wallet.js +0 -41
- package/dist/lib/types.d.ts +0 -19
- package/dist/lib/types.d.ts.map +0 -1
- package/dist/lib/types.js +0 -7
- package/dist/lib/utils.d.ts +0 -5
- package/dist/lib/utils.d.ts.map +0 -1
- package/dist/lib/utils.js +0 -51
- package/dist/src/lib/rpc/reporter.d.ts +0 -17
- package/dist/src/lib/rpc/reporter.d.ts.map +0 -1
- package/dist/src/lib/rpc/reporter.js +0 -27
package/.env_witnet
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
### witnet-toolkit
|
|
2
|
-
WITNET_SDK_PROVIDER_URL=
|
|
3
|
-
WITNET_SDK_RADON_ASSETS_PATH=
|
|
4
|
-
WITNET_SDK_WALLET_MASTER_KEY=
|
|
5
|
-
WITNET_SDK_FARM_NODES=
|
|
6
|
-
|
|
1
|
+
### witnet-toolkit
|
|
2
|
+
WITNET_SDK_PROVIDER_URL=
|
|
3
|
+
WITNET_SDK_RADON_ASSETS_PATH=
|
|
4
|
+
WITNET_SDK_WALLET_MASTER_KEY=
|
|
5
|
+
WITNET_SDK_FARM_NODES=
|
|
6
|
+
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2023 The Witnet Project
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2023 The Witnet Project
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,103 +1,103 @@
|
|
|
1
|
-
# @witnet/sdk
|
|
2
|
-
|
|
3
|
-
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.
|
|
4
|
-
|
|
5
|
-
## Package install
|
|
6
|
-
|
|
7
|
-
`$ npm install --save-dev @witnet/sdk`
|
|
8
|
-
|
|
9
|
-
## JS/TS libraries
|
|
10
|
-
### Import clauses
|
|
11
|
-
```javascript
|
|
12
|
-
const Witnet = require('@witnet/sdk')
|
|
13
|
-
const { RadonRequest, Wallet, Utils } from '@witnet/sdk'
|
|
14
|
-
```
|
|
15
|
-
### Usage exmpales
|
|
16
|
-
#### Managing Radon Requests
|
|
17
|
-
```
|
|
18
|
-
const Witnet = require("@witnet/sdk")
|
|
19
|
-
|
|
20
|
-
// Example 1: CCDR for getting transaction details on a foreign EVM-chain
|
|
21
|
-
const ccdr = Witnet.RadonRetrievals.CrossChainRPC({
|
|
22
|
-
rpc: Witnet.RadonRetrievals.RPCs.ETH.getTransactionByHash("\\1\\"),
|
|
23
|
-
script: Witnet.RadonScript().parseJSONMap()
|
|
24
|
-
})
|
|
25
|
-
const template = new Witnet.RadonTemplate({
|
|
26
|
-
retrieve: ccdr.spawnRetrievals(
|
|
27
|
-
"https://polygon-amoy.gateway.tenderly.co",
|
|
28
|
-
"https://rpc.ankr.com/polygon_amoy",
|
|
29
|
-
"https://polygon-amoy-bor-rpc.publicnode.com",
|
|
30
|
-
),
|
|
31
|
-
aggregate: Witnet.RadonReducers.Mode(),
|
|
32
|
-
tally: Witnet.RadonReducers.Mode(),
|
|
33
|
-
});
|
|
34
|
-
const request = template.buildRequestModal("0xfc3c17407f788c075483b0ad5383b1d5e6fbdc7ba500b08397c80423755c5eba")
|
|
35
|
-
|
|
36
|
-
// Example 2: Compose a regular randomness request
|
|
37
|
-
const request = new Witnet.RadonRequest({
|
|
38
|
-
retrieve: Witnet.RadonRetrievals.RNG(),
|
|
39
|
-
tally: Witnet.RadonReducers.ConcatHash(),
|
|
40
|
-
})
|
|
41
|
-
|
|
42
|
-
// Example 3: Leverage a pre-built price feed from the WF's pricefeeds repository
|
|
43
|
-
const assets = require('witnet-feeds')
|
|
44
|
-
const request = assets.legacy.requests.price.crypto.WitOracleRequestPriceAvaxUsd6;
|
|
45
|
-
|
|
46
|
-
// Example 4: Get WSB addresses on "conflux:core:mainnet"
|
|
47
|
-
const addresses = assets.getAddresses("conflux:core:mainnet")
|
|
48
|
-
|
|
49
|
-
// Example 5: Serialize a RadonRequest into a hexified buffer
|
|
50
|
-
const hexString = request.toBytecode()
|
|
51
|
-
|
|
52
|
-
// Example 6: Convert RadonRequest into Witnet-compliant protobuf object
|
|
53
|
-
const protobuf = request.toProtobuf()
|
|
54
|
-
|
|
55
|
-
// Example 7: Stringify a Witnet-compliant script
|
|
56
|
-
console.info(request.retrieve[0].script.toString())
|
|
57
|
-
|
|
58
|
-
// Example 8: Decode hexified bytecode into a RadonRequest
|
|
59
|
-
const request = Witnet.RadonRequest.from(hexString)
|
|
60
|
-
|
|
61
|
-
// Example 9: Get result of dry running a RadonRequest, locally
|
|
62
|
-
const result = JSON.parse(await request.execDryRun())
|
|
63
|
-
```
|
|
64
|
-
#### Interacting with the Witnet network
|
|
65
|
-
#### Sending a Data Request to the Witnet network
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
## CLI binaries
|
|
69
|
-
|
|
70
|
-
### Optional environment constiables
|
|
71
|
-
```
|
|
72
|
-
WITNET_SDK_WALLET_MASTER_KEY=
|
|
73
|
-
WITNET_SDK_PROVIDER_URL=
|
|
74
|
-
WITNET_TOOLKIT_REPORTER_URL=
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
### General-purpose usage
|
|
78
|
-
```
|
|
79
|
-
$ npx witnet
|
|
80
|
-
USAGE:
|
|
81
|
-
npx witnet [FLAGS] <COMMAND>
|
|
82
|
-
|
|
83
|
-
FLAGS:
|
|
84
|
-
--help Describes command or subcommand usage
|
|
85
|
-
--update Forces update of underlying binaries
|
|
86
|
-
--version Prints toolkit name and version as first line
|
|
87
|
-
|
|
88
|
-
COMMANDS:
|
|
89
|
-
fetch Fetch public data from the Wit/Oracle blockchain.
|
|
90
|
-
history Aggregated historical data from the Wit/Oracle blockchain.
|
|
91
|
-
network Current information about the Wit/Oracle P2P network.
|
|
92
|
-
node Interact with private Wit/Oracle nodes, if reachable.
|
|
93
|
-
radon Manage Radon requests and templates within your project.
|
|
94
|
-
wallet Simple CLI wallet for spending and staking your Wits.
|
|
95
|
-
```
|
|
96
|
-
### Setting up your own Radon assets workspace
|
|
97
|
-
```
|
|
98
|
-
$ npx witnet radon init
|
|
99
|
-
...
|
|
100
|
-
|
|
101
|
-
$ npx witnet radon
|
|
102
|
-
...
|
|
103
|
-
```
|
|
1
|
+
# @witnet/sdk
|
|
2
|
+
|
|
3
|
+
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.
|
|
4
|
+
|
|
5
|
+
## Package install
|
|
6
|
+
|
|
7
|
+
`$ npm install --save-dev @witnet/sdk`
|
|
8
|
+
|
|
9
|
+
## JS/TS libraries
|
|
10
|
+
### Import clauses
|
|
11
|
+
```javascript
|
|
12
|
+
const Witnet = require('@witnet/sdk')
|
|
13
|
+
const { RadonRequest, Wallet, Utils } from '@witnet/sdk'
|
|
14
|
+
```
|
|
15
|
+
### Usage exmpales
|
|
16
|
+
#### Managing Radon Requests
|
|
17
|
+
```
|
|
18
|
+
const Witnet = require("@witnet/sdk")
|
|
19
|
+
|
|
20
|
+
// Example 1: CCDR for getting transaction details on a foreign EVM-chain
|
|
21
|
+
const ccdr = Witnet.RadonRetrievals.CrossChainRPC({
|
|
22
|
+
rpc: Witnet.RadonRetrievals.RPCs.ETH.getTransactionByHash("\\1\\"),
|
|
23
|
+
script: Witnet.RadonScript().parseJSONMap()
|
|
24
|
+
})
|
|
25
|
+
const template = new Witnet.RadonTemplate({
|
|
26
|
+
retrieve: ccdr.spawnRetrievals(
|
|
27
|
+
"https://polygon-amoy.gateway.tenderly.co",
|
|
28
|
+
"https://rpc.ankr.com/polygon_amoy",
|
|
29
|
+
"https://polygon-amoy-bor-rpc.publicnode.com",
|
|
30
|
+
),
|
|
31
|
+
aggregate: Witnet.RadonReducers.Mode(),
|
|
32
|
+
tally: Witnet.RadonReducers.Mode(),
|
|
33
|
+
});
|
|
34
|
+
const request = template.buildRequestModal("0xfc3c17407f788c075483b0ad5383b1d5e6fbdc7ba500b08397c80423755c5eba")
|
|
35
|
+
|
|
36
|
+
// Example 2: Compose a regular randomness request
|
|
37
|
+
const request = new Witnet.RadonRequest({
|
|
38
|
+
retrieve: Witnet.RadonRetrievals.RNG(),
|
|
39
|
+
tally: Witnet.RadonReducers.ConcatHash(),
|
|
40
|
+
})
|
|
41
|
+
|
|
42
|
+
// Example 3: Leverage a pre-built price feed from the WF's pricefeeds repository
|
|
43
|
+
const assets = require('witnet-feeds')
|
|
44
|
+
const request = assets.legacy.requests.price.crypto.WitOracleRequestPriceAvaxUsd6;
|
|
45
|
+
|
|
46
|
+
// Example 4: Get WSB addresses on "conflux:core:mainnet"
|
|
47
|
+
const addresses = assets.getAddresses("conflux:core:mainnet")
|
|
48
|
+
|
|
49
|
+
// Example 5: Serialize a RadonRequest into a hexified buffer
|
|
50
|
+
const hexString = request.toBytecode()
|
|
51
|
+
|
|
52
|
+
// Example 6: Convert RadonRequest into Witnet-compliant protobuf object
|
|
53
|
+
const protobuf = request.toProtobuf()
|
|
54
|
+
|
|
55
|
+
// Example 7: Stringify a Witnet-compliant script
|
|
56
|
+
console.info(request.retrieve[0].script.toString())
|
|
57
|
+
|
|
58
|
+
// Example 8: Decode hexified bytecode into a RadonRequest
|
|
59
|
+
const request = Witnet.RadonRequest.from(hexString)
|
|
60
|
+
|
|
61
|
+
// Example 9: Get result of dry running a RadonRequest, locally
|
|
62
|
+
const result = JSON.parse(await request.execDryRun())
|
|
63
|
+
```
|
|
64
|
+
#### Interacting with the Witnet network
|
|
65
|
+
#### Sending a Data Request to the Witnet network
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
## CLI binaries
|
|
69
|
+
|
|
70
|
+
### Optional environment constiables
|
|
71
|
+
```
|
|
72
|
+
WITNET_SDK_WALLET_MASTER_KEY=
|
|
73
|
+
WITNET_SDK_PROVIDER_URL=
|
|
74
|
+
WITNET_TOOLKIT_REPORTER_URL=
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### General-purpose usage
|
|
78
|
+
```
|
|
79
|
+
$ npx witnet
|
|
80
|
+
USAGE:
|
|
81
|
+
npx witnet [FLAGS] <COMMAND>
|
|
82
|
+
|
|
83
|
+
FLAGS:
|
|
84
|
+
--help Describes command or subcommand usage
|
|
85
|
+
--update Forces update of underlying binaries
|
|
86
|
+
--version Prints toolkit name and version as first line
|
|
87
|
+
|
|
88
|
+
COMMANDS:
|
|
89
|
+
fetch Fetch public data from the Wit/Oracle blockchain.
|
|
90
|
+
history Aggregated historical data from the Wit/Oracle blockchain.
|
|
91
|
+
network Current information about the Wit/Oracle P2P network.
|
|
92
|
+
node Interact with private Wit/Oracle nodes, if reachable.
|
|
93
|
+
radon Manage Radon requests and templates within your project.
|
|
94
|
+
wallet Simple CLI wallet for spending and staking your Wits.
|
|
95
|
+
```
|
|
96
|
+
### Setting up your own Radon assets workspace
|
|
97
|
+
```
|
|
98
|
+
$ npx witnet radon init
|
|
99
|
+
...
|
|
100
|
+
|
|
101
|
+
$ npx witnet radon
|
|
102
|
+
...
|
|
103
|
+
```
|
package/dist/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@witnet/sdk",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.6",
|
|
4
4
|
"description": "Typescript library and CLI tooling for Web3 buidlers willing to interact with the Witnet blockchain.",
|
|
5
5
|
"author": "Witnet Foundation",
|
|
6
6
|
"license": "MIT",
|
|
@@ -8,13 +8,12 @@
|
|
|
8
8
|
"type": "commonjs",
|
|
9
9
|
"bin": {
|
|
10
10
|
"witnet": "src/bin/toolkit.js",
|
|
11
|
-
"witnet-toolkit": "src/bin/toolkit.js"
|
|
11
|
+
"witnet-toolkit": "src/bin/toolkit.js",
|
|
12
|
+
"witnet-sdk": "src/bin/toolkit.js"
|
|
12
13
|
},
|
|
13
14
|
"files": [
|
|
14
15
|
"dist",
|
|
15
16
|
"src/bin",
|
|
16
|
-
"src/lib/cli",
|
|
17
|
-
"src/lib/helpers.js",
|
|
18
17
|
"witnet/witnet.proto.json",
|
|
19
18
|
"witnet/assets",
|
|
20
19
|
".env_witnet"
|