@pincerpay/agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PincerPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# @pincerpay/agent
+
+Agent SDK for AI agents to pay for APIs using on-chain USDC via the x402 protocol.
+
+> **ESM Required:** Your project must have `"type": "module"` in package.json. This package is ESM-only.
+
+## Install
+
+```bash
+npm install @pincerpay/agent
+```
+
+## Quick Start
+
+```typescript
+import { PincerPayAgent } from "@pincerpay/agent";
+
+const agent = await PincerPayAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+});
+
+// Automatic 402 handling — pays and retries transparently
+const response = await agent.fetch("https://api.example.com/weather");
+const data = await response.json();
+```
+
+## API Reference
+
+### `PincerPayAgent`
+
+Wraps `fetch` with automatic x402 payment handling. When a request returns HTTP 402, the agent signs a USDC transfer and retries.
+
+```typescript
+class PincerPayAgent {
+  static async create(config: AgentConfig): Promise<PincerPayAgent>;
+
+  fetch(url: string | URL, init?: RequestInit): Promise<Response>;
+
+  checkPolicy(amountBaseUnits: string): { allowed: boolean; reason?: string };
+  setPolicy(policy: Partial<SpendingPolicy>): void;
+  getDailySpend(): { date: string; amount: string };
+  recordSpend(amountBaseUnits: string): void;
+
+  get evmAddress(): string | undefined;
+  get solanaAddress(): string | undefined;
+  get chains(): string[];
+}
+```
+
+### `SolanaSmartAgent`
+
+Extended agent with Squads SPN smart account support and on-chain spending policies.
+
+```typescript
+class SolanaSmartAgent extends PincerPayAgent {
+  static override async create(
+    config: SolanaSmartAgentConfig
+  ): Promise<SolanaSmartAgent>;
+
+  get smartAccountPda(): string | undefined;
+  get settingsPda(): string | undefined;
+  get spendingLimitPda(): string | undefined;
+
+  async settleDirectly(
+    merchantId: string,
+    amountBaseUnits: string,
+    options?: { facilitatorUrl?: string; apiKey?: string; network?: string }
+  ): Promise<{ success: boolean; transactionId?: string; error?: string }>;
+
+  async checkOnChainPolicy(
+    amountBaseUnits: string,
+    rpcUrl?: string
+  ): Promise<{ allowed: boolean; reason?: string; remainingAmount?: bigint }>;
+}
+```
+
+### Config
+
+```typescript
+interface AgentConfig {
+  chains: string[];                // ["solana", "base", "polygon"]
+  evmPrivateKey?: string;          // Hex-encoded EVM key
+  solanaPrivateKey?: string;       // Base58-encoded Solana keypair
+  policies?: SpendingPolicy[];     // Client-side spending limits
+  facilitatorUrl?: string;         // Default: https://facilitator.pincerpay.com
+}
+
+interface SpendingPolicy {
+  maxPerTransaction?: string;      // Max USDC per transaction (base units)
+  maxPerDay?: string;              // Max USDC per day (base units)
+  allowedMerchants?: string[];     // Whitelist merchant addresses
+  allowedChains?: string[];        // Whitelist chain shorthands
+}
+
+// USDC base units (6 decimals): $0.01 = "10000", $0.10 = "100000", $1.00 = "1000000"
+// WARNING: Do NOT use human-readable amounts like "0.10" — BigInt("0.10") throws at runtime.
+```
+
+## Common Patterns
+
+### Solana agent with spending limits
+
+```typescript
+const agent = await PincerPayAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+  policies: [
+    {
+      maxPerTransaction: "1000000", // 1 USDC max per tx
+      maxPerDay: "10000000",        // 10 USDC max per day
+    },
+  ],
+});
+```
+
+### Multi-chain agent (Solana + EVM)
+
+```typescript
+const agent = await PincerPayAgent.create({
+  chains: ["solana", "base"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+  evmPrivateKey: process.env.AGENT_EVM_KEY!,
+});
+```
+
+### Direct settlement via Anchor program
+
+```typescript
+import { SolanaSmartAgent } from "@pincerpay/agent";
+
+const agent = await SolanaSmartAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+  smartAccountIndex: 0,
+  spendingLimitIndex: 0,
+});
+
+const result = await agent.settleDirectly("merchant-uuid", "500000", {
+  apiKey: process.env.PINCERPAY_API_KEY!,
+});
+```
+
+### Runtime policy management
+
+```typescript
+// Pre-check if a payment would be allowed
+const check = agent.checkPolicy("500000"); // 0.50 USDC
+if (!check.allowed) console.log(check.reason);
+
+// Update spending limits dynamically
+agent.setPolicy({ maxPerTransaction: "5000000", maxPerDay: "50000000" });
+
+// Monitor daily spending
+const { date, amount } = agent.getDailySpend();
+console.log(`Spent ${amount} base units on ${date}`);
+```
+
+## Anti-Patterns
+
+### Don't expose agent private keys in client-side code
+
+Agent keys should only be used in server-side or backend agent processes, never in browser environments.
+
+### Don't skip spending policies in production
+
+Without policies, an agent can spend unlimited USDC. Always set `maxPerDay` at minimum.
+
+```typescript
+// Bad — no limits
+const agent = await PincerPayAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: key,
+});
+
+// Good — bounded spending
+const agent = await PincerPayAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: key,
+  policies: [{ maxPerDay: "10000000" }], // 10 USDC/day
+});
+```
+
+### Don't use `PincerPayAgent` for merchant-side logic
+
+The agent SDK is for making payments. Use `@pincerpay/merchant` for accepting payments.

package/dist/client.d.ts

@@ -0,0 +1,74 @@
+import { x402Client } from "@x402/core/client";
+import type { AgentConfig, SpendingPolicy } from "@pincerpay/core";
+/**
+ * PincerPayAgent — wraps x402/fetch with EVM + Solana wallet support and spending policies.
+ *
+ * ```ts
+ * const agent = await PincerPayAgent.create({
+ *   chains: ["base-sepolia"],
+ *   evmPrivateKey: process.env.AGENT_EVM_KEY!,
+ * });
+ *
+ * const response = await agent.fetch("https://api.example.com/weather");
+ * ```
+ */
+export declare class PincerPayAgent {
+    private config;
+    private x402Fetch;
+    private dailySpend;
+    private dailyResetAt;
+    private _solanaAddress?;
+    /**
+     * Create a new PincerPayAgent. Use `PincerPayAgent.create()` for async initialization
+     * (required when using Solana wallets).
+     */
+    constructor(config: AgentConfig, client?: x402Client);
+    /**
+     * Async factory — use this when Solana wallets are needed.
+     * Also works for EVM-only agents.
+     */
+    static create(config: AgentConfig): Promise<PincerPayAgent>;
+    /**
+     * Payment-enabled fetch — automatically handles 402 challenges.
+     */
+    fetch(url: string | URL, init?: RequestInit): Promise<Response>;
+    /**
+     * Check if a transaction amount is within spending policy limits.
+     */
+    checkPolicy(amountBaseUnits: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Record a successful spend for daily tracking.
+     */
+    recordSpend(amountBaseUnits: string): void;
+    /** Get the agent's EVM address */
+    get evmAddress(): string | undefined;
+    /** Get the agent's Solana address (only available via PincerPayAgent.create()) */
+    get solanaAddress(): string | undefined;
+    /** Get configured chain shorthands */
+    get chains(): string[];
+    /**
+     * Replace the agent's spending policies and reset daily tracking.
+     */
+    setPolicy(policy: SpendingPolicy): void;
+    /**
+     * Get the first active spending policy, if any.
+     */
+    getPolicy(): SpendingPolicy | undefined;
+    /**
+     * Get today's tracked spend total and date.
+     */
+    getDailySpend(): {
+        date: string;
+        amount: bigint;
+    };
+    /**
+     * Register x402 hooks to enforce spending policies before payment
+     * and record spend after successful payment creation.
+     */
+    private registerPolicyHooks;
+    private resetDailyIfNeeded;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC;;;OAGG;gBACS,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,UAAU;IAsBpD;;;OAGG;WACU,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAuBjE;;OAEG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAIpB;;OAEG;IACH,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAuC3E;;OAEG;IACH,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAO1C,kCAAkC;IAClC,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED,kFAAkF;IAClF,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,sCAAsC;IACtC,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAMvC;;OAEG;IACH,SAAS,IAAI,cAAc,GAAG,SAAS;IAIvC;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IASjD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/client.js

@@ -0,0 +1,217 @@
+import { privateKeyToAccount } from "viem/accounts";
+import { x402Client } from "@x402/core/client";
+import { wrapFetchWithPayment } from "@x402/fetch";
+import { registerExactEvmScheme } from "@x402/evm/exact/client";
+import { registerExactSvmScheme } from "@x402/svm/exact/client";
+import { createKeyPairSignerFromBytes } from "@solana/kit";
+/**
+ * PincerPayAgent — wraps x402/fetch with EVM + Solana wallet support and spending policies.
+ *
+ * ```ts
+ * const agent = await PincerPayAgent.create({
+ *   chains: ["base-sepolia"],
+ *   evmPrivateKey: process.env.AGENT_EVM_KEY!,
+ * });
+ *
+ * const response = await agent.fetch("https://api.example.com/weather");
+ * ```
+ */
+export class PincerPayAgent {
+    config;
+    x402Fetch;
+    dailySpend = new Map();
+    dailyResetAt = 0;
+    _solanaAddress;
+    /**
+     * Create a new PincerPayAgent. Use `PincerPayAgent.create()` for async initialization
+     * (required when using Solana wallets).
+     */
+    constructor(config, client) {
+        this.config = config;
+        if (!config.evmPrivateKey && !config.solanaPrivateKey) {
+            throw new Error("At least one wallet key (evmPrivateKey or solanaPrivateKey) is required");
+        }
+        const x402 = client ?? new x402Client();
+        // Register EVM scheme synchronously
+        if (config.evmPrivateKey && !client) {
+            const account = privateKeyToAccount(config.evmPrivateKey);
+            registerExactEvmScheme(x402, { signer: account });
+        }
+        // Register spending policy hooks
+        this.registerPolicyHooks(x402);
+        // Wrap global fetch with x402 payment handling
+        this.x402Fetch = wrapFetchWithPayment(globalThis.fetch, x402);
+    }
+    /**
+     * Async factory — use this when Solana wallets are needed.
+     * Also works for EVM-only agents.
+     */
+    static async create(config) {
+        const client = new x402Client();
+        // Register EVM scheme
+        if (config.evmPrivateKey) {
+            const account = privateKeyToAccount(config.evmPrivateKey);
+            registerExactEvmScheme(client, { signer: account });
+        }
+        // Register Solana scheme (async — needs key derivation)
+        let solanaAddress;
+        if (config.solanaPrivateKey) {
+            const keyBytes = base58Decode(config.solanaPrivateKey);
+            const keypairSigner = await createKeyPairSignerFromBytes(keyBytes);
+            registerExactSvmScheme(client, { signer: keypairSigner });
+            solanaAddress = keypairSigner.address;
+        }
+        const agent = new PincerPayAgent(config, client);
+        agent._solanaAddress = solanaAddress;
+        return agent;
+    }
+    /**
+     * Payment-enabled fetch — automatically handles 402 challenges.
+     */
+    async fetch(url, init) {
+        return this.x402Fetch(url.toString(), init);
+    }
+    /**
+     * Check if a transaction amount is within spending policy limits.
+     */
+    checkPolicy(amountBaseUnits) {
+        const policies = this.config.policies;
+        if (!policies || policies.length === 0) {
+            return { allowed: true };
+        }
+        const amount = BigInt(amountBaseUnits);
+        for (const policy of policies) {
+            // Per-transaction limit
+            if (policy.maxPerTransaction) {
+                const max = BigInt(policy.maxPerTransaction);
+                if (amount > max) {
+                    return {
+                        allowed: false,
+                        reason: `Exceeds per-transaction limit: ${amountBaseUnits} > ${policy.maxPerTransaction}`,
+                    };
+                }
+            }
+            // Daily limit
+            if (policy.maxPerDay) {
+                this.resetDailyIfNeeded();
+                const todayKey = new Date().toISOString().slice(0, 10);
+                const currentSpend = this.dailySpend.get(todayKey) ?? 0n;
+                const max = BigInt(policy.maxPerDay);
+                if (currentSpend + amount > max) {
+                    return {
+                        allowed: false,
+                        reason: `Exceeds daily limit: ${currentSpend + amount} > ${policy.maxPerDay}`,
+                    };
+                }
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record a successful spend for daily tracking.
+     */
+    recordSpend(amountBaseUnits) {
+        this.resetDailyIfNeeded();
+        const todayKey = new Date().toISOString().slice(0, 10);
+        const current = this.dailySpend.get(todayKey) ?? 0n;
+        this.dailySpend.set(todayKey, current + BigInt(amountBaseUnits));
+    }
+    /** Get the agent's EVM address */
+    get evmAddress() {
+        if (!this.config.evmPrivateKey)
+            return undefined;
+        return privateKeyToAccount(this.config.evmPrivateKey).address;
+    }
+    /** Get the agent's Solana address (only available via PincerPayAgent.create()) */
+    get solanaAddress() {
+        return this._solanaAddress;
+    }
+    /** Get configured chain shorthands */
+    get chains() {
+        return this.config.chains;
+    }
+    /**
+     * Replace the agent's spending policies and reset daily tracking.
+     */
+    setPolicy(policy) {
+        this.config.policies = [policy];
+        this.dailySpend.clear();
+        this.dailyResetAt = 0;
+    }
+    /**
+     * Get the first active spending policy, if any.
+     */
+    getPolicy() {
+        return this.config.policies?.[0];
+    }
+    /**
+     * Get today's tracked spend total and date.
+     */
+    getDailySpend() {
+        this.resetDailyIfNeeded();
+        const todayKey = new Date().toISOString().slice(0, 10);
+        return {
+            date: todayKey,
+            amount: this.dailySpend.get(todayKey) ?? 0n,
+        };
+    }
+    /**
+     * Register x402 hooks to enforce spending policies before payment
+     * and record spend after successful payment creation.
+     */
+    registerPolicyHooks(client) {
+        if (!this.config.policies || this.config.policies.length === 0)
+            return;
+        // Before payment: enforce spending limits
+        client.onBeforePaymentCreation(async (ctx) => {
+            const amount = String(ctx.selectedRequirements.maxAmountRequired ?? ctx.selectedRequirements.amount ?? "0");
+            const check = this.checkPolicy(amount);
+            if (!check.allowed) {
+                return { abort: true, reason: check.reason };
+            }
+        });
+        // After payment: track spend for daily limits
+        client.onAfterPaymentCreation(async (ctx) => {
+            const amount = String(ctx.selectedRequirements.maxAmountRequired ?? ctx.selectedRequirements.amount ?? "0");
+            this.recordSpend(amount);
+        });
+    }
+    resetDailyIfNeeded() {
+        const now = Date.now();
+        if (now > this.dailyResetAt) {
+            this.dailySpend.clear();
+            // Reset at midnight UTC
+            const tomorrow = new Date();
+            tomorrow.setUTCHours(24, 0, 0, 0);
+            this.dailyResetAt = tomorrow.getTime();
+        }
+    }
+}
+/**
+ * Minimal base58 decoder for Solana private keys.
+ * Avoids pulling in @scure/base as a dependency for the agent SDK.
+ */
+function base58Decode(input) {
+    const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+    const BASE = BigInt(58);
+    let num = 0n;
+    for (const char of input) {
+        const idx = ALPHABET.indexOf(char);
+        if (idx === -1)
+            throw new Error(`Invalid base58 character: ${char}`);
+        num = num * BASE + BigInt(idx);
+    }
+    // Count leading zeros
+    let leadingZeros = 0;
+    for (const char of input) {
+        if (char !== "1")
+            break;
+        leadingZeros++;
+    }
+    // Convert to bytes (pad hex to even length so .match(/.{2}/g) doesn't drop a nibble)
+    const rawHex = num.toString(16);
+    const hex = rawHex.length % 2 ? "0" + rawHex : rawHex;
+    const bytes = hex.match(/.{2}/g)?.map((b) => parseInt(b, 16)) ?? [];
+    return new Uint8Array([...new Array(leadingZeros).fill(0), ...bytes]);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { PincerPayAgent } from "./client.js";
+export { SolanaSmartAgent } from "./solana-agent.js";
+export type { AgentConfig, SpendingPolicy, SolanaSmartAgentConfig, AgentStatus, AgentProfile } from "@pincerpay/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { PincerPayAgent } from "./client.js";
+export { SolanaSmartAgent } from "./solana-agent.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/solana-agent.d.ts

@@ -0,0 +1,95 @@
+import type { Instruction } from "@solana/kit";
+import { type SolanaSmartAgentConfig } from "@pincerpay/core";
+import { SpendingLimitPeriod } from "@pincerpay/solana/squads";
+import { PincerPayAgent } from "./client.js";
+/**
+ * SolanaSmartAgent — extends PincerPayAgent with Squads Smart Account support.
+ *
+ * Spending limits are enforced on-chain via the Squads program, not in-memory.
+ * This agent performs an optimistic pre-check against the on-chain spending limit
+ * before each payment, but the real enforcement happens at the transaction level.
+ *
+ * ```ts
+ * const agent = await SolanaSmartAgent.create({
+ *   chains: ["solana"],
+ *   solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+ *   smartAccountIndex: 0,
+ *   spendingLimitIndex: 0,
+ * });
+ *
+ * const response = await agent.fetch("https://api.example.com/weather");
+ * ```
+ */
+export declare class SolanaSmartAgent extends PincerPayAgent {
+    private smartConfig;
+    private _smartAccountPda?;
+    private _settingsPda?;
+    private _spendingLimitPda?;
+    private constructor();
+    /**
+     * Async factory — initializes the Solana wallet, derives Squads PDAs,
+     * and optionally validates on-chain state.
+     */
+    static create(config: SolanaSmartAgentConfig): Promise<SolanaSmartAgent>;
+    /** Get the Squads Smart Account PDA */
+    get smartAccountPda(): string | undefined;
+    /** Get the Squads Settings PDA */
+    get settingsPda(): string | undefined;
+    /** Get the Squads Spending Limit PDA */
+    get spendingLimitPda(): string | undefined;
+    /**
+     * Settle a payment directly via the Anchor program (bypassing x402).
+     * Calls POST /v1/settle-direct on the facilitator.
+     *
+     * Returns the settlement response including the on-chain accounts needed
+     * for the agent to construct and sign the settle_payment instruction.
+     */
+    settleDirectly(merchantId: string, amountBaseUnits: string, options?: {
+        facilitatorUrl?: string;
+        apiKey?: string;
+        network?: string;
+    }): Promise<{
+        success: boolean;
+        transactionId?: string;
+        accounts?: Record<string, string>;
+        error?: string;
+    }>;
+    /**
+     * Build a createSmartAccount instruction using this agent's config.
+     * The caller is responsible for signing and sending.
+     */
+    buildCreateSmartAccountInstruction(params?: {
+        members?: string[];
+        threshold?: number;
+    }): Promise<Instruction>;
+    /**
+     * Build an addSpendingLimit instruction for this agent's Smart Account.
+     * Requires a Smart Account to be configured.
+     */
+    buildAddSpendingLimitInstruction(params: {
+        mint: string;
+        amount: bigint;
+        period: SpendingLimitPeriod;
+        members?: string[];
+        destinations?: string[];
+        authority: string;
+    }): Promise<Instruction>;
+    /**
+     * Build a removeSpendingLimit instruction for this agent's Smart Account.
+     * Requires a Smart Account to be configured.
+     */
+    buildRevokeSpendingLimitInstruction(params: {
+        authority: string;
+        rentCollector?: string;
+    }): Promise<Instruction>;
+    /**
+     * Check on-chain spending limit before payment.
+     * This is an optimistic pre-check — the real enforcement is on-chain.
+     */
+    checkOnChainPolicy(amountBaseUnits: string, rpcUrl?: string): Promise<{
+        allowed: boolean;
+        reason?: string;
+        remainingAmount?: bigint;
+    }>;
+}
+//# sourceMappingURL=solana-agent.d.ts.map

package/dist/solana-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-agent.d.ts","sourceRoot":"","sources":["../src/solana-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAQL,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAC,CAAS;IAEnC,OAAO;IAKP;;;OAGG;WACmB,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCvF,uCAAuC;IACvC,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,kCAAkC;IAClC,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,wCAAwC;IACxC,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED;;;;;;OAMG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAmCF;;;OAGG;IACG,kCAAkC,CAAC,MAAM,CAAC,EAAE;QAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBxB;;;OAGG;IACG,gCAAgC,CAAC,MAAM,EAAE;QAC7C,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,mBAAmB,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBxB;;;OAGG;IACG,mCAAmC,CAAC,MAAM,EAAE;QAChD,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,WAAW,CAAC;IAaxB;;;OAGG;IACG,kBAAkB,CACtB,eAAe,EAAE,MAAM,EACvB,MAAM,SAAkC,GACvC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CA8B5E"}

package/dist/solana-agent.js

@@ -0,0 +1,190 @@
+import { createSolanaRpc } from "@solana/kit";
+import { DEFAULT_FACILITATOR_URL } from "@pincerpay/core";
+import { deriveSmartAccountPda, deriveSettingsPda, deriveSpendingLimitPda, checkSpendingLimit, createSmartAccountInstruction, addSpendingLimitInstruction, removeSpendingLimitInstruction, SpendingLimitPeriod, } from "@pincerpay/solana/squads";
+import { PincerPayAgent } from "./client.js";
+/**
+ * SolanaSmartAgent — extends PincerPayAgent with Squads Smart Account support.
+ *
+ * Spending limits are enforced on-chain via the Squads program, not in-memory.
+ * This agent performs an optimistic pre-check against the on-chain spending limit
+ * before each payment, but the real enforcement happens at the transaction level.
+ *
+ * ```ts
+ * const agent = await SolanaSmartAgent.create({
+ *   chains: ["solana"],
+ *   solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+ *   smartAccountIndex: 0,
+ *   spendingLimitIndex: 0,
+ * });
+ *
+ * const response = await agent.fetch("https://api.example.com/weather");
+ * ```
+ */
+export class SolanaSmartAgent extends PincerPayAgent {
+    smartConfig;
+    _smartAccountPda;
+    _settingsPda;
+    _spendingLimitPda;
+    constructor(config) {
+        super(config);
+        this.smartConfig = config;
+    }
+    /**
+     * Async factory — initializes the Solana wallet, derives Squads PDAs,
+     * and optionally validates on-chain state.
+     */
+    static async create(config) {
+        // Create the base agent (registers Solana x402 scheme)
+        const baseAgent = await PincerPayAgent.create(config);
+        // Create SolanaSmartAgent and transfer state
+        const agent = new SolanaSmartAgent(config);
+        // Copy over the Solana address from base agent
+        Object.defineProperty(agent, "_solanaAddress", {
+            value: baseAgent.solanaAddress,
+            writable: true,
+        });
+        // Derive Squads PDAs if configured
+        const solanaAddr = baseAgent.solanaAddress;
+        if (solanaAddr && config.smartAccountIndex !== undefined) {
+            const [smartPda] = await deriveSmartAccountPda(solanaAddr, config.smartAccountIndex);
+            agent._smartAccountPda = smartPda;
+            const [settingsPda] = await deriveSettingsPda(smartPda);
+            agent._settingsPda = config.settingsPda ?? settingsPda;
+            if (config.spendingLimitIndex !== undefined) {
+                const [limitPda] = await deriveSpendingLimitPda(smartPda, config.spendingLimitIndex);
+                agent._spendingLimitPda = limitPda;
+            }
+        }
+        return agent;
+    }
+    /** Get the Squads Smart Account PDA */
+    get smartAccountPda() {
+        return this._smartAccountPda;
+    }
+    /** Get the Squads Settings PDA */
+    get settingsPda() {
+        return this._settingsPda;
+    }
+    /** Get the Squads Spending Limit PDA */
+    get spendingLimitPda() {
+        return this._spendingLimitPda;
+    }
+    /**
+     * Settle a payment directly via the Anchor program (bypassing x402).
+     * Calls POST /v1/settle-direct on the facilitator.
+     *
+     * Returns the settlement response including the on-chain accounts needed
+     * for the agent to construct and sign the settle_payment instruction.
+     */
+    async settleDirectly(merchantId, amountBaseUnits, options) {
+        const facilitatorUrl = options?.facilitatorUrl
+            ?? this.smartConfig.facilitatorUrl
+            ?? DEFAULT_FACILITATOR_URL;
+        const solanaAddr = this.solanaAddress;
+        if (!solanaAddr) {
+            return { success: false, error: "No Solana address configured" };
+        }
+        try {
+            const response = await globalThis.fetch(`${facilitatorUrl}/v1/settle-direct`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...(options?.apiKey ? { "x-pincerpay-api-key": options.apiKey } : {}),
+                },
+                body: JSON.stringify({
+                    agentAddress: solanaAddr,
+                    merchantId,
+                    amount: amountBaseUnits,
+                    network: options?.network ?? "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+                }),
+            });
+            const result = await response.json();
+            return result;
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    /**
+     * Build a createSmartAccount instruction using this agent's config.
+     * The caller is responsible for signing and sending.
+     */
+    async buildCreateSmartAccountInstruction(params) {
+        const solanaAddr = this.solanaAddress;
+        if (!solanaAddr)
+            throw new Error("No Solana address configured");
+        const accountIndex = this.smartConfig.smartAccountIndex ?? 0;
+        const members = params?.members?.map((m) => m) ?? [solanaAddr];
+        const threshold = params?.threshold ?? 1;
+        return createSmartAccountInstruction({
+            creator: solanaAddr,
+            accountIndex,
+            members,
+            threshold,
+        });
+    }
+    /**
+     * Build an addSpendingLimit instruction for this agent's Smart Account.
+     * Requires a Smart Account to be configured.
+     */
+    async buildAddSpendingLimitInstruction(params) {
+        if (!this._smartAccountPda)
+            throw new Error("No Smart Account PDA configured");
+        const solanaAddr = this.solanaAddress;
+        const spendingLimitIndex = this.smartConfig.spendingLimitIndex ?? 0;
+        const members = params.members?.map((m) => m) ?? (solanaAddr ? [solanaAddr] : []);
+        return addSpendingLimitInstruction({
+            smartAccountPda: this._smartAccountPda,
+            mint: params.mint,
+            amount: params.amount,
+            period: params.period,
+            members,
+            destinations: params.destinations?.map((d) => d) ?? [],
+        }, spendingLimitIndex, params.authority);
+    }
+    /**
+     * Build a removeSpendingLimit instruction for this agent's Smart Account.
+     * Requires a Smart Account to be configured.
+     */
+    async buildRevokeSpendingLimitInstruction(params) {
+        if (!this._smartAccountPda)
+            throw new Error("No Smart Account PDA configured");
+        const spendingLimitIndex = this.smartConfig.spendingLimitIndex ?? 0;
+        return removeSpendingLimitInstruction({
+            smartAccountPda: this._smartAccountPda,
+            spendingLimitIndex,
+            authority: params.authority,
+            rentCollector: (params.rentCollector ?? params.authority),
+        });
+    }
+    /**
+     * Check on-chain spending limit before payment.
+     * This is an optimistic pre-check — the real enforcement is on-chain.
+     */
+    async checkOnChainPolicy(amountBaseUnits, rpcUrl = "https://api.devnet.solana.com") {
+        if (!this._smartAccountPda || this.smartConfig.spendingLimitIndex === undefined) {
+            // No Squads spending limit configured — fall back to in-memory policy
+            return this.checkPolicy(amountBaseUnits);
+        }
+        const result = await checkSpendingLimit(this._smartAccountPda, this.smartConfig.spendingLimitIndex, rpcUrl);
+        if (!result) {
+            return {
+                allowed: false,
+                reason: "Spending limit account not found on-chain",
+            };
+        }
+        const amount = BigInt(amountBaseUnits);
+        if (result.remainingAmount !== undefined && amount > result.remainingAmount) {
+            return {
+                allowed: false,
+                reason: `Exceeds on-chain spending limit: ${amountBaseUnits} > ${result.remainingAmount}`,
+                remainingAmount: result.remainingAmount,
+            };
+        }
+        return { allowed: true, remainingAmount: result.remainingAmount };
+    }
+}
+//# sourceMappingURL=solana-agent.js.map

package/dist/solana-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-agent.js","sourceRoot":"","sources":["../src/solana-agent.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@pincerpay/agent",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Agent SDK for PincerPay. Drop-in fetch wrapper that handles x402 payment flows automatically.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://pincerpay.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ds1/pincerpay.git",
+    "directory": "packages/agent"
+  },
+  "bugs": {
+    "url": "https://github.com/ds1/pincerpay/issues"
+  },
+  "keywords": [
+    "pincerpay",
+    "x402",
+    "usdc",
+    "payments",
+    "ai-agents",
+    "solana",
+    "agent-sdk",
+    "payment-gateway",
+    "stablecoin"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@solana/kit": "^5.5.1",
+    "@x402/core": "^2.3",
+    "@x402/evm": "^2.3",
+    "@x402/fetch": "^2.3",
+    "@x402/svm": "^2.3.0",
+    "viem": "^2",
+    "zod": "^3.24",
+    "@pincerpay/core": "0.1.0",
+    "@pincerpay/solana": "0.1.0"
+  },
+  "devDependencies": {
+    "@scure/base": "^1.2.6",
+    "typescript": "^5.7"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}