@perkos/agent-sdk 0.3.2 → 0.5.0

package/examples/mpp-usdcx.ts

@@ -0,0 +1,91 @@
+import {
+  NayoriX402PaymentPolicy,
+  buildNayoriMppUnsignedPaymentTransaction,
+  createNayoriMppUsdcStacksChallenge,
+  createNayoriX402PaymentIntent,
+  createNayoriX402PaymentRequirements,
+  createNayoriX402Quote,
+  decodeNayoriMppChallengeHeader,
+  decodeNayoriMppUsdcStacksRequest,
+} from "@perkos/agent-sdk";
+
+const payer = "ST1THWXQ8368SDN2MJGE4BMDKMCHZ2GSVTSQDA7QF";
+const payerPublicKey =
+  "0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798";
+const payTo = "ST3AZN3BSQYJ5VWMNG92N88Z4G9498VYSHDZD9EK";
+const now = Math.floor(Date.now() / 1_000);
+const protectedRequest = {
+  method: "POST",
+  url: "https://api.nayori.ai/api/mpp/v1/research",
+  body: JSON.stringify({ topic: "Stacks agent commerce" }),
+} as const;
+
+const quote = await createNayoriX402Quote({
+  quoteId: "nq_mpp_quickstart_001",
+  merchantId: "merchant-research",
+  network: "testnet",
+  asset: "usdcx",
+  amount: 100_000n,
+  payTo,
+  ...protectedRequest,
+  issuedAt: now,
+  expiresAt: now + 300,
+});
+const challenge = await createNayoriMppUsdcStacksChallenge({
+  quote,
+  realm: "api.nayori.ai",
+  description: "Nayori agent research request",
+});
+const paymentRequirements = await createNayoriX402PaymentRequirements(quote);
+const intent = await createNayoriX402PaymentIntent({
+  quote,
+  paymentRequirements,
+  request: protectedRequest,
+  payer,
+  publicKey: payerPublicKey,
+  fee: 300n,
+  nonce: 0n,
+  nowSeconds: now,
+});
+const policy = new NayoriX402PaymentPolicy(
+  {
+    allowedNetworks: ["testnet"],
+    allowedAssets: ["usdcx"],
+    allowedRecipients: [payTo],
+    allowedOrigins: ["https://api.nayori.ai"],
+    allowedMerchantIds: ["merchant-research"],
+    maxPerTransaction: { usdcx: 100_000n },
+    maxPerSession: { usdcx: 500_000n },
+    maxFeePerTransaction: 500n,
+    maxFeePerSession: 2_500n,
+  },
+  () => now
+);
+const authorization = policy.reserve(intent);
+const unsignedTransaction = await buildNayoriMppUnsignedPaymentTransaction(intent);
+const parsedChallenge = decodeNayoriMppChallengeHeader(challenge.wwwAuthenticate);
+const paymentRequest = decodeNayoriMppUsdcStacksRequest(parsedChallenge.request);
+
+console.log(
+  JSON.stringify(
+    {
+      status: "ready-for-wallet-signature",
+      protocol: "MPP PaymentAuth",
+      challengeHeader: parsedChallenge.header,
+      method: parsedChallenge.method,
+      intent: parsedChallenge.intent,
+      profile: paymentRequest.methodDetails.type,
+      network: paymentRequest.methodDetails.stacks.network,
+      currency: paymentRequest.currency,
+      amount: paymentRequest.amount,
+      unsignedTransactionBytes: unsignedTransaction.length / 2,
+      policyRemaining: authorization.remainingThisSession.toString(),
+      walletBroadcast: false,
+      serverSettlementRequired: true,
+    },
+    null,
+    2
+  )
+);
+
+authorization.release();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perkos/agent-sdk",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "TypeScript SDK for agent identity, escrow settlement, and reputation on Stacks.",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,6 +35,8 @@
     "quickstart:x402:facilitator": "node --import tsx examples/x402-facilitator.ts",
     "prequickstart:x402:payer": "npm run build",
     "quickstart:x402:payer": "node --import tsx examples/x402-payment-intent.ts",
+    "prequickstart:mpp": "npm run build",
+    "quickstart:mpp": "node --import tsx examples/mpp-usdcx.ts",
     "prequickstart:testnet": "npm run build",
     "quickstart:testnet": "node --import tsx examples/testnet-lifecycle.ts"
   },
@@ -49,8 +51,12 @@
   "keywords": [
     "ai-agents",
     "agentic-commerce",
+    "mpp",
+    "paymentauth",
     "stacks",
     "sbtc",
+    "usdcx",
+    "x402",
     "escrow",
     "bitcoin"
   ],