Démarrage rapide

Dans ce guide, vous créez un agent dans l'application Pacerelle, lancez un petit programme sur votre ordinateur et échangez avec lui votre premier message chiffré de bout en bout.

Prérequis : un compte Pacerelle et Node.js 20+ ou Python 3.12.

PACERELLE_AGENT_ID=agent_...
PACERELLE_AGENT_TOKEN=...

npm init -y
npm install @pacerelle/sdk

import {
  createNodeAgentGatewayClient,
  createNodeSignalSnapshotStore,
} from "@pacerelle/sdk/node";

const agentId = process.env.PACERELLE_AGENT_ID;
const token = process.env.PACERELLE_AGENT_TOKEN;

// Conserve les clés de chiffrement de l'agent entre deux redémarrages.
const state = createNodeSignalSnapshotStore(agentId);

const client = createNodeAgentGatewayClient({
  agentId,
  token,
  e2ee: true,
  signalSnapshot: state.signalSnapshot,
  onSignalSnapshot: state.onSignalSnapshot,
  onOpen: () => console.log("Connecté. Envoyez un message depuis Pacerelle."),
});

client.onMessage(async (message, agent) => {
  await agent.reply(message, { text: `Vous avez dit : ${message.text}` });
});

await client.connect();

node --env-file=.env agent.mjs

C'est tout : votre téléphone et votre ordinateur viennent d'échanger un message chiffré de bout en bout via Pacerelle, sans ouvrir le moindre port.

Ce qui vient de se passer

1. Au démarrage, le SDK a généré les clés de chiffrement de l'agent, publié ses clés publiques et ouvert un WebSocket sortant et authentifié vers Pacerelle.
2. Votre application a chiffré Bonjour pour les clés de votre agent. Le relais n'a stocké et transmis que du contenu chiffré.
3. Le SDK a déchiffré le message sur votre machine et appelé votre fonction.
4. Votre réponse a été chiffrée localement puis livrée dans la même conversation.

Étapes suivantes