# JavaScript Client

Esta documentação é extraída de [social-rpc-client-js](https://github.com/decentraland/social-rpc-client-js#using-the-client)

#### Configuração básica e uso

Para usar o client, instale o pacote no seu projeto NPM:

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

Importe a função criadora do client a partir do pacote instalado:

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

Crie uma nova instância do client fornecendo ao client:

1. Uma URL para a REST API do Social Service
2. Uma URL para o endpoint WebSocket do Social Service
3. O endereço do usuário (o mesmo usado para assinar a identidade)
4. Uma identidade, assinada com a wallet do usuário.

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

// Gere uma wallet aleatória para fins de teste ou use a do usuário em ambientes de produção.
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
);
```

O `createSocialClient` irá executar as operações necessárias para conectar-se ao Social Service e retornará o client conectado.

Use o client para interagir com o Social Service:

```typescript
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)
}
```

O client expõe os métodos disponíveis através do [social protobuff](https://github.com/decentraland/protocol/blob/main/public/social.proto) e um método disconnect que desconecta o client do Social Service.

#### Gerando uma identidade

Para autenticar usuários com o Social Service, você precisará gerar uma identidade para eles. Para isso, a `@dcl/crypto` biblioteca fornece o `Authenticator.initializeAuthChain` método. Use-o para gerar uma identidade para seus usuários:

```typescript
  import { Wallet } from 'ethers'
  import { Authenticator } from '@dcl/crypto'
  // Gere uma wallet aleatória para fins de teste ou use a do usuário em ambientes de produção.
  const userWallet = Wallet.createRandom()

  // Gere uma identidade para o usuário.
  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))
```