@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.0

package/dist/cjs/utils/volume-curve.js.map

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

package/dist/cjs/utils/x402-direct.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * @module utils/x402-direct
+ * @description Recognize x402 direct SPL token payments on an agent's ATA
+ * by scanning transaction history and filtering for x402 patterns.
+ *
+ * @category Utils
+ * @since v0.6.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getX402DirectPayments = getX402DirectPayments;
+const web3_js_1 = require("@solana/web3.js");
+const utils_1 = require("../utils");
+// ═══════════════════════════════════════════════════════════════════
+//  Core
+// ═══════════════════════════════════════════════════════════════════
+/** Recognized x402 memo prefixes. */
+const X402_MEMO_PREFIXES = ["x402:", "SAP-x402:", "x402-direct:"];
+/**
+ * @name extractSplTransfer
+ * @description Extract SPL Token transfer details from a parsed transaction.
+ *
+ * Looks for `transfer` or `transferChecked` inner instructions on the
+ * Token Program and returns source/dest/amount/mint.
+ *
+ * @internal
+ */
+function extractSplTransfer(tx, payToAta) {
+    if (!tx.meta?.innerInstructions && !tx.transaction.message.instructions) {
+        return null;
+    }
+    // Check all instructions (outer + inner)
+    const allIxs = [
+        ...tx.transaction.message.instructions,
+        ...(tx.meta?.innerInstructions?.flatMap((g) => g.instructions) ?? []),
+    ];
+    for (const ix of allIxs) {
+        // Only process parsed instructions with known program
+        if (!("parsed" in ix) || !("program" in ix))
+            continue;
+        const parsed = ix;
+        if (parsed.program !== "spl-token")
+            continue;
+        const info = parsed.parsed;
+        if (info.type !== "transfer" &&
+            info.type !== "transferChecked") {
+            continue;
+        }
+        const transferInfo = info.info;
+        if (!transferInfo?.source || !transferInfo?.destination)
+            continue;
+        // Check destination matches our payTo ATA
+        const destPk = new web3_js_1.PublicKey(transferInfo.destination);
+        if (!destPk.equals(payToAta))
+            continue;
+        const amountStr = transferInfo.amount ?? transferInfo.tokenAmount?.amount ?? "0";
+        return {
+            amount: BigInt(amountStr),
+            source: new web3_js_1.PublicKey(transferInfo.source),
+            destination: destPk,
+            mint: transferInfo.mint ? new web3_js_1.PublicKey(transferInfo.mint) : destPk, // fallback
+        };
+    }
+    return null;
+}
+/**
+ * @name extractMemo
+ * @description Extract memo data from a parsed transaction.
+ * @internal
+ */
+function extractMemo(tx) {
+    const allIxs = [
+        ...tx.transaction.message.instructions,
+        ...(tx.meta?.innerInstructions?.flatMap((g) => g.instructions) ?? []),
+    ];
+    for (const ix of allIxs) {
+        if (!("parsed" in ix) || !("program" in ix))
+            continue;
+        const parsed = ix;
+        if (parsed.program === "spl-memo" && typeof parsed.parsed === "string") {
+            return parsed.parsed;
+        }
+    }
+    // Also check log messages for memo
+    if (tx.meta?.logMessages) {
+        for (const log of tx.meta.logMessages) {
+            if (log.startsWith("Program log: Memo")) {
+                const memoMatch = log.match(/Memo \(len \d+\): "(.*?)"/);
+                if (memoMatch?.[1])
+                    return memoMatch[1];
+            }
+        }
+    }
+    return null;
+}
+/**
+ * @name matchesX402Pattern
+ * @description Check if a transfer matches an x402 payment pattern.
+ *
+ * Matches if:
+ * - A memo with recognized x402 prefix is present, OR
+ * - The transfer matches a known settlement payload (deterministic hash), OR
+ * - `requireMemo` is false (any SPL transfer to the ATA is included)
+ *
+ * @internal
+ */
+function matchesX402Pattern(transfer, memo, knownSettlements, requireMemo) {
+    // 1. Check memo prefix
+    if (memo) {
+        for (const prefix of X402_MEMO_PREFIXES) {
+            if (memo.startsWith(prefix))
+                return true;
+        }
+        // Try base64 JSON parse for embedded x402 payload
+        try {
+            const decoded = Buffer.from(memo, "base64").toString("utf-8");
+            const parsed = JSON.parse(decoded);
+            if (parsed.protocol === "x402" || parsed.protocol === "SAP-x402") {
+                return true;
+            }
+        }
+        catch {
+            // Not base64 JSON — ignore
+        }
+    }
+    // 2. Match against known settlements (deterministic hash)
+    for (const settlement of knownSettlements) {
+        const expected = BigInt(settlement.amount);
+        if (transfer.amount !== expected)
+            continue;
+        // Deterministic hash: sha256(agentWallet + depositor + amount + timestamp)
+        const hashInput = settlement.agentWallet +
+            settlement.depositorWallet +
+            settlement.amount +
+            settlement.timestamp.toString();
+        const expectedHash = Buffer.from((0, utils_1.sha256)(hashInput)).toString("hex");
+        const serviceHash = settlement.serviceHash;
+        if (expectedHash === serviceHash)
+            return settlement;
+    }
+    // 3. If requireMemo is false, accept any SPL transfer to the ATA
+    if (!requireMemo)
+        return true;
+    return false;
+}
+/**
+ * @name getX402DirectPayments
+ * @description Scan an agent's ATA for x402 direct payments.
+ *
+ * Fetches recent transaction signatures for the given `payTo` ATA,
+ * inspects each transaction for SPL token transfers, and filters
+ * for x402 payment patterns (memo prefix, settlement hash match, etc.).
+ *
+ * @param connection - Solana RPC connection.
+ * @param payToAta   - The agent's receiving ATA (e.g. USDC ATA of Syra).
+ * @param opts       - Filter and pagination options.
+ * @returns Array of recognized x402 direct payments, newest first.
+ *
+ * @category Utils
+ * @since v0.6.4
+ *
+ * @example
+ * ```ts
+ * import { getX402DirectPayments, findATA } from "@oobe-protocol-labs/synapse-sap-sdk";
+ *
+ * const USDC_MINT = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+ * const payToAta = findATA(agentWallet, USDC_MINT);
+ *
+ * const payments = await getX402DirectPayments(connection, payToAta, {
+ *   limit: 50,
+ *   knownSettlements: savedSettlements, // from your API PAYMENT-RESPONSE logs
+ * });
+ *
+ * for (const p of payments) {
+ *   console.log(`${p.signature}: ${p.amount} from ${p.payerAta.toBase58()}`);
+ *   if (p.settlement) {
+ *     console.log(`  Matched settlement: ${p.settlement.serviceHash}`);
+ *   }
+ * }
+ * ```
+ */
+async function getX402DirectPayments(connection, payToAta, opts) {
+    const limit = opts?.limit ?? 100;
+    const knownSettlements = opts?.knownSettlements ?? [];
+    const requireMemo = opts?.requireMemo ?? false;
+    // 1. Fetch signatures
+    const sigOpts = { limit };
+    if (opts?.before)
+        sigOpts.before = opts.before;
+    if (opts?.until)
+        sigOpts.until = opts.until;
+    const sigs = await connection.getSignaturesForAddress(payToAta, sigOpts);
+    if (sigs.length === 0)
+        return [];
+    // 2. Fetch transactions (batch with getParsedTransactions if available)
+    const txs = await connection.getParsedTransactions(sigs.map((s) => s.signature), { maxSupportedTransactionVersion: 0 });
+    // 3. Extract and filter
+    const results = [];
+    for (let i = 0; i < txs.length; i++) {
+        const tx = txs[i];
+        if (!tx)
+            continue;
+        // Extract SPL transfer to our ATA
+        const transfer = extractSplTransfer(tx, payToAta);
+        if (!transfer)
+            continue;
+        // Filter by payer if specified
+        if (opts?.filterPayer && !transfer.source.equals(opts.filterPayer)) {
+            continue;
+        }
+        // Extract memo
+        const memo = extractMemo(tx);
+        // Match x402 pattern
+        const match = matchesX402Pattern(transfer, memo, knownSettlements, requireMemo);
+        if (match === false)
+            continue;
+        results.push({
+            signature: sigs[i].signature,
+            amount: transfer.amount,
+            payerAta: transfer.source,
+            payeeAta: transfer.destination,
+            mint: transfer.mint,
+            memo,
+            settlement: typeof match === "object" ? match : null,
+            blockTime: tx.blockTime ?? null,
+            slot: tx.slot,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=x402-direct.js.map

package/dist/cjs/utils/x402-direct.js.map

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

package/dist/esm/client.js

@@ -9,6 +9,23 @@ import { AgentModule, AttestationModule, DigestModule, DisputeModule, EscrowModu
 // @ts-ignore — JSON resolution handled by bundler
 const idlJson = require("./idl.json");
 export class SapClient {
+    program;
+    connection;
+    programId;
+    _provider;
+    _agent;
+    _attestation;
+    _digest;
+    _dispute;
+    _escrow;
+    _global;
+    _indexing;
+    _misc;
+    _session;
+    _staking;
+    _subscription;
+    _tools;
+    _vault;
     constructor(opts = {}) {
         this.connection = opts.connection ?? new Connection(opts.rpcUrl ?? "https://api.mainnet-beta.solana.com", opts.commitment ?? "confirmed");
         this.programId = opts.programId ?? new PublicKey(PROGRAM_ID);
@@ -20,19 +37,19 @@ export class SapClient {
         this.program = new Program(idlJson, this._provider);
     }
     get methods() { return this.program.methods; }
-    get agent() { return this._agent ?? (this._agent = new AgentModule(this.program)); }
-    get attestation() { return this._attestation ?? (this._attestation = new AttestationModule(this.program)); }
-    get digest() { return this._digest ?? (this._digest = new DigestModule(this.program)); }
-    get dispute() { return this._dispute ?? (this._dispute = new DisputeModule(this.program)); }
-    get escrow() { return this._escrow ?? (this._escrow = new EscrowModule(this.program)); }
-    get global() { return this._global ?? (this._global = new GlobalModule(this.program)); }
-    get indexing() { return this._indexing ?? (this._indexing = new IndexingModule(this.program)); }
-    get misc() { return this._misc ?? (this._misc = new MiscModule(this.program)); }
-    get session() { return this._session ?? (this._session = new SessionModule(this.program)); }
-    get staking() { return this._staking ?? (this._staking = new StakingModule(this.program)); }
-    get subscription() { return this._subscription ?? (this._subscription = new SubscriptionModule(this.program)); }
-    get tools() { return this._tools ?? (this._tools = new ToolsModule(this.program)); }
-    get vault() { return this._vault ?? (this._vault = new VaultModule(this.program)); }
+    get agent() { return this._agent ??= new AgentModule(this.program); }
+    get attestation() { return this._attestation ??= new AttestationModule(this.program); }
+    get digest() { return this._digest ??= new DigestModule(this.program); }
+    get dispute() { return this._dispute ??= new DisputeModule(this.program); }
+    get escrow() { return this._escrow ??= new EscrowModule(this.program); }
+    get global() { return this._global ??= new GlobalModule(this.program); }
+    get indexing() { return this._indexing ??= new IndexingModule(this.program); }
+    get misc() { return this._misc ??= new MiscModule(this.program); }
+    get session() { return this._session ??= new SessionModule(this.program); }
+    get staking() { return this._staking ??= new StakingModule(this.program); }
+    get subscription() { return this._subscription ??= new SubscriptionModule(this.program); }
+    get tools() { return this._tools ??= new ToolsModule(this.program); }
+    get vault() { return this._vault ??= new VaultModule(this.program); }
     async fetchAccount(name, address) {
         try { // @ts-ignore
             return await this.program.account[name].fetch(address);

package/dist/esm/client.js.map

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

package/dist/esm/constants/addresses.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @module constants/addresses
+ * @description Pre-computed mainnet addresses for singleton PDAs and protocol infrastructure.
+ *
+ * These addresses are deterministic — derived from the canonical program ID
+ * and fixed seeds. They are provided for convenience so consumers can
+ * reference well-known accounts without re-deriving them.
+ *
+ * @category Constants
+ * @since v0.3.1
+ */
+import { PublicKey } from "@solana/web3.js";
+/**
+ * SAP v2 program ID on mainnet-beta (base58).
+ *
+ * @name SAP_PROGRAM
+ * @description The deployed and verified SAP v2 program address.
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const SAP_PROGRAM: PublicKey;
+/**
+ * Upgrade authority for the SAP v2 program.
+ *
+ * @name SAP_UPGRADE_AUTHORITY
+ * @description The wallet that holds upgrade authority over the deployed program.
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const SAP_UPGRADE_AUTHORITY: PublicKey;
+/**
+ * **GlobalRegistry** PDA — the protocol singleton.
+ *
+ * Seeds: `["sap_global"]` · Bump: `255`
+ *
+ * Tracks total agent count, active agent count, and protocol-level
+ * counters. Must be initialized once before any agent can register.
+ *
+ * @name GLOBAL_REGISTRY_ADDRESS
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const GLOBAL_REGISTRY_ADDRESS: PublicKey;
+/**
+ * Bump seed for the GlobalRegistry PDA.
+ * @name GLOBAL_REGISTRY_BUMP
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const GLOBAL_REGISTRY_BUMP = 255;
+/**
+ * IDL metadata account derived via the `program-metadata` standard.
+ *
+ * Seeds: `["idl", program_id]` under `pmetaypqG6SiB47xMigYVMAkuHDWeSDXcv3zzDrJJvA`.
+ *
+ * Contains the Anchor IDL JSON, queryable by explorers like Solscan.
+ *
+ * @name IDL_ACCOUNT_ADDRESS
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const IDL_ACCOUNT_ADDRESS: PublicKey;
+/**
+ * The `program-metadata` program used to store the IDL.
+ *
+ * @name PROGRAM_METADATA_PROGRAM
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const PROGRAM_METADATA_PROGRAM: PublicKey;
+/**
+ * Pre-computed Tool Category Index PDAs for each `ToolCategory` variant.
+ *
+ * Seeds: `["sap_tool_cat", category_byte]`
+ *
+ * Each entry corresponds to a `ToolCategory` enum discriminant:
+ *
+ * | Index | Category   | Address                                            |
+ * |-------|------------|----------------------------------------------------|
+ * | 0     | Swap       | `5H8yn9RuRgZWqkDiWbKNaCHzTMjqSpwbNQKMPLtUXx2G`   |
+ * | 1     | Lend       | `5Lqqk6VtFWnYq3h4Ae4FuUAKnFzw1Nm1DaSdt2cjcTDj`   |
+ * | 2     | Stake      | `kC8oAiVUcFMXEnmMNu1h2sdAc3dWKcwV5qVKRFYMmQD`    |
+ * | 3     | Nft        | `2zNWR9J3znvGQ5J6xDfJyZkd12Gi66mjErRDkgPeKbyF`   |
+ * | 4     | Payment    | `Eh7MwxJYWRN8bzAmY3ZPTRXYjWpWypokBf1STixu2dy9`   |
+ * | 5     | Data       | `AwpVxehQUZCVTAJ9icZfS6oRbF66jNo32duXaL11B5df`   |
+ * | 6     | Governance | `2573WjZzV9QtbqtM6Z86YGivkk1kdvJa4gK3tZRQ2jkN`   |
+ * | 7     | Bridge     | `664nyr6kBeeFiE1ij5gtdncNCVHrXqrk2uBhnKmUREvK`   |
+ * | 8     | Analytics  | `4DFsiTZ6h6RoCZuUeMTpaoQguepnPUMJBLJuwwjKg5GL`   |
+ * | 9     | Custom     | `3Nk5dvFWEyWPEArdG9cCdab6C6ym36mSWUSB8HzN35ZM`   |
+ *
+ * @name TOOL_CATEGORY_ADDRESSES
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const TOOL_CATEGORY_ADDRESSES: {
+    readonly Swap: PublicKey;
+    readonly Lend: PublicKey;
+    readonly Stake: PublicKey;
+    readonly Nft: PublicKey;
+    readonly Payment: PublicKey;
+    readonly Data: PublicKey;
+    readonly Governance: PublicKey;
+    readonly Bridge: PublicKey;
+    readonly Analytics: PublicKey;
+    readonly Custom: PublicKey;
+};
+/**
+ * Array-indexed version of {@link TOOL_CATEGORY_ADDRESSES}.
+ *
+ * `TOOL_CATEGORY_ADDRESS_LIST[0]` = Swap, `[1]` = Lend, etc.
+ *
+ * @name TOOL_CATEGORY_ADDRESS_LIST
+ * @category Constants
+ * @since v0.3.1
+ */
+export declare const TOOL_CATEGORY_ADDRESS_LIST: readonly PublicKey[];
+//# sourceMappingURL=addresses.d.ts.map

package/dist/esm/constants/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../../src/constants/addresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,WAEvB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WAEjC,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,WAEnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAMxC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,WAE/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,WAEpC,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;CAW1B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,SAAS,EAWjD,CAAC"}

package/dist/esm/constants/addresses.js

@@ -0,0 +1,140 @@
+/**
+ * @module constants/addresses
+ * @description Pre-computed mainnet addresses for singleton PDAs and protocol infrastructure.
+ *
+ * These addresses are deterministic — derived from the canonical program ID
+ * and fixed seeds. They are provided for convenience so consumers can
+ * reference well-known accounts without re-deriving them.
+ *
+ * @category Constants
+ * @since v0.3.1
+ */
+import { PublicKey } from "@solana/web3.js";
+// ═══════════════════════════════════════════════════════════════════
+//  Program & Authority
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * SAP v2 program ID on mainnet-beta (base58).
+ *
+ * @name SAP_PROGRAM
+ * @description The deployed and verified SAP v2 program address.
+ * @category Constants
+ * @since v0.3.1
+ */
+export const SAP_PROGRAM = new PublicKey("SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ");
+/**
+ * Upgrade authority for the SAP v2 program.
+ *
+ * @name SAP_UPGRADE_AUTHORITY
+ * @description The wallet that holds upgrade authority over the deployed program.
+ * @category Constants
+ * @since v0.3.1
+ */
+export const SAP_UPGRADE_AUTHORITY = new PublicKey("GBLQznn1QMnx64zHXcDguP9yNW9ZfYCVdrY8eDovBvPk");
+// ═══════════════════════════════════════════════════════════════════
+//  Singleton PDAs
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * **GlobalRegistry** PDA — the protocol singleton.
+ *
+ * Seeds: `["sap_global"]` · Bump: `255`
+ *
+ * Tracks total agent count, active agent count, and protocol-level
+ * counters. Must be initialized once before any agent can register.
+ *
+ * @name GLOBAL_REGISTRY_ADDRESS
+ * @category Constants
+ * @since v0.3.1
+ */
+export const GLOBAL_REGISTRY_ADDRESS = new PublicKey("9odFrYBBZq6UQC6aGyzMPNXWJQn55kMtfigzhLg6S6L5");
+/**
+ * Bump seed for the GlobalRegistry PDA.
+ * @name GLOBAL_REGISTRY_BUMP
+ * @category Constants
+ * @since v0.3.1
+ */
+export const GLOBAL_REGISTRY_BUMP = 255;
+// ═══════════════════════════════════════════════════════════════════
+//  IDL Account (program-metadata format)
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * IDL metadata account derived via the `program-metadata` standard.
+ *
+ * Seeds: `["idl", program_id]` under `pmetaypqG6SiB47xMigYVMAkuHDWeSDXcv3zzDrJJvA`.
+ *
+ * Contains the Anchor IDL JSON, queryable by explorers like Solscan.
+ *
+ * @name IDL_ACCOUNT_ADDRESS
+ * @category Constants
+ * @since v0.3.1
+ */
+export const IDL_ACCOUNT_ADDRESS = new PublicKey("ENs7L1NFuoP7dur8cqGGE6b98CQHfNeDZPWPSjRzhc4f");
+/**
+ * The `program-metadata` program used to store the IDL.
+ *
+ * @name PROGRAM_METADATA_PROGRAM
+ * @category Constants
+ * @since v0.3.1
+ */
+export const PROGRAM_METADATA_PROGRAM = new PublicKey("pmetaypqG6SiB47xMigYVMAkuHDWeSDXcv3zzDrJJvA");
+// ═══════════════════════════════════════════════════════════════════
+//  Tool Category Index PDAs (pre-computed for categories 0–9)
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Pre-computed Tool Category Index PDAs for each `ToolCategory` variant.
+ *
+ * Seeds: `["sap_tool_cat", category_byte]`
+ *
+ * Each entry corresponds to a `ToolCategory` enum discriminant:
+ *
+ * | Index | Category   | Address                                            |
+ * |-------|------------|----------------------------------------------------|
+ * | 0     | Swap       | `5H8yn9RuRgZWqkDiWbKNaCHzTMjqSpwbNQKMPLtUXx2G`   |
+ * | 1     | Lend       | `5Lqqk6VtFWnYq3h4Ae4FuUAKnFzw1Nm1DaSdt2cjcTDj`   |
+ * | 2     | Stake      | `kC8oAiVUcFMXEnmMNu1h2sdAc3dWKcwV5qVKRFYMmQD`    |
+ * | 3     | Nft        | `2zNWR9J3znvGQ5J6xDfJyZkd12Gi66mjErRDkgPeKbyF`   |
+ * | 4     | Payment    | `Eh7MwxJYWRN8bzAmY3ZPTRXYjWpWypokBf1STixu2dy9`   |
+ * | 5     | Data       | `AwpVxehQUZCVTAJ9icZfS6oRbF66jNo32duXaL11B5df`   |
+ * | 6     | Governance | `2573WjZzV9QtbqtM6Z86YGivkk1kdvJa4gK3tZRQ2jkN`   |
+ * | 7     | Bridge     | `664nyr6kBeeFiE1ij5gtdncNCVHrXqrk2uBhnKmUREvK`   |
+ * | 8     | Analytics  | `4DFsiTZ6h6RoCZuUeMTpaoQguepnPUMJBLJuwwjKg5GL`   |
+ * | 9     | Custom     | `3Nk5dvFWEyWPEArdG9cCdab6C6ym36mSWUSB8HzN35ZM`   |
+ *
+ * @name TOOL_CATEGORY_ADDRESSES
+ * @category Constants
+ * @since v0.3.1
+ */
+export const TOOL_CATEGORY_ADDRESSES = {
+    Swap: new PublicKey("5H8yn9RuRgZWqkDiWbKNaCHzTMjqSpwbNQKMPLtUXx2G"),
+    Lend: new PublicKey("5Lqqk6VtFWnYq3h4Ae4FuUAKnFzw1Nm1DaSdt2cjcTDj"),
+    Stake: new PublicKey("kC8oAiVUcFMXEnmMNu1h2sdAc3dWKcwV5qVKRFYMmQD"),
+    Nft: new PublicKey("2zNWR9J3znvGQ5J6xDfJyZkd12Gi66mjErRDkgPeKbyF"),
+    Payment: new PublicKey("Eh7MwxJYWRN8bzAmY3ZPTRXYjWpWypokBf1STixu2dy9"),
+    Data: new PublicKey("AwpVxehQUZCVTAJ9icZfS6oRbF66jNo32duXaL11B5df"),
+    Governance: new PublicKey("2573WjZzV9QtbqtM6Z86YGivkk1kdvJa4gK3tZRQ2jkN"),
+    Bridge: new PublicKey("664nyr6kBeeFiE1ij5gtdncNCVHrXqrk2uBhnKmUREvK"),
+    Analytics: new PublicKey("4DFsiTZ6h6RoCZuUeMTpaoQguepnPUMJBLJuwwjKg5GL"),
+    Custom: new PublicKey("3Nk5dvFWEyWPEArdG9cCdab6C6ym36mSWUSB8HzN35ZM"),
+};
+/**
+ * Array-indexed version of {@link TOOL_CATEGORY_ADDRESSES}.
+ *
+ * `TOOL_CATEGORY_ADDRESS_LIST[0]` = Swap, `[1]` = Lend, etc.
+ *
+ * @name TOOL_CATEGORY_ADDRESS_LIST
+ * @category Constants
+ * @since v0.3.1
+ */
+export const TOOL_CATEGORY_ADDRESS_LIST = [
+    TOOL_CATEGORY_ADDRESSES.Swap,
+    TOOL_CATEGORY_ADDRESSES.Lend,
+    TOOL_CATEGORY_ADDRESSES.Stake,
+    TOOL_CATEGORY_ADDRESSES.Nft,
+    TOOL_CATEGORY_ADDRESSES.Payment,
+    TOOL_CATEGORY_ADDRESSES.Data,
+    TOOL_CATEGORY_ADDRESSES.Governance,
+    TOOL_CATEGORY_ADDRESSES.Bridge,
+    TOOL_CATEGORY_ADDRESSES.Analytics,
+    TOOL_CATEGORY_ADDRESSES.Custom,
+];
+//# sourceMappingURL=addresses.js.map

package/dist/esm/constants/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../src/constants/addresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,sEAAsE;AACtE,uBAAuB;AACvB,sEAAsE;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,SAAS,CACtC,6CAA6C,CAC9C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,SAAS,CAChD,8CAA8C,CAC/C,CAAC;AAEF,sEAAsE;AACtE,kBAAkB;AAClB,sEAAsE;AAEtE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,SAAS,CAClD,8CAA8C,CAC/C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,sEAAsE;AACtE,yCAAyC;AACzC,sEAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,SAAS,CAC9C,8CAA8C,CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,SAAS,CACnD,6CAA6C,CAC9C,CAAC;AAEF,sEAAsE;AACtE,8DAA8D;AAC9D,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACnE,IAAI,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACnE,KAAK,EAAE,IAAI,SAAS,CAAC,6CAA6C,CAAC;IACnE,GAAG,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IAClE,OAAO,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACtE,IAAI,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACnE,UAAU,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACzE,MAAM,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACrE,SAAS,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACxE,MAAM,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;CAC7D,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAyB;IAC9D,uBAAuB,CAAC,IAAI;IAC5B,uBAAuB,CAAC,IAAI;IAC5B,uBAAuB,CAAC,KAAK;IAC7B,uBAAuB,CAAC,GAAG;IAC3B,uBAAuB,CAAC,OAAO;IAC/B,uBAAuB,CAAC,IAAI;IAC5B,uBAAuB,CAAC,UAAU;IAClC,uBAAuB,CAAC,MAAM;IAC9B,uBAAuB,CAAC,SAAS;IACjC,uBAAuB,CAAC,MAAM;CACtB,CAAC"}

package/dist/esm/constants/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @module constants
+ * @description Protocol constants mirroring the on-chain Rust program.
+ *
+ * Organized into:
+ * - **programs** — Network-specific program IDs
+ * - **seeds** — PDA seed prefix strings
+ * - **limits** — Size constraints, versions, enum numeric values
+ *
+ * @category Constants
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   MAINNET_SAP_PROGRAM_ID,
+ *   DEVNET_SAP_PROGRAM_ID,
+ *   SEEDS,
+ *   LIMITS,
+ * } from "@synapse-sap/sdk/constants";
+ * ```
+ */
+export { SAP_PROGRAM_ADDRESS, MAINNET_SAP_PROGRAM_ID, DEVNET_SAP_PROGRAM_ID, LOCALNET_SAP_PROGRAM_ID, SAP_PROGRAM_ID, } from "./programs";
+export { SEEDS } from "./seeds";
+export type { SeedKey } from "./seeds";
+export { LIMITS, AGENT_VERSION, VAULT_PROTOCOL_VERSION, TOOL_CATEGORY_VALUES, HTTP_METHOD_VALUES, } from "./limits";
+export { SapNetwork } from "./network";
+export type { SapNetworkId } from "./network";
+export { SAP_PROGRAM, SAP_UPGRADE_AUTHORITY, GLOBAL_REGISTRY_ADDRESS, GLOBAL_REGISTRY_BUMP, IDL_ACCOUNT_ADDRESS, PROGRAM_METADATA_PROGRAM, TOOL_CATEGORY_ADDRESSES, TOOL_CATEGORY_ADDRESS_LIST, } from "./addresses";
+export { USDC_MINT_MAINNET, USDC_MINT_DEVNET, MIN_AGENT_STAKE_LAMPORTS, MAX_DELEGATE_DURATION_SECS, isAcceptedUsdcMint, isAcceptedPaymentToken, } from "./payments";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EACL,MAAM,EACN,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}