@svsprotocol/solana 0.1.0

package/dist/solana-agent-kit.js

@@ -0,0 +1,151 @@
+import {
+  SvsAdapterCoreError,
+  createSvsAdapterClient,
+  requireSvsAdapterProductionReady,
+  verifyAndSubmitSvsAdapterSolanaAction
+} from "./adapter-core.js";
+
+export const SOLANA_AGENT_KIT_ADAPTER_VERSION = "svs.solana-agent-kit-adapter.v1";
+export const SOLANA_AGENT_KIT_TOOL_NAME = "svs_verify_and_submit_solana_action";
+
+export class SvsSolanaAgentKitAdapterError extends SvsAdapterCoreError {
+  constructor(message, details = {}) {
+    super(message, details);
+    this.name = "SvsSolanaAgentKitAdapterError";
+  }
+}
+
+export function createSvsSolanaAgentKitAdapter({
+  client = null,
+  baseUrl,
+  apiKey,
+  requestSigningSecret,
+  expectedIntegrationContractHash,
+  botId,
+  policyId = null,
+  rpcUrl = null,
+  certificationStaleAfterMs = undefined,
+  requireCurrentIntegrationContract = true,
+  waitForProof = false,
+  waitAttempts = 12,
+  waitIntervalMs = 5000,
+  fetchProof = true,
+  checkReceiptRegistryChain = true,
+  requireReadinessOnSubmit = true
+} = {}) {
+  if (!botId) {
+    throw new Error("botId is required.");
+  }
+
+  const svs = createSvsAdapterClient({
+    client,
+    baseUrl,
+    apiKey,
+    requestSigningSecret,
+    expectedIntegrationContractHash
+  });
+  const defaults = {
+    botId,
+    policyId,
+    rpcUrl,
+    certificationStaleAfterMs,
+    requireCurrentIntegrationContract,
+    waitForProof,
+    waitAttempts,
+    waitIntervalMs,
+    fetchProof,
+    checkReceiptRegistryChain,
+    requireReadinessOnSubmit
+  };
+
+  return {
+    version: SOLANA_AGENT_KIT_ADAPTER_VERSION,
+    name: SOLANA_AGENT_KIT_TOOL_NAME,
+    description: "Submit a Solana agent action through SVS human approval, production certification, policy enforcement, and portable proof generation.",
+    botId,
+    policyId,
+    rpcUrl,
+    client: svs,
+    async requireSvsProductionReady(options = {}) {
+      return requireSvsProductionReady({
+        client: svs,
+        ...defaults,
+        ...options
+      });
+    },
+    async verifyAndSubmitSolanaAction(input = {}, options = {}) {
+      return verifyAndSubmitSolanaAction({
+        client: svs,
+        ...defaults,
+        ...input,
+        ...options
+      });
+    },
+    tool: {
+      name: SOLANA_AGENT_KIT_TOOL_NAME,
+      description: "Require SVS production readiness, then queue a Solana action for human approval and proof-backed execution.",
+      parameters: {
+        type: "object",
+        required: ["intent", "serializedTransaction"],
+        properties: {
+          requestId: {
+            type: "string",
+            description: "Stable idempotency key for this agent action."
+          },
+          intent: {
+            type: "object",
+            description: "Human-readable action intent shown to the operator."
+          },
+          policyId: {
+            type: "string",
+            description: "SVS policy id to enforce for this action."
+          },
+          serializedTransaction: {
+            type: "string",
+            description: "Base64 or wire-format serialized Solana transaction prepared by the agent."
+          },
+          rpcUrl: {
+            type: "string",
+            description: "Solana RPC URL used to simulate or broadcast the action."
+          },
+          simulation: {
+            type: "object",
+            description: "Optional simulation result produced before submitting."
+          }
+        }
+      },
+      execute: async (input = {}) => verifyAndSubmitSolanaAction({
+        client: svs,
+        ...defaults,
+        ...input
+      })
+    }
+  };
+}
+
+export async function requireSvsProductionReady({
+  ...options
+} = {}) {
+  return requireSvsAdapterProductionReady({
+    ...options,
+    readinessVersion: "svs.solana-agent-kit-readiness.v1",
+    readyMessage: "SVS bot readiness and production certification passed.",
+    adapterLabel: "Solana Agent Kit adapter",
+    ErrorClass: SvsSolanaAgentKitAdapterError
+  });
+}
+
+export async function verifyAndSubmitSolanaAction({
+  ...options
+} = {}) {
+  return verifyAndSubmitSvsAdapterSolanaAction({
+    ...options,
+    adapterVersion: SOLANA_AGENT_KIT_ADAPTER_VERSION,
+    agentFramework: "solana-agent-kit",
+    resultVersion: "svs.solana-agent-kit-action-result.v1",
+    readinessVersion: "svs.solana-agent-kit-readiness.v1",
+    readyMessage: "SVS bot readiness and production certification passed.",
+    adapterLabel: "Solana Agent Kit adapter",
+    ErrorClass: SvsSolanaAgentKitAdapterError
+  });
+}