npm install portal-sdk

Add Jitpack and the dependency to your build.gradle:

repositories { maven { url 'https://jitpack.io' } }
dependencies { implementation 'com.github.PortalTechnologiesInc:java-sdk:0.1.0' }

See Installation for Maven and full details.

Create a file (e.g. portal-demo.js or portal-demo.ts):

import { PortalSDK } from 'portal-sdk';

async function main() {
  const client = new PortalSDK({
    serverUrl: process.env.PORTAL_URL || 'ws://localhost:3000/ws',
  });

  await client.connect();
  await client.authenticate(process.env.PORTAL_AUTH_TOKEN || 'my-secret-token');

  console.log('Connected to Portal');
}
main().catch(console.error);

Run it (with env set if you use Option B):

PORTAL_AUTH_TOKEN=my-secret-token node portal-demo.js

Create a PortalSDK with your health and WebSocket endpoints, then connect with your auth token:

var portalSDK = new PortalSDK("http://localhost:3000/health", "ws://localhost:3000/ws");
portalSDK.connect("my-secret-token");

See Basic Usage for full usage.

const url = await client.newKeyHandshakeUrl((mainKey, preferredRelays) => {
  console.log('User authenticated with key:', mainKey);
});

console.log('Share this URL with your user:');
console.log(url);

Run the script, open the URL in a browser, and approve in your wallet. You should see the user’s key in the console.

Use KeyHandshakeUrlRequest and sendCommand to get an auth URL; handle the response in the callback. See API Reference and Authentication guide.