Agent SDK quickstart

npm install @sorenpay/agent-sdk

import { SorenAgent } from "@sorenpay/agent-sdk";

const soren = new SorenAgent({
apiKey: process.env.SOREN_API_KEY!, // apk_…
});

// 1. Register (generates Ed25519 keypair locally; returns the private key ONCE)
const { agent, privateKeyPem } = await soren.register({
agentName: "research-assistant",
protocols: ["TAP", "MPP", "ACP"],
});
// → persist privateKeyPem to your secret store

// 2. Sign + submit a payment intent
const result = await soren.submitIntent({
agentId: agent.id,
privateKeyPem,
merchant: { name: "OpenAI API", mcc: "5734" },
amount: { currency: "USD", cents: 1500 },
protocol: "TAP",
ttlSeconds: 300,
});

console.log(result.decision, result.reason);
// → APPROVE within_limits

pip install sorenpay-agent-sdk

import os
from sorenpay_agent import SorenAgent

soren = SorenAgent(api_key=os.environ["SOREN_API_KEY"])

# 1. Register (generates Ed25519 locally)
register = soren.register(
  agent_name="research-assistant",
  protocols=["TAP", "MPP", "ACP"],
)
# → persist register.private_key_pem to your secret store

# 2. Sign + submit
result = soren.submit_intent(
  agent_id=register.agent.id,
  private_key_pem=register.private_key_pem,
  merchant={"name": "OpenAI API", "mcc": "5734"},
  amount={"currency": "USD", "cents": 1500},
  protocol="TAP",
  ttl_seconds=300,
)

print(result.decision, result.reason)

openssl genpkey -algorithm Ed25519 -out agent.key
openssl pkey -in agent.key -pubout -out agent.pub

PUBKEY=$(cat agent.pub | tr -d '\n')
curl -X POST https://api.sorenpay.com/api/agents \
-H "Authorization: Bearer $SOREN_API_KEY" \
-H "Content-Type: application/json" \
-d "{
  \"agentName\": \"research-assistant\",
  \"protocols\": [\"TAP\", \"MPP\", \"ACP\"],
  \"publicKeyPem\": \"$PUBKEY\"
}"