@abstractfruitfactory/radix-js 中文文档教程

Question

这个库专门用于 Radix 桌面钱包，而不是一般用途。 它没有文档记录，不受支持，并且可能随时更改。 使用风险自负。 我们已禁用问题，但会考虑带有错误修复的 PR。

对于 Olympia 主网版本，不提供特定语言的库，我们建议使用 Radix 节点提供的简单 JSON RPC 和 REST API 端点。 这些涵盖了 Olympia 的全部代币和质押功能，足以用于交易所或钱包集成。

后来的 Alexandria 和 Babylon 版本将更多地关注开发人员功能，因此预计届时将开始引入经过大量重构的 API 和新库。 我们期望这些新的 API 和库在其 Babylon 版本中成为与 Radix 网络进行编程交互的主要方法。

Build and run tests

yarn build && yarn bootstrap
yarn test

Publish a new release

当新更改已合并到主分支中，并且您想要发布新版本时，请确保您在本地与主分支保持同步并执行以下操作：

yarn release

它会自动更新已更改包中的版本，更新更改日志，提交并发布到 npm。

对于主分支的提交，请遵循常规提交。

Usage

WORK IN PROGRESS

Creating a new Radix instance

import { Radix, Wallet } from 'radixdlt-javascript` 

const walletResult = Wallet.new('parrot try blind immune drink stay three cluster ship draw fluid become despair primary curtain')

if (walletResult.isErr()) throw walletResult.error

const wallet = walletResult.value

const radix = Radix.new(wallet)
await radix.connect('http://localhost:8080')

或者，以映射结果的方式：

import { Radix, Wallet } from 'radixdlt-javascript` 

const result =
  Wallet.new('parrot try blind immune drink stay three cluster ship draw fluid become despair primary curtain')
  .map(
    wallet => Radix.new(wallet)
  )

if (result.isErr()) throw result.error

const radix = result.value
await radix.connect('http://localhost:8080')

Saving a keystore

await wallet.saveKeystore('path/to/keystore')

从保存的密钥库创建 Radix 实例：

import { Radix, Wallet } from 'radixdlt-javascript`
import fs from 'fs'

const keystore = fs.readFileSync('path/to/keystore/keystore.json')

const result =
  Wallet.fromKeystore(keystore)
  .map(
    wallet => Radix.new(wallet)
  )

if (result.isErr()) throw result.error

const radix = result.value

Managing accounts

let activeAccount

activeAccount = await radix.activeAccountPromise() // account at index 0
await radix.deriveNextAccount()
activeAccount = await radix.activeAccountPromise() // account at index 1

await radix.switchAccount(0)

activeAccount = await radix.activeAccountPromise() // account at index 0

订阅数据流：

const sub = radix.activeAccount.subscribe(account => console.log(account))

sub.unsubscribe() // stop polling

Interacting with the network

Getting token balances

作为连续数据流：

const sub = radix.tokenBalances.subscribe(
   result => { // invoked every second
      if (result.isErr()) // handle error

      const balances = result.value
   }
)

sub.unsubscribe() // stops polling

作为一个-关闭响应：

const result = await radix.tokenBalancesPromise()

if (result.isErr()) throw result.error

const balances = result.value

Getting a validator

const result = await radix.lookupValidator('rv1qvz3anvawgvm7pwvjs7xmjg48dvndczkgnufh475k2tqa2vm5c6cq4mrz0p')

if (result.isErr()) throw result.error

const validator = result.value

Sending tokens

const { status, completion } = radix.transferTokens(
  'rdx1qsps28kdn4epn0c9ej2rcmwfz5a4jdhq2ez03x7h6jefvr4fnwnrtqqjaj7dt', // recipient address
  10, // amount
  'xrd_rb1qya85pwq' // token identifier,
  {
    plaintext: 'this is a message!',
    encrypted: false
  },
  confirm => {
    // waiting for confirmation before continuing
    confirm()
  }
)

status.subscribe(status => console.log(event))

const result = await completion

if (result.isErr()) // handle error

const txID = result.value