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 protobuff 그리고 클라이언트를 Social Service에서 연결 해제하는 disconnect 메서드를 제공합니다.

신원 생성

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))