quorum-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,257 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AgentMultisig: () => AgentMultisig,
+  AgentMultisigError: () => AgentMultisigError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var AgentMultisigError = class extends Error {
+  constructor(message, statusCode, code) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "AgentMultisigError";
+  }
+};
+var AgentMultisig = class {
+  constructor(config) {
+    this.apiUrl = config.apiUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout ?? 3e4;
+  }
+  async request(method, path, body) {
+    const url = `${this.apiUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const data = await response.json();
+      if (!response.ok) {
+        throw new AgentMultisigError(
+          data.error || data.message || "Request failed",
+          response.status,
+          data.code
+        );
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof AgentMultisigError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new AgentMultisigError("Request timeout", 408, "TIMEOUT");
+      }
+      throw new AgentMultisigError(
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
+  }
+  // ==================== Health ====================
+  async health() {
+    return this.request("GET", "/health");
+  }
+  // ==================== Agents ====================
+  /**
+   * Register a new agent with the coordination API.
+   */
+  async registerAgent(input) {
+    return this.request("POST", "/agents", input);
+  }
+  /**
+   * Get an agent by ID.
+   */
+  async getAgent(agentId) {
+    return this.request("GET", `/agents/${agentId}`);
+  }
+  /**
+   * List all registered agents.
+   */
+  async listAgents() {
+    return this.request("GET", "/agents");
+  }
+  // ==================== Multisigs ====================
+  /**
+   * Create a new multisig wallet.
+   * 
+   * @example
+   * ```typescript
+   * const multisig = await client.createMultisig({
+   *   name: 'AI Treasury',
+   *   threshold: 2,
+   *   agents: ['agent_abc', 'agent_def', 'agent_ghi'],
+   *   network: 'mainnet'
+   * });
+   * console.log('Fund this address:', multisig.address);
+   * ```
+   */
+  async createMultisig(input) {
+    return this.request("POST", "/multisigs", input);
+  }
+  /**
+   * Get a multisig by ID.
+   */
+  async getMultisig(multisigId) {
+    return this.request("GET", `/multisigs/${multisigId}`);
+  }
+  /**
+   * List all multisigs.
+   */
+  async listMultisigs() {
+    return this.request("GET", "/multisigs");
+  }
+  /**
+   * Get the balance of a multisig wallet.
+   */
+  async getMultisigBalance(multisigId) {
+    return this.request("GET", `/multisigs/${multisigId}/balance`);
+  }
+  // ==================== Proposals ====================
+  /**
+   * Create a spend proposal for a multisig.
+   * 
+   * @example
+   * ```typescript
+   * const proposal = await client.createProposal({
+   *   multisigId: 'msig_xyz',
+   *   to: 'bc1qpzlw29z50cz7ysjpsaqggtscya3p6ggehnsp2g',
+   *   amount: 10000  // satoshis
+   * });
+   * console.log('PSBT to sign:', proposal.psbtHex);
+   * ```
+   */
+  async createProposal(input) {
+    return this.request("POST", "/proposals", input);
+  }
+  /**
+   * Get a proposal by ID.
+   */
+  async getProposal(proposalId) {
+    return this.request("GET", `/proposals/${proposalId}`);
+  }
+  /**
+   * List proposals, optionally filtered by multisig.
+   */
+  async listProposals(multisigId) {
+    const path = multisigId ? `/proposals?multisigId=${multisigId}` : "/proposals";
+    return this.request("GET", path);
+  }
+  /**
+   * Sign a proposal with an agent's key.
+   * 
+   * @example
+   * ```typescript
+   * // Agent signs the PSBT and submits signature
+   * const signature = await myWallet.signPsbt(proposal.psbtHex);
+   * await client.signProposal({
+   *   proposalId: proposal.id,
+   *   agentId: myAgent.id,
+   *   signature: signature
+   * });
+   * ```
+   */
+  async signProposal(input) {
+    return this.request("POST", `/proposals/${input.proposalId}/sign`, {
+      agentId: input.agentId,
+      signature: input.signature
+    });
+  }
+  /**
+   * Broadcast a fully-signed proposal.
+   */
+  async broadcastProposal(proposalId) {
+    return this.request("POST", `/proposals/${proposalId}/broadcast`);
+  }
+  // ==================== Convenience Methods ====================
+  /**
+   * Create a multisig and register agents in one call.
+   * 
+   * @example
+   * ```typescript
+   * const { multisig, agents } = await client.quickSetup({
+   *   name: 'Quick Treasury',
+   *   threshold: 2,
+   *   signers: [
+   *     { name: 'Bot1', provider: 'aibtc', publicKey: '...' },
+   *     { name: 'Bot2', provider: 'aibtc', publicKey: '...' },
+   *     { name: 'Bot3', provider: 'aibtc', publicKey: '...' },
+   *   ]
+   * });
+   * ```
+   */
+  async quickSetup(input) {
+    const agents = await Promise.all(
+      input.signers.map((signer) => this.registerAgent(signer))
+    );
+    const multisig = await this.createMultisig({
+      name: input.name,
+      threshold: input.threshold,
+      agents: agents.map((a) => a.id),
+      network: input.network
+    });
+    return { multisig, agents };
+  }
+  /**
+   * Wait for a proposal to reach a target status.
+   */
+  async waitForProposal(proposalId, targetStatus, options) {
+    const timeout = options?.timeoutMs ?? 3e5;
+    const interval = options?.pollIntervalMs ?? 5e3;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const proposal = await this.getProposal(proposalId);
+      if (proposal.status === targetStatus) {
+        return proposal;
+      }
+      if (proposal.status === "failed") {
+        throw new AgentMultisigError(
+          "Proposal failed",
+          400,
+          "PROPOSAL_FAILED"
+        );
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    throw new AgentMultisigError(
+      `Timeout waiting for proposal to reach ${targetStatus}`,
+      408,
+      "TIMEOUT"
+    );
+  }
+};
+var index_default = AgentMultisig;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentMultisig,
+  AgentMultisigError
+});

package/dist/index.mjs

@@ -0,0 +1,231 @@
+// src/index.ts
+var AgentMultisigError = class extends Error {
+  constructor(message, statusCode, code) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "AgentMultisigError";
+  }
+};
+var AgentMultisig = class {
+  constructor(config) {
+    this.apiUrl = config.apiUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout ?? 3e4;
+  }
+  async request(method, path, body) {
+    const url = `${this.apiUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const data = await response.json();
+      if (!response.ok) {
+        throw new AgentMultisigError(
+          data.error || data.message || "Request failed",
+          response.status,
+          data.code
+        );
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof AgentMultisigError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new AgentMultisigError("Request timeout", 408, "TIMEOUT");
+      }
+      throw new AgentMultisigError(
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
+  }
+  // ==================== Health ====================
+  async health() {
+    return this.request("GET", "/health");
+  }
+  // ==================== Agents ====================
+  /**
+   * Register a new agent with the coordination API.
+   */
+  async registerAgent(input) {
+    return this.request("POST", "/agents", input);
+  }
+  /**
+   * Get an agent by ID.
+   */
+  async getAgent(agentId) {
+    return this.request("GET", `/agents/${agentId}`);
+  }
+  /**
+   * List all registered agents.
+   */
+  async listAgents() {
+    return this.request("GET", "/agents");
+  }
+  // ==================== Multisigs ====================
+  /**
+   * Create a new multisig wallet.
+   * 
+   * @example
+   * ```typescript
+   * const multisig = await client.createMultisig({
+   *   name: 'AI Treasury',
+   *   threshold: 2,
+   *   agents: ['agent_abc', 'agent_def', 'agent_ghi'],
+   *   network: 'mainnet'
+   * });
+   * console.log('Fund this address:', multisig.address);
+   * ```
+   */
+  async createMultisig(input) {
+    return this.request("POST", "/multisigs", input);
+  }
+  /**
+   * Get a multisig by ID.
+   */
+  async getMultisig(multisigId) {
+    return this.request("GET", `/multisigs/${multisigId}`);
+  }
+  /**
+   * List all multisigs.
+   */
+  async listMultisigs() {
+    return this.request("GET", "/multisigs");
+  }
+  /**
+   * Get the balance of a multisig wallet.
+   */
+  async getMultisigBalance(multisigId) {
+    return this.request("GET", `/multisigs/${multisigId}/balance`);
+  }
+  // ==================== Proposals ====================
+  /**
+   * Create a spend proposal for a multisig.
+   * 
+   * @example
+   * ```typescript
+   * const proposal = await client.createProposal({
+   *   multisigId: 'msig_xyz',
+   *   to: 'bc1qpzlw29z50cz7ysjpsaqggtscya3p6ggehnsp2g',
+   *   amount: 10000  // satoshis
+   * });
+   * console.log('PSBT to sign:', proposal.psbtHex);
+   * ```
+   */
+  async createProposal(input) {
+    return this.request("POST", "/proposals", input);
+  }
+  /**
+   * Get a proposal by ID.
+   */
+  async getProposal(proposalId) {
+    return this.request("GET", `/proposals/${proposalId}`);
+  }
+  /**
+   * List proposals, optionally filtered by multisig.
+   */
+  async listProposals(multisigId) {
+    const path = multisigId ? `/proposals?multisigId=${multisigId}` : "/proposals";
+    return this.request("GET", path);
+  }
+  /**
+   * Sign a proposal with an agent's key.
+   * 
+   * @example
+   * ```typescript
+   * // Agent signs the PSBT and submits signature
+   * const signature = await myWallet.signPsbt(proposal.psbtHex);
+   * await client.signProposal({
+   *   proposalId: proposal.id,
+   *   agentId: myAgent.id,
+   *   signature: signature
+   * });
+   * ```
+   */
+  async signProposal(input) {
+    return this.request("POST", `/proposals/${input.proposalId}/sign`, {
+      agentId: input.agentId,
+      signature: input.signature
+    });
+  }
+  /**
+   * Broadcast a fully-signed proposal.
+   */
+  async broadcastProposal(proposalId) {
+    return this.request("POST", `/proposals/${proposalId}/broadcast`);
+  }
+  // ==================== Convenience Methods ====================
+  /**
+   * Create a multisig and register agents in one call.
+   * 
+   * @example
+   * ```typescript
+   * const { multisig, agents } = await client.quickSetup({
+   *   name: 'Quick Treasury',
+   *   threshold: 2,
+   *   signers: [
+   *     { name: 'Bot1', provider: 'aibtc', publicKey: '...' },
+   *     { name: 'Bot2', provider: 'aibtc', publicKey: '...' },
+   *     { name: 'Bot3', provider: 'aibtc', publicKey: '...' },
+   *   ]
+   * });
+   * ```
+   */
+  async quickSetup(input) {
+    const agents = await Promise.all(
+      input.signers.map((signer) => this.registerAgent(signer))
+    );
+    const multisig = await this.createMultisig({
+      name: input.name,
+      threshold: input.threshold,
+      agents: agents.map((a) => a.id),
+      network: input.network
+    });
+    return { multisig, agents };
+  }
+  /**
+   * Wait for a proposal to reach a target status.
+   */
+  async waitForProposal(proposalId, targetStatus, options) {
+    const timeout = options?.timeoutMs ?? 3e5;
+    const interval = options?.pollIntervalMs ?? 5e3;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const proposal = await this.getProposal(proposalId);
+      if (proposal.status === targetStatus) {
+        return proposal;
+      }
+      if (proposal.status === "failed") {
+        throw new AgentMultisigError(
+          "Proposal failed",
+          400,
+          "PROPOSAL_FAILED"
+        );
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    throw new AgentMultisigError(
+      `Timeout waiting for proposal to reach ${targetStatus}`,
+      408,
+      "TIMEOUT"
+    );
+  }
+};
+var index_default = AgentMultisig;
+export {
+  AgentMultisig,
+  AgentMultisigError,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "quorum-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Quorum - Multi-Agent Wallet Coordination",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["quorum", "bitcoin", "ethereum", "solana", "multisig", "agent", "ai", "taproot", "safe", "squads"],
+  "author": "Aetos <aetos@agentmail.to>",
+  "license": "MIT",
+  "homepage": "https://quorumclaw.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aetos53t/agent-multisig-api"
+  },
+  "bugs": {
+    "url": "https://github.com/aetos53t/agent-multisig-api/issues"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}