@zerox1/sdk 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -205,6 +205,27 @@ export declare class Zerox1Agent {
      */
     encodeBidValue(value: bigint, rest?: Buffer): Buffer;
     private _connectInbox;
+    /**
+     * Upload a media blob to the aggregator.
+     * Enforces reputation-based size limits:
+     *   - Claimed/Rep 100+: 10 MB
+     *   - Rep 50-99: 2 MB
+     *   - Rep 10-49: 512 KB
+     *
+     * Every upload is signed by the agent's keypair for authentication.
+     *
+     * @param data - Buffer or Uint8Array of the media.
+     * @param aggregatorUrl - Aggregator base URL.
+     * @returns Hex-encoded CID (Keccak-256 hash).
+     */
+    uploadBlob(data: Buffer | Uint8Array, aggregatorUrl?: string): Promise<string>;
+    /**
+     * Download a media blob from the aggregator.
+     *
+     * @param cid - Hex-encoded CID.
+     * @param aggregatorUrl - Aggregator base URL.
+     */
+    downloadBlob(cid: string, aggregatorUrl?: string): Promise<Buffer>;
 }
 /**
  * A hosted agent that delegates signing and routing to a host node.

package/dist/index.js

@@ -43,6 +43,7 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const ws_1 = __importDefault(require("ws"));
+const ed = __importStar(require("@noble/ed25519"));
 // ============================================================================
 // CBOR encoding for FEEDBACK payload
 //
@@ -458,6 +459,70 @@ class Zerox1Agent {
         });
         ws.on('error', () => { });
     }
+    // ── Blobs (Media Relay) ───────────────────────────────────────────────────
+    /**
+     * Upload a media blob to the aggregator.
+     * Enforces reputation-based size limits:
+     *   - Claimed/Rep 100+: 10 MB
+     *   - Rep 50-99: 2 MB
+     *   - Rep 10-49: 512 KB
+     *
+     * Every upload is signed by the agent's keypair for authentication.
+     *
+     * @param data - Buffer or Uint8Array of the media.
+     * @param aggregatorUrl - Aggregator base URL.
+     * @returns Hex-encoded CID (Keccak-256 hash).
+     */
+    async uploadBlob(data, aggregatorUrl = 'https://api.0x01.world') {
+        const timestamp = Math.floor(Date.now() / 1000);
+        const body = Buffer.from(data);
+        // Signing payload: body + timestamp (8-byte Little Endian)
+        const tsBuf = Buffer.alloc(8);
+        tsBuf.writeBigUInt64LE(BigInt(timestamp), 0);
+        const msg = Buffer.concat([body, tsBuf]);
+        const secretKeyHex = fs.readFileSync(resolveKeypairPath(this._config.keypair), 'hex');
+        const secretKey = Buffer.from(secretKeyHex, 'hex').slice(0, 32);
+        const pubKey = await ed.getPublicKey(secretKey);
+        const signature = await ed.sign(msg, secretKey);
+        // In dev mode agent_id == verifying key (same hex).
+        // In SATI mode agent_id is the SATI mint address (different key).
+        // The aggregator uses X-0x01-Agent-Id for reputation lookup and
+        // X-0x01-Signer for signature verification — always the Ed25519 key.
+        const signerHex = Buffer.from(pubKey).toString('hex');
+        const agentIdHex = this._config.satiMint ?? signerHex;
+        const res = await fetch(`${aggregatorUrl}/blobs`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/octet-stream',
+                'X-0x01-Agent-Id': agentIdHex,
+                'X-0x01-Signer': signerHex,
+                'X-0x01-Timestamp': timestamp.toString(),
+                'X-0x01-Signature': Buffer.from(signature).toString('hex'),
+            },
+            body: body,
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+            throw new Error(`uploadBlob failed: ${err.error ?? res.status}`);
+        }
+        const { cid } = await res.json();
+        return cid;
+    }
+    /**
+     * Download a media blob from the aggregator.
+     *
+     * @param cid - Hex-encoded CID.
+     * @param aggregatorUrl - Aggregator base URL.
+     */
+    async downloadBlob(cid, aggregatorUrl = 'https://api.0x01.world') {
+        const res = await fetch(`${aggregatorUrl}/blobs/${cid}`);
+        if (res.status === 404)
+            throw new Error('Blob not found');
+        if (!res.ok)
+            throw new Error(`downloadBlob failed: HTTP ${res.status}`);
+        const arrayBuffer = await res.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
 }
 exports.Zerox1Agent = Zerox1Agent;
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "0x01 mesh agent SDK — zero-config, binary bundled, works on every platform",
   "license": "MIT",
   "main": "dist/index.js",
@@ -10,13 +10,14 @@
     "dev": "tsc --watch"
   },
   "dependencies": {
+    "@noble/ed25519": "^3.0.0",
     "ws": "^8.18.0"
   },
   "optionalDependencies": {
-    "@zerox1/sdk-darwin-arm64": "0.2.1",
-    "@zerox1/sdk-darwin-x64": "0.2.1",
-    "@zerox1/sdk-linux-x64": "0.2.1",
-    "@zerox1/sdk-win32-x64": "0.2.1"
+    "@zerox1/sdk-darwin-arm64": "0.2.3",
+    "@zerox1/sdk-darwin-x64": "0.2.3",
+    "@zerox1/sdk-linux-x64": "0.2.3",
+    "@zerox1/sdk-win32-x64": "0.2.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/packages/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-darwin-arm64",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "zerox1-node binary for macOS ARM64 (Apple Silicon)",
   "os": [
     "darwin"

package/packages/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-darwin-x64",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "zerox1-node binary for macOS x64 (Intel)",
   "os": [
     "darwin"

package/packages/linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-linux-x64",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "zerox1-node binary for Linux x64",
   "os": [
     "linux"

package/packages/win32-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-win32-x64",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "zerox1-node binary for Windows x64",
   "os": [
     "win32"

package/src/index.ts

@@ -4,6 +4,7 @@ import * as os from 'os'
 import * as path from 'path'
 import { spawn, ChildProcess } from 'child_process'
 import WebSocket from 'ws'
+import * as ed from '@noble/ed25519'
 
 // ============================================================================
 // Public config / types
@@ -623,6 +624,84 @@ export class Zerox1Agent {
 
     ws.on('error', () => { /* close event handles reconnect */ })
   }
+
+  // ── Blobs (Media Relay) ───────────────────────────────────────────────────
+
+  /**
+   * Upload a media blob to the aggregator.
+   * Enforces reputation-based size limits:
+   *   - Claimed/Rep 100+: 10 MB
+   *   - Rep 50-99: 2 MB
+   *   - Rep 10-49: 512 KB
+   *
+   * Every upload is signed by the agent's keypair for authentication.
+   *
+   * @param data - Buffer or Uint8Array of the media.
+   * @param aggregatorUrl - Aggregator base URL.
+   * @returns Hex-encoded CID (Keccak-256 hash).
+   */
+  async uploadBlob(
+    data: Buffer | Uint8Array,
+    aggregatorUrl = 'https://api.0x01.world'
+  ): Promise<string> {
+    const timestamp = Math.floor(Date.now() / 1000)
+    const body = Buffer.from(data)
+
+    // Signing payload: body + timestamp (8-byte Little Endian)
+    const tsBuf = Buffer.alloc(8)
+    tsBuf.writeBigUInt64LE(BigInt(timestamp), 0)
+    const msg = Buffer.concat([body, tsBuf])
+
+    const secretKeyHex = fs.readFileSync(resolveKeypairPath(this._config.keypair), 'hex')
+    const secretKey = Buffer.from(secretKeyHex, 'hex').slice(0, 32)
+    const pubKey = await ed.getPublicKey(secretKey)
+    const signature = await ed.sign(msg, secretKey)
+
+    // In dev mode agent_id == verifying key (same hex).
+    // In SATI mode agent_id is the SATI mint address (different key).
+    // The aggregator uses X-0x01-Agent-Id for reputation lookup and
+    // X-0x01-Signer for signature verification — always the Ed25519 key.
+    const signerHex  = Buffer.from(pubKey).toString('hex')
+    const agentIdHex = this._config.satiMint ?? signerHex
+
+    const res = await fetch(`${aggregatorUrl}/blobs`, {
+      method: 'POST',
+      headers: {
+        'Content-Type':   'application/octet-stream',
+        'X-0x01-Agent-Id': agentIdHex,
+        'X-0x01-Signer':   signerHex,
+        'X-0x01-Timestamp': timestamp.toString(),
+        'X-0x01-Signature': Buffer.from(signature).toString('hex'),
+      },
+      body: body,
+    })
+
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }))
+      throw new Error(`uploadBlob failed: ${(err as { error?: string }).error ?? res.status}`)
+    }
+
+    const { cid } = await res.json() as { cid: string }
+    return cid
+  }
+
+  /**
+   * Download a media blob from the aggregator.
+   *
+   * @param cid - Hex-encoded CID.
+   * @param aggregatorUrl - Aggregator base URL.
+   */
+  async downloadBlob(
+    cid: string,
+    aggregatorUrl = 'https://api.0x01.world'
+  ): Promise<Buffer> {
+    const res = await fetch(`${aggregatorUrl}/blobs/${cid}`)
+    if (res.status === 404) throw new Error('Blob not found')
+    if (!res.ok) throw new Error(`downloadBlob failed: HTTP ${res.status}`)
+
+    const arrayBuffer = await res.arrayBuffer()
+    return Buffer.from(arrayBuffer)
+  }
 }
 
 // ============================================================================