docs: warp to warp-contracts
This commit is contained in:
@@ -97,22 +97,22 @@ SDK requires node.js version 16.5+.
|
||||
|
||||
#### Using npm
|
||||
|
||||
`npm install warp`
|
||||
`npm install warp-contracts`
|
||||
|
||||
#### Using yarn
|
||||
|
||||
`yarn add warp`
|
||||
`yarn add warp-contracts`
|
||||
|
||||
### Import
|
||||
|
||||
You can import the full API or individual modules.
|
||||
|
||||
```typescript
|
||||
import * as WarpSdk from 'warp';
|
||||
import * as WarpSdk from 'warp-contracts';
|
||||
```
|
||||
|
||||
```typescript
|
||||
import { Warp, Contract, ... } from 'warp'
|
||||
import { Warp, Contract, ... } from 'warp-contracts'
|
||||
```
|
||||
|
||||
The SDK is available in both the ESM and CJS format - to make it possible for web bundlers (like webpack) to effectively
|
||||
|
||||
@@ -3,16 +3,19 @@
|
||||
This guide describes <strong>the simplest</strong> way to switch to the new version of SmartWeave. It uses `WebNodeFactory` for Node and `WarpWebFactory` for Web to quickly obtain fully configured, mem-cacheable SmartWeave instance. To see a more detailed explanation of all the core modules check out the [source code.](https://github.com/redstone-finance/warp)
|
||||
|
||||
### You can watch this tutorial on YouTube 🎬
|
||||
|
||||
- [Youtube link](https://www.youtube.com/watch?v=fNjUV7mHFqw)
|
||||
|
||||
[](https://www.youtube.com/watch?v=fNjUV7mHFqw)
|
||||
|
||||
### Need help? 🙋♂️
|
||||
|
||||
Please feel free to contact us [on Discord](https://redstone.finance/discord) if you face any problems.
|
||||
|
||||
## 1. Update dependencies 📦
|
||||
|
||||
#### 1.1 Install Warp
|
||||
|
||||
```bash
|
||||
# Yarn
|
||||
yarn add warp
|
||||
@@ -20,8 +23,11 @@ yarn add warp
|
||||
# or NPM
|
||||
npm install warp
|
||||
```
|
||||
|
||||
#### 1.2 Remove smartweave v1
|
||||
|
||||
If smartweave was installed globally, add `-g` flag to npm or use `yarn global`
|
||||
|
||||
```bash
|
||||
# Yarn
|
||||
yarn remove smartweave
|
||||
@@ -31,25 +37,29 @@ npm uninstall smartweave
|
||||
```
|
||||
|
||||
#### 1.3 Replace imports
|
||||
|
||||
You can import the full API or individual modules.
|
||||
|
||||
```typescript
|
||||
import * as WarpSdk from 'warp';
|
||||
import { Warp, Contract, ... } from 'warp';
|
||||
import * as WarpSdk from 'warp-contracts';
|
||||
import { Warp, Contract, ... } from 'warp-contracts';
|
||||
```
|
||||
|
||||
## 2. Update your implementation 🧑💻
|
||||
|
||||
### 2.1 Initialize a Warp client
|
||||
|
||||
```typescript
|
||||
import Arweave from 'arweave';
|
||||
import { WarpNodeFactory } from 'warp';
|
||||
import { WarpNodeFactory } from 'warp-contracts';
|
||||
|
||||
// Create an Arweave instance
|
||||
const arweave = Arweave.init({
|
||||
host: "dh48zl0solow5.cloudfront.net",
|
||||
host: 'dh48zl0solow5.cloudfront.net',
|
||||
port: 443,
|
||||
protocol: "https",
|
||||
protocol: 'https',
|
||||
timeout: 20000,
|
||||
logging: false,
|
||||
logging: false
|
||||
});
|
||||
|
||||
// Create a Warp client
|
||||
@@ -59,31 +69,37 @@ const smartweave = WarpNodeFactory.memCached(arweave);
|
||||
For Web environment you should use `WarpWebFactory` instead of `WarpNodeFactory`.
|
||||
|
||||
In this example we've used the `memCached` method. You can see other available methods in documentation:
|
||||
|
||||
- [For Web](https://smartweave.docs.redstone.finance/classes/SmartWeaveWebFactory.html)
|
||||
- [For Node.js](https://smartweave.docs.redstone.finance/classes/SmartWeaveNodeFactory.html)
|
||||
|
||||
#### [Optional] Custom modules 🛠
|
||||
|
||||
Warp has a modular architecture, which allows you to connect custom modules to any part of the Warp client implementation. See [custom-client-example.ts](https://github.com/redstone-finance/redstone-smartweave-examples/blob/main/src/custom-client-example.ts) to learn more.
|
||||
|
||||
### 2.2 Initialize contract object
|
||||
|
||||
```typescript
|
||||
// Simple connection (allows to read state)
|
||||
const contract = warp.contract("YOUR_CONTRACT_TX_ID");
|
||||
const contract = warp.contract('YOUR_CONTRACT_TX_ID');
|
||||
```
|
||||
|
||||
💡 Note! For being able to write interactions to blockchain you need to connect wallet to contract object.
|
||||
|
||||
```typescript
|
||||
const contract = warp
|
||||
.contract("YOUR_CONTRACT_TX_ID")
|
||||
.contract('YOUR_CONTRACT_TX_ID')
|
||||
.connect(jwk) // jwk should be a valid private key (in JSON Web Key format)
|
||||
.setEvaluationOptions({
|
||||
// with this flag set to true, the write will wait for the transaction to be confirmed
|
||||
waitForConfirmation: true,
|
||||
waitForConfirmation: true
|
||||
});
|
||||
```
|
||||
|
||||
### 2.3 Interact with your contract
|
||||
|
||||
#### Read state (readContract in V1)
|
||||
|
||||
```typescript
|
||||
// Read state (similar to the "readContract" from SmartWeave V1)
|
||||
const { state, validity } = await contract.readState();
|
||||
@@ -95,6 +111,7 @@ const { state, validity } = await contract.readState();
|
||||
```
|
||||
|
||||
#### View state (interactRead in V1)
|
||||
|
||||
```typescript
|
||||
// View state (similar to the "interactRead" from SmartWeave V1)
|
||||
const { result } = await contract.viewState<Input, View>({
|
||||
@@ -104,6 +121,7 @@ const { result } = await contract.viewState<Input, View>({
|
||||
```
|
||||
|
||||
#### Write interaction (interactWrite in V1)
|
||||
|
||||
```typescript
|
||||
// Write interaction (similar to the "interactWrite" from SmartWeave V1)
|
||||
const result = await contract.writeInteraction({
|
||||
@@ -115,28 +133,32 @@ const result = await contract.writeInteraction({
|
||||
💡 You can read detailed explanation of each contract method [here.](CONTRACT_METHODS.md)
|
||||
|
||||
### [Optional] 2.4 Confgure logging
|
||||
|
||||
Warp uses `tslog` library for logging. By default logger is set to "debug" level, which means that all messages with level "debug" or higher are logged.
|
||||
|
||||
#### Update logger options
|
||||
|
||||
```typescript
|
||||
LoggerFactory.INST.setOptions({
|
||||
type: "json",
|
||||
displayFilePath: "hidden",
|
||||
type: 'json',
|
||||
displayFilePath: 'hidden',
|
||||
displayInstanceName: false,
|
||||
minLevel: "info",
|
||||
minLevel: 'info'
|
||||
});
|
||||
```
|
||||
|
||||
Learn more about available logging options in [tslog documentation.](https://tslog.js.org/tsdoc/interfaces/isettingsparam.html)
|
||||
|
||||
#### Update logger level
|
||||
|
||||
Instead of updaitng all logger options you can simply set the new minimum logger level
|
||||
|
||||
```typescript
|
||||
LoggerFactory.INST.logLevel("info");
|
||||
LoggerFactory.INST.logLevel('info');
|
||||
```
|
||||
|
||||
Available log levels are listed [here.](https://github.com/redstone-finance/warp/blob/main/src/logging/RedStoneLogger.ts#L1)
|
||||
|
||||
|
||||
## 3. Test everything 🔥
|
||||
|
||||
Before deploying your changes test it carefully. If you face any problems please contact us [on our discord](https://redstone.finance/discord). We'll be happy to help 😊
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"name": "warp",
|
||||
"name": "warp-contracts",
|
||||
"version": "1.0.0",
|
||||
"description": "An implementation of the SmartWeave smart contract protocol.",
|
||||
"main": "./lib/cjs/index.js",
|
||||
|
||||
Reference in New Issue
Block a user