quest-dao-client 1.0.0

package/README.md

@@ -0,0 +1,27 @@
+# quest-dao-client
+
+The official library for interacting with QuestDAO's on-chain quest and voting systems.
+
+## features
+
+- **createQuest**: lock bounties in escrow for agent-specific tasks.
+- **delegateVote**: participate in DAO governance by delegating voting power.
+- **Robustness**: handles all Clarity value conversions automatically.
+
+## installation
+
+```bash
+npm install quest-dao-client
+```
+
+## usage
+
+```typescript
+import { createQuest } from 'quest-dao-client';
+
+await createQuest({
+  contractAddress: 'ST...',
+  senderKey: '...',
+  network: 'mainnet'
+}, 'ST_AGENT_OWNER...', 42, 1000000); // 1 STX bounty
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export interface QuestOptions {
+    contractAddress: string;
+    senderKey: string;
+    network?: 'mainnet' | 'testnet';
+}
+export declare function createQuest(opts: QuestOptions, agentOwner: string, agentId: number, bounty: number): Promise<import("@stacks/transactions").TxBroadcastResult>;
+export declare function delegateVote(opts: QuestOptions, delegateAddress: string): Promise<import("@stacks/transactions").TxBroadcastResult>;

package/dist/index.js

@@ -0,0 +1,38 @@
+import { makeContractCall, broadcastTransaction, AnchorMode, PostConditionMode, uintCV, standardPrincipalCV, } from '@stacks/transactions';
+import { StacksMainnet, StacksTestnet } from '@stacks/network';
+export async function createQuest(opts, agentOwner, agentId, bounty) {
+    const network = opts.network === 'mainnet' ? new StacksMainnet() : new StacksTestnet();
+    const txOptions = {
+        contractAddress: opts.contractAddress,
+        contractName: 'quest-escrow',
+        functionName: 'create-quest',
+        functionArgs: [
+            standardPrincipalCV(agentOwner),
+            uintCV(agentId),
+            uintCV(bounty),
+        ],
+        senderKey: opts.senderKey,
+        network,
+        anchorMode: AnchorMode.Any,
+        postConditionMode: PostConditionMode.Allow,
+        fee: 400,
+    };
+    const transaction = await makeContractCall(txOptions);
+    return broadcastTransaction(transaction, network);
+}
+export async function delegateVote(opts, delegateAddress) {
+    const network = opts.network === 'mainnet' ? new StacksMainnet() : new StacksTestnet();
+    const txOptions = {
+        contractAddress: opts.contractAddress,
+        contractName: 'dao-voting',
+        functionName: 'delegate',
+        functionArgs: [standardPrincipalCV(delegateAddress)],
+        senderKey: opts.senderKey,
+        network,
+        anchorMode: AnchorMode.Any,
+        postConditionMode: PostConditionMode.Allow,
+        fee: 400,
+    };
+    const transaction = await makeContractCall(txOptions);
+    return broadcastTransaction(transaction, network);
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "quest-dao-client",
+  "version": "1.0.0",
+  "description": "Client library for QuestDAO escrow and voting.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stacks",
+    "dao",
+    "quest",
+    "escrow",
+    "voting"
+  ],
+  "author": "QuestDAO Team",
+  "license": "MIT",
+  "dependencies": {
+    "@stacks/transactions": "^6.15.0",
+    "@stacks/network": "^6.17.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5"
+  }
+}