SDK Quickstart

1
import { Gwop } from "@gwop/sdk";
2
3
const gwop = new Gwop({
4
  merchantApiKey: process.env.GWOP_MERCHANT_API_KEY,
5
});
6
7
const { result: invoice } = await gwop.invoices.create({
8
  idempotencyKey: crypto.randomUUID(),
9
  body: {
10
    amountUsdc: 5_000_000, // $5.00 USDC (6 decimals)
11
    description: "Starter plan — 300 credits",
12
  },
13
});
14
15
console.log(invoice.publicInvoiceId); // inv_7dbeeaad...
16
console.log(invoice.agentProtocol);   // Machine-readable payment instructions

1
// 1. Create an auth challenge ($0.001 USDC dust payment)
2
const { result: intent } = await gwop.authIntents.create({
3
  idempotencyKey: crypto.randomUUID(),
4
});
5
6
// 2. Agent pays the challenge via x402 — proving wallet ownership
7
8
// 3. Exchange for a JWT
9
const { result: token } = await gwop.authIntents.exchange({
10
  authIntentId: intent.authIntentId,
11
  idempotencyKey: crypto.randomUUID(),
12
});
13
14
console.log(token.principal.sub);        // "base:0x742d..." — the agent's identity
15
console.log(token.account.isNewAccount); // true on first auth

1
const gwop = new Gwop({
2
  merchantApiKey: process.env.GWOP_MERCHANT_API_KEY,
3
  webhookSecret: process.env.GWOP_WEBHOOK_SECRET,
4
});
5
6
const event = await gwop.validateWebhook({ request });
7
8
if (event.body.eventType === "invoice.paid") {
9
  console.log(event.body.data.publicInvoiceId);
10
  console.log(event.body.data.paymentChain); // "base" or "solana"
11
}