@pincerpay/solana 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,178 @@
+# @pincerpay/solana
+
+Solana infrastructure integrations for PincerPay: Kora gasless transactions and Squads SPN smart accounts.
+
+## Install
+
+```bash
+npm install @pincerpay/solana
+```
+
+## Kora (Gasless Transactions)
+
+Agents pay transaction fees in USDC instead of SOL via Kora signer nodes.
+
+### Quick Start
+
+```typescript
+import { createKoraClient, createKoraFacilitatorSvmSigner } from "@pincerpay/solana/kora";
+
+// Low-level client
+const kora = createKoraClient({
+  rpcUrl: "https://your-kora-node.example.com",
+  apiKey: "optional-api-key",
+});
+
+const feePayer = await kora.getFeePayer();
+
+// x402 facilitator integration
+const signer = createKoraFacilitatorSvmSigner({
+  config: { rpcUrl: "https://your-kora-node.example.com" },
+  rpcUrls: { "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": "https://api.devnet.solana.com" },
+});
+
+await signer.init(); // Fetches fee payer address
+```
+
+### API Reference
+
+```typescript
+interface KoraConfig {
+  rpcUrl: string;
+  apiKey?: string;
+}
+
+function createKoraClient(config: KoraConfig): KoraRpcClient;
+
+function createKoraFacilitatorSvmSigner(options: {
+  config: KoraConfig;
+  rpcUrls?: Record<string, string>;
+}): FacilitatorSvmSigner & { init(): Promise<void> };
+
+function parseKoraConfig(
+  env: Record<string, string | undefined>
+): KoraConfig | null;
+```
+
+## Squads SPN (Smart Accounts)
+
+Decentralized policy co-signer for agent sub-accounts with on-chain spending limits.
+
+### Quick Start
+
+```typescript
+import {
+  deriveSmartAccountPda,
+  createSpendingLimit,
+  checkSpendingLimit,
+  SpendingLimitPeriod,
+} from "@pincerpay/solana/squads";
+
+// Derive smart account PDA
+const [smartAccountPda] = await deriveSmartAccountPda(creatorAddress, 0);
+
+// Create a daily spending limit
+const ix = await createSpendingLimit(
+  {
+    smartAccountPda,
+    mint: usdcMintAddress,
+    amount: 10_000_000n, // 10 USDC
+    period: SpendingLimitPeriod.Day,
+    members: [agentAddress],
+    destinations: [merchantAddress],
+  },
+  0, // spending limit index
+  authorityAddress
+);
+
+// Check remaining allowance
+const limit = await checkSpendingLimit(smartAccountPda, 0, rpcUrl);
+// { exists: true, remainingAmount: 8_000_000n, period: "Day" }
+```
+
+### API Reference
+
+#### PDA Derivation
+
+```typescript
+async function deriveSmartAccountPda(
+  creator: Address, accountIndex: number, programId?: Address
+): Promise<[Address, number]>;
+
+async function deriveSettingsPda(
+  smartAccountPda: Address, programId?: Address
+): Promise<[Address, number]>;
+
+async function deriveSpendingLimitPda(
+  smartAccountPda: Address, spendingLimitIndex: number, programId?: Address
+): Promise<[Address, number]>;
+```
+
+#### Spending Limit Management
+
+```typescript
+async function createSpendingLimit(
+  config: SpendingLimitConfig, spendingLimitIndex: number, authority: Address
+): Promise<Instruction>;
+
+async function checkSpendingLimit(
+  smartAccountPda: Address, spendingLimitIndex: number, rpcUrl: string
+): Promise<{ exists: boolean; remainingAmount?: bigint; period?: SpendingLimitPeriod } | null>;
+
+async function revokeSpendingLimit(
+  smartAccountPda: Address, spendingLimitIndex: number, authority: Address, rentCollector: Address
+): Promise<Instruction>;
+```
+
+#### Types
+
+```typescript
+enum SpendingLimitPeriod {
+  OneTime = 0,
+  Day = 1,
+  Week = 2,
+  Month = 3,
+}
+
+interface SpendingLimitConfig {
+  smartAccountPda: Address;
+  mint: Address;
+  amount: bigint;
+  period: SpendingLimitPeriod;
+  members: Address[];
+  destinations: Address[];
+}
+
+interface SmartAccountConfig {
+  creator: Address;
+  accountIndex: number;
+  members: Address[];
+  threshold: number;
+}
+
+const SQUADS_PROGRAM_ID = "SMRTzfY6DfH5ik3TKiyLFfXexV8uSG3d2UksSCYdunG";
+```
+
+## Common Patterns
+
+### Kora + Squads together
+
+```typescript
+import { createKoraFacilitatorSvmSigner } from "@pincerpay/solana/kora";
+import { deriveSmartAccountPda, checkSpendingLimit } from "@pincerpay/solana/squads";
+
+// Agent pays gas in USDC (Kora) + has on-chain spending limits (Squads)
+const signer = createKoraFacilitatorSvmSigner({ config: koraConfig });
+const [smartAccount] = await deriveSmartAccountPda(creator, 0);
+const limit = await checkSpendingLimit(smartAccount, 0, rpcUrl);
+```
+
+## Anti-Patterns
+
+### Don't skip `signer.init()` for Kora
+
+The Kora signer must call `init()` before use — it fetches the fee payer address from the Kora node.
+
+### Don't use Squads on EVM
+
+Squads SPN is Solana-only. For EVM agent permissions, use ERC-7715 session keys instead.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./kora/index.js";
+export * from "./squads/index.js";
+//# 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,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./kora/index.js";
+export * from "./squads/index.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,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/kora/config.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const koraConfigSchema: z.ZodObject<{
+    /** Kora RPC endpoint URL */
+    rpcUrl: z.ZodString;
+    /** Kora API key for authentication (optional, depends on Kora node config) */
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    rpcUrl: string;
+    apiKey?: string | undefined;
+}, {
+    rpcUrl: string;
+    apiKey?: string | undefined;
+}>;
+export type KoraConfig = z.infer<typeof koraConfigSchema>;
+/**
+ * Parse Kora configuration from environment variables.
+ * Returns null if KORA_RPC_URL is not set.
+ */
+export declare function parseKoraConfig(env: Record<string, string | undefined>): KoraConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/kora/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/kora/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;IAC3B,4BAA4B;;IAE5B,8EAA8E;;;;;;;;EAE9E,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,UAAU,GAAG,IAAI,CAM1F"}

package/dist/kora/config.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export const koraConfigSchema = z.object({
+    /** Kora RPC endpoint URL */
+    rpcUrl: z.string().url(),
+    /** Kora API key for authentication (optional, depends on Kora node config) */
+    apiKey: z.string().optional(),
+});
+/**
+ * Parse Kora configuration from environment variables.
+ * Returns null if KORA_RPC_URL is not set.
+ */
+export function parseKoraConfig(env) {
+    if (!env.KORA_RPC_URL)
+        return null;
+    return koraConfigSchema.parse({
+        rpcUrl: env.KORA_RPC_URL,
+        apiKey: env.KORA_API_KEY,
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/kora/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/kora/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,4BAA4B;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuC;IACrE,IAAI,CAAC,GAAG,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,gBAAgB,CAAC,KAAK,CAAC;QAC5B,MAAM,EAAE,GAAG,CAAC,YAAY;QACxB,MAAM,EAAE,GAAG,CAAC,YAAY;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/kora/index.d.ts

@@ -0,0 +1,5 @@
+export { createKoraFacilitatorSvmSigner, createKoraClient } from "./signer.js";
+export type { KoraRpcClient } from "./signer.js";
+export { parseKoraConfig, koraConfigSchema } from "./config.js";
+export type { KoraConfig } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/kora/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kora/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/kora/index.js

@@ -0,0 +1,3 @@
+export { createKoraFacilitatorSvmSigner, createKoraClient } from "./signer.js";
+export { parseKoraConfig, koraConfigSchema } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/kora/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kora/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/kora/signer.d.ts

@@ -0,0 +1,52 @@
+import type { FacilitatorSvmSigner } from "@x402/svm";
+import type { KoraConfig } from "./config.js";
+/**
+ * Kora RPC client interface — minimal subset of JSON-RPC methods we use.
+ * Kora exposes standard Solana RPC + custom methods for gasless transactions.
+ */
+interface KoraPayerSignerResult {
+    signer_address: string;
+    payment_address: string;
+}
+interface KoraSignResult {
+    signature: string;
+    signed_transaction: string;
+    signer_pubkey: string;
+}
+interface KoraRpcClient {
+    /** Fetch the Kora signer node's payer signer info (address + payment destination) */
+    getPayerSigner(): Promise<KoraPayerSignerResult>;
+    /** Sign a base64-encoded transaction with the Kora fee payer */
+    signTransaction(params: {
+        transaction: string;
+    }): Promise<KoraSignResult>;
+    /** Sign and send a base64-encoded transaction via the Kora signer node */
+    signAndSendTransaction(params: {
+        transaction: string;
+    }): Promise<KoraSignResult>;
+}
+/**
+ * Minimal Kora JSON-RPC client. Calls Kora's custom RPC methods.
+ */
+declare function createKoraClient(config: KoraConfig): KoraRpcClient;
+interface KoraFacilitatorSvmSignerOptions {
+    config: KoraConfig;
+    /** Override Solana RPC URLs per network (CAIP-2 → URL) */
+    rpcUrls?: Record<string, string>;
+}
+/**
+ * Creates a FacilitatorSvmSigner backed by a Kora signer node.
+ *
+ * Kora handles fee payment in USDC (or other SPL tokens) instead of SOL.
+ * The facilitator delegates transaction signing to the Kora node which:
+ * 1. Adds its fee payer as the transaction fee payer
+ * 2. Signs the transaction with its fee payer key
+ * 3. Charges the agent in USDC for gas costs
+ *
+ * IMPORTANT: Call `await signer.init()` before using — fetches the fee payer address.
+ */
+export declare function createKoraFacilitatorSvmSigner(options: KoraFacilitatorSvmSignerOptions): FacilitatorSvmSigner & {
+    init(): Promise<void>;
+};
+export { createKoraClient, type KoraRpcClient };
+//# sourceMappingURL=signer.d.ts.map

package/dist/kora/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/kora/signer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,UAAU,qBAAqB;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,aAAa;IACrB,qFAAqF;IACrF,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjD,gEAAgE;IAChE,eAAe,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1E,0EAA0E;IAC1E,sBAAsB,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAoC3D;AAED,UAAU,+BAA+B;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,oBAAoB,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA6HlD;AAED,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,CAAC"}

package/dist/kora/signer.js

@@ -0,0 +1,151 @@
+import { createSolanaRpc, signature } from "@solana/kit";
+/**
+ * Minimal Kora JSON-RPC client. Calls Kora's custom RPC methods.
+ */
+function createKoraClient(config) {
+    let requestId = 0;
+    async function rpcCall(method, params) {
+        const headers = { "Content-Type": "application/json" };
+        if (config.apiKey) {
+            headers["Authorization"] = `Bearer ${config.apiKey}`;
+        }
+        const res = await fetch(config.rpcUrl, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: ++requestId,
+                method,
+                params: params ?? [],
+            }),
+        });
+        if (!res.ok) {
+            throw new Error(`Kora RPC error: ${res.status} ${res.statusText}`);
+        }
+        const json = (await res.json());
+        if (json.error) {
+            throw new Error(`Kora RPC error [${json.error.code}]: ${json.error.message}`);
+        }
+        return json.result;
+    }
+    return {
+        getPayerSigner: () => rpcCall("getPayerSigner"),
+        signTransaction: (params) => rpcCall("signTransaction", params),
+        signAndSendTransaction: (params) => rpcCall("signAndSendTransaction", params),
+    };
+}
+/**
+ * Creates a FacilitatorSvmSigner backed by a Kora signer node.
+ *
+ * Kora handles fee payment in USDC (or other SPL tokens) instead of SOL.
+ * The facilitator delegates transaction signing to the Kora node which:
+ * 1. Adds its fee payer as the transaction fee payer
+ * 2. Signs the transaction with its fee payer key
+ * 3. Charges the agent in USDC for gas costs
+ *
+ * IMPORTANT: Call `await signer.init()` before using — fetches the fee payer address.
+ */
+export function createKoraFacilitatorSvmSigner(options) {
+    const { config, rpcUrls } = options;
+    const kora = createKoraClient(config);
+    // Cached fee payer address — populated during init()
+    let feePayerAddress = null;
+    // Cache Solana RPC connections for simulation/confirmation
+    const rpcCache = new Map();
+    function getSolanaRpc(network) {
+        let rpc = rpcCache.get(network);
+        if (!rpc) {
+            const url = rpcUrls?.[network] ?? "https://api.devnet.solana.com";
+            rpc = createSolanaRpc(url);
+            rpcCache.set(network, rpc);
+        }
+        return rpc;
+    }
+    const signer = {
+        /**
+         * Fetch the Kora fee payer address. Must be called before getAddresses().
+         */
+        async init() {
+            const result = await kora.getPayerSigner();
+            feePayerAddress = result.signer_address;
+        },
+        getAddresses() {
+            if (!feePayerAddress) {
+                throw new Error("KoraFacilitatorSvmSigner not initialized — call init() first");
+            }
+            return [feePayerAddress];
+        },
+        async signTransaction(transaction, _feePayer, _network) {
+            const result = await kora.signTransaction({ transaction });
+            return result.signed_transaction;
+        },
+        async simulateTransaction(transaction, network) {
+            const rpc = getSolanaRpc(network);
+            // Simulate using the standard Solana RPC — cast transaction to expected encoded type
+            const result = await rpc
+                .simulateTransaction(transaction, {
+                commitment: "confirmed",
+                replaceRecentBlockhash: true,
+                encoding: "base64",
+            })
+                .send();
+            if (result.value.err) {
+                throw new Error(`Transaction simulation failed: ${JSON.stringify(result.value.err)}`);
+            }
+        },
+        async sendTransaction(transaction, network) {
+            // Transaction is already fully signed by signTransaction() — submit directly
+            // to Solana RPC instead of Kora's signAndSendTransaction (which would re-sign).
+            // Use raw fetch to avoid @solana/kit type/encoding issues.
+            const url = rpcUrls?.[network] ?? "https://api.devnet.solana.com";
+            const res = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: 1,
+                    method: "sendTransaction",
+                    params: [transaction, {
+                            encoding: "base64",
+                            skipPreflight: false,
+                            preflightCommitment: "confirmed",
+                        }],
+                }),
+            });
+            const json = (await res.json());
+            if (json.error) {
+                throw new Error(`Solana sendTransaction failed [${json.error.code}]: ${json.error.message}` +
+                    (json.error.data ? ` (${JSON.stringify(json.error.data)})` : ""));
+            }
+            return json.result;
+        },
+        async confirmTransaction(sig, network) {
+            const rpc = getSolanaRpc(network);
+            const brandedSig = signature(sig);
+            // Poll for confirmation with timeout
+            const timeout = 30_000;
+            const interval = 2_000;
+            const start = Date.now();
+            while (Date.now() - start < timeout) {
+                const statuses = await rpc
+                    .getSignatureStatuses([brandedSig], { searchTransactionHistory: true })
+                    .send();
+                const status = statuses.value[0];
+                if (status) {
+                    if (status.err) {
+                        throw new Error(`Transaction failed: ${JSON.stringify(status.err)}`);
+                    }
+                    if (status.confirmationStatus === "confirmed" ||
+                        status.confirmationStatus === "finalized") {
+                        return;
+                    }
+                }
+                await new Promise((resolve) => setTimeout(resolve, interval));
+            }
+            throw new Error(`Transaction confirmation timed out after ${timeout}ms`);
+        },
+    };
+    return signer;
+}
+export { createKoraClient };
+//# sourceMappingURL=signer.js.map

package/dist/kora/signer.js.map

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

package/dist/squads/accounts.d.ts

@@ -0,0 +1,19 @@
+import type { Address } from "@solana/kit";
+import { SQUADS_PROGRAM_ID } from "./types.js";
+export { SQUADS_PROGRAM_ID };
+/**
+ * Derive the Smart Account PDA.
+ * Seeds: ["smart_account", creator, account_index (u32 LE)]
+ */
+export declare function deriveSmartAccountPda(creator: Address, accountIndex: number, programId?: Address): Promise<readonly [Address, number]>;
+/**
+ * Derive the Settings PDA for a Smart Account.
+ * Seeds: ["settings", smart_account_pda]
+ */
+export declare function deriveSettingsPda(smartAccountPda: Address, programId?: Address): Promise<readonly [Address, number]>;
+/**
+ * Derive a Spending Limit PDA.
+ * Seeds: ["spending_limit", smart_account_pda, spending_limit_index (u32 LE)]
+ */
+export declare function deriveSpendingLimitPda(smartAccountPda: Address, spendingLimitIndex: number, programId?: Address): Promise<readonly [Address, number]>;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/squads/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/squads/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,OAA2B,GACrC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAarC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,OAAO,EACxB,SAAS,GAAE,OAA2B,GACrC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,OAAO,EACxB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,GAAE,OAA2B,GACrC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAarC"}

package/dist/squads/accounts.js

@@ -0,0 +1,52 @@
+import { getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
+import { SQUADS_PROGRAM_ID } from "./types.js";
+export { SQUADS_PROGRAM_ID };
+/**
+ * Derive the Smart Account PDA.
+ * Seeds: ["smart_account", creator, account_index (u32 LE)]
+ */
+export async function deriveSmartAccountPda(creator, accountIndex, programId = SQUADS_PROGRAM_ID) {
+    const encoder = getAddressEncoder();
+    const indexBuffer = new Uint8Array(4);
+    new DataView(indexBuffer.buffer).setUint32(0, accountIndex, true); // little-endian
+    return getProgramDerivedAddress({
+        programAddress: programId,
+        seeds: [
+            new TextEncoder().encode("smart_account"),
+            encoder.encode(creator),
+            indexBuffer,
+        ],
+    });
+}
+/**
+ * Derive the Settings PDA for a Smart Account.
+ * Seeds: ["settings", smart_account_pda]
+ */
+export async function deriveSettingsPda(smartAccountPda, programId = SQUADS_PROGRAM_ID) {
+    const encoder = getAddressEncoder();
+    return getProgramDerivedAddress({
+        programAddress: programId,
+        seeds: [
+            new TextEncoder().encode("settings"),
+            encoder.encode(smartAccountPda),
+        ],
+    });
+}
+/**
+ * Derive a Spending Limit PDA.
+ * Seeds: ["spending_limit", smart_account_pda, spending_limit_index (u32 LE)]
+ */
+export async function deriveSpendingLimitPda(smartAccountPda, spendingLimitIndex, programId = SQUADS_PROGRAM_ID) {
+    const encoder = getAddressEncoder();
+    const indexBuffer = new Uint8Array(4);
+    new DataView(indexBuffer.buffer).setUint32(0, spendingLimitIndex, true);
+    return getProgramDerivedAddress({
+        programAddress: programId,
+        seeds: [
+            new TextEncoder().encode("spending_limit"),
+            encoder.encode(smartAccountPda),
+            indexBuffer,
+        ],
+    });
+}
+//# sourceMappingURL=accounts.js.map

package/dist/squads/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/squads/accounts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgB,EAChB,YAAoB,EACpB,YAAqB,iBAAiB;IAEtC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB;IAEnF,OAAO,wBAAwB,CAAC;QAC9B,cAAc,EAAE,SAAS;QACzB,KAAK,EAAE;YACL,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACvB,WAAW;SACZ;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,eAAwB,EACxB,YAAqB,iBAAiB;IAEtC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,OAAO,wBAAwB,CAAC;QAC9B,cAAc,EAAE,SAAS;QACzB,KAAK,EAAE;YACL,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;SAChC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,eAAwB,EACxB,kBAA0B,EAC1B,YAAqB,iBAAiB;IAEtC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAExE,OAAO,wBAAwB,CAAC;QAC9B,cAAc,EAAE,SAAS;QACzB,KAAK,EAAE;YACL,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;YAC/B,WAAW;SACZ;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/squads/index.d.ts

@@ -0,0 +1,6 @@
+export { deriveSmartAccountPda, deriveSettingsPda, deriveSpendingLimitPda, SQUADS_PROGRAM_ID } from "./accounts.js";
+export { createSmartAccountInstruction, addSpendingLimitInstruction, useSpendingLimitInstruction, removeSpendingLimitInstruction } from "./instructions.js";
+export { createSpendingLimit, checkSpendingLimit, revokeSpendingLimit } from "./spending.js";
+export { SpendingLimitPeriod } from "./types.js";
+export type { SpendingLimitConfig, SmartAccountConfig } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/squads/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/squads/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAC5J,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/squads/index.js

@@ -0,0 +1,6 @@
+// Squads Smart Account module — implemented in task S2b
+export { deriveSmartAccountPda, deriveSettingsPda, deriveSpendingLimitPda, SQUADS_PROGRAM_ID } from "./accounts.js";
+export { createSmartAccountInstruction, addSpendingLimitInstruction, useSpendingLimitInstruction, removeSpendingLimitInstruction } from "./instructions.js";
+export { createSpendingLimit, checkSpendingLimit, revokeSpendingLimit } from "./spending.js";
+export { SpendingLimitPeriod } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/squads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/squads/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAC5J,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/squads/instructions.d.ts

@@ -0,0 +1,43 @@
+import type { Address, Instruction } from "@solana/kit";
+import { type SmartAccountConfig, type SpendingLimitConfig, SpendingLimitPeriod } from "./types.js";
+/**
+ * Build a `createSmartAccount` instruction.
+ * Initializes a new Squads Smart Account with the given signers and threshold.
+ */
+export declare function createSmartAccountInstruction(config: SmartAccountConfig): Promise<Instruction>;
+/**
+ * Build an `addSpendingLimitAsAuthority` instruction.
+ * Sets a per-mint spending cap with time period on a Smart Account.
+ */
+export declare function addSpendingLimitInstruction(config: SpendingLimitConfig, spendingLimitIndex: number, authority: Address): Promise<Instruction>;
+/**
+ * Build a `useSpendingLimit` instruction.
+ * Spends within the limit — no proposal required.
+ */
+export declare function useSpendingLimitInstruction(params: {
+    smartAccountPda: Address;
+    spendingLimitIndex: number;
+    /** Token mint (USDC) */
+    mint: Address;
+    /** Source token account (Smart Account's ATA) */
+    sourceTokenAccount: Address;
+    /** Destination token account */
+    destinationTokenAccount: Address;
+    /** Member (agent) signing the transaction */
+    member: Address;
+    /** Amount to spend (base units) */
+    amount: bigint;
+}): Promise<Instruction>;
+/**
+ * Build a `removeSpendingLimitAsAuthority` instruction.
+ * Revokes a spending limit from the Smart Account.
+ */
+export declare function removeSpendingLimitInstruction(params: {
+    smartAccountPda: Address;
+    spendingLimitIndex: number;
+    authority: Address;
+    /** Account to receive the rent-exempt lamports */
+    rentCollector: Address;
+}): Promise<Instruction>;
+export { SpendingLimitPeriod };
+//# sourceMappingURL=instructions.d.ts.map

package/dist/squads/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/squads/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA+BvH;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqCtB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,EAC3B,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,WAAW,CAAC,CAqDtB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,iDAAiD;IACjD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gCAAgC;IAChC,uBAAuB,EAAE,OAAO,CAAC;IACjC,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBvB;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,MAAM,EAAE;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBvB;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/squads/instructions.js

@@ -0,0 +1,163 @@
+import { getAddressEncoder } from "@solana/kit";
+import { SQUADS_PROGRAM_ID, SpendingLimitPeriod } from "./types.js";
+import { deriveSmartAccountPda, deriveSettingsPda, deriveSpendingLimitPda } from "./accounts.js";
+// Anchor discriminators are first 8 bytes of sha256("global:<instruction_name>")
+// Pre-computed for the 4 instructions we need
+/** sha256("global:create_smart_account")[0..8] */
+const CREATE_SMART_ACCOUNT_DISC = new Uint8Array([
+    0x18, 0x46, 0xf0, 0x52, 0x88, 0xa5, 0x03, 0x26,
+]);
+/** sha256("global:add_spending_limit_as_authority")[0..8] */
+const ADD_SPENDING_LIMIT_DISC = new Uint8Array([
+    0xd1, 0x81, 0xb2, 0x0f, 0x07, 0x0c, 0x79, 0xa2,
+]);
+/** sha256("global:use_spending_limit")[0..8] */
+const USE_SPENDING_LIMIT_DISC = new Uint8Array([
+    0x65, 0x7b, 0x5a, 0xf7, 0x80, 0x5e, 0x89, 0x11,
+]);
+/** sha256("global:remove_spending_limit_as_authority")[0..8] */
+const REMOVE_SPENDING_LIMIT_DISC = new Uint8Array([
+    0xc9, 0x18, 0x27, 0x0d, 0x3e, 0x5b, 0x7a, 0x4f,
+]);
+/** System Program ID */
+const SYSTEM_PROGRAM = "11111111111111111111111111111111";
+/** SPL Token Program ID */
+const TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+/**
+ * Build a `createSmartAccount` instruction.
+ * Initializes a new Squads Smart Account with the given signers and threshold.
+ */
+export async function createSmartAccountInstruction(config) {
+    const [smartAccountPda] = await deriveSmartAccountPda(config.creator, config.accountIndex);
+    const [settingsPda] = await deriveSettingsPda(smartAccountPda);
+    // Serialize args: threshold (u16 LE) + members count (u32 LE) + members (32 bytes each)
+    const argsSize = 8 + 2 + 4 + config.members.length * 32;
+    const data = new Uint8Array(argsSize);
+    const view = new DataView(data.buffer);
+    let offset = 0;
+    // Discriminator
+    data.set(CREATE_SMART_ACCOUNT_DISC, offset);
+    offset += 8;
+    // Threshold (u16 LE)
+    view.setUint16(offset, config.threshold, true);
+    offset += 2;
+    // Members array (Borsh: u32 length prefix + items)
+    const encoder = getAddressEncoder();
+    view.setUint32(offset, config.members.length, true);
+    offset += 4;
+    for (const member of config.members) {
+        data.set(encoder.encode(member), offset);
+        offset += 32;
+    }
+    return {
+        programAddress: SQUADS_PROGRAM_ID,
+        accounts: [
+            { address: smartAccountPda, role: 1 }, // writable
+            { address: settingsPda, role: 1 }, // writable
+            { address: config.creator, role: 3 }, // writable + signer
+            { address: SYSTEM_PROGRAM, role: 0 }, // readonly
+        ],
+        data,
+    };
+}
+/**
+ * Build an `addSpendingLimitAsAuthority` instruction.
+ * Sets a per-mint spending cap with time period on a Smart Account.
+ */
+export async function addSpendingLimitInstruction(config, spendingLimitIndex, authority) {
+    const [settingsPda] = await deriveSettingsPda(config.smartAccountPda);
+    const [spendingLimitPda] = await deriveSpendingLimitPda(config.smartAccountPda, spendingLimitIndex);
+    // Serialize: disc + mint(32) + amount(u64 LE) + period(u8) + members_len(u32) + members + destinations_len(u32) + destinations
+    const argsSize = 8 + 32 + 8 + 1 + 4 + config.members.length * 32 + 4 + config.destinations.length * 32;
+    const data = new Uint8Array(argsSize);
+    const view = new DataView(data.buffer);
+    const encoder = getAddressEncoder();
+    let offset = 0;
+    data.set(ADD_SPENDING_LIMIT_DISC, offset);
+    offset += 8;
+    // Mint
+    data.set(encoder.encode(config.mint), offset);
+    offset += 32;
+    // Amount (u64 LE)
+    view.setBigUint64(offset, config.amount, true);
+    offset += 8;
+    // Period (u8 enum)
+    data[offset] = config.period;
+    offset += 1;
+    // Members
+    view.setUint32(offset, config.members.length, true);
+    offset += 4;
+    for (const member of config.members) {
+        data.set(encoder.encode(member), offset);
+        offset += 32;
+    }
+    // Destinations
+    view.setUint32(offset, config.destinations.length, true);
+    offset += 4;
+    for (const dest of config.destinations) {
+        data.set(encoder.encode(dest), offset);
+        offset += 32;
+    }
+    return {
+        programAddress: SQUADS_PROGRAM_ID,
+        accounts: [
+            { address: config.smartAccountPda, role: 0 }, // readonly
+            { address: settingsPda, role: 0 }, // readonly
+            { address: spendingLimitPda, role: 1 }, // writable
+            { address: authority, role: 3 }, // writable + signer
+            { address: SYSTEM_PROGRAM, role: 0 }, // readonly
+        ],
+        data,
+    };
+}
+/**
+ * Build a `useSpendingLimit` instruction.
+ * Spends within the limit — no proposal required.
+ */
+export async function useSpendingLimitInstruction(params) {
+    const [settingsPda] = await deriveSettingsPda(params.smartAccountPda);
+    const [spendingLimitPda] = await deriveSpendingLimitPda(params.smartAccountPda, params.spendingLimitIndex);
+    // Serialize: disc + amount(u64 LE)
+    const data = new Uint8Array(8 + 8);
+    const view = new DataView(data.buffer);
+    data.set(USE_SPENDING_LIMIT_DISC, 0);
+    view.setBigUint64(8, params.amount, true);
+    return {
+        programAddress: SQUADS_PROGRAM_ID,
+        accounts: [
+            { address: params.smartAccountPda, role: 0 }, // readonly
+            { address: settingsPda, role: 0 }, // readonly
+            { address: spendingLimitPda, role: 1 }, // writable
+            { address: params.sourceTokenAccount, role: 1 }, // writable
+            { address: params.destinationTokenAccount, role: 1 }, // writable
+            { address: params.member, role: 2 }, // signer
+            { address: params.mint, role: 0 }, // readonly
+            { address: TOKEN_PROGRAM, role: 0 }, // readonly
+        ],
+        data,
+    };
+}
+/**
+ * Build a `removeSpendingLimitAsAuthority` instruction.
+ * Revokes a spending limit from the Smart Account.
+ */
+export async function removeSpendingLimitInstruction(params) {
+    const [settingsPda] = await deriveSettingsPda(params.smartAccountPda);
+    const [spendingLimitPda] = await deriveSpendingLimitPda(params.smartAccountPda, params.spendingLimitIndex);
+    const data = new Uint8Array(8);
+    data.set(REMOVE_SPENDING_LIMIT_DISC, 0);
+    return {
+        programAddress: SQUADS_PROGRAM_ID,
+        accounts: [
+            { address: params.smartAccountPda, role: 0 }, // readonly
+            { address: settingsPda, role: 0 }, // readonly
+            { address: spendingLimitPda, role: 1 }, // writable (closed)
+            { address: params.authority, role: 3 }, // writable + signer
+            { address: params.rentCollector, role: 1 }, // writable (receives lamports)
+        ],
+        data,
+    };
+}
+// Re-export for convenience
+export { SpendingLimitPeriod };
+//# sourceMappingURL=instructions.js.map

package/dist/squads/instructions.js.map

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

package/dist/squads/spending.d.ts

@@ -0,0 +1,24 @@
+import type { Address } from "@solana/kit";
+import type { SpendingLimitConfig } from "./types.js";
+import { SpendingLimitPeriod } from "./types.js";
+/**
+ * Create a spending limit instruction for a Smart Account.
+ * Returns the instruction — caller is responsible for signing and sending.
+ */
+export declare function createSpendingLimit(config: SpendingLimitConfig, spendingLimitIndex: number, authority: Address): Promise<import("@solana/kit").Instruction<string, readonly (import("@solana/kit").AccountLookupMeta<string, string> | import("@solana/kit").AccountMeta<string>)[]>>;
+/**
+ * Check if a spending limit account exists on-chain and fetch its state.
+ * Returns null if the account doesn't exist.
+ */
+export declare function checkSpendingLimit(smartAccountPda: Address, spendingLimitIndex: number, rpcUrl: string): Promise<{
+    exists: boolean;
+    remainingAmount?: bigint;
+    period?: SpendingLimitPeriod;
+    lastReset?: bigint;
+} | null>;
+/**
+ * Revoke a spending limit from a Smart Account.
+ * Returns the instruction — caller is responsible for signing and sending.
+ */
+export declare function revokeSpendingLimit(smartAccountPda: Address, spendingLimitIndex: number, authority: Address, rentCollector: Address): Promise<import("@solana/kit").Instruction<string, readonly (import("@solana/kit").AccountLookupMeta<string, string> | import("@solana/kit").AccountMeta<string>)[]>>;
+//# sourceMappingURL=spending.d.ts.map

package/dist/squads/spending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spending.d.ts","sourceRoot":"","sources":["../../src/squads/spending.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,OAAO,wKAGnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,OAAO,EACxB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC,CA8BR;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,OAAO,EACxB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,OAAO,wKAQvB"}

package/dist/squads/spending.js

@@ -0,0 +1,54 @@
+import { createSolanaRpc } from "@solana/kit";
+import { SpendingLimitPeriod } from "./types.js";
+import { deriveSpendingLimitPda } from "./accounts.js";
+import { addSpendingLimitInstruction, removeSpendingLimitInstruction } from "./instructions.js";
+/**
+ * Create a spending limit instruction for a Smart Account.
+ * Returns the instruction — caller is responsible for signing and sending.
+ */
+export async function createSpendingLimit(config, spendingLimitIndex, authority) {
+    return addSpendingLimitInstruction(config, spendingLimitIndex, authority);
+}
+/**
+ * Check if a spending limit account exists on-chain and fetch its state.
+ * Returns null if the account doesn't exist.
+ */
+export async function checkSpendingLimit(smartAccountPda, spendingLimitIndex, rpcUrl) {
+    const rpc = createSolanaRpc(rpcUrl);
+    const [spendingLimitPda] = await deriveSpendingLimitPda(smartAccountPda, spendingLimitIndex);
+    const accountInfo = await rpc
+        .getAccountInfo(spendingLimitPda, { encoding: "base64" })
+        .send();
+    if (!accountInfo.value) {
+        return null;
+    }
+    // Parse the account data
+    // Layout: discriminator(8) + smart_account(32) + mint(32) + amount(8) + remaining_amount(8) + period(1) + last_reset(8) + ...
+    const data = Buffer.from(accountInfo.value.data[0], "base64");
+    if (data.length < 89) {
+        return null;
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const remainingAmount = view.getBigUint64(80, true); // offset 8+32+32+8 = 80
+    const period = data[88]; // offset 80+8 = 88
+    const lastReset = view.getBigUint64(89, true); // offset 88+1 = 89
+    return {
+        exists: true,
+        remainingAmount,
+        period,
+        lastReset,
+    };
+}
+/**
+ * Revoke a spending limit from a Smart Account.
+ * Returns the instruction — caller is responsible for signing and sending.
+ */
+export async function revokeSpendingLimit(smartAccountPda, spendingLimitIndex, authority, rentCollector) {
+    return removeSpendingLimitInstruction({
+        smartAccountPda,
+        spendingLimitIndex,
+        authority,
+        rentCollector,
+    });
+}
+//# sourceMappingURL=spending.js.map

package/dist/squads/spending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spending.js","sourceRoot":"","sources":["../../src/squads/spending.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAEhG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA2B,EAC3B,kBAA0B,EAC1B,SAAkB;IAElB,OAAO,2BAA2B,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,eAAwB,EACxB,kBAA0B,EAC1B,MAAc;IAOd,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,gBAAgB,CAAC,GAAG,MAAM,sBAAsB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAE7F,MAAM,WAAW,GAAG,MAAM,GAAG;SAC1B,cAAc,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;SACxD,IAAI,EAAE,CAAC;IAEV,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yBAAyB;IACzB,8HAA8H;IAC9H,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,QAAQ,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,wBAAwB;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAwB,CAAC,CAAC,mBAAmB;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,mBAAmB;IAElE,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,eAAe;QACf,MAAM;QACN,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,eAAwB,EACxB,kBAA0B,EAC1B,SAAkB,EAClB,aAAsB;IAEtB,OAAO,8BAA8B,CAAC;QACpC,eAAe;QACf,kBAAkB;QAClB,SAAS;QACT,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/squads/types.d.ts

@@ -0,0 +1,41 @@
+import type { Address } from "@solana/kit";
+/** Squads Smart Account program ID on mainnet/devnet */
+export declare const SQUADS_PROGRAM_ID: Address;
+/** Configuration for creating a spending limit on a Smart Account */
+export interface SpendingLimitConfig {
+    /** The Smart Account PDA that owns this spending limit */
+    smartAccountPda: Address;
+    /** Token mint address (USDC) */
+    mint: Address;
+    /** Maximum amount allowed per time period (base units) */
+    amount: bigint;
+    /** Time period for the spending limit */
+    period: SpendingLimitPeriod;
+    /** Members (agent addresses) authorized to use this spending limit */
+    members: Address[];
+    /** Destination addresses the agent can send to */
+    destinations: Address[];
+}
+/** Time period for spending limit reset */
+export declare enum SpendingLimitPeriod {
+    /** One-time allowance — no reset */
+    OneTime = 0,
+    /** Resets daily */
+    Day = 1,
+    /** Resets weekly */
+    Week = 2,
+    /** Resets monthly */
+    Month = 3
+}
+/** Configuration for creating a Smart Account */
+export interface SmartAccountConfig {
+    /** Creator/authority address */
+    creator: Address;
+    /** Index for PDA derivation (allows multiple accounts per creator) */
+    accountIndex: number;
+    /** Signers for the multisig */
+    members: Address[];
+    /** Number of required signers */
+    threshold: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/squads/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/squads/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAoD,OAAO,CAAC;AAE1F,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;IACzB,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,sEAAsE;IACtE,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,kDAAkD;IAClD,YAAY,EAAE,OAAO,EAAE,CAAC;CACzB;AAED,2CAA2C;AAC3C,oBAAY,mBAAmB;IAC7B,oCAAoC;IACpC,OAAO,IAAI;IACX,mBAAmB;IACnB,GAAG,IAAI;IACP,oBAAoB;IACpB,IAAI,IAAI;IACR,qBAAqB;IACrB,KAAK,IAAI;CACV;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/squads/types.js

@@ -0,0 +1,15 @@
+/** Squads Smart Account program ID on mainnet/devnet */
+export const SQUADS_PROGRAM_ID = "SMRTzfY6DfH5ik3TKiyLFfXexV8uSG3d2UksSCYdunG";
+/** Time period for spending limit reset */
+export var SpendingLimitPeriod;
+(function (SpendingLimitPeriod) {
+    /** One-time allowance — no reset */
+    SpendingLimitPeriod[SpendingLimitPeriod["OneTime"] = 0] = "OneTime";
+    /** Resets daily */
+    SpendingLimitPeriod[SpendingLimitPeriod["Day"] = 1] = "Day";
+    /** Resets weekly */
+    SpendingLimitPeriod[SpendingLimitPeriod["Week"] = 2] = "Week";
+    /** Resets monthly */
+    SpendingLimitPeriod[SpendingLimitPeriod["Month"] = 3] = "Month";
+})(SpendingLimitPeriod || (SpendingLimitPeriod = {}));
+//# sourceMappingURL=types.js.map

package/dist/squads/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/squads/types.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,6CAAwD,CAAC;AAkB1F,2CAA2C;AAC3C,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,oCAAoC;IACpC,mEAAW,CAAA;IACX,mBAAmB;IACnB,2DAAO,CAAA;IACP,oBAAoB;IACpB,6DAAQ,CAAA;IACR,qBAAqB;IACrB,+DAAS,CAAA;AACX,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@pincerpay/solana",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Solana integration for PincerPay. Kora gasless transactions and Squads smart account support.",
+  "license": "MIT",
+  "homepage": "https://pincerpay.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ds1/pincerpay.git",
+    "directory": "packages/solana"
+  },
+  "bugs": {
+    "url": "https://github.com/ds1/pincerpay/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "pincerpay",
+    "solana",
+    "kora",
+    "squads",
+    "gasless",
+    "usdc",
+    "smart-accounts",
+    "session-keys"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./kora": {
+      "types": "./dist/kora/index.d.ts",
+      "import": "./dist/kora/index.js"
+    },
+    "./squads": {
+      "types": "./dist/squads/index.d.ts",
+      "import": "./dist/squads/index.js"
+    }
+  },
+  "dependencies": {
+    "@solana/kit": "^5.5.1",
+    "@x402/svm": "^2.3.0",
+    "zod": "^3.24",
+    "@pincerpay/core": "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"
+  }
+}