aegis-sdk 1.0.0

package/README.md

@@ -0,0 +1,27 @@
+# aegis-sdk
+
+The official client for the Aegis AI ecosystem on Stacks.
+
+## features
+
+- **registerAgent**: programmatically register AI agents.
+- **updateStatus**: toggle your agent's availability on-chain.
+- **Integration**: direct compatibility with the Aegis Agent Registry.
+
+## installation
+
+```bash
+npm install aegis-sdk
+```
+
+## usage
+
+```typescript
+import { registerAgent } from 'aegis-sdk';
+
+const result = await registerAgent({
+  contractAddress: 'ST...',
+  senderKey: '...',
+  network: 'testnet'
+}, "https://metadata.url/agent-details");
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export interface AegisOptions {
+    contractAddress: string;
+    senderKey: string;
+    network?: 'mainnet' | 'testnet';
+}
+export declare function registerAgent(opts: AegisOptions, metadata: string): Promise<import("@stacks/transactions").TxBroadcastResult>;
+export declare function updateStatus(opts: AegisOptions, agentId: number, active: boolean): Promise<import("@stacks/transactions").TxBroadcastResult>;

package/dist/index.js

@@ -0,0 +1,34 @@
+import { makeContractCall, broadcastTransaction, AnchorMode, PostConditionMode, stringUtf8CV, uintCV, boolCV, } from '@stacks/transactions';
+import { StacksMainnet, StacksTestnet } from '@stacks/network';
+export async function registerAgent(opts, metadata) {
+    const network = opts.network === 'mainnet' ? new StacksMainnet() : new StacksTestnet();
+    const txOptions = {
+        contractAddress: opts.contractAddress,
+        contractName: 'agent-registry',
+        functionName: 'register-agent',
+        functionArgs: [stringUtf8CV(metadata)],
+        senderKey: opts.senderKey,
+        network,
+        anchorMode: AnchorMode.Any,
+        postConditionMode: PostConditionMode.Allow,
+        fee: 400,
+    };
+    const transaction = await makeContractCall(txOptions);
+    return broadcastTransaction(transaction, network);
+}
+export async function updateStatus(opts, agentId, active) {
+    const network = opts.network === 'mainnet' ? new StacksMainnet() : new StacksTestnet();
+    const txOptions = {
+        contractAddress: opts.contractAddress,
+        contractName: 'agent-registry',
+        functionName: 'toggle-agent-status',
+        functionArgs: [uintCV(agentId), boolCV(active)],
+        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": "aegis-sdk",
+  "version": "1.0.0",
+  "description": "SDK for the Aegis AI project on Stacks.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stacks",
+    "bitcoin",
+    "ai",
+    "agent",
+    "registry"
+  ],
+  "author": "Aegis Team",
+  "license": "MIT",
+  "dependencies": {
+    "@stacks/transactions": "^6.15.0",
+    "@stacks/network": "^6.17.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5"
+  }
+}