JavaScript SDK

npm install @peridotvault/pid-sdk-js

import { Peridot } from '@peridotvault/pid-sdk-js';

const peridot = Peridot({
  clientId: 'pidapp_…', // your registered app id
  onUnauthorized: async () => {
    // Access token expired — try to refresh silently before redirecting to login
    const ok = await peridot.auth.refresh();
    if (!ok) {
      const url = await peridot.auth.login(); // Google OAuth URL — navigate to it
      if (url) window.location.assign(url);
    }
  },
});

const url = await peridot.auth.login();
if (url) window.location.assign(url);
const { available, pid } = await peridot.auth.pidAvailable("ifal");
// { available: true, pid: "ifal@pid" }
const status = await peridot.auth.claimStatus();
// { pending: true, email, displayName, avatarUrl } when a claim is waiting
const claimed = await peridot.auth.claim("ifal");
// { ok: true, pid: "ifal@pid", pidCode? } — session cookies set

const me = await peridot.identity.me();
// { id: "ifal@pid", status: "active", createdAt: "2026-08-03T13:30:00.000Z" }

const credentials = await peridot.identity.credentials();
// [{ id: "3f9c...", provider: "google", email: "[email protected]", linkedAt, lastLoginAt }]

await peridot.identity.unlinkCredential(credentials[0].id); // true if unlinked

const profile = await peridot.profile.me();
// { pid, displayName, avatarUrl, locale, createdAt, updatedAt }

const updated = await peridot.profile.update({
  displayName: 'PeridotPlayer',
  locale: 'en-US',
});

const rows = await peridot.wallet.me();
// [{ id, chainNamespace, chainReference, address, accountType, status, ... }]
// or ApiError { statusCode: 404 } when the PID has no wallet yet

const created = await peridot.wallet.createAccount();
// idempotent ensure — same rows back on repeat calls

const bal = await peridot.fiat.balance();          // { balanceIdr, source: 'fiat-ledger', ... }
const view = await peridot.fiat.ledger();          // statement rows
const deposit = await peridot.fiat.checkoutDeposit('100000'); // → { paymentUrl, grossIdr, feeIdr, netIdr }
await peridot.fiat.syncTransaction(deposit.id);    // corroborate payment → credits the ledger
await peridot.fiat.transferViaPopup({ amountIdr: '100000', beneficiaryPid: 'live2dev@pid' });

await peridot.get('/v1/apps');
await peridot.patch(`/v1/apps/${id}`, { allowedOrigins: ['https://mygame.dev'] });
await peridot.put(`/v1/apps/${id}/fees/topup`, {
  percentBps: 200, minIdr: '0', maxIdr: '10000', enabled: true,
});

await peridot.auth.logout();

const ok = await peridot.auth.refresh(); // true if a new session was issued

const result = await peridot.profile.me();
if ('statusCode' in result && result.statusCode === 401) {
  // handle unauthenticated
}