JavaScript 客户端

本文档摘自 social-rpc-client-js

基本设置和使用

要使用客户端，请在你的 NPM 项目中安装该包：

npm install -S @dcl/social-rpc-client

从已安装的包中导入客户端创建函数：

import { createSocialClient } from "@dcl/social-client";

通过向客户端提供以下内容来创建一个新的客户端实例：

1. Social Service 的 REST API URL

2. Social Service 的 WebSocket 端点 URL

3. 用户地址（与用于签名身份的地址相同）

4. 使用用户钱包签名的身份。

import { createSocialClient } from "@dcl/social-client";
import { Wallet } from 'ethers'

// 生成一个随机钱包用于测试，或在生产环境中使用用户的钱包。
const wallet = Wallet.createRandom()
const identity = await createIdentity(wallet, expiration)

const socialClient = await createSocialClient(
  "https://social.decentraland.org",
  "wss://social-service.decentraland.org",
  wallet.address,
  identity
);

该 createSocialClient 将执行连接到 Social Service 所需的操作，并返回已连接的客户端。

使用客户端与 Social Service 进行交互：

import { createSocialClient } from "@dcl/social-client";

const socialClient = await createSocialClient(
  "https://social.decentraland.org",
  "wss://social-service.decentraland.org",
  wallet.address,
  identity
);

const friends = socialClient.getFriends()
for await (const friend of friends) {
  console.log(friend)
}

该客户端公开了可通过以下方式使用的方法： social protobuf 以及一个 disconnect 方法，用于将客户端从 Social Service 断开连接。

生成身份

要使用 Social Service 对用户进行身份验证，你需要为他们生成一个身份。为此， @dcl/crypto 库提供了 Authenticator.initializeAuthChain 方法。使用它为你的用户生成身份：

  import { Wallet } from 'ethers'
  import { Authenticator } from '@dcl/crypto'
  // 生成一个随机钱包用于测试，或在生产环境中使用用户的钱包。
  const userWallet = Wallet.createRandom()

  // 为用户生成一个身份。
  const address = await userWallet.getAddress()
  const ephemeralWallet = Wallet.createRandom()
  const payload = {
    address: ephemeralWallet.address,
    privateKey: ephemeralWallet.privateKey,
    publicKey: ephemeralWallet.publicKey
  }
  const identity = await Authenticator.initializeAuthChain(address, payload, expiration, (message: string) => signer.signMessage(message))